# jvrycode/attendance-face-recognition architecture

> Architecture diagram of the GitHub repository jvrycode/attendance-face-recognition, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/jvrycode/attendance-face-recognition
- Repository: https://github.com/jvrycode/attendance-face-recognition

## Overview

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: [`frontend/src/App.jsx`](https://github.com/jvrycode/attendance-face-recognition/blob/main/frontend/src/App.jsx) (Role-based app), [`core/models.py`](https://github.com/jvrycode/attendance-face-recognition/blob/main/core/models.py) (Academic records), [`attendance_fr/api/views`](https://github.com/jvrycode/attendance-face-recognition/tree/main/attendance_fr/api/views) (REST API views), [`frontend/src/components/scanner/ScannerRuntime.jsx`](https://github.com/jvrycode/attendance-face-recognition/blob/main/frontend/src/components/scanner/ScannerRuntime.jsx) (Live scanner runtime)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web application"]
  node_frontend["Role-based app<br/>[App.jsx]"]
  node_routes["Role routes<br/>[routes.js]"]
  node_admin_views["Academic admin views<br/>[SectionsView.jsx]"]
  node_reports_views["Reports and profiles<br/>[ReportsView.jsx]"]
  node_enrollment_view["Student enrollment"]
  node_scanner["Live scanner runtime<br/>[ScannerRuntime.jsx]"]
  node_api_client["REST API client<br/>[api.js]"]
end

subgraph group_api["API and identity"]
  node_api_views["REST API views"]
  node_auth_service["Authentication service<br/>[auth.py]"]
  node_reports_service["Reports service<br/>[reports.py]"]
end

subgraph group_academic["Academic domain"]
  node_enrollment_service["Enrollment access rules"]
  node_schedule_service["Schedule validation"]
end

subgraph group_attendance["Attendance and biometrics"]
  node_attendance_service["Attendance operations"]
  node_face_service["Face matching<br/>[face_service.py]"]
end

subgraph group_data["Persistent data"]
  node_account_models[("Users and profiles<br/>[models.py]")]
  node_academic_models[("Academic records<br/>[models.py]")]
  node_private_storage["Private face storage<br/>[storage.py]"]
end

node_users(("Admin, teacher, student"))
node_camera(("Webcam"))

node_users -->|"use"| node_frontend
node_frontend -->|"resolves routes"| node_routes
node_frontend -->|"renders"| node_admin_views
node_frontend -->|"renders"| node_reports_views
node_frontend -->|"renders"| node_enrollment_view
node_enrollment_view -.->|"submits enrollment"| node_api_client
node_scanner -->|"loads session"| node_api_client
node_camera -.->|"provides frames"| node_scanner
node_scanner -.->|"requests attendance"| node_api_views
node_api_client -.->|"calls REST API"| node_api_views
node_api_views -->|"delegates auth"| node_auth_service
node_auth_service -->|"revokes tokens"| node_account_models
node_academic_models -->|"references profiles"| node_account_models
node_academic_models -->|"validated by"| node_schedule_service
node_enrollment_service -->|"filters enrollments"| node_academic_models
node_attendance_service -->|"uses attendance records"| node_academic_models
node_face_service -->|"loads roster"| node_academic_models
node_face_service -->|"marks attendance"| node_attendance_service
node_account_models -->|"stores face photos"| node_private_storage
node_api_views -.->|"serves reports"| node_reports_service

click node_frontend "https://github.com/jvrycode/attendance-face-recognition/blob/main/frontend/src/App.jsx"
click node_routes "https://github.com/jvrycode/attendance-face-recognition/blob/main/frontend/src/routes.js"
click node_admin_views "https://github.com/jvrycode/attendance-face-recognition/blob/main/frontend/src/views/SectionsView.jsx"
click node_reports_views "https://github.com/jvrycode/attendance-face-recognition/blob/main/frontend/src/views/ReportsView.jsx"
click node_enrollment_view "https://github.com/jvrycode/attendance-face-recognition/blob/main/frontend/src/views/StudentEnrollmentView.jsx"
click node_scanner "https://github.com/jvrycode/attendance-face-recognition/blob/main/frontend/src/components/scanner/ScannerRuntime.jsx"
click node_api_client "https://github.com/jvrycode/attendance-face-recognition/blob/main/frontend/src/api.js"
click node_api_views "https://github.com/jvrycode/attendance-face-recognition/tree/main/attendance_fr/api/views"
click node_auth_service "https://github.com/jvrycode/attendance-face-recognition/blob/main/attendance_fr/api/services/auth.py"
click node_account_models "https://github.com/jvrycode/attendance-face-recognition/blob/main/accounts/models.py"
click node_academic_models "https://github.com/jvrycode/attendance-face-recognition/blob/main/core/models.py"
click node_enrollment_service "https://github.com/jvrycode/attendance-face-recognition/blob/main/core/services/enrollment_service.py"
click node_schedule_service "https://github.com/jvrycode/attendance-face-recognition/blob/main/core/services/schedule_service.py"
click node_attendance_service "https://github.com/jvrycode/attendance-face-recognition/blob/main/core/services/attendance_service.py"
click node_face_service "https://github.com/jvrycode/attendance-face-recognition/blob/main/face_app/services/face_service.py"
click node_private_storage "https://github.com/jvrycode/attendance-face-recognition/blob/main/attendance_fr/storage.py"
click node_reports_service "https://github.com/jvrycode/attendance-face-recognition/blob/main/attendance_fr/api/services/reports.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_frontend,node_routes,node_admin_views,node_reports_views,node_enrollment_view,node_scanner,node_api_client toneBlue
class node_api_views,node_auth_service,node_reports_service toneAmber
class node_enrollment_service,node_schedule_service toneMint
class node_attendance_service,node_face_service toneRose
class node_account_models,node_academic_models,node_private_storage,node_users,node_camera toneIndigo
```

## Components

### Web application

- [Role-based app](https://github.com/jvrycode/attendance-face-recognition/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Role routes](https://github.com/jvrycode/attendance-face-recognition/blob/main/frontend/src/routes.js): `frontend/src/routes.js`
- [Academic admin views](https://github.com/jvrycode/attendance-face-recognition/blob/main/frontend/src/views/SectionsView.jsx): `frontend/src/views/SectionsView.jsx`
- [Reports and profiles](https://github.com/jvrycode/attendance-face-recognition/blob/main/frontend/src/views/ReportsView.jsx): `frontend/src/views/ReportsView.jsx`
- [Student enrollment](https://github.com/jvrycode/attendance-face-recognition/blob/main/frontend/src/views/StudentEnrollmentView.jsx): `frontend/src/views/StudentEnrollmentView.jsx`
- [Live scanner runtime](https://github.com/jvrycode/attendance-face-recognition/blob/main/frontend/src/components/scanner/ScannerRuntime.jsx): `frontend/src/components/scanner/ScannerRuntime.jsx`
- [REST API client](https://github.com/jvrycode/attendance-face-recognition/blob/main/frontend/src/api.js): `frontend/src/api.js`

### API and identity

- [REST API views](https://github.com/jvrycode/attendance-face-recognition/tree/main/attendance_fr/api/views): `attendance_fr/api/views`
- [Authentication service](https://github.com/jvrycode/attendance-face-recognition/blob/main/attendance_fr/api/services/auth.py): `attendance_fr/api/services/auth.py`
- [Reports service](https://github.com/jvrycode/attendance-face-recognition/blob/main/attendance_fr/api/services/reports.py): `attendance_fr/api/services/reports.py`

### Academic domain

- [Enrollment access rules](https://github.com/jvrycode/attendance-face-recognition/blob/main/core/services/enrollment_service.py): `core/services/enrollment_service.py`
- [Schedule validation](https://github.com/jvrycode/attendance-face-recognition/blob/main/core/services/schedule_service.py): `core/services/schedule_service.py`

### Attendance and biometrics

- [Attendance operations](https://github.com/jvrycode/attendance-face-recognition/blob/main/core/services/attendance_service.py): `core/services/attendance_service.py`
- [Face matching](https://github.com/jvrycode/attendance-face-recognition/blob/main/face_app/services/face_service.py): `face_app/services/face_service.py`

### Persistent data

- [Users and profiles](https://github.com/jvrycode/attendance-face-recognition/blob/main/accounts/models.py): `accounts/models.py`
- [Academic records](https://github.com/jvrycode/attendance-face-recognition/blob/main/core/models.py): `core/models.py`
- [Private face storage](https://github.com/jvrycode/attendance-face-recognition/blob/main/attendance_fr/storage.py): `attendance_fr/storage.py`

### Other components

- **Admin, teacher, student**
- **Webcam**

## Connections

- Admin, teacher, student → Role-based app: use (evidence: `README.md`)
- Role-based app → Role routes: resolves routes (evidence: `frontend/src/App.jsx`)
- Role-based app → Academic admin views: renders (evidence: `frontend/src/App.jsx`)
- Role-based app → Reports and profiles: renders (evidence: `frontend/src/App.jsx`)
- Role-based app → Student enrollment: renders (evidence: `frontend/src/App.jsx`)
- Student enrollment → REST API client: submits enrollment (evidence: `frontend/src/views/StudentEnrollmentView.jsx`)
- Live scanner runtime → REST API client: loads session (evidence: `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 (evidence: `attendance_fr/api/views/auth.py`)
- Authentication service → Users and profiles: revokes tokens (evidence: `attendance_fr/api/services/auth.py`)
- Academic records → Users and profiles: references profiles (evidence: `core/models.py`)
- Academic records → Schedule validation: validated by (evidence: `core/models.py`)
- Enrollment access rules → Academic records: filters enrollments (evidence: `core/services/enrollment_service.py`)
- Attendance operations → Academic records: uses attendance records (evidence: `core/services/attendance_service.py`)
- Face matching → Academic records: loads roster (evidence: `face_app/services/face_service.py`)
- Face matching → Attendance operations: marks attendance (evidence: `face_app/services/face_service.py`)
- Users and profiles → Private face storage: stores face photos (evidence: `accounts/models.py`)
- REST API views → Reports service: serves reports
