Lost & Found Desktop App
A modern Lost & Found management system built with Python Tkinter. This application provides an intuitive interface for managing lost and found items with advanced search functionality, dark/light mode support, animated effects, and comprehensive database integration.
Features
User Interface
- undefinedDark/Light Mode Toggle: Switch between dark and light themes for better user experience across all interfaces
- undefinedModern Dashboard: Clean, professional interface with customizable color schemes and gradient backgrounds
- undefinedAnimated Effects: Typewriter text effects, blinking text animations, and smooth color transitions
- undefinedResponsive Design: Modern GUI that adapts to different themes with consistent styling
Authentication & User Management
- undefinedSecure Login System: Role-based authentication distinguishing between users and administrators
- undefinedUser Registration: Complete registration form with validation for new user accounts
- undefinedAdmin Panel Access: Separate administrative interface for system management
- undefinedDatabase Integration: SQLite database for secure user credential storage
Item Management
- undefinedLost Item Reporting: Comprehensive forms for reporting lost items with detailed information
- undefinedFound Item Submission: Easy-to-use interface for submitting found items
- undefinedAdvanced Search: Multi-criteria search functionality (item type, category, keywords, location)
- undefinedQuick Search: Fast search from main interface with instant results
- undefinedCategory Support: Multiple predefined categories including Electronics, Bags, Books, Personal Items, and more
Search and Navigation
- undefinedAdvanced Search Window: Detailed search functionality with filters for item type and category
- undefinedQuick Search Bar: Fast search from main interface with real-time results
- undefinedModal Windows: Professional popup windows for forms and searches
- undefinedIntuitive Navigation: Easy-to-use interface with clear button layouts and color coding
Administrative Features
- undefinedAdmin Control Panel: Complete administrative interface with tabbed navigation
- undefinedUser Management: Edit user accounts, delete users, manage permissions, and view user data
- undefinedItem Management: Add lost/found items directly through admin interface
- undefinedReports & Statistics: View comprehensive statistics including total items, active items, and claimed items
- undefinedDark Mode Support: Theme switching available in admin panel
- undefinedUser Type Management: Distinguish between admin and regular users
- undefinedDatabase Oversight: Complete CRUD operations for all data tables
Database Features
- undefinedSQLite Database: Lightweight and efficient database for storing all application data
- undefinedMultiple Tables: Separate tables for users, lost items, found items, and claimed items
- undefinedData Validation: Form validation and error handling throughout the application
- undefinedCRUD Operations: Complete Create, Read, Update, Delete functionality
- undefinedAutomatic Table Creation: Database initialization with proper schema setup
- undefinedUser Authentication: Secure credential storage with role-based access (admin/user)
- undefinedPhone Number Support: Complete user profile management including contact information
Application Components
-
undefinedLogin System (main.py):
- User authentication interface with gradient background
- Animated typewriter effects and blinking text
- User registration functionality with validation
- Admin panel access for authorized users
- Secure database integration
-
undefinedUser Interface (user_page.py):
- Report lost/found items with detailed forms
- Advanced search functionality with multiple filters
- Dark/light mode toggle with theme persistence
- Clean table display with sortable columns
- Modal windows for enhanced user experience
-
undefinedAdmin Panel (admin_page.py):
- Administrative controls with tabbed interface
- Item management (add lost/found items)
- User management (edit accounts, view details)
- Reports and statistics dashboard
- Dark mode support with consistent theming
-
undefinedDatabase Connection (db_connection.py):
- Centralized database connection management
- Automatic table creation and schema management
- Error handling and connection security
User Experience
- undefinedTheme Switching: Dark and light mode support across all interfaces
- undefinedColor-coded Interface:
- Red for “Report Lost Item”
- Green for “Report Found Item”
- Blue for “Search Items”
- Orange for administrative functions
- undefinedAnimated Effects: Typewriter animations, text blinking, and color transitions
- undefinedModal Dialogs: Professional popup windows for forms and data entry
- undefinedForm Validation: Comprehensive input validation with user-friendly error messages
- undefinedResponsive Design: Consistent layout across different window sizes
- undefinedModal Window Management: Prevents multiple instances of the same window
- undefinedError Handling: Robust database error handling throughout the application
- undefinedResponsive Tables: Automatic table refresh and data synchronization
- undefinedSequential ID Display: User-friendly ID numbering in table displays
- undefinedWindow Centering: All windows automatically center on screen
- undefinedGradient Backgrounds: Beautiful gradient effects in login and registration windows
Getting Started
Prerequisites
- Python 3.7 or higher
- Tkinter (usually included with Python installation)
- SQLite3 (included with Python)
Installation
- Clone or download the repository
- Navigate to the project directory
- Ensure all Python files are in the same directory
- Run the application
Running the Application
undefinedMain Entry Point (Recommended):undefined
python main.py
undefinedDirect Access Options:undefined
# Access user interface directly
python user_page.py
# Access admin panel directly (requires authentication)
python admin_page.py
Application Flow
- undefinedStart with Login (
main.py) - Main entry point with authentication and registration
- undefinedUser Authentication - Login with username/password or register new account
- undefinedUser Interface - Report lost/found items, search database, and view results
- undefinedAdmin Panel - Administrative controls, user management, and system reports
Database Structure
- undefinedUsers Table: Stores user accounts with authentication and profile information (username, password, full_name, email, phone, user_type)
- undefinedLost Items Table: Records of reported lost items with detailed descriptions
- undefinedFound Items Table: Records of submitted found items with location data
- undefinedClaimed Items Table: Tracking of successfully reunited items
Features in Detail
Search Functionality
- Multi-field search across item names, categories, locations, and descriptions
- Filter by item type (Lost, Found, or All)
- Category-based filtering with predefined options
- Real-time results display with sequential ID numbering
Theme Support
- Consistent dark/light mode across all application windows
- Automatic theme application to modal windows and forms
- Professional color schemes optimized for readability
Data Management
- Automatic database initialization on first run
- Comprehensive error handling and user feedback
- Data validation for all form inputs
- Secure database operations with proper connection management
undefinedDeveloped by TEAM DOBERMANundefined
© 2025 All rights reserved