How codewithvihar/drishtiai works
Drishti AI is a remote-exam platform: students take exams while browser and AI observations support proctoring; faculty manage exams and review sessions, and admins oversee users, settings, and system activity. The React frontend sends requests to the Express backend, which owns business logic and forwards AI analysis to FastAPI. PostgreSQL stores relational exam data and MongoDB stores proctoring events. The graph combines documented architecture with shown imports and calls; several backend and detector internals were not sampled, so their detailed links are omitted.
Main entry points: main.py FastAPI Service · api.js API Client · App.jsx Web App · postgres.js Postgres Config
Components 34
Exam Interfaces
- Web App
frontend/src/App.jsx - Student Exams
frontend/src/pages/Student/ExamInterfacePage.jsx - Student Portal
frontend/src/pages/StudentPortal.jsx - Faculty Views
frontend/src/pages/Faculty/ProctoringSessionsPage.jsx - Session Detail
frontend/src/pages/Faculty/ProctoringSessionDetailPage.jsx - Admin Console
frontend/src/pages/Admin/AdminProctoringSettingsPage.jsx - Proctoring Hooks
frontend/src/hooks/useAIProctoring.js - Voice Hook
frontend/src/hooks/useVoiceProctoring.js - Auth Context
frontend/src/context/AuthContext.jsx - API Client
frontend/src/services/api.js
Platform API
- Express API
backend/src/app.js - Exam Routes
backend/src/routes/exam.routes.js - Proctor Routes
backend/src/routes/proctoring.routes.js - Authentication
backend/src/services/auth.service.js - Auth Middleware
backend/src/middleware/authenticate.js - Admin Service
backend/src/services/admin.service.js - Proctor Service
backend/src/services/proctoring.service.js - AI Client
backend/src/services/ai.service.js - Postgres Config
backend/src/config/postgres.js - Mongo Config
backend/src/config/mongodb.js
AI Proctoring
- FastAPI Service
ai-service/main.py - Frame Analysis
ai-service/app/api/analyze.py - AI Health
ai-service/app/api/health.py - Face Detection
ai-service/app/detectors/face/face_landmarker.py - Gaze Estimation
ai-service/app/detectors/gaze/gaze_estimator.py - Head Pose Tracking
ai-service/app/risk_engine/head_pose_tracker.py - Observation Tracking
ai-service/app/risk_engine/observation_tracker.py - Object Detection
ai-service/app/detectors/object/yolo_detector.py - Voice Activity
ai-service/app/detectors/audio/silero_vad.py
Data Stores
- PostgreSQL
- MongoDB
Other components
- Student
- Faculty
- Admin
Connections 39
- Student → Web App: uses
README.md - Faculty → Web App: uses
README.md - Admin → Web App: uses
README.md - Web App → Student Portal: routes to
frontend/src/App.jsx - Web App → Student Exams: routes to
frontend/src/App.jsx - Web App → Faculty Views: routes to
frontend/src/App.jsx - Web App → Admin Console: routes to
frontend/src/App.jsx - Student Exams → API Client: requests
- Student Portal → API Client: requests
frontend/src/pages/StudentPortal.jsx - Faculty Views → API Client: requests
frontend/src/pages/Faculty/ProctoringSessionsPage.jsx - Session Detail → API Client: requests
frontend/src/pages/Faculty/ProctoringSessionDetailPage.jsx - Admin Console → API Client: requests
frontend/src/pages/Admin/AdminProctoringSettingsPage.jsx - Proctoring Hooks → API Client: sends frames
frontend/src/hooks/useAIProctoring.js - Voice Hook → API Client: sends audio
frontend/src/hooks/useVoiceProctoring.js - Auth Context → API Client: uses
frontend/src/context/AuthContext.jsx - API Client → Express API: HTTP requests
README.md - Express API → Exam Routes: mounts routes
- Express API → Proctor Routes: mounts routes
- Exam Routes → Auth Middleware: authenticates
backend/src/routes/exam.routes.js - Exam Routes → Postgres Config: queries
backend/src/routes/exam.routes.js - Proctor Routes → Proctor Service: dispatches
backend/src/routes/proctoring.routes.js - Proctor Routes → AI Client: requests analysis
backend/src/routes/proctoring.routes.js - Proctor Routes → Auth Middleware: authenticates
backend/src/routes/proctoring.routes.js - Authentication → Postgres Config: uses
backend/src/services/auth.service.js - Admin Service → Postgres Config: queries
backend/src/services/admin.service.js - Admin Service → Mongo Config: uses
backend/src/services/admin.service.js - Proctor Service → Postgres Config: uses
backend/src/services/proctoring.service.js - Proctor Service → Mongo Config: uses
backend/src/services/proctoring.service.js - Postgres Config → PostgreSQL: connects
README.md - Mongo Config → MongoDB: connects
README.md - AI Client → FastAPI Service: HTTP analysis
README.md - FastAPI Service → Frame Analysis: mounts router
ai-service/main.py - FastAPI Service → AI Health: mounts router
ai-service/main.py - FastAPI Service → Face Detection: initializes
ai-service/main.py - FastAPI Service → Object Detection: initializes
ai-service/main.py - FastAPI Service → Voice Activity: initializes
ai-service/main.py - FastAPI Service → Head Pose Tracking: initializes
ai-service/main.py - FastAPI Service → Observation Tracking: initializes
ai-service/main.py - Frame Analysis → Gaze Estimation: uses