How hasritha-r/aiproctor works
ProctorAI supports student exam-taking with AI-assisted grading and live proctoring, plus an administrator review and verdict workflow. Students register or log in, check their camera, choose an exam, take it under monitoring, and receive results; administrators inspect risk-ranked sessions, events, and snapshots before acting. The graph combines documented product capabilities with source-indexed backend calls and sampled frontend/AI wiring. Several routes, integrations, and storage interactions are not shown in excerpts, so those links are omitted or marked unverified.
Main entry points: App.jsx Web routes · main.py AI endpoints · ExamRoom.jsx Exam room · repository Exam and user records
Components 29
Student experience
- Web routes
frontend/src/App.jsx - Registration and login
frontend/src/pages - Camera check
frontend/src/pages/CameraSetup.jsx - Exam selection
frontend/src/pages/ExamList.jsx - Exam room
frontend/src/pages/ExamRoom.jsx - Browser monitoring
frontend/src/hooks/useProctoring.js - Results
frontend/src/pages/Result.jsx - Frontend API clients
frontend/src/api
Admin review
- Risk dashboard
frontend/src/pages/AdminDashboard.jsx - Session review
frontend/src/pages/StudentReview.jsx - Admin API client
frontend/src/api/adminApi.js - Admin routes
backend/src/main/java/com/proctai/controller/AdminController.java - Admin decisions
backend/src/main/java/com/proctai/service/AdminService.java
Exam backend
- Authentication routes
backend/src/main/java/com/proctai/controller/AuthController.java - Account and tokens
backend/src/main/java/com/proctai/service/AuthService.java - Exam routes
backend/src/main/java/com/proctai/controller/ExamController.java - Exam sessions
backend/src/main/java/com/proctai/service/ExamService.java - Scoring and submission
backend/src/main/java/com/proctai/service/ScoringService.java
Proctoring and AI
- Event and risk processing
backend/src/main/java/com/proctai/service/ProctoringService.java - WebSocket frame intake
backend/src/main/java/com/proctai/websocket/ProctoringWebSocketController.java - AI service client
backend/src/main/java/com/proctai/service/AiClientService.java - AI endpoints
ai-service/main.py - Face analysis
ai-service/models/face_analyzer.py - Question generation
ai-service/models/question_generator.py - Theory grading
ai-service/models/grader.py - Risk scoring
ai-service/models/anomaly_model.py
Domain storage
- Exam and user records
backend/src/main/java/com/proctai/repository
Other components
- Student
- Administrator
Connections 31
- Student → Registration and login: registers or logs in
- Registration and login → Camera check: continues to
- Camera check → Exam selection: continues to
- Exam selection → Exam room: starts exam
- Exam room → Results: submits answers
- Web routes → Registration and login: routes to
frontend/src/App.jsx - Web routes → Camera check: routes to
frontend/src/App.jsx - Web routes → Exam selection: routes to
frontend/src/App.jsx - Web routes → Exam room: routes to
frontend/src/App.jsx - Web routes → Results: routes to
frontend/src/App.jsx - Exam room → Browser monitoring: monitors session
- Browser monitoring → Frontend API clients: logs behavior
frontend/src/hooks/useProctoring.js - Administrator → Risk dashboard: reviews sessions
- Risk dashboard → Session review: opens review
- Session review → Admin API client: loads events and submits verdict
frontend/src/pages/StudentReview.jsx - Authentication routes → Account and tokens: delegates
backend/src/main/java/com/proctai/controller/AuthController.java - Account and tokens → Exam and user records: reads and saves users
backend/src/main/java/com/proctai/service/AuthService.java - Exam routes → Exam sessions: delegates exam actions
backend/src/main/java/com/proctai/controller/ExamController.java - Exam routes → Scoring and submission: submits answers
backend/src/main/java/com/proctai/controller/ExamController.java - Scoring and submission → Exam and user records: reads and saves results
backend/src/main/java/com/proctai/service/ScoringService.java - Scoring and submission → AI service client: grades theory
backend/src/main/java/com/proctai/service/ScoringService.java - Admin routes → Admin decisions: delegates
backend/src/main/java/com/proctai/controller/AdminController.java - Admin decisions → Exam and user records: reads and updates records
backend/src/main/java/com/proctai/service/AdminService.java - WebSocket frame intake → Event and risk processing: dispatches frames
backend/src/main/java/com/proctai/websocket/ProctoringWebSocketController.java - Event and risk processing → AI service client: analyzes frames and risk
backend/src/main/java/com/proctai/service/ProctoringService.java - Event and risk processing → Exam and user records: stores events and risk
backend/src/main/java/com/proctai/service/ProctoringService.java - AI endpoints → Face analysis: registers face route
ai-service/main.py - AI service client → AI endpoints: calls AI endpoints
- AI endpoints → Theory grading: grades theory
- AI endpoints → Question generation: generates questions
- AI endpoints → Risk scoring: computes anomalies