# trungnamhai/ttcsn-main architecture

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

- Interactive diagram: https://gitdiagram.com/trungnamhai/ttcsn-main
- Repository: https://github.com/trungnamhai/ttcsn-main

## Overview

ExamGuard is an online exam and remote-proctoring system. Students authenticate to a scheduled session, complete face verification and check-in, take and submit an exam, while teachers manage exam content and sessions and monitor candidates, review check-ins, and respond to support or integrity events. The client routes user tasks through an Express API and live Socket.IO events; server controllers coordinate exam state and persistence. A separate FastAPI/OpenCV service analyzes face frames. Evidence is limited to the supplied excerpts and SOURCE INDEX; unsampled feature links are omitted where their wiring is not shown.

Main entry points: [`examguard-fullstack-vscode/client/src/App.jsx`](https://github.com/trungnamhai/ttcsn-main/blob/main/examguard-fullstack-vscode/client/src/App.jsx) (Route and auth UI), [`examguard-fullstack-vscode/server/server.js`](https://github.com/trungnamhai/ttcsn-main/blob/main/examguard-fullstack-vscode/server/server.js) (HTTP and socket server), [`examguard-fullstack-vscode/client/src/services/api.js`](https://github.com/trungnamhai/ttcsn-main/blob/main/examguard-fullstack-vscode/client/src/services/api.js) (HTTP API client), [`examguard-fullstack-vscode/client/src/pages/Teacher/ProctoringDashboard.jsx`](https://github.com/trungnamhai/ttcsn-main/blob/main/examguard-fullstack-vscode/client/src/pages/Teacher/ProctoringDashboard.jsx) (Proctor dashboard)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["ExamGuard client"]
  node_app["Route and auth UI<br/>[App.jsx]"]
  node_student_login["Student login<br/>[ExamLogin.jsx]"]
  node_teacher_login["Teacher login<br/>[TeacherLogin.jsx]"]
  node_student_dashboard["Student dashboard<br/>[Dashboard.jsx]"]
  node_face_ui["Face verification"]
  node_exam_room["Exam room<br/>[ExamRoom.jsx]"]
  node_anti_cheat["Browser anti-cheat<br/>[useAntiCheat.js]"]
  node_vision["Client vision<br/>[vision.js]"]
  node_teacher_dash["Proctor dashboard"]
  node_exam_authoring["Exam authoring<br/>[ExamModal.jsx]"]
  node_question_authoring["Question authoring<br/>[QuestionModal.jsx]"]
  node_session_admin["Session administration<br/>[SessionModal.jsx]"]
  node_api_client["HTTP API client<br/>[api.js]"]
  node_socket_client["Realtime client<br/>[socket.js]"]
end

subgraph group_server["Exam backend"]
  node_backend["HTTP and socket server<br/>[server.js]"]
  node_auth_routes["Authentication routes<br/>[auth.routes.js]"]
  node_auth_controller["Authentication<br/>[auth.controller.js]"]
  node_exam_routes["Exam routes<br/>[exam.routes.js]"]
  node_exam_controller["Exam workflow<br/>[exam.controller.js]"]
  node_teacher_routes["Teacher routes<br/>[teacher.routes.js]"]
  node_teacher_controller["Teacher operations"]
  node_proctor_routes["Proctoring routes"]
  node_proctor_controller["Proctoring operations"]
  node_auth_middleware["Token and role guard<br/>[auth.middleware.js]"]
  node_socket_server["Proctoring events"]
  node_presence["Student presence"]
  node_exam_model["Exam data and fallback<br/>[exam.model.js]"]
  node_db[("MySQL connection<br/>[db.js]")]
end

subgraph group_ai["Face analysis"]
  node_ai_routes["Face analysis API<br/>[routes.py]"]
  node_face_service["Frame analysis<br/>[face_service.py]"]
  node_image_utils["Image utilities<br/>[image_utils.py]"]
  node_ai_config["AI configuration<br/>[config.py]"]
end

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

node_student -->|"uses"| node_app
node_teacher -->|"uses"| node_app
node_app -->|"routes to"| node_student_login
node_app -->|"routes to"| node_teacher_login
node_app -->|"routes to"| node_student_dashboard
node_app -->|"routes to"| node_face_ui
node_app -->|"routes to"| node_exam_room
node_app -->|"routes to"| node_teacher_dash
node_student_login -->|"requests"| node_api_client
node_teacher_login -->|"requests"| node_api_client
node_student_dashboard -->|"requests"| node_api_client
node_exam_room -->|"requests"| node_api_client
node_exam_room -->|"uses events"| node_socket_client
node_exam_room -->|"uses"| node_anti_cheat
node_exam_room -->|"uses"| node_vision
node_face_ui -->|"requests"| node_api_client
node_teacher_dash -->|"requests"| node_api_client
node_teacher_dash -->|"uses events"| node_socket_client
node_teacher_dash -->|"renders"| node_exam_authoring
node_teacher_dash -->|"renders"| node_question_authoring
node_teacher_dash -->|"renders"| node_session_admin
node_api_client -->|"HTTP requests"| node_backend
node_socket_client -->|"socket connection"| node_backend
node_backend -->|"mounts"| node_auth_routes
node_backend -->|"mounts"| node_exam_routes
node_backend -->|"mounts"| node_teacher_routes
node_backend -->|"mounts"| node_proctor_routes
node_backend -->|"registers"| node_socket_server
node_auth_routes -->|"routes to"| node_auth_controller
node_exam_routes -->|"routes to"| node_exam_controller
node_teacher_routes -->|"routes to"| node_teacher_controller
node_proctor_routes -->|"routes to"| node_proctor_controller
node_auth_routes -->|"guards"| node_auth_middleware
node_exam_routes -->|"guards"| node_auth_middleware
node_teacher_routes -->|"guards"| node_auth_middleware
node_proctor_routes -->|"guards"| node_auth_middleware
node_auth_controller -->|"uses fallback"| node_exam_model
node_auth_controller -->|"queries"| node_db
node_exam_controller -->|"reads and writes"| node_exam_model
node_teacher_controller -->|"reads and writes"| node_exam_model
node_teacher_controller -->|"uses"| node_presence
node_exam_model -->|"connects"| node_db
node_socket_server -->|"verifies tokens"| node_auth_middleware
node_socket_server -->|"updates"| node_presence
node_ai_routes -->|"calls"| node_face_service
node_face_service -->|"uses"| node_image_utils
node_face_service -->|"reads"| node_ai_config
node_vision -.->|"submits frames"| node_ai_routes

click node_app "https://github.com/trungnamhai/ttcsn-main/blob/main/examguard-fullstack-vscode/client/src/App.jsx"
click node_student_login "https://github.com/trungnamhai/ttcsn-main/blob/main/examguard-fullstack-vscode/client/src/pages/Auth/ExamLogin.jsx"
click node_teacher_login "https://github.com/trungnamhai/ttcsn-main/blob/main/examguard-fullstack-vscode/client/src/pages/Auth/TeacherLogin.jsx"
click node_student_dashboard "https://github.com/trungnamhai/ttcsn-main/blob/main/examguard-fullstack-vscode/client/src/pages/Student/Dashboard.jsx"
click node_face_ui "https://github.com/trungnamhai/ttcsn-main/blob/main/examguard-fullstack-vscode/client/src/pages/Student/FaceVerification.jsx"
click node_exam_room "https://github.com/trungnamhai/ttcsn-main/blob/main/examguard-fullstack-vscode/client/src/pages/Student/ExamRoom.jsx"
click node_anti_cheat "https://github.com/trungnamhai/ttcsn-main/blob/main/examguard-fullstack-vscode/client/src/hooks/useAntiCheat.js"
click node_vision "https://github.com/trungnamhai/ttcsn-main/blob/main/examguard-fullstack-vscode/client/src/services/vision.js"
click node_teacher_dash "https://github.com/trungnamhai/ttcsn-main/blob/main/examguard-fullstack-vscode/client/src/pages/Teacher/ProctoringDashboard.jsx"
click node_exam_authoring "https://github.com/trungnamhai/ttcsn-main/blob/main/examguard-fullstack-vscode/client/src/components/ExamModal.jsx"
click node_question_authoring "https://github.com/trungnamhai/ttcsn-main/blob/main/examguard-fullstack-vscode/client/src/components/QuestionModal.jsx"
click node_session_admin "https://github.com/trungnamhai/ttcsn-main/blob/main/examguard-fullstack-vscode/client/src/components/SessionModal.jsx"
click node_api_client "https://github.com/trungnamhai/ttcsn-main/blob/main/examguard-fullstack-vscode/client/src/services/api.js"
click node_socket_client "https://github.com/trungnamhai/ttcsn-main/blob/main/examguard-fullstack-vscode/client/src/services/socket.js"
click node_backend "https://github.com/trungnamhai/ttcsn-main/blob/main/examguard-fullstack-vscode/server/server.js"
click node_auth_routes "https://github.com/trungnamhai/ttcsn-main/blob/main/examguard-fullstack-vscode/server/routes/auth.routes.js"
click node_auth_controller "https://github.com/trungnamhai/ttcsn-main/blob/main/examguard-fullstack-vscode/server/controllers/auth.controller.js"
click node_exam_routes "https://github.com/trungnamhai/ttcsn-main/blob/main/examguard-fullstack-vscode/server/routes/exam.routes.js"
click node_exam_controller "https://github.com/trungnamhai/ttcsn-main/blob/main/examguard-fullstack-vscode/server/controllers/exam.controller.js"
click node_teacher_routes "https://github.com/trungnamhai/ttcsn-main/blob/main/examguard-fullstack-vscode/server/routes/teacher.routes.js"
click node_teacher_controller "https://github.com/trungnamhai/ttcsn-main/blob/main/examguard-fullstack-vscode/server/controllers/teacher.controller.js"
click node_proctor_routes "https://github.com/trungnamhai/ttcsn-main/blob/main/examguard-fullstack-vscode/server/routes/proctoring.routes.js"
click node_proctor_controller "https://github.com/trungnamhai/ttcsn-main/blob/main/examguard-fullstack-vscode/server/controllers/proctoring.controller.js"
click node_auth_middleware "https://github.com/trungnamhai/ttcsn-main/blob/main/examguard-fullstack-vscode/server/middlewares/auth.middleware.js"
click node_socket_server "https://github.com/trungnamhai/ttcsn-main/blob/main/examguard-fullstack-vscode/server/sockets/proctoring.socket.js"
click node_presence "https://github.com/trungnamhai/ttcsn-main/blob/main/examguard-fullstack-vscode/server/services/student-presence.js"
click node_exam_model "https://github.com/trungnamhai/ttcsn-main/blob/main/examguard-fullstack-vscode/server/models/exam.model.js"
click node_db "https://github.com/trungnamhai/ttcsn-main/blob/main/examguard-fullstack-vscode/server/config/db.js"
click node_ai_routes "https://github.com/trungnamhai/ttcsn-main/blob/main/examguard-fullstack-vscode/ai-service/app/api/routes.py"
click node_face_service "https://github.com/trungnamhai/ttcsn-main/blob/main/examguard-fullstack-vscode/ai-service/app/services/face_service.py"
click node_image_utils "https://github.com/trungnamhai/ttcsn-main/blob/main/examguard-fullstack-vscode/ai-service/app/utils/image_utils.py"
click node_ai_config "https://github.com/trungnamhai/ttcsn-main/blob/main/examguard-fullstack-vscode/ai-service/app/core/config.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_student_login,node_teacher_login,node_student_dashboard,node_face_ui,node_exam_room,node_anti_cheat,node_vision,node_teacher_dash,node_exam_authoring,node_question_authoring,node_session_admin,node_api_client,node_socket_client toneBlue
class node_backend,node_auth_routes,node_auth_controller,node_exam_routes,node_exam_controller,node_teacher_routes,node_teacher_controller,node_proctor_routes,node_proctor_controller,node_auth_middleware,node_socket_server,node_presence,node_exam_model,node_db toneAmber
class node_ai_routes,node_face_service,node_image_utils,node_ai_config toneMint
class node_student,node_teacher toneIndigo
```

## Components

### ExamGuard client

- [Route and auth UI](https://github.com/trungnamhai/ttcsn-main/blob/main/examguard-fullstack-vscode/client/src/App.jsx): `examguard-fullstack-vscode/client/src/App.jsx`
- [Student login](https://github.com/trungnamhai/ttcsn-main/blob/main/examguard-fullstack-vscode/client/src/pages/Auth/ExamLogin.jsx): `examguard-fullstack-vscode/client/src/pages/Auth/ExamLogin.jsx`
- [Teacher login](https://github.com/trungnamhai/ttcsn-main/blob/main/examguard-fullstack-vscode/client/src/pages/Auth/TeacherLogin.jsx): `examguard-fullstack-vscode/client/src/pages/Auth/TeacherLogin.jsx`
- [Student dashboard](https://github.com/trungnamhai/ttcsn-main/blob/main/examguard-fullstack-vscode/client/src/pages/Student/Dashboard.jsx): `examguard-fullstack-vscode/client/src/pages/Student/Dashboard.jsx`
- [Face verification](https://github.com/trungnamhai/ttcsn-main/blob/main/examguard-fullstack-vscode/client/src/pages/Student/FaceVerification.jsx): `examguard-fullstack-vscode/client/src/pages/Student/FaceVerification.jsx`
- [Exam room](https://github.com/trungnamhai/ttcsn-main/blob/main/examguard-fullstack-vscode/client/src/pages/Student/ExamRoom.jsx): `examguard-fullstack-vscode/client/src/pages/Student/ExamRoom.jsx`
- [Browser anti-cheat](https://github.com/trungnamhai/ttcsn-main/blob/main/examguard-fullstack-vscode/client/src/hooks/useAntiCheat.js): `examguard-fullstack-vscode/client/src/hooks/useAntiCheat.js`
- [Client vision](https://github.com/trungnamhai/ttcsn-main/blob/main/examguard-fullstack-vscode/client/src/services/vision.js): `examguard-fullstack-vscode/client/src/services/vision.js`
- [Proctor dashboard](https://github.com/trungnamhai/ttcsn-main/blob/main/examguard-fullstack-vscode/client/src/pages/Teacher/ProctoringDashboard.jsx): `examguard-fullstack-vscode/client/src/pages/Teacher/ProctoringDashboard.jsx`
- [Exam authoring](https://github.com/trungnamhai/ttcsn-main/blob/main/examguard-fullstack-vscode/client/src/components/ExamModal.jsx): `examguard-fullstack-vscode/client/src/components/ExamModal.jsx`
- [Question authoring](https://github.com/trungnamhai/ttcsn-main/blob/main/examguard-fullstack-vscode/client/src/components/QuestionModal.jsx): `examguard-fullstack-vscode/client/src/components/QuestionModal.jsx`
- [Session administration](https://github.com/trungnamhai/ttcsn-main/blob/main/examguard-fullstack-vscode/client/src/components/SessionModal.jsx): `examguard-fullstack-vscode/client/src/components/SessionModal.jsx`
- [HTTP API client](https://github.com/trungnamhai/ttcsn-main/blob/main/examguard-fullstack-vscode/client/src/services/api.js): `examguard-fullstack-vscode/client/src/services/api.js`
- [Realtime client](https://github.com/trungnamhai/ttcsn-main/blob/main/examguard-fullstack-vscode/client/src/services/socket.js): `examguard-fullstack-vscode/client/src/services/socket.js`

### Exam backend

- [HTTP and socket server](https://github.com/trungnamhai/ttcsn-main/blob/main/examguard-fullstack-vscode/server/server.js): `examguard-fullstack-vscode/server/server.js`
- [Authentication routes](https://github.com/trungnamhai/ttcsn-main/blob/main/examguard-fullstack-vscode/server/routes/auth.routes.js): `examguard-fullstack-vscode/server/routes/auth.routes.js`
- [Authentication](https://github.com/trungnamhai/ttcsn-main/blob/main/examguard-fullstack-vscode/server/controllers/auth.controller.js): `examguard-fullstack-vscode/server/controllers/auth.controller.js`
- [Exam routes](https://github.com/trungnamhai/ttcsn-main/blob/main/examguard-fullstack-vscode/server/routes/exam.routes.js): `examguard-fullstack-vscode/server/routes/exam.routes.js`
- [Exam workflow](https://github.com/trungnamhai/ttcsn-main/blob/main/examguard-fullstack-vscode/server/controllers/exam.controller.js): `examguard-fullstack-vscode/server/controllers/exam.controller.js`
- [Teacher routes](https://github.com/trungnamhai/ttcsn-main/blob/main/examguard-fullstack-vscode/server/routes/teacher.routes.js): `examguard-fullstack-vscode/server/routes/teacher.routes.js`
- [Teacher operations](https://github.com/trungnamhai/ttcsn-main/blob/main/examguard-fullstack-vscode/server/controllers/teacher.controller.js): `examguard-fullstack-vscode/server/controllers/teacher.controller.js`
- [Proctoring routes](https://github.com/trungnamhai/ttcsn-main/blob/main/examguard-fullstack-vscode/server/routes/proctoring.routes.js): `examguard-fullstack-vscode/server/routes/proctoring.routes.js`
- [Proctoring operations](https://github.com/trungnamhai/ttcsn-main/blob/main/examguard-fullstack-vscode/server/controllers/proctoring.controller.js): `examguard-fullstack-vscode/server/controllers/proctoring.controller.js`
- [Token and role guard](https://github.com/trungnamhai/ttcsn-main/blob/main/examguard-fullstack-vscode/server/middlewares/auth.middleware.js): `examguard-fullstack-vscode/server/middlewares/auth.middleware.js`
- [Proctoring events](https://github.com/trungnamhai/ttcsn-main/blob/main/examguard-fullstack-vscode/server/sockets/proctoring.socket.js): `examguard-fullstack-vscode/server/sockets/proctoring.socket.js`
- [Student presence](https://github.com/trungnamhai/ttcsn-main/blob/main/examguard-fullstack-vscode/server/services/student-presence.js): `examguard-fullstack-vscode/server/services/student-presence.js`
- [Exam data and fallback](https://github.com/trungnamhai/ttcsn-main/blob/main/examguard-fullstack-vscode/server/models/exam.model.js): `examguard-fullstack-vscode/server/models/exam.model.js`
- [MySQL connection](https://github.com/trungnamhai/ttcsn-main/blob/main/examguard-fullstack-vscode/server/config/db.js): `examguard-fullstack-vscode/server/config/db.js`

### Face analysis

- [Face analysis API](https://github.com/trungnamhai/ttcsn-main/blob/main/examguard-fullstack-vscode/ai-service/app/api/routes.py): `examguard-fullstack-vscode/ai-service/app/api/routes.py`
- [Frame analysis](https://github.com/trungnamhai/ttcsn-main/blob/main/examguard-fullstack-vscode/ai-service/app/services/face_service.py): `examguard-fullstack-vscode/ai-service/app/services/face_service.py`
- [Image utilities](https://github.com/trungnamhai/ttcsn-main/blob/main/examguard-fullstack-vscode/ai-service/app/utils/image_utils.py): `examguard-fullstack-vscode/ai-service/app/utils/image_utils.py`
- [AI configuration](https://github.com/trungnamhai/ttcsn-main/blob/main/examguard-fullstack-vscode/ai-service/app/core/config.py): `examguard-fullstack-vscode/ai-service/app/core/config.py`

### Other components

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

## Connections

- Student → Route and auth UI: uses (evidence: `examguard-fullstack-vscode/client/src/App.jsx`)
- Teacher → Route and auth UI: uses (evidence: `examguard-fullstack-vscode/client/src/App.jsx`)
- Route and auth UI → Student login: routes to (evidence: `examguard-fullstack-vscode/client/src/App.jsx`)
- Route and auth UI → Teacher login: routes to (evidence: `examguard-fullstack-vscode/client/src/App.jsx`)
- Route and auth UI → Student dashboard: routes to (evidence: `examguard-fullstack-vscode/client/src/App.jsx`)
- Route and auth UI → Face verification: routes to (evidence: `examguard-fullstack-vscode/client/src/App.jsx`)
- Route and auth UI → Exam room: routes to (evidence: `examguard-fullstack-vscode/client/src/App.jsx`)
- Route and auth UI → Proctor dashboard: routes to (evidence: `examguard-fullstack-vscode/client/src/App.jsx`)
- Student login → HTTP API client: requests (evidence: `examguard-fullstack-vscode/client/src/pages/Auth/ExamLogin.jsx`)
- Teacher login → HTTP API client: requests (evidence: `examguard-fullstack-vscode/client/src/pages/Auth/TeacherLogin.jsx`)
- Student dashboard → HTTP API client: requests (evidence: `examguard-fullstack-vscode/client/src/pages/Student/Dashboard.jsx`)
- Exam room → HTTP API client: requests (evidence: `examguard-fullstack-vscode/client/src/pages/Student/ExamRoom.jsx`)
- Exam room → Realtime client: uses events (evidence: `examguard-fullstack-vscode/client/src/pages/Student/ExamRoom.jsx`)
- Exam room → Browser anti-cheat: uses (evidence: `examguard-fullstack-vscode/client/src/pages/Student/ExamRoom.jsx`)
- Exam room → Client vision: uses (evidence: `examguard-fullstack-vscode/client/src/pages/Student/ExamRoom.jsx`)
- Face verification → HTTP API client: requests (evidence: `examguard-fullstack-vscode/client/src/pages/Student/FaceVerification.jsx`)
- Proctor dashboard → HTTP API client: requests (evidence: `examguard-fullstack-vscode/client/src/pages/Teacher/ProctoringDashboard.jsx`)
- Proctor dashboard → Realtime client: uses events (evidence: `examguard-fullstack-vscode/client/src/pages/Teacher/ProctoringDashboard.jsx`)
- Proctor dashboard → Exam authoring: renders (evidence: `examguard-fullstack-vscode/client/src/pages/Teacher/ProctoringDashboard.jsx`)
- Proctor dashboard → Question authoring: renders (evidence: `examguard-fullstack-vscode/client/src/pages/Teacher/ProctoringDashboard.jsx`)
- Proctor dashboard → Session administration: renders (evidence: `examguard-fullstack-vscode/client/src/pages/Teacher/ProctoringDashboard.jsx`)
- HTTP API client → HTTP and socket server: HTTP requests (evidence: `examguard-fullstack-vscode/client/src/services/api.js`)
- Realtime client → HTTP and socket server: socket connection
- HTTP and socket server → Authentication routes: mounts (evidence: `examguard-fullstack-vscode/server/server.js`)
- HTTP and socket server → Exam routes: mounts (evidence: `examguard-fullstack-vscode/server/server.js`)
- HTTP and socket server → Teacher routes: mounts (evidence: `examguard-fullstack-vscode/server/server.js`)
- HTTP and socket server → Proctoring routes: mounts (evidence: `examguard-fullstack-vscode/server/server.js`)
- HTTP and socket server → Proctoring events: registers (evidence: `examguard-fullstack-vscode/server/server.js`)
- Authentication routes → Authentication: routes to (evidence: `examguard-fullstack-vscode/server/routes/auth.routes.js`)
- Exam routes → Exam workflow: routes to (evidence: `examguard-fullstack-vscode/server/routes/exam.routes.js`)
- Teacher routes → Teacher operations: routes to (evidence: `examguard-fullstack-vscode/server/routes/teacher.routes.js`)
- Proctoring routes → Proctoring operations: routes to (evidence: `examguard-fullstack-vscode/server/routes/proctoring.routes.js`)
- Authentication routes → Token and role guard: guards (evidence: `examguard-fullstack-vscode/server/routes/auth.routes.js`)
- Exam routes → Token and role guard: guards (evidence: `examguard-fullstack-vscode/server/routes/exam.routes.js`)
- Teacher routes → Token and role guard: guards (evidence: `examguard-fullstack-vscode/server/routes/teacher.routes.js`)
- Proctoring routes → Token and role guard: guards (evidence: `examguard-fullstack-vscode/server/routes/proctoring.routes.js`)
- Authentication → Exam data and fallback: uses fallback (evidence: `examguard-fullstack-vscode/server/controllers/auth.controller.js`)
- Authentication → MySQL connection: queries (evidence: `examguard-fullstack-vscode/server/controllers/auth.controller.js`)
- Exam workflow → Exam data and fallback: reads and writes (evidence: `examguard-fullstack-vscode/server/controllers/exam.controller.js`)
- Teacher operations → Exam data and fallback: reads and writes (evidence: `examguard-fullstack-vscode/server/controllers/teacher.controller.js`)
- Teacher operations → Student presence: uses (evidence: `examguard-fullstack-vscode/server/controllers/teacher.controller.js`)
- Exam data and fallback → MySQL connection: connects (evidence: `examguard-fullstack-vscode/server/models/exam.model.js`)
- Proctoring events → Token and role guard: verifies tokens (evidence: `examguard-fullstack-vscode/server/sockets/proctoring.socket.js`)
- Proctoring events → Student presence: updates (evidence: `examguard-fullstack-vscode/server/sockets/proctoring.socket.js`)
- Face analysis API → Frame analysis: calls (evidence: `examguard-fullstack-vscode/ai-service/app/api/routes.py`)
- Frame analysis → Image utilities: uses (evidence: `examguard-fullstack-vscode/ai-service/app/services/face_service.py`)
- Frame analysis → AI configuration: reads (evidence: `examguard-fullstack-vscode/ai-service/app/services/face_service.py`)
- Client vision → Face analysis API: submits frames
