# codewithvihar/drishtiai architecture

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

- Interactive diagram: https://gitdiagram.com/codewithvihar/drishtiai
- Repository: https://github.com/codewithvihar/drishtiai

## Overview

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: [`ai-service/main.py`](https://github.com/codewithvihar/drishtiai/blob/main/ai-service/main.py) (FastAPI Service), [`frontend/src/services/api.js`](https://github.com/codewithvihar/drishtiai/blob/main/frontend/src/services/api.js) (API Client), [`frontend/src/App.jsx`](https://github.com/codewithvihar/drishtiai/blob/main/frontend/src/App.jsx) (Web App), [`backend/src/config/postgres.js`](https://github.com/codewithvihar/drishtiai/blob/main/backend/src/config/postgres.js) (Postgres Config)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Exam Interfaces"]
  node_webapp["Web App<br/>[App.jsx]"]
  node_student_exam["Student Exams"]
  node_student_portal["Student Portal<br/>[StudentPortal.jsx]"]
  node_faculty_views["Faculty Views"]
  node_faculty_detail["Session Detail"]
  node_admin_views["Admin Console"]
  node_proctor_hooks["Proctoring Hooks<br/>[useAIProctoring.js]"]
  node_voice_hook["Voice Hook"]
  node_auth_context["Auth Context<br/>[AuthContext.jsx]"]
  node_api_client["API Client<br/>[api.js]"]
end

subgraph group_backend["Platform API"]
  node_express_api["Express API<br/>[app.js]"]
  node_exam_routes["Exam Routes<br/>[exam.routes.js]"]
  node_proctor_routes["Proctor Routes"]
  node_auth["Authentication<br/>[auth.service.js]"]
  node_auth_middleware["Auth Middleware<br/>[authenticate.js]"]
  node_admin_service["Admin Service<br/>[admin.service.js]"]
  node_proctor_service["Proctor Service"]
  node_ai_client["AI Client<br/>[ai.service.js]"]
  node_postgres_config["Postgres Config<br/>[postgres.js]"]
  node_mongo_config["Mongo Config<br/>[mongodb.js]"]
end

subgraph group_ai["AI Proctoring"]
  node_ai_service["FastAPI Service<br/>[main.py]"]
  node_analysis["Frame Analysis<br/>[analyze.py]"]
  node_ai_health["AI Health<br/>[health.py]"]
  node_face_detector["Face Detection<br/>[face_landmarker.py]"]
  node_gaze["Gaze Estimation<br/>[gaze_estimator.py]"]
  node_head_tracker["Head Pose Tracking"]
  node_observation_tracker["Observation Tracking"]
  node_object_detector["Object Detection<br/>[yolo_detector.py]"]
  node_voice_detector["Voice Activity<br/>[silero_vad.py]"]
end

subgraph group_storage["Data Stores"]
  node_postgres[("PostgreSQL")]
  node_mongodb[("MongoDB")]
end

node_student(("Student"))
node_faculty(("Faculty"))
node_admin(("Admin"))

node_student -->|"uses"| node_webapp
node_faculty -->|"uses"| node_webapp
node_admin -->|"uses"| node_webapp
node_webapp -->|"routes to"| node_student_portal
node_webapp -->|"routes to"| node_student_exam
node_webapp -->|"routes to"| node_faculty_views
node_webapp -->|"routes to"| node_admin_views
node_student_exam -.->|"requests"| node_api_client
node_student_portal -->|"requests"| node_api_client
node_faculty_views -->|"requests"| node_api_client
node_faculty_detail -->|"requests"| node_api_client
node_admin_views -->|"requests"| node_api_client
node_proctor_hooks -->|"sends frames"| node_api_client
node_voice_hook -->|"sends audio"| node_api_client
node_auth_context -->|"uses"| node_api_client
node_api_client -->|"HTTP requests"| node_express_api
node_express_api -.->|"mounts routes"| node_exam_routes
node_express_api -.->|"mounts routes"| node_proctor_routes
node_exam_routes -->|"authenticates"| node_auth_middleware
node_exam_routes -->|"queries"| node_postgres_config
node_proctor_routes -->|"dispatches"| node_proctor_service
node_proctor_routes -->|"requests analysis"| node_ai_client
node_proctor_routes -->|"authenticates"| node_auth_middleware
node_auth -->|"uses"| node_postgres_config
node_admin_service -->|"queries"| node_postgres_config
node_admin_service -->|"uses"| node_mongo_config
node_proctor_service -->|"uses"| node_postgres_config
node_proctor_service -->|"uses"| node_mongo_config
node_postgres_config -->|"connects"| node_postgres
node_mongo_config -->|"connects"| node_mongodb
node_ai_client -->|"HTTP analysis"| node_ai_service
node_ai_service -->|"mounts router"| node_analysis
node_ai_service -->|"mounts router"| node_ai_health
node_ai_service -->|"initializes"| node_face_detector
node_ai_service -->|"initializes"| node_object_detector
node_ai_service -->|"initializes"| node_voice_detector
node_ai_service -->|"initializes"| node_head_tracker
node_ai_service -->|"initializes"| node_observation_tracker
node_analysis -.->|"uses"| node_gaze

click node_webapp "https://github.com/codewithvihar/drishtiai/blob/main/frontend/src/App.jsx"
click node_student_exam "https://github.com/codewithvihar/drishtiai/blob/main/frontend/src/pages/Student/ExamInterfacePage.jsx"
click node_student_portal "https://github.com/codewithvihar/drishtiai/blob/main/frontend/src/pages/StudentPortal.jsx"
click node_faculty_views "https://github.com/codewithvihar/drishtiai/blob/main/frontend/src/pages/Faculty/ProctoringSessionsPage.jsx"
click node_faculty_detail "https://github.com/codewithvihar/drishtiai/blob/main/frontend/src/pages/Faculty/ProctoringSessionDetailPage.jsx"
click node_admin_views "https://github.com/codewithvihar/drishtiai/blob/main/frontend/src/pages/Admin/AdminProctoringSettingsPage.jsx"
click node_proctor_hooks "https://github.com/codewithvihar/drishtiai/blob/main/frontend/src/hooks/useAIProctoring.js"
click node_voice_hook "https://github.com/codewithvihar/drishtiai/blob/main/frontend/src/hooks/useVoiceProctoring.js"
click node_auth_context "https://github.com/codewithvihar/drishtiai/blob/main/frontend/src/context/AuthContext.jsx"
click node_api_client "https://github.com/codewithvihar/drishtiai/blob/main/frontend/src/services/api.js"
click node_express_api "https://github.com/codewithvihar/drishtiai/blob/main/backend/src/app.js"
click node_exam_routes "https://github.com/codewithvihar/drishtiai/blob/main/backend/src/routes/exam.routes.js"
click node_proctor_routes "https://github.com/codewithvihar/drishtiai/blob/main/backend/src/routes/proctoring.routes.js"
click node_auth "https://github.com/codewithvihar/drishtiai/blob/main/backend/src/services/auth.service.js"
click node_auth_middleware "https://github.com/codewithvihar/drishtiai/blob/main/backend/src/middleware/authenticate.js"
click node_admin_service "https://github.com/codewithvihar/drishtiai/blob/main/backend/src/services/admin.service.js"
click node_proctor_service "https://github.com/codewithvihar/drishtiai/blob/main/backend/src/services/proctoring.service.js"
click node_ai_client "https://github.com/codewithvihar/drishtiai/blob/main/backend/src/services/ai.service.js"
click node_postgres_config "https://github.com/codewithvihar/drishtiai/blob/main/backend/src/config/postgres.js"
click node_mongo_config "https://github.com/codewithvihar/drishtiai/blob/main/backend/src/config/mongodb.js"
click node_ai_service "https://github.com/codewithvihar/drishtiai/blob/main/ai-service/main.py"
click node_analysis "https://github.com/codewithvihar/drishtiai/blob/main/ai-service/app/api/analyze.py"
click node_ai_health "https://github.com/codewithvihar/drishtiai/blob/main/ai-service/app/api/health.py"
click node_face_detector "https://github.com/codewithvihar/drishtiai/blob/main/ai-service/app/detectors/face/face_landmarker.py"
click node_gaze "https://github.com/codewithvihar/drishtiai/blob/main/ai-service/app/detectors/gaze/gaze_estimator.py"
click node_head_tracker "https://github.com/codewithvihar/drishtiai/blob/main/ai-service/app/risk_engine/head_pose_tracker.py"
click node_observation_tracker "https://github.com/codewithvihar/drishtiai/blob/main/ai-service/app/risk_engine/observation_tracker.py"
click node_object_detector "https://github.com/codewithvihar/drishtiai/blob/main/ai-service/app/detectors/object/yolo_detector.py"
click node_voice_detector "https://github.com/codewithvihar/drishtiai/blob/main/ai-service/app/detectors/audio/silero_vad.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_webapp,node_student_exam,node_student_portal,node_faculty_views,node_faculty_detail,node_admin_views,node_proctor_hooks,node_voice_hook,node_auth_context,node_api_client toneBlue
class node_express_api,node_exam_routes,node_proctor_routes,node_auth,node_auth_middleware,node_admin_service,node_proctor_service,node_ai_client,node_postgres_config,node_mongo_config toneAmber
class node_ai_service,node_analysis,node_ai_health,node_face_detector,node_gaze,node_head_tracker,node_observation_tracker,node_object_detector,node_voice_detector toneMint
class node_postgres,node_mongodb toneRose
class node_student,node_faculty,node_admin toneIndigo
```

## Components

### Exam Interfaces

- [Web App](https://github.com/codewithvihar/drishtiai/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Student Exams](https://github.com/codewithvihar/drishtiai/blob/main/frontend/src/pages/Student/ExamInterfacePage.jsx): `frontend/src/pages/Student/ExamInterfacePage.jsx`
- [Student Portal](https://github.com/codewithvihar/drishtiai/blob/main/frontend/src/pages/StudentPortal.jsx): `frontend/src/pages/StudentPortal.jsx`
- [Faculty Views](https://github.com/codewithvihar/drishtiai/blob/main/frontend/src/pages/Faculty/ProctoringSessionsPage.jsx): `frontend/src/pages/Faculty/ProctoringSessionsPage.jsx`
- [Session Detail](https://github.com/codewithvihar/drishtiai/blob/main/frontend/src/pages/Faculty/ProctoringSessionDetailPage.jsx): `frontend/src/pages/Faculty/ProctoringSessionDetailPage.jsx`
- [Admin Console](https://github.com/codewithvihar/drishtiai/blob/main/frontend/src/pages/Admin/AdminProctoringSettingsPage.jsx): `frontend/src/pages/Admin/AdminProctoringSettingsPage.jsx`
- [Proctoring Hooks](https://github.com/codewithvihar/drishtiai/blob/main/frontend/src/hooks/useAIProctoring.js): `frontend/src/hooks/useAIProctoring.js`
- [Voice Hook](https://github.com/codewithvihar/drishtiai/blob/main/frontend/src/hooks/useVoiceProctoring.js): `frontend/src/hooks/useVoiceProctoring.js`
- [Auth Context](https://github.com/codewithvihar/drishtiai/blob/main/frontend/src/context/AuthContext.jsx): `frontend/src/context/AuthContext.jsx`
- [API Client](https://github.com/codewithvihar/drishtiai/blob/main/frontend/src/services/api.js): `frontend/src/services/api.js`

### Platform API

- [Express API](https://github.com/codewithvihar/drishtiai/blob/main/backend/src/app.js): `backend/src/app.js`
- [Exam Routes](https://github.com/codewithvihar/drishtiai/blob/main/backend/src/routes/exam.routes.js): `backend/src/routes/exam.routes.js`
- [Proctor Routes](https://github.com/codewithvihar/drishtiai/blob/main/backend/src/routes/proctoring.routes.js): `backend/src/routes/proctoring.routes.js`
- [Authentication](https://github.com/codewithvihar/drishtiai/blob/main/backend/src/services/auth.service.js): `backend/src/services/auth.service.js`
- [Auth Middleware](https://github.com/codewithvihar/drishtiai/blob/main/backend/src/middleware/authenticate.js): `backend/src/middleware/authenticate.js`
- [Admin Service](https://github.com/codewithvihar/drishtiai/blob/main/backend/src/services/admin.service.js): `backend/src/services/admin.service.js`
- [Proctor Service](https://github.com/codewithvihar/drishtiai/blob/main/backend/src/services/proctoring.service.js): `backend/src/services/proctoring.service.js`
- [AI Client](https://github.com/codewithvihar/drishtiai/blob/main/backend/src/services/ai.service.js): `backend/src/services/ai.service.js`
- [Postgres Config](https://github.com/codewithvihar/drishtiai/blob/main/backend/src/config/postgres.js): `backend/src/config/postgres.js`
- [Mongo Config](https://github.com/codewithvihar/drishtiai/blob/main/backend/src/config/mongodb.js): `backend/src/config/mongodb.js`

### AI Proctoring

- [FastAPI Service](https://github.com/codewithvihar/drishtiai/blob/main/ai-service/main.py): `ai-service/main.py`
- [Frame Analysis](https://github.com/codewithvihar/drishtiai/blob/main/ai-service/app/api/analyze.py): `ai-service/app/api/analyze.py`
- [AI Health](https://github.com/codewithvihar/drishtiai/blob/main/ai-service/app/api/health.py): `ai-service/app/api/health.py`
- [Face Detection](https://github.com/codewithvihar/drishtiai/blob/main/ai-service/app/detectors/face/face_landmarker.py): `ai-service/app/detectors/face/face_landmarker.py`
- [Gaze Estimation](https://github.com/codewithvihar/drishtiai/blob/main/ai-service/app/detectors/gaze/gaze_estimator.py): `ai-service/app/detectors/gaze/gaze_estimator.py`
- [Head Pose Tracking](https://github.com/codewithvihar/drishtiai/blob/main/ai-service/app/risk_engine/head_pose_tracker.py): `ai-service/app/risk_engine/head_pose_tracker.py`
- [Observation Tracking](https://github.com/codewithvihar/drishtiai/blob/main/ai-service/app/risk_engine/observation_tracker.py): `ai-service/app/risk_engine/observation_tracker.py`
- [Object Detection](https://github.com/codewithvihar/drishtiai/blob/main/ai-service/app/detectors/object/yolo_detector.py): `ai-service/app/detectors/object/yolo_detector.py`
- [Voice Activity](https://github.com/codewithvihar/drishtiai/blob/main/ai-service/app/detectors/audio/silero_vad.py): `ai-service/app/detectors/audio/silero_vad.py`

### Data Stores

- **PostgreSQL**
- **MongoDB**

### Other components

- **Student**
- **Faculty**
- **Admin**

## Connections

- Student → Web App: uses (evidence: `README.md`)
- Faculty → Web App: uses (evidence: `README.md`)
- Admin → Web App: uses (evidence: `README.md`)
- Web App → Student Portal: routes to (evidence: `frontend/src/App.jsx`)
- Web App → Student Exams: routes to (evidence: `frontend/src/App.jsx`)
- Web App → Faculty Views: routes to (evidence: `frontend/src/App.jsx`)
- Web App → Admin Console: routes to (evidence: `frontend/src/App.jsx`)
- Student Exams → API Client: requests
- Student Portal → API Client: requests (evidence: `frontend/src/pages/StudentPortal.jsx`)
- Faculty Views → API Client: requests (evidence: `frontend/src/pages/Faculty/ProctoringSessionsPage.jsx`)
- Session Detail → API Client: requests (evidence: `frontend/src/pages/Faculty/ProctoringSessionDetailPage.jsx`)
- Admin Console → API Client: requests (evidence: `frontend/src/pages/Admin/AdminProctoringSettingsPage.jsx`)
- Proctoring Hooks → API Client: sends frames (evidence: `frontend/src/hooks/useAIProctoring.js`)
- Voice Hook → API Client: sends audio (evidence: `frontend/src/hooks/useVoiceProctoring.js`)
- Auth Context → API Client: uses (evidence: `frontend/src/context/AuthContext.jsx`)
- API Client → Express API: HTTP requests (evidence: `README.md`)
- Express API → Exam Routes: mounts routes
- Express API → Proctor Routes: mounts routes
- Exam Routes → Auth Middleware: authenticates (evidence: `backend/src/routes/exam.routes.js`)
- Exam Routes → Postgres Config: queries (evidence: `backend/src/routes/exam.routes.js`)
- Proctor Routes → Proctor Service: dispatches (evidence: `backend/src/routes/proctoring.routes.js`)
- Proctor Routes → AI Client: requests analysis (evidence: `backend/src/routes/proctoring.routes.js`)
- Proctor Routes → Auth Middleware: authenticates (evidence: `backend/src/routes/proctoring.routes.js`)
- Authentication → Postgres Config: uses (evidence: `backend/src/services/auth.service.js`)
- Admin Service → Postgres Config: queries (evidence: `backend/src/services/admin.service.js`)
- Admin Service → Mongo Config: uses (evidence: `backend/src/services/admin.service.js`)
- Proctor Service → Postgres Config: uses (evidence: `backend/src/services/proctoring.service.js`)
- Proctor Service → Mongo Config: uses (evidence: `backend/src/services/proctoring.service.js`)
- Postgres Config → PostgreSQL: connects (evidence: `README.md`)
- Mongo Config → MongoDB: connects (evidence: `README.md`)
- AI Client → FastAPI Service: HTTP analysis (evidence: `README.md`)
- FastAPI Service → Frame Analysis: mounts router (evidence: `ai-service/main.py`)
- FastAPI Service → AI Health: mounts router (evidence: `ai-service/main.py`)
- FastAPI Service → Face Detection: initializes (evidence: `ai-service/main.py`)
- FastAPI Service → Object Detection: initializes (evidence: `ai-service/main.py`)
- FastAPI Service → Voice Activity: initializes (evidence: `ai-service/main.py`)
- FastAPI Service → Head Pose Tracking: initializes (evidence: `ai-service/main.py`)
- FastAPI Service → Observation Tracking: initializes (evidence: `ai-service/main.py`)
- Frame Analysis → Gaze Estimation: uses
