A comprehensive Django-based attendance management system with face recognition and fingerprint verification capabilities. This system allows organizations to track employee attendance efficiently with multiple verification methods.

• Multiple Authentication Methods:
  • Face Recognition (✅ Implemented with real camera access)
  • Fingerprint Scanning
  • Manual Entry
• User Management:
  • User Registration
  • Profile Management
  • Role-based Access Control
• Attendance Tracking:
  • Check-in/Check-out Recording
  • Attendance History
  • Attendance Reports
• Reporting:
  • Detailed and Summary Reports
  • Export to CSV
  • Date Range Filtering
• Admin Dashboard:
  • User Management
  • Attendance Overview
  • System Configuration
  • Notification Dashboard: Real-time attendance monitoring with live statistics and notification management
• Camera Integration:
  • Real-time camera access using Web API
  • Face detection and capture
  • Image processing and validation
  • Secure file upload handling

• Backend: Django (Python)
• Frontend: HTML, CSS, JavaScript, Bootstrap
• Database: SQLite (default), compatible with PostgreSQL, MySQL
• Authentication: Django Authentication System
• Camera Integration: Web MediaDevices API, Canvas API for image processing
• Biometric Integration: JavaScript APIs for camera and fingerprint scanner

# Clone the repository
git clone https://github.com/Abhishek-max825/project_django.git
cd project_django

# Run the automated installation script
python install.py

• Python 3.8 or higher
• pip (Python package manager)
• Virtual environment (recommended)

1. Clone the repository

   git clone https://github.com/Abhishek-max825/project_django.git
   cd project_django

2. Create and activate a virtual environment

   # Windows
   python -m venv venv
   venv\Scripts\activate
   
   # Linux/Mac
   python3 -m venv venv
   source venv/bin/activate

3. Install dependencies

   pip install -r requirements.txt

4. Apply migrations

   python manage.py migrate

5. Create a superuser

   python manage.py createsuperuser

6. Run the development server

   python manage.py runserver

7. Access the application

   • Main application: http://127.0.0.1:8000/
   • Admin interface: http://127.0.0.1:8000/admin/
   • Camera test: http://127.0.0.1:8000/attendance/test-camera/
   • Notification Dashboard: http://127.0.0.1:8000/attendance/notifications/

• No additional system dependencies required
• OpenCV will be installed automatically via pip

• May need to install OpenCV system dependencies:

  sudo apt install libgl1-mesa-glx libglib2.0-0

• Install OpenCV via Homebrew:

  brew install opencv

If you encounter issues:

1. Check Python version: Ensure you have Python 3.8+
2. Use the installation script: python install.py
3. Check platform-specific requirements in DEPLOYMENT_GUIDE.md
4. Verify virtual environment: Make sure it's activated
5. Check pip: Ensure pip is up to date

1. Log in to the admin interface using the superuser credentials
2. Manage users, departments, and attendance records
3. Generate and export attendance reports
4. Access the notification dashboard for daily attendance monitoring

The notification dashboard provides real-time attendance monitoring and management:

1. Access the Dashboard:

   • Navigate to: http://127.0.0.1:8000/attendance/notifications/
   • Requires admin/staff privileges to access

2. Features Available:

   • Real-time Statistics: View total students, present, absent, and late counts
   • Current Date & Time: Live display of current date and time
   • Attendance Status Table: Manage individual student attendance status
   • Recent Notifications: View and manage system notifications
   • Daily Summary: Create daily attendance summaries
   • Send Notifications: Send alerts for absent/late students

3. How to Use:

   • View Statistics: Check the cards at the top for attendance overview
   • Update Status: Use dropdown menus in the attendance table to change student status
   • Create Notifications: Click "Create Daily Summary" or "Send Notifications" buttons
   • Mark as Read: Click the checkmark button on unread notifications
   • Auto-refresh: Dashboard refreshes every 5 minutes automatically

4. Attendance Status Options:

   • Present: Student is present and on time
   • Absent: Student is not present
   • Late: Student arrived late
   • Half Day: Student attended for part of the day
   • On Leave: Student is on approved leave

5. Notification Types:

   • Daily Summary: Overview of daily attendance
   • Absent Alert: Notifications for absent students
   • Late Alert: Notifications for late students
   • System Alert: General system notifications

1. Register a new account or log in with existing credentials
2. Set up your profile with required information
3. Upload face image and/or fingerprint data for biometric verification
4. Mark attendance using preferred verification method
5. View attendance history and personal reports

1. Face Upload: Navigate to "Upload Face" to capture your face image using your device's camera
2. Attendance Marking: When marking attendance, select "Face Recognition" as verification method
3. Camera Access: The system will request camera permissions - allow access for face verification
4. Face Detection: The system includes basic face detection to ensure a face is visible in the captured image
5. Image Processing: Captured images are processed and stored securely for attendance verification

• Modern web browser with camera support (Chrome, Firefox, Safari, Edge)
• HTTPS connection (required for camera access in most browsers)
• Camera permissions granted to the website
• Front-facing camera recommended for best results

attendance_system/
├── attendance/            # Attendance app
│   ├── admin.py           # Admin configuration
│   ├── forms.py           # Form definitions
│   ├── models.py          # Data models
│   ├── urls.py            # URL routing
│   └── views.py           # View functions
├── users/                 # Users app
│   ├── admin.py           # Admin configuration
│   ├── forms.py           # Form definitions
│   ├── models.py          # Data models
│   ├── urls.py            # URL routing
│   └── views.py           # View functions
├── attendance_system/     # Project settings
│   ├── settings.py        # Django settings
│   ├── urls.py            # Main URL routing
│   └── wsgi.py            # WSGI configuration
├── static/                # Static files
│   ├── css/               # CSS files
│   ├── js/                # JavaScript files
│   └── img/               # Image files
├── templates/             # HTML templates
│   ├── attendance/        # Attendance templates
│   └── users/             # User templates
├── media/                 # User-uploaded files
├── manage.py              # Django management script
└── requirements.txt       # Project dependencies

• Biometric data is stored securely and used only for attendance verification
• User passwords are hashed and not stored in plaintext
• CSRF protection is enabled for all forms
• User permissions are strictly enforced

• Mobile application integration
• Real-time notifications
• Advanced analytics dashboard
• Integration with HR systems
• Geolocation-based attendance

This project is licensed under the MIT License - see the LICENSE file for details.

• [Your Name] - Initial work