How jvrycode/attendance-face-recognition works
AttendFR is a role-based attendance management system combining academic administration, biometric enrollment, live face-recognition attendance, and reporting. Users navigate role-specific views; teachers run live scans that match enrolled students and update session attendance, while administrators manage academic data and students submit biometric enrollment. The graph includes the frontend, REST-facing backend, domain services, models, and private biometric storage. Backend API routing and several view-to-service calls were not sampled, so uncertain connections are omitted or marked unverified.
Main entry points: App.jsx Role-based app · models.py Academic records · views REST API views · ScannerRuntime.jsx Live scanner runtime
Components 19
Web application
- Role-based app
frontend/src/App.jsx - Role routes
frontend/src/routes.js - Academic admin views
frontend/src/views/SectionsView.jsx - Reports and profiles
frontend/src/views/ReportsView.jsx - Student enrollment
frontend/src/views/StudentEnrollmentView.jsx - Live scanner runtime
frontend/src/components/scanner/ScannerRuntime.jsx - REST API client
frontend/src/api.js
API and identity
- REST API views
attendance_fr/api/views - Authentication service
attendance_fr/api/services/auth.py - Reports service
attendance_fr/api/services/reports.py
Academic domain
- Enrollment access rules
core/services/enrollment_service.py - Schedule validation
core/services/schedule_service.py
Attendance and biometrics
- Attendance operations
core/services/attendance_service.py - Face matching
face_app/services/face_service.py
Persistent data
- Users and profiles
accounts/models.py - Academic records
core/models.py - Private face storage
attendance_fr/storage.py
Other components
- Admin, teacher, student
- Webcam
Connections 20
- Admin, teacher, student → Role-based app: use
README.md - Role-based app → Role routes: resolves routes
frontend/src/App.jsx - Role-based app → Academic admin views: renders
frontend/src/App.jsx - Role-based app → Reports and profiles: renders
frontend/src/App.jsx - Role-based app → Student enrollment: renders
frontend/src/App.jsx - Student enrollment → REST API client: submits enrollment
frontend/src/views/StudentEnrollmentView.jsx - Live scanner runtime → REST API client: loads session
frontend/src/components/scanner/ScannerRuntime.jsx - Webcam → Live scanner runtime: provides frames
- Live scanner runtime → REST API views: requests attendance
- REST API client → REST API views: calls REST API
- REST API views → Authentication service: delegates auth
attendance_fr/api/views/auth.py - Authentication service → Users and profiles: revokes tokens
attendance_fr/api/services/auth.py - Academic records → Users and profiles: references profiles
core/models.py - Academic records → Schedule validation: validated by
core/models.py - Enrollment access rules → Academic records: filters enrollments
core/services/enrollment_service.py - Attendance operations → Academic records: uses attendance records
core/services/attendance_service.py - Face matching → Academic records: loads roster
face_app/services/face_service.py - Face matching → Attendance operations: marks attendance
face_app/services/face_service.py - Users and profiles → Private face storage: stores face photos
accounts/models.py - REST API views → Reports service: serves reports