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

1. 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

2. 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

3. 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

4. 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

1. Clone or download the repository
2. Navigate to the project directory
3. Ensure all Python files are in the same directory
4. 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

1. undefinedStart with Login (main.py) - Main entry point with authentication and registration
2. undefinedUser Authentication - Login with username/password or register new account
3. undefinedUser Interface - Report lost/found items, search database, and view results
4. 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