# nguyleminhtu/facetrackapp architecture

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

- Interactive diagram: https://gitdiagram.com/nguyleminhtu/facetrackapp
- Repository: https://github.com/nguyleminhtu/facetrackapp

## Overview

DeepFaceApp is a face-recognition attendance system for teachers and students. Users sign in, then teachers manage courses and enrollments and run attendance sessions; students can submit attendance through the recognition flow. Attendance history and downloadable reports support review. The graph combines the documented product capabilities with relationships visible in the excerpts and SOURCE INDEX; some UI pages and backend services were not sampled, so their internal interactions are not inferred.

Main entry points: [`Frontend/src/App.jsx`](https://github.com/nguyleminhtu/facetrackapp/blob/main/Frontend/src/App.jsx) (App routing), [`Backend/app/main.py`](https://github.com/nguyleminhtu/facetrackapp/blob/main/Backend/app/main.py) (FastAPI app), [`Frontend/src/api/axios.js`](https://github.com/nguyleminhtu/facetrackapp/blob/main/Frontend/src/api/axios.js) (API client), [`Backend/app/api/routers/courses.py`](https://github.com/nguyleminhtu/facetrackapp/blob/main/Backend/app/api/routers/courses.py) (Course routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web application"]
  node_app["App routing<br/>[App.jsx]"]
  node_login["Login<br/>[Login.jsx]"]
  node_attendance_ui["Attendance page<br/>[Attendance.jsx]"]
  node_management_ui["Management page<br/>[Management.jsx]"]
  node_course_ui["Course page<br/>[Course.jsx]"]
  node_history_ui["History page<br/>[History.jsx]"]
  node_student_ui["Student attendance"]
  node_attendance_ctx["Attendance context"]
  node_course_ctx["Course context<br/>[courseContext.jsx]"]
  node_user_ctx["User context<br/>[userContext.jsx]"]
  node_history_ctx["History context<br/>[historyContext.jsx]"]
  node_http["API client<br/>[axios.js]"]
end

subgraph group_api["Backend API"]
  node_server["FastAPI app<br/>[main.py]"]
  node_auth_routes["Auth routes<br/>[auth.py]"]
  node_user_routes["User routes<br/>[users.py]"]
  node_course_routes["Course routes<br/>[courses.py]"]
  node_recognize_routes["Recognition routes<br/>[recognize.py]"]
end

subgraph group_domain["Attendance services"]
  node_enrollment["Enrollment service<br/>[enrollment.py]"]
  node_attendance["Attendance service<br/>[attendance.py]"]
  node_recognition["Face recognition"]
  node_reports["Report service<br/>[report.py]"]
end

subgraph group_data["Persistence and identity"]
  node_auth_service["Auth service<br/>[auth.py]"]
  node_user_service["User service<br/>[user.py]"]
  node_database[("Database<br/>[database.py]")]
end

node_teacher(("Teacher"))
node_student(("Student"))

node_teacher -->|"uses"| node_app
node_student -->|"uses"| node_app
node_app -->|"routes to"| node_login
node_app -->|"routes to"| node_attendance_ui
node_app -->|"routes to"| node_management_ui
node_app -->|"routes to"| node_course_ui
node_app -->|"routes to"| node_history_ui
node_app -->|"routes to"| node_student_ui
node_attendance_ui -->|"uses"| node_attendance_ctx
node_management_ui -->|"uses"| node_user_ctx
node_management_ui -->|"uses"| node_course_ctx
node_course_ui -->|"uses"| node_course_ctx
node_history_ui -->|"uses"| node_history_ctx
node_attendance_ctx -->|"sends requests"| node_http
node_course_ctx -->|"sends requests"| node_http
node_user_ctx -->|"sends requests"| node_http
node_history_ctx -->|"sends requests"| node_http
node_http -->|"calls API"| node_server
node_server -->|"registers"| node_auth_routes
node_server -->|"registers"| node_user_routes
node_server -->|"registers"| node_course_routes
node_server -->|"registers"| node_recognize_routes
node_auth_routes -->|"uses"| node_auth_service
node_auth_routes -->|"uses"| node_user_service
node_user_routes -->|"uses"| node_user_service
node_user_routes -->|"uses"| node_enrollment
node_course_routes -->|"uses"| node_enrollment
node_course_routes -->|"uses"| node_attendance
node_course_routes -->|"uses"| node_reports
node_recognize_routes -->|"uses"| node_recognition
node_recognize_routes -->|"uses"| node_attendance
node_auth_service -.-> node_database
node_enrollment -.->|"reads and writes"| node_database
node_attendance -.->|"reads and writes"| node_database
node_reports -.->|"reads"| node_database

click node_app "https://github.com/nguyleminhtu/facetrackapp/blob/main/Frontend/src/App.jsx"
click node_login "https://github.com/nguyleminhtu/facetrackapp/blob/main/Frontend/src/pages/Login.jsx"
click node_attendance_ui "https://github.com/nguyleminhtu/facetrackapp/blob/main/Frontend/src/pages/Attendance.jsx"
click node_management_ui "https://github.com/nguyleminhtu/facetrackapp/blob/main/Frontend/src/pages/Management.jsx"
click node_course_ui "https://github.com/nguyleminhtu/facetrackapp/blob/main/Frontend/src/pages/Course.jsx"
click node_history_ui "https://github.com/nguyleminhtu/facetrackapp/blob/main/Frontend/src/pages/History.jsx"
click node_student_ui "https://github.com/nguyleminhtu/facetrackapp/blob/main/Frontend/src/pages/StudentAttendance.jsx"
click node_attendance_ctx "https://github.com/nguyleminhtu/facetrackapp/blob/main/Frontend/src/context/AttendanceContext.jsx"
click node_course_ctx "https://github.com/nguyleminhtu/facetrackapp/blob/main/Frontend/src/context/courseContext.jsx"
click node_user_ctx "https://github.com/nguyleminhtu/facetrackapp/blob/main/Frontend/src/context/userContext.jsx"
click node_history_ctx "https://github.com/nguyleminhtu/facetrackapp/blob/main/Frontend/src/context/historyContext.jsx"
click node_http "https://github.com/nguyleminhtu/facetrackapp/blob/main/Frontend/src/api/axios.js"
click node_server "https://github.com/nguyleminhtu/facetrackapp/blob/main/Backend/app/main.py"
click node_auth_routes "https://github.com/nguyleminhtu/facetrackapp/blob/main/Backend/app/api/routers/auth.py"
click node_user_routes "https://github.com/nguyleminhtu/facetrackapp/blob/main/Backend/app/api/routers/users.py"
click node_course_routes "https://github.com/nguyleminhtu/facetrackapp/blob/main/Backend/app/api/routers/courses.py"
click node_recognize_routes "https://github.com/nguyleminhtu/facetrackapp/blob/main/Backend/app/api/routers/recognize.py"
click node_auth_service "https://github.com/nguyleminhtu/facetrackapp/blob/main/Backend/app/services/auth.py"
click node_user_service "https://github.com/nguyleminhtu/facetrackapp/blob/main/Backend/app/services/user.py"
click node_enrollment "https://github.com/nguyleminhtu/facetrackapp/blob/main/Backend/app/services/enrollment.py"
click node_attendance "https://github.com/nguyleminhtu/facetrackapp/blob/main/Backend/app/services/attendance.py"
click node_recognition "https://github.com/nguyleminhtu/facetrackapp/blob/main/Backend/app/services/face_recognition.py"
click node_reports "https://github.com/nguyleminhtu/facetrackapp/blob/main/Backend/app/services/report.py"
click node_database "https://github.com/nguyleminhtu/facetrackapp/blob/main/Backend/app/database.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_app,node_login,node_attendance_ui,node_management_ui,node_course_ui,node_history_ui,node_student_ui,node_attendance_ctx,node_course_ctx,node_user_ctx,node_history_ctx,node_http toneBlue
class node_server,node_auth_routes,node_user_routes,node_course_routes,node_recognize_routes toneAmber
class node_enrollment,node_attendance,node_recognition,node_reports toneMint
class node_auth_service,node_user_service,node_database toneRose
class node_teacher,node_student toneIndigo
```

## Components

### Web application

- [App routing](https://github.com/nguyleminhtu/facetrackapp/blob/main/Frontend/src/App.jsx): `Frontend/src/App.jsx`
- [Login](https://github.com/nguyleminhtu/facetrackapp/blob/main/Frontend/src/pages/Login.jsx): `Frontend/src/pages/Login.jsx`
- [Attendance page](https://github.com/nguyleminhtu/facetrackapp/blob/main/Frontend/src/pages/Attendance.jsx): `Frontend/src/pages/Attendance.jsx`
- [Management page](https://github.com/nguyleminhtu/facetrackapp/blob/main/Frontend/src/pages/Management.jsx): `Frontend/src/pages/Management.jsx`
- [Course page](https://github.com/nguyleminhtu/facetrackapp/blob/main/Frontend/src/pages/Course.jsx): `Frontend/src/pages/Course.jsx`
- [History page](https://github.com/nguyleminhtu/facetrackapp/blob/main/Frontend/src/pages/History.jsx): `Frontend/src/pages/History.jsx`
- [Student attendance](https://github.com/nguyleminhtu/facetrackapp/blob/main/Frontend/src/pages/StudentAttendance.jsx): `Frontend/src/pages/StudentAttendance.jsx`
- [Attendance context](https://github.com/nguyleminhtu/facetrackapp/blob/main/Frontend/src/context/AttendanceContext.jsx): `Frontend/src/context/AttendanceContext.jsx`
- [Course context](https://github.com/nguyleminhtu/facetrackapp/blob/main/Frontend/src/context/courseContext.jsx): `Frontend/src/context/courseContext.jsx`
- [User context](https://github.com/nguyleminhtu/facetrackapp/blob/main/Frontend/src/context/userContext.jsx): `Frontend/src/context/userContext.jsx`
- [History context](https://github.com/nguyleminhtu/facetrackapp/blob/main/Frontend/src/context/historyContext.jsx): `Frontend/src/context/historyContext.jsx`
- [API client](https://github.com/nguyleminhtu/facetrackapp/blob/main/Frontend/src/api/axios.js): `Frontend/src/api/axios.js`

### Backend API

- [FastAPI app](https://github.com/nguyleminhtu/facetrackapp/blob/main/Backend/app/main.py): `Backend/app/main.py`
- [Auth routes](https://github.com/nguyleminhtu/facetrackapp/blob/main/Backend/app/api/routers/auth.py): `Backend/app/api/routers/auth.py`
- [User routes](https://github.com/nguyleminhtu/facetrackapp/blob/main/Backend/app/api/routers/users.py): `Backend/app/api/routers/users.py`
- [Course routes](https://github.com/nguyleminhtu/facetrackapp/blob/main/Backend/app/api/routers/courses.py): `Backend/app/api/routers/courses.py`
- [Recognition routes](https://github.com/nguyleminhtu/facetrackapp/blob/main/Backend/app/api/routers/recognize.py): `Backend/app/api/routers/recognize.py`

### Attendance services

- [Enrollment service](https://github.com/nguyleminhtu/facetrackapp/blob/main/Backend/app/services/enrollment.py): `Backend/app/services/enrollment.py`
- [Attendance service](https://github.com/nguyleminhtu/facetrackapp/blob/main/Backend/app/services/attendance.py): `Backend/app/services/attendance.py`
- [Face recognition](https://github.com/nguyleminhtu/facetrackapp/blob/main/Backend/app/services/face_recognition.py): `Backend/app/services/face_recognition.py`
- [Report service](https://github.com/nguyleminhtu/facetrackapp/blob/main/Backend/app/services/report.py): `Backend/app/services/report.py`

### Persistence and identity

- [Auth service](https://github.com/nguyleminhtu/facetrackapp/blob/main/Backend/app/services/auth.py): `Backend/app/services/auth.py`
- [User service](https://github.com/nguyleminhtu/facetrackapp/blob/main/Backend/app/services/user.py): `Backend/app/services/user.py`
- [Database](https://github.com/nguyleminhtu/facetrackapp/blob/main/Backend/app/database.py): `Backend/app/database.py`

### Other components

- **Teacher**
- **Student**

## Connections

- Teacher → App routing: uses (evidence: `README.md`)
- Student → App routing: uses (evidence: `README.md`)
- App routing → Login: routes to (evidence: `Frontend/src/App.jsx`)
- App routing → Attendance page: routes to (evidence: `Frontend/src/App.jsx`)
- App routing → Management page: routes to (evidence: `Frontend/src/App.jsx`)
- App routing → Course page: routes to (evidence: `Frontend/src/App.jsx`)
- App routing → History page: routes to (evidence: `Frontend/src/App.jsx`)
- App routing → Student attendance: routes to (evidence: `Frontend/src/App.jsx`)
- Attendance page → Attendance context: uses (evidence: `Frontend/src/pages/Attendance.jsx`)
- Management page → User context: uses (evidence: `Frontend/src/pages/Management.jsx`)
- Management page → Course context: uses (evidence: `Frontend/src/pages/Management.jsx`)
- Course page → Course context: uses (evidence: `Frontend/src/pages/Course.jsx`)
- History page → History context: uses (evidence: `Frontend/src/pages/History.jsx`)
- Attendance context → API client: sends requests (evidence: `Frontend/src/context/AttendanceContext.jsx`)
- Course context → API client: sends requests (evidence: `Frontend/src/context/courseContext.jsx`)
- User context → API client: sends requests (evidence: `Frontend/src/context/userContext.jsx`)
- History context → API client: sends requests (evidence: `Frontend/src/context/historyContext.jsx`)
- API client → FastAPI app: calls API (evidence: `README.md`)
- FastAPI app → Auth routes: registers (evidence: `Backend/app/main.py`)
- FastAPI app → User routes: registers (evidence: `Backend/app/main.py`)
- FastAPI app → Course routes: registers (evidence: `Backend/app/main.py`)
- FastAPI app → Recognition routes: registers (evidence: `Backend/app/main.py`)
- Auth routes → Auth service: uses (evidence: `Backend/app/api/routers/auth.py`)
- Auth routes → User service: uses (evidence: `Backend/app/api/routers/auth.py`)
- User routes → User service: uses (evidence: `Backend/app/api/routers/users.py`)
- User routes → Enrollment service: uses (evidence: `Backend/app/api/routers/users.py`)
- Course routes → Enrollment service: uses (evidence: `Backend/app/api/routers/courses.py`)
- Course routes → Attendance service: uses (evidence: `Backend/app/api/routers/courses.py`)
- Course routes → Report service: uses (evidence: `Backend/app/api/routers/courses.py`)
- Recognition routes → Face recognition: uses (evidence: `Backend/app/api/routers/recognize.py`)
- Recognition routes → Attendance service: uses (evidence: `Backend/app/api/routers/recognize.py`)
- Auth service → Database
- Enrollment service → Database: reads and writes
- Attendance service → Database: reads and writes
- Report service → Database: reads
