How shreyanshfs/attendance_ai_running works
Smart Attendance System is a Flask application for camera-based, liveness-verified attendance, with admin and student dashboards, account access, and absence notifications. The main workflow sends camera frames to the application’s recognition orchestration, verifies identity and liveness, then marks attendance and updates student records. Separate branches provide dashboard and authentication APIs, student statistics, and WhatsApp alerts. The README documents dashboard, gamification, and anti-spoofing capabilities; some routes and integrations are unsampled, so only documented or indexed relationships are shown.
Main entry points: main.py Flask Application · dashboard.js Dashboard Client · routes.py Admin API · auth_routes.py Auth API
Components 18
Web and Access
- Admin Dashboard
templates/dashboard.html - Student Dashboard
templates/student_dashboard.html - Dashboard Client
static/js/dashboard.js - Admin API
routes.py - Student API
student_routes.py - Auth API
auth_routes.py - Auth Service
auth_service.py - Flask Application
main.py
Attendance Verification
- Camera Orchestrator
main.py - Face Recognition
face_recognition_service.py - Liveness Checks
liveness_detection.py - Spoof Detection
spoof_detection/ensemble_spoof.py
Attendance Domain
- Attendance Service
attendance_service.py
Persistence and Alerts
- Attendance Records
models.py - Runtime Configuration
config.py - WhatsApp Service
whatsapp_service.py
Other components
- User Browser
- WhatsApp API
Connections 23
- User Browser → Admin Dashboard: uses
README.md - User Browser → Student Dashboard: uses
README.md - Admin Dashboard → Dashboard Client: loads
- Student Dashboard → Dashboard Client: loads
- Dashboard Client → Admin API: requests
- Dashboard Client → Student API: requests
- User Browser → Auth API: authenticates
README.md - Flask Application → Admin API: registers
main.py - Flask Application → Auth API: registers
main.py - Flask Application → Student API: registers
main.py - Auth API → Auth Service: uses
auth_routes.py - Admin API → Attendance Service: uses
routes.py - Admin API → Face Recognition: uses
routes.py - Student API → Attendance Records: queries
student_routes.py - Camera Orchestrator → Face Recognition: processes frames
main.py - Camera Orchestrator → Attendance Service: marks attendance
main.py - Face Recognition → Liveness Checks: checks liveness
face_recognition_service.py - Face Recognition → Spoof Detection: checks spoofing
face_recognition_service.py - Attendance Service → Attendance Records: updates
attendance_service.py - Attendance Service → WhatsApp Service: sends alerts
attendance_service.py - Auth API → WhatsApp Service: sends OTP
auth_routes.py - WhatsApp Service → WhatsApp API: sends messages
whatsapp_service.py - Flask Application → Runtime Configuration: loads settings
main.py