# hasritha-r/ai_proctoringexamportal architecture

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

- Interactive diagram: https://gitdiagram.com/hasritha-r/ai_proctoringexamportal
- Repository: https://github.com/hasritha-r/ai_proctoringexamportal

## Overview

Pariksha is a remote-exam platform with two visible application surfaces: a React administrator/student portal backed by Spring APIs, and a PHP portal with Python face-authentication and gaze-tracking components. The principal workflow is staff setup of courses, cohorts, semesters, exams and questions, followed by student exam access and proctoring. The excerpts show selected React routing and API hooks, Spring user/exam handling, and the PHP landing page; several feature areas are present in the tree but their runtime connections are not verified here.

Main entry points: [`frontend/examProctoringSystem/frontend/src/App.jsx`](https://github.com/hasritha-r/ai_proctoringexamportal/blob/main/frontend/examProctoringSystem/frontend/src/App.jsx) (Portal routing), [`backend/Easy-Proctr/student/js/proctoring.js`](https://github.com/hasritha-r/ai_proctoringexamportal/blob/main/backend/Easy-Proctr/student/js/proctoring.js) (Browser proctoring), [`frontend/examProctoringSystem/frontend/src/features/exams/CreateExam.jsx`](https://github.com/hasritha-r/ai_proctoringexamportal/blob/main/frontend/examProctoringSystem/frontend/src/features/exams/CreateExam.jsx) (Exam setup), [`frontend/examProctoringSystem/frontend/src/features/questions/CreateExamQuestion.jsx`](https://github.com/hasritha-r/ai_proctoringexamportal/blob/main/frontend/examProctoringSystem/frontend/src/features/questions/CreateExamQuestion.jsx) (Question authoring)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_portal["React Portal"]
  node_router["Portal routing<br/>[App.jsx]"]
  node_exam_page["Student exam page<br/>[ExamPage.jsx]"]
  node_live_proctor["Live proctor view<br/>[LiveProctor.jsx]"]
end

subgraph group_management["Exam Management"]
  node_batch_ui["Batch management<br/>[CourseBatches.jsx]"]
  node_course_ui["Course management<br/>[CoursesList.jsx]"]
  node_exam_ui["Exam setup<br/>[CreateExam.jsx]"]
  node_question_ui["Question authoring"]
  node_semester_api["Semester API client<br/>[apiSemesters.js]"]
  node_mcq_api["MCQ API client<br/>[apiMcqs.js]"]
end

subgraph group_spring["Spring Backend"]
  node_spring_users["User endpoints"]
  node_user_repo[("User repository")]
  node_exam_controller["Exam endpoints"]
  node_exam_service["Exam service<br/>[ExamService.java]"]
  node_exam_repo[("Exam repository")]
  node_exam_model["Exam record<br/>[Exam.java]"]
  node_alerts["Alert receiver"]
end

subgraph group_legacy["PHP Portal"]
  node_legacy_portal["PHP exam portal<br/>[index.php]"]
  node_legacy_db[("MySQL connection")]
  node_student_exam["PHP student exam<br/>[exam.php]"]
  node_proctor_js["Browser proctoring<br/>[proctoring.js]"]
end

subgraph group_ai["Proctoring AI"]
  node_face_auth["Face authentication<br/>[face_auth.py]"]
  node_face_init["Face setup<br/>[init_face_auth.py]"]
  node_gaze["Gaze tracking<br/>[gaze_tracking.py]"]
  node_ai_server["Proctoring server"]
end

node_staff(("Staff / student"))

node_staff -->|"uses portal"| node_router
node_router -->|"routes to"| node_exam_page
node_router -->|"routes to"| node_live_proctor
node_router -->|"routes to"| node_batch_ui
node_router -->|"routes to"| node_course_ui
node_router -->|"routes to"| node_exam_ui
node_router -->|"routes to"| node_question_ui
node_question_ui -->|"creates via"| node_mcq_api
node_exam_ui -.->|"loads semesters"| node_semester_api
node_exam_controller -->|"delegates to"| node_exam_service
node_exam_service -->|"reads and writes"| node_exam_repo
node_exam_repo -->|"stores records"| node_exam_model
node_spring_users -->|"authenticates users"| node_user_repo
node_staff -->|"opens portal"| node_legacy_portal
node_legacy_portal -->|"uses connection"| node_legacy_db
node_student_exam -.->|"loads proctoring"| node_proctor_js
node_face_init -->|"imports"| node_face_auth
node_proctor_js -.->|"sends signals"| node_ai_server
node_ai_server -.->|"uses tracking"| node_gaze
node_proctor_js -.->|"submits alerts"| node_alerts

click node_router "https://github.com/hasritha-r/ai_proctoringexamportal/blob/main/frontend/examProctoringSystem/frontend/src/App.jsx"
click node_exam_page "https://github.com/hasritha-r/ai_proctoringexamportal/blob/main/frontend/examProctoringSystem/frontend/src/pages/ExamPage.jsx"
click node_live_proctor "https://github.com/hasritha-r/ai_proctoringexamportal/blob/main/frontend/examProctoringSystem/frontend/src/pages/LiveProctor.jsx"
click node_batch_ui "https://github.com/hasritha-r/ai_proctoringexamportal/blob/main/frontend/examProctoringSystem/frontend/src/features/batches/CourseBatches.jsx"
click node_course_ui "https://github.com/hasritha-r/ai_proctoringexamportal/blob/main/frontend/examProctoringSystem/frontend/src/features/courses/CoursesList.jsx"
click node_exam_ui "https://github.com/hasritha-r/ai_proctoringexamportal/blob/main/frontend/examProctoringSystem/frontend/src/features/exams/CreateExam.jsx"
click node_question_ui "https://github.com/hasritha-r/ai_proctoringexamportal/blob/main/frontend/examProctoringSystem/frontend/src/features/questions/CreateExamQuestion.jsx"
click node_semester_api "https://github.com/hasritha-r/ai_proctoringexamportal/blob/main/frontend/examProctoringSystem/frontend/src/services/apiSemesters.js"
click node_mcq_api "https://github.com/hasritha-r/ai_proctoringexamportal/blob/main/frontend/examProctoringSystem/frontend/src/services/apiMcqs.js"
click node_spring_users "https://github.com/hasritha-r/ai_proctoringexamportal/blob/main/backend/backend/src/main/java/com/onlineProctoring/backend/controller/UserController.java"
click node_user_repo "https://github.com/hasritha-r/ai_proctoringexamportal/blob/main/backend/backend/src/main/java/com/onlineProctoring/backend/repository/UserRepository.java"
click node_exam_controller "https://github.com/hasritha-r/ai_proctoringexamportal/blob/main/backend/backend/src/main/java/com/onlineProctoring/backend/controller/ExamController.java"
click node_exam_service "https://github.com/hasritha-r/ai_proctoringexamportal/blob/main/backend/backend/src/main/java/com/onlineProctoring/backend/service/ExamService.java"
click node_exam_repo "https://github.com/hasritha-r/ai_proctoringexamportal/blob/main/backend/backend/src/main/java/com/onlineProctoring/backend/repository/ExamRepository.java"
click node_exam_model "https://github.com/hasritha-r/ai_proctoringexamportal/blob/main/backend/backend/src/main/java/com/onlineProctoring/backend/model/Exam.java"
click node_alerts "https://github.com/hasritha-r/ai_proctoringexamportal/blob/main/backend/backend/src/main/java/com/onlineProctoring/backend/controller/ProctoringController.java"
click node_legacy_portal "https://github.com/hasritha-r/ai_proctoringexamportal/blob/main/backend/Easy-Proctr/index.php"
click node_legacy_db "https://github.com/hasritha-r/ai_proctoringexamportal/blob/main/backend/Easy-Proctr/databaseconnect.php"
click node_student_exam "https://github.com/hasritha-r/ai_proctoringexamportal/blob/main/backend/Easy-Proctr/student/exam.php"
click node_proctor_js "https://github.com/hasritha-r/ai_proctoringexamportal/blob/main/backend/Easy-Proctr/student/js/proctoring.js"
click node_face_auth "https://github.com/hasritha-r/ai_proctoringexamportal/blob/main/backend/Easy-Proctr/dl_backend/face_auth.py"
click node_face_init "https://github.com/hasritha-r/ai_proctoringexamportal/blob/main/backend/Easy-Proctr/dl_backend/init_face_auth.py"
click node_gaze "https://github.com/hasritha-r/ai_proctoringexamportal/blob/main/backend/Easy-Proctr/dl_backend/gaze_tracking/gaze_tracking.py"
click node_ai_server "https://github.com/hasritha-r/ai_proctoringexamportal/blob/main/backend/Easy-Proctr/dl_backend/proctoring_server.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_router,node_exam_page,node_live_proctor toneBlue
class node_batch_ui,node_course_ui,node_exam_ui,node_question_ui,node_semester_api,node_mcq_api toneAmber
class node_spring_users,node_user_repo,node_exam_controller,node_exam_service,node_exam_repo,node_exam_model,node_alerts toneMint
class node_legacy_portal,node_legacy_db,node_student_exam,node_proctor_js toneRose
class node_face_auth,node_face_init,node_gaze,node_ai_server,node_staff toneIndigo
```

## Components

### React Portal

- [Portal routing](https://github.com/hasritha-r/ai_proctoringexamportal/blob/main/frontend/examProctoringSystem/frontend/src/App.jsx): `frontend/examProctoringSystem/frontend/src/App.jsx`
- [Student exam page](https://github.com/hasritha-r/ai_proctoringexamportal/blob/main/frontend/examProctoringSystem/frontend/src/pages/ExamPage.jsx): `frontend/examProctoringSystem/frontend/src/pages/ExamPage.jsx`
- [Live proctor view](https://github.com/hasritha-r/ai_proctoringexamportal/blob/main/frontend/examProctoringSystem/frontend/src/pages/LiveProctor.jsx): `frontend/examProctoringSystem/frontend/src/pages/LiveProctor.jsx`

### Exam Management

- [Batch management](https://github.com/hasritha-r/ai_proctoringexamportal/blob/main/frontend/examProctoringSystem/frontend/src/features/batches/CourseBatches.jsx): `frontend/examProctoringSystem/frontend/src/features/batches/CourseBatches.jsx`
- [Course management](https://github.com/hasritha-r/ai_proctoringexamportal/blob/main/frontend/examProctoringSystem/frontend/src/features/courses/CoursesList.jsx): `frontend/examProctoringSystem/frontend/src/features/courses/CoursesList.jsx`
- [Exam setup](https://github.com/hasritha-r/ai_proctoringexamportal/blob/main/frontend/examProctoringSystem/frontend/src/features/exams/CreateExam.jsx): `frontend/examProctoringSystem/frontend/src/features/exams/CreateExam.jsx`
- [Question authoring](https://github.com/hasritha-r/ai_proctoringexamportal/blob/main/frontend/examProctoringSystem/frontend/src/features/questions/CreateExamQuestion.jsx): `frontend/examProctoringSystem/frontend/src/features/questions/CreateExamQuestion.jsx`
- [Semester API client](https://github.com/hasritha-r/ai_proctoringexamportal/blob/main/frontend/examProctoringSystem/frontend/src/services/apiSemesters.js): `frontend/examProctoringSystem/frontend/src/services/apiSemesters.js`
- [MCQ API client](https://github.com/hasritha-r/ai_proctoringexamportal/blob/main/frontend/examProctoringSystem/frontend/src/services/apiMcqs.js): `frontend/examProctoringSystem/frontend/src/services/apiMcqs.js`

### Spring Backend

- [User endpoints](https://github.com/hasritha-r/ai_proctoringexamportal/blob/main/backend/backend/src/main/java/com/onlineProctoring/backend/controller/UserController.java): `backend/backend/src/main/java/com/onlineProctoring/backend/controller/UserController.java`
- [User repository](https://github.com/hasritha-r/ai_proctoringexamportal/blob/main/backend/backend/src/main/java/com/onlineProctoring/backend/repository/UserRepository.java): `backend/backend/src/main/java/com/onlineProctoring/backend/repository/UserRepository.java`
- [Exam endpoints](https://github.com/hasritha-r/ai_proctoringexamportal/blob/main/backend/backend/src/main/java/com/onlineProctoring/backend/controller/ExamController.java): `backend/backend/src/main/java/com/onlineProctoring/backend/controller/ExamController.java`
- [Exam service](https://github.com/hasritha-r/ai_proctoringexamportal/blob/main/backend/backend/src/main/java/com/onlineProctoring/backend/service/ExamService.java): `backend/backend/src/main/java/com/onlineProctoring/backend/service/ExamService.java`
- [Exam repository](https://github.com/hasritha-r/ai_proctoringexamportal/blob/main/backend/backend/src/main/java/com/onlineProctoring/backend/repository/ExamRepository.java): `backend/backend/src/main/java/com/onlineProctoring/backend/repository/ExamRepository.java`
- [Exam record](https://github.com/hasritha-r/ai_proctoringexamportal/blob/main/backend/backend/src/main/java/com/onlineProctoring/backend/model/Exam.java): `backend/backend/src/main/java/com/onlineProctoring/backend/model/Exam.java`
- [Alert receiver](https://github.com/hasritha-r/ai_proctoringexamportal/blob/main/backend/backend/src/main/java/com/onlineProctoring/backend/controller/ProctoringController.java): `backend/backend/src/main/java/com/onlineProctoring/backend/controller/ProctoringController.java`

### PHP Portal

- [PHP exam portal](https://github.com/hasritha-r/ai_proctoringexamportal/blob/main/backend/Easy-Proctr/index.php): `backend/Easy-Proctr/index.php`
- [MySQL connection](https://github.com/hasritha-r/ai_proctoringexamportal/blob/main/backend/Easy-Proctr/databaseconnect.php): `backend/Easy-Proctr/databaseconnect.php`
- [PHP student exam](https://github.com/hasritha-r/ai_proctoringexamportal/blob/main/backend/Easy-Proctr/student/exam.php): `backend/Easy-Proctr/student/exam.php`
- [Browser proctoring](https://github.com/hasritha-r/ai_proctoringexamportal/blob/main/backend/Easy-Proctr/student/js/proctoring.js): `backend/Easy-Proctr/student/js/proctoring.js`

### Proctoring AI

- [Face authentication](https://github.com/hasritha-r/ai_proctoringexamportal/blob/main/backend/Easy-Proctr/dl_backend/face_auth.py): `backend/Easy-Proctr/dl_backend/face_auth.py`
- [Face setup](https://github.com/hasritha-r/ai_proctoringexamportal/blob/main/backend/Easy-Proctr/dl_backend/init_face_auth.py): `backend/Easy-Proctr/dl_backend/init_face_auth.py`
- [Gaze tracking](https://github.com/hasritha-r/ai_proctoringexamportal/blob/main/backend/Easy-Proctr/dl_backend/gaze_tracking/gaze_tracking.py): `backend/Easy-Proctr/dl_backend/gaze_tracking/gaze_tracking.py`
- [Proctoring server](https://github.com/hasritha-r/ai_proctoringexamportal/blob/main/backend/Easy-Proctr/dl_backend/proctoring_server.py): `backend/Easy-Proctr/dl_backend/proctoring_server.py`

### Other components

- **Staff / student**

## Connections

- Staff / student → Portal routing: uses portal (evidence: `frontend/examProctoringSystem/frontend/src/App.jsx`)
- Portal routing → Student exam page: routes to (evidence: `frontend/examProctoringSystem/frontend/src/App.jsx`)
- Portal routing → Live proctor view: routes to (evidence: `frontend/examProctoringSystem/frontend/src/App.jsx`)
- Portal routing → Batch management: routes to (evidence: `frontend/examProctoringSystem/frontend/src/App.jsx`)
- Portal routing → Course management: routes to (evidence: `frontend/examProctoringSystem/frontend/src/App.jsx`)
- Portal routing → Exam setup: routes to (evidence: `frontend/examProctoringSystem/frontend/src/App.jsx`)
- Portal routing → Question authoring: routes to (evidence: `frontend/examProctoringSystem/frontend/src/App.jsx`)
- Question authoring → MCQ API client: creates via
- Exam setup → Semester API client: loads semesters
- Exam endpoints → Exam service: delegates to (evidence: `backend/backend/src/main/java/com/onlineProctoring/backend/controller/ExamController.java`)
- Exam service → Exam repository: reads and writes (evidence: `backend/backend/src/main/java/com/onlineProctoring/backend/service/ExamService.java`)
- Exam repository → Exam record: stores records (evidence: `backend/backend/src/main/java/com/onlineProctoring/backend/repository/ExamRepository.java`)
- User endpoints → User repository: authenticates users (evidence: `backend/backend/src/main/java/com/onlineProctoring/backend/controller/UserController.java`)
- Staff / student → PHP exam portal: opens portal (evidence: `backend/Easy-Proctr/index.php`)
- PHP exam portal → MySQL connection: uses connection (evidence: `backend/Easy-Proctr/index.php`)
- PHP student exam → Browser proctoring: loads proctoring
- Face setup → Face authentication: imports (evidence: `backend/Easy-Proctr/dl_backend/init_face_auth.py`)
- Browser proctoring → Proctoring server: sends signals
- Proctoring server → Gaze tracking: uses tracking
- Browser proctoring → Alert receiver: submits alerts
