How zaniac25/smart-attendance-system works
ABIT Attendance System is a Django-backed student attendance and academic administration application, with a desktop QR scanner as a thin client. The main workflow scans a student's QR code, optionally verifies the face locally, submits attendance to the backend, and records it for reporting. The web application also supports student and session administration, manual attendance, teacher and student dashboards, timetable and holiday management, analytics, and email alerts. Source excerpts establish the main backend and scanner relationships; some desktop-to-API routing details are not shown.
Main entry points: views.py Views and APIs · models.py Student and domain data · scanner.py QR scanner · analytics.py Attendance analytics
Components 23
Desktop scanning
- QR scanner
desktop/scanner.py - Face verification
desktop/face_verifier.py - API client
desktop/api_client.py
Web application
- Web routes
core/urls.py - Views and APIs
core/views.py - Role checks
core/roles.py - Role context
core/context_processors.py - Admin and dashboards
core/templates/dashboard - Student management
core/views.py
Attendance domain
- Academic sessions
core/models.py - Attendance records
core/models.py - Student and domain data
core/models.py - API serialization
core/serializers.py - CSV imports
core/import_csv.py - Admission-year import
core/management/commands/import_admission_year.py - Session enrollment
core/management/commands/auto_enroll_sessions.py
Reports and alerts
- Attendance analytics
core/analytics.py - Scheduled jobs
core/scheduler.py - Absent reports
core/notifications.py - Attendance alert email
core/smtp_helper.py
Other components
- Scanner operator
- Web user
- Email service
Connections 26
- Scanner operator → QR scanner: operates
desktop/scanner.py - QR scanner → Face verification: verifies face
desktop/scanner.py - QR scanner → API client: submits attendance
desktop/scanner.py - API client → Views and APIs: calls attendance API
- Web user → Web routes: requests page
core/urls.py - Web routes → Views and APIs: routes to
core/urls.py - Views and APIs → Student and domain data: reads and updates
core/views.py - Views and APIs → API serialization: uses serialization
core/views.py - Views and APIs → Attendance analytics: requests reports
core/views.py - Views and APIs → Absent reports: uses notifications
core/views.py - Views and APIs → Attendance alert email: uses email alerts
core/views.py - Views and APIs → Role checks: checks permissions
core/views.py - Role context → Role checks: checks roles
core/context_processors.py - Role context → Student and domain data: counts change requests
core/context_processors.py - Views and APIs → Admin and dashboards: renders pages
- Views and APIs → Student management: handles student changes
core/views.py - Student management → Student and domain data: persists students
core/views.py - Student and domain data → Academic sessions: stores session data
core/models.py - Student and domain data → Attendance records: stores attendance
core/models.py - CSV imports → Student and domain data: imports records
core/import_csv.py - Admission-year import → Student and domain data: updates admission year
core/management/commands/import_admission_year.py - Session enrollment → Student and domain data: assigns sessions
core/management/commands/auto_enroll_sessions.py - Attendance analytics → Student and domain data: queries attendance data
core/analytics.py - Absent reports → Attendance analytics: gets daily report
core/notifications.py - Scheduled jobs → Absent reports: schedules reports
core/scheduler.py - Attendance alert email → Email service: sends email