How trungnamhai/ttcsn-main works
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: App.jsx Route and auth UI · server.js HTTP and socket server · api.js HTTP API client · ProctoringDashboard.jsx Proctor dashboard
Components 34
ExamGuard client
- Route and auth UI
examguard-fullstack-vscode/client/src/App.jsx - Student login
examguard-fullstack-vscode/client/src/pages/Auth/ExamLogin.jsx - Teacher login
examguard-fullstack-vscode/client/src/pages/Auth/TeacherLogin.jsx - Student dashboard
examguard-fullstack-vscode/client/src/pages/Student/Dashboard.jsx - Face verification
examguard-fullstack-vscode/client/src/pages/Student/FaceVerification.jsx - Exam room
examguard-fullstack-vscode/client/src/pages/Student/ExamRoom.jsx - Browser anti-cheat
examguard-fullstack-vscode/client/src/hooks/useAntiCheat.js - Client vision
examguard-fullstack-vscode/client/src/services/vision.js - Proctor dashboard
examguard-fullstack-vscode/client/src/pages/Teacher/ProctoringDashboard.jsx - Exam authoring
examguard-fullstack-vscode/client/src/components/ExamModal.jsx - Question authoring
examguard-fullstack-vscode/client/src/components/QuestionModal.jsx - Session administration
examguard-fullstack-vscode/client/src/components/SessionModal.jsx - HTTP API client
examguard-fullstack-vscode/client/src/services/api.js - Realtime client
examguard-fullstack-vscode/client/src/services/socket.js
Exam backend
- HTTP and socket server
examguard-fullstack-vscode/server/server.js - Authentication routes
examguard-fullstack-vscode/server/routes/auth.routes.js - Authentication
examguard-fullstack-vscode/server/controllers/auth.controller.js - Exam routes
examguard-fullstack-vscode/server/routes/exam.routes.js - Exam workflow
examguard-fullstack-vscode/server/controllers/exam.controller.js - Teacher routes
examguard-fullstack-vscode/server/routes/teacher.routes.js - Teacher operations
examguard-fullstack-vscode/server/controllers/teacher.controller.js - Proctoring routes
examguard-fullstack-vscode/server/routes/proctoring.routes.js - Proctoring operations
examguard-fullstack-vscode/server/controllers/proctoring.controller.js - Token and role guard
examguard-fullstack-vscode/server/middlewares/auth.middleware.js - Proctoring events
examguard-fullstack-vscode/server/sockets/proctoring.socket.js - Student presence
examguard-fullstack-vscode/server/services/student-presence.js - Exam data and fallback
examguard-fullstack-vscode/server/models/exam.model.js - MySQL connection
examguard-fullstack-vscode/server/config/db.js
Face analysis
- Face analysis API
examguard-fullstack-vscode/ai-service/app/api/routes.py - Frame analysis
examguard-fullstack-vscode/ai-service/app/services/face_service.py - Image utilities
examguard-fullstack-vscode/ai-service/app/utils/image_utils.py - AI configuration
examguard-fullstack-vscode/ai-service/app/core/config.py
Other components
- Student
- Teacher
Connections 48
- Student → Route and auth UI: uses
examguard-fullstack-vscode/client/src/App.jsx - Teacher → Route and auth UI: uses
examguard-fullstack-vscode/client/src/App.jsx - Route and auth UI → Student login: routes to
examguard-fullstack-vscode/client/src/App.jsx - Route and auth UI → Teacher login: routes to
examguard-fullstack-vscode/client/src/App.jsx - Route and auth UI → Student dashboard: routes to
examguard-fullstack-vscode/client/src/App.jsx - Route and auth UI → Face verification: routes to
examguard-fullstack-vscode/client/src/App.jsx - Route and auth UI → Exam room: routes to
examguard-fullstack-vscode/client/src/App.jsx - Route and auth UI → Proctor dashboard: routes to
examguard-fullstack-vscode/client/src/App.jsx - Student login → HTTP API client: requests
examguard-fullstack-vscode/client/src/pages/Auth/ExamLogin.jsx - Teacher login → HTTP API client: requests
examguard-fullstack-vscode/client/src/pages/Auth/TeacherLogin.jsx - Student dashboard → HTTP API client: requests
examguard-fullstack-vscode/client/src/pages/Student/Dashboard.jsx - Exam room → HTTP API client: requests
examguard-fullstack-vscode/client/src/pages/Student/ExamRoom.jsx - Exam room → Realtime client: uses events
examguard-fullstack-vscode/client/src/pages/Student/ExamRoom.jsx - Exam room → Browser anti-cheat: uses
examguard-fullstack-vscode/client/src/pages/Student/ExamRoom.jsx - Exam room → Client vision: uses
examguard-fullstack-vscode/client/src/pages/Student/ExamRoom.jsx - Face verification → HTTP API client: requests
examguard-fullstack-vscode/client/src/pages/Student/FaceVerification.jsx - Proctor dashboard → HTTP API client: requests
examguard-fullstack-vscode/client/src/pages/Teacher/ProctoringDashboard.jsx - Proctor dashboard → Realtime client: uses events
examguard-fullstack-vscode/client/src/pages/Teacher/ProctoringDashboard.jsx - Proctor dashboard → Exam authoring: renders
examguard-fullstack-vscode/client/src/pages/Teacher/ProctoringDashboard.jsx - Proctor dashboard → Question authoring: renders
examguard-fullstack-vscode/client/src/pages/Teacher/ProctoringDashboard.jsx - Proctor dashboard → Session administration: renders
examguard-fullstack-vscode/client/src/pages/Teacher/ProctoringDashboard.jsx - HTTP API client → HTTP and socket server: HTTP requests
examguard-fullstack-vscode/client/src/services/api.js - Realtime client → HTTP and socket server: socket connection
- HTTP and socket server → Authentication routes: mounts
examguard-fullstack-vscode/server/server.js - HTTP and socket server → Exam routes: mounts
examguard-fullstack-vscode/server/server.js - HTTP and socket server → Teacher routes: mounts
examguard-fullstack-vscode/server/server.js - HTTP and socket server → Proctoring routes: mounts
examguard-fullstack-vscode/server/server.js - HTTP and socket server → Proctoring events: registers
examguard-fullstack-vscode/server/server.js - Authentication routes → Authentication: routes to
examguard-fullstack-vscode/server/routes/auth.routes.js - Exam routes → Exam workflow: routes to
examguard-fullstack-vscode/server/routes/exam.routes.js - Teacher routes → Teacher operations: routes to
examguard-fullstack-vscode/server/routes/teacher.routes.js - Proctoring routes → Proctoring operations: routes to
examguard-fullstack-vscode/server/routes/proctoring.routes.js - Authentication routes → Token and role guard: guards
examguard-fullstack-vscode/server/routes/auth.routes.js - Exam routes → Token and role guard: guards
examguard-fullstack-vscode/server/routes/exam.routes.js - Teacher routes → Token and role guard: guards
examguard-fullstack-vscode/server/routes/teacher.routes.js - Proctoring routes → Token and role guard: guards
examguard-fullstack-vscode/server/routes/proctoring.routes.js - Authentication → Exam data and fallback: uses fallback
examguard-fullstack-vscode/server/controllers/auth.controller.js - Authentication → MySQL connection: queries
examguard-fullstack-vscode/server/controllers/auth.controller.js - Exam workflow → Exam data and fallback: reads and writes
examguard-fullstack-vscode/server/controllers/exam.controller.js - Teacher operations → Exam data and fallback: reads and writes
examguard-fullstack-vscode/server/controllers/teacher.controller.js - Teacher operations → Student presence: uses
examguard-fullstack-vscode/server/controllers/teacher.controller.js - Exam data and fallback → MySQL connection: connects
examguard-fullstack-vscode/server/models/exam.model.js - Proctoring events → Token and role guard: verifies tokens
examguard-fullstack-vscode/server/sockets/proctoring.socket.js - Proctoring events → Student presence: updates
examguard-fullstack-vscode/server/sockets/proctoring.socket.js - Face analysis API → Frame analysis: calls
examguard-fullstack-vscode/ai-service/app/api/routes.py - Frame analysis → Image utilities: uses
examguard-fullstack-vscode/ai-service/app/services/face_service.py - Frame analysis → AI configuration: reads
examguard-fullstack-vscode/ai-service/app/services/face_service.py - Client vision → Face analysis API: submits frames