How sreekanthbathala/examageis works
ExamAegis takes students from authentication and exam-session creation into live webcam, microphone, and browser-event monitoring. The monitor orchestrates specialist detectors, while a temporal violation engine applies thresholds, records incidents, and captures high-severity screenshots. Students receive live feedback; instructors review sessions, timelines, integrity scores, and JSON exports. The graph follows documented routes and sampled calls; some browser-to-endpoint wiring and report UI details are supported only by the README, not inspected source excerpts.
Main entry points: routes_monitor.py WebSocket monitor · database.py SQL database · main.py FastAPI app · violation_engine.py Violation engine
Components 29
Browser clients
- Exam room
frontend/index.html - Webcam capture
frontend/js/webcam.js - Socket and audio
frontend/js/socket_client.js - Focus monitor
frontend/js/focus_monitor.js - Fullscreen monitor
frontend/js/fullscreen_monitor.js - Admin dashboard
frontend/admin_dashboard.html - Dashboard rendering
frontend/js/dashboard.js
API workflows
- FastAPI app
app/main.py - Authentication
app/api/routes_auth.py - Exam sessions
app/api/routes_exam.py
Live proctoring
- WebSocket monitor
app/api/routes_monitor.py - Face detection
app/core/face_detection.py - Eye gaze
app/core/eye_gaze.py - Blink detection
app/core/blink_detection.py - Head pose
app/core/head_pose.py - Mouth tracking
app/core/mouth_tracking.py - Object detection
app/core/object_detection.py - Audio detection
app/core/audio_detection.py - Violation engine
app/core/violation_engine.py - Frame utilities
app/utils/frame_utils.py - Threshold settings
app/config.py
Session and records
- SQL database
app/models/database.py - Student records
app/models/student.py - Exam sessions
app/models/exam_session.py - Violation logs
app/models/violation_log.py
Incident review
- Reports and exports
app/api/routes_report.py - Integrity scoring
app/core/integrity_score.py
Other components
- Student
- Instructor
Connections 40
- Student → Exam room: uses
README.md - Instructor → Admin dashboard: uses
README.md - Exam room → Webcam capture: captures video
README.md - Exam room → Socket and audio: streams media
README.md - Focus monitor → Socket and audio: reports events
- Fullscreen monitor → Socket and audio: reports events
- Socket and audio → WebSocket monitor: sends frames and audio
README.md - WebSocket monitor → Socket and audio: returns alerts
app/api/routes_monitor.py - Admin dashboard → Dashboard rendering: renders dashboard
README.md - Dashboard rendering → Reports and exports: requests reports
- FastAPI app → Authentication: registers routes
app/main.py - FastAPI app → Exam sessions: registers routes
app/main.py - FastAPI app → WebSocket monitor: registers routes
app/main.py - FastAPI app → Reports and exports: registers routes
app/main.py - FastAPI app → SQL database: initializes
app/main.py - Authentication → SQL database: queries and writes
app/api/routes_auth.py - Authentication → Student records: authenticates
app/api/routes_auth.py - Exam sessions → Authentication: checks identity
app/api/routes_exam.py - Exam sessions → Exam sessions: creates and updates
app/api/routes_exam.py - Exam sessions → Violation engine: clears session state
app/api/routes_exam.py - WebSocket monitor → SQL database: loads session
app/api/routes_monitor.py - WebSocket monitor → Frame utilities: decodes frames
app/api/routes_monitor.py - WebSocket monitor → Face detection: detects faces
app/api/routes_monitor.py - WebSocket monitor → Eye gaze: estimates gaze
app/api/routes_monitor.py - WebSocket monitor → Blink detection: measures blinks
app/api/routes_monitor.py - WebSocket monitor → Head pose: estimates pose
app/api/routes_monitor.py - WebSocket monitor → Mouth tracking: measures mouth
app/api/routes_monitor.py - WebSocket monitor → Object detection: detects objects
app/api/routes_monitor.py - WebSocket monitor → Audio detection: analyzes audio
app/api/routes_monitor.py - WebSocket monitor → Violation engine: processes detections
app/api/routes_monitor.py - Violation engine → Violation logs: records incidents
app/core/violation_engine.py - Violation engine → Frame utilities: saves screenshots
app/core/violation_engine.py - Violation engine → Threshold settings: reads thresholds
app/core/violation_engine.py - SQL database → Student records: registers schema
app/models/database.py - SQL database → Exam sessions: registers schema
app/models/database.py - SQL database → Violation logs: registers schema
app/models/database.py - Reports and exports → Authentication: checks identity
app/api/routes_report.py - Reports and exports → SQL database: queries records
app/api/routes_report.py - Reports and exports → Integrity scoring: calculates score
app/api/routes_report.py - Integrity scoring → Violation logs: scores incidents
app/core/integrity_score.py