# mp-team58/assessmate architecture

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

- Interactive diagram: https://gitdiagram.com/mp-team58/assessmate
- Repository: https://github.com/mp-team58/assessmate

## Overview

AssessMate is an assessment platform for hosts to create and manage exams, and candidates to join, complete, and review them. The frontend routes host and candidate workflows through a shared API client to a Spring backend. Backend services cover authentication, exam/question authoring, AI-assisted generation, coding evaluation, candidate submissions, proctoring, results, and analytics. The shown source supports several service-to-dependency links; other major capabilities are retained from the repository tree but their internal calls were not sampled, so those relationships are not asserted.

Main entry points: [`frontend/src/App.jsx`](https://github.com/mp-team58/assessmate/blob/main/frontend/src/App.jsx) (Role-based routes), [`frontend/src/services/apiClient.js`](https://github.com/mp-team58/assessmate/blob/main/frontend/src/services/apiClient.js) (HTTP API client), [`backend/src/main/java/com/assessmate/service/AIQuestionService.java`](https://github.com/mp-team58/assessmate/blob/main/backend/src/main/java/com/assessmate/service/AIQuestionService.java) (AI question generation), [`backend/src/main/java/com/assessmate/service/AuthService.java`](https://github.com/mp-team58/assessmate/blob/main/backend/src/main/java/com/assessmate/service/AuthService.java) (Authentication service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Web application"]
  node_app["Role-based routes<br/>[App.jsx]"]
  node_api["HTTP API client<br/>[apiClient.js]"]
  node_auth_ui["Sign-in and signup<br/>[Login.jsx]"]
  node_exam_ui["Host exam workflows<br/>[CreateExam.jsx]"]
  node_questions_ui["Question authoring UI<br/>[ExamQuestions.jsx]"]
  node_candidate_ui["Candidate exam room<br/>[ActiveExam.jsx]"]
end

subgraph group_identity["Identity and access"]
  node_auth["Authentication service<br/>[AuthService.java]"]
  node_security["JWT security"]
  node_users[("User persistence")]
end

subgraph group_authoring["Exam authoring"]
  node_exam_questions["Exam question endpoints"]
  node_ai_questions["AI question generation"]
  node_gemini["Gemini integration<br/>[GeminiService.java]"]
  node_file_processing["Source file processing"]
  node_exam_model["Exam and question model"]
  node_excel["Spreadsheet import<br/>[ExcelService.java]"]
end

subgraph group_assessment["Assessment runtime"]
  node_candidate_service["Candidate workflow"]
  node_enrollments[("Enrollment persistence")]
  node_coding["Coding assessments"]
  node_judge["Code execution<br/>[Judge0Service.java]"]
end

subgraph group_insights["Monitoring and results"]
  node_proctoring["Proctoring workflows"]
  node_results["Host results and analytics"]
  node_analytics["Analytics service"]
end

node_user(("Host or candidate"))
node_backend["Assessment API"]

node_user -->|"uses"| node_app
node_app -->|"routes to"| node_auth_ui
node_app -->|"routes to"| node_exam_ui
node_app -->|"routes to"| node_questions_ui
node_app -->|"routes to"| node_candidate_ui
node_auth_ui -.->|"requests via"| node_api
node_exam_ui -.->|"requests via"| node_api
node_questions_ui -.->|"requests via"| node_api
node_candidate_ui -.->|"requests via"| node_api
node_api -->|"sends HTTP"| node_backend
node_backend -.->|"dispatches to"| node_auth
node_auth -->|"reads and writes"| node_users
node_auth -->|"creates tokens"| node_security
node_backend -.->|"dispatches to"| node_exam_questions
node_exam_questions -->|"delegates to"| node_ai_questions
node_ai_questions -->|"generates with"| node_gemini
node_ai_questions -->|"extracts from"| node_file_processing
node_ai_questions -->|"persists questions"| node_exam_model
node_backend -.->|"dispatches to"| node_candidate_service
node_candidate_service -->|"reads and writes"| node_enrollments
node_backend -.->|"dispatches to"| node_coding
node_coding -->|"runs submissions"| node_judge
node_backend -.->|"dispatches to"| node_proctoring
node_backend -.->|"dispatches to"| node_results
node_backend -.->|"dispatches to"| node_analytics
node_backend -.->|"dispatches to"| node_excel

click node_app "https://github.com/mp-team58/assessmate/blob/main/frontend/src/App.jsx"
click node_api "https://github.com/mp-team58/assessmate/blob/main/frontend/src/services/apiClient.js"
click node_auth_ui "https://github.com/mp-team58/assessmate/blob/main/frontend/src/pages/Login.jsx"
click node_auth "https://github.com/mp-team58/assessmate/blob/main/backend/src/main/java/com/assessmate/service/AuthService.java"
click node_security "https://github.com/mp-team58/assessmate/tree/main/backend/src/main/java/com/assessmate/security"
click node_users "https://github.com/mp-team58/assessmate/blob/main/backend/src/main/java/com/assessmate/repository/UserRepository.java"
click node_exam_ui "https://github.com/mp-team58/assessmate/blob/main/frontend/src/pages/CreateExam.jsx"
click node_questions_ui "https://github.com/mp-team58/assessmate/blob/main/frontend/src/pages/ExamQuestions.jsx"
click node_exam_questions "https://github.com/mp-team58/assessmate/blob/main/backend/src/main/java/com/assessmate/controller/ExamQuestionController.java"
click node_ai_questions "https://github.com/mp-team58/assessmate/blob/main/backend/src/main/java/com/assessmate/service/AIQuestionService.java"
click node_gemini "https://github.com/mp-team58/assessmate/blob/main/backend/src/main/java/com/assessmate/service/GeminiService.java"
click node_file_processing "https://github.com/mp-team58/assessmate/blob/main/backend/src/main/java/com/assessmate/service/FileProcessingService.java"
click node_exam_model "https://github.com/mp-team58/assessmate/tree/main/backend/src/main/java/com/assessmate/entity"
click node_candidate_ui "https://github.com/mp-team58/assessmate/blob/main/frontend/src/pages/ActiveExam.jsx"
click node_candidate_service "https://github.com/mp-team58/assessmate/blob/main/backend/src/main/java/com/assessmate/service/CandidateService.java"
click node_enrollments "https://github.com/mp-team58/assessmate/blob/main/backend/src/main/java/com/assessmate/repository/ExamEnrollmentRepository.java"
click node_coding "https://github.com/mp-team58/assessmate/blob/main/backend/src/main/java/com/assessmate/service/CodingQuestionService.java"
click node_judge "https://github.com/mp-team58/assessmate/blob/main/backend/src/main/java/com/assessmate/service/Judge0Service.java"
click node_proctoring "https://github.com/mp-team58/assessmate/blob/main/backend/src/main/java/com/assessmate/service/ProctoringService.java"
click node_results "https://github.com/mp-team58/assessmate/blob/main/backend/src/main/java/com/assessmate/service/HostResultService.java"
click node_analytics "https://github.com/mp-team58/assessmate/blob/main/backend/src/main/java/com/assessmate/service/AnalyticsService.java"
click node_excel "https://github.com/mp-team58/assessmate/blob/main/backend/src/main/java/com/assessmate/service/ExcelService.java"

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_app,node_api,node_auth_ui,node_exam_ui,node_questions_ui,node_candidate_ui toneBlue
class node_auth,node_security,node_users toneAmber
class node_exam_questions,node_ai_questions,node_gemini,node_file_processing,node_exam_model,node_excel,node_backend toneMint
class node_candidate_service,node_enrollments,node_coding,node_judge toneRose
class node_proctoring,node_results,node_analytics,node_user toneIndigo
```

## Components

### Web application

- [Role-based routes](https://github.com/mp-team58/assessmate/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [HTTP API client](https://github.com/mp-team58/assessmate/blob/main/frontend/src/services/apiClient.js): `frontend/src/services/apiClient.js`
- [Sign-in and signup](https://github.com/mp-team58/assessmate/blob/main/frontend/src/pages/Login.jsx): `frontend/src/pages/Login.jsx`
- [Host exam workflows](https://github.com/mp-team58/assessmate/blob/main/frontend/src/pages/CreateExam.jsx): `frontend/src/pages/CreateExam.jsx`
- [Question authoring UI](https://github.com/mp-team58/assessmate/blob/main/frontend/src/pages/ExamQuestions.jsx): `frontend/src/pages/ExamQuestions.jsx`
- [Candidate exam room](https://github.com/mp-team58/assessmate/blob/main/frontend/src/pages/ActiveExam.jsx): `frontend/src/pages/ActiveExam.jsx`

### Identity and access

- [Authentication service](https://github.com/mp-team58/assessmate/blob/main/backend/src/main/java/com/assessmate/service/AuthService.java): `backend/src/main/java/com/assessmate/service/AuthService.java`
- [JWT security](https://github.com/mp-team58/assessmate/tree/main/backend/src/main/java/com/assessmate/security): `backend/src/main/java/com/assessmate/security`
- [User persistence](https://github.com/mp-team58/assessmate/blob/main/backend/src/main/java/com/assessmate/repository/UserRepository.java): `backend/src/main/java/com/assessmate/repository/UserRepository.java`

### Exam authoring

- [Exam question endpoints](https://github.com/mp-team58/assessmate/blob/main/backend/src/main/java/com/assessmate/controller/ExamQuestionController.java): `backend/src/main/java/com/assessmate/controller/ExamQuestionController.java`
- [AI question generation](https://github.com/mp-team58/assessmate/blob/main/backend/src/main/java/com/assessmate/service/AIQuestionService.java): `backend/src/main/java/com/assessmate/service/AIQuestionService.java`
- [Gemini integration](https://github.com/mp-team58/assessmate/blob/main/backend/src/main/java/com/assessmate/service/GeminiService.java): `backend/src/main/java/com/assessmate/service/GeminiService.java`
- [Source file processing](https://github.com/mp-team58/assessmate/blob/main/backend/src/main/java/com/assessmate/service/FileProcessingService.java): `backend/src/main/java/com/assessmate/service/FileProcessingService.java`
- [Exam and question model](https://github.com/mp-team58/assessmate/tree/main/backend/src/main/java/com/assessmate/entity): `backend/src/main/java/com/assessmate/entity`
- [Spreadsheet import](https://github.com/mp-team58/assessmate/blob/main/backend/src/main/java/com/assessmate/service/ExcelService.java): `backend/src/main/java/com/assessmate/service/ExcelService.java`

### Assessment runtime

- [Candidate workflow](https://github.com/mp-team58/assessmate/blob/main/backend/src/main/java/com/assessmate/service/CandidateService.java): `backend/src/main/java/com/assessmate/service/CandidateService.java`
- [Enrollment persistence](https://github.com/mp-team58/assessmate/blob/main/backend/src/main/java/com/assessmate/repository/ExamEnrollmentRepository.java): `backend/src/main/java/com/assessmate/repository/ExamEnrollmentRepository.java`
- [Coding assessments](https://github.com/mp-team58/assessmate/blob/main/backend/src/main/java/com/assessmate/service/CodingQuestionService.java): `backend/src/main/java/com/assessmate/service/CodingQuestionService.java`
- [Code execution](https://github.com/mp-team58/assessmate/blob/main/backend/src/main/java/com/assessmate/service/Judge0Service.java): `backend/src/main/java/com/assessmate/service/Judge0Service.java`

### Monitoring and results

- [Proctoring workflows](https://github.com/mp-team58/assessmate/blob/main/backend/src/main/java/com/assessmate/service/ProctoringService.java): `backend/src/main/java/com/assessmate/service/ProctoringService.java`
- [Host results and analytics](https://github.com/mp-team58/assessmate/blob/main/backend/src/main/java/com/assessmate/service/HostResultService.java): `backend/src/main/java/com/assessmate/service/HostResultService.java`
- [Analytics service](https://github.com/mp-team58/assessmate/blob/main/backend/src/main/java/com/assessmate/service/AnalyticsService.java): `backend/src/main/java/com/assessmate/service/AnalyticsService.java`

### Other components

- **Host or candidate**
- **Assessment API**

## Connections

- Host or candidate → Role-based routes: uses (evidence: `frontend/src/App.jsx`)
- Role-based routes → Sign-in and signup: routes to (evidence: `frontend/src/App.jsx`)
- Role-based routes → Host exam workflows: routes to (evidence: `frontend/src/App.jsx`)
- Role-based routes → Question authoring UI: routes to (evidence: `frontend/src/App.jsx`)
- Role-based routes → Candidate exam room: routes to (evidence: `frontend/src/App.jsx`)
- Sign-in and signup → HTTP API client: requests via
- Host exam workflows → HTTP API client: requests via
- Question authoring UI → HTTP API client: requests via
- Candidate exam room → HTTP API client: requests via
- HTTP API client → Assessment API: sends HTTP (evidence: `frontend/src/services/apiClient.js`)
- Assessment API → Authentication service: dispatches to
- Authentication service → User persistence: reads and writes (evidence: `backend/src/main/java/com/assessmate/service/AuthService.java`)
- Authentication service → JWT security: creates tokens (evidence: `backend/src/main/java/com/assessmate/service/AuthService.java`)
- Assessment API → Exam question endpoints: dispatches to
- Exam question endpoints → AI question generation: delegates to (evidence: `backend/src/main/java/com/assessmate/controller/ExamQuestionController.java`)
- AI question generation → Gemini integration: generates with (evidence: `backend/src/main/java/com/assessmate/service/AIQuestionService.java`)
- AI question generation → Source file processing: extracts from (evidence: `backend/src/main/java/com/assessmate/service/AIQuestionService.java`)
- AI question generation → Exam and question model: persists questions (evidence: `backend/src/main/java/com/assessmate/service/AIQuestionService.java`)
- Assessment API → Candidate workflow: dispatches to
- Candidate workflow → Enrollment persistence: reads and writes (evidence: `backend/src/main/java/com/assessmate/service/CandidateService.java`)
- Assessment API → Coding assessments: dispatches to
- Coding assessments → Code execution: runs submissions (evidence: `backend/src/main/java/com/assessmate/service/CodingQuestionService.java`)
- Assessment API → Proctoring workflows: dispatches to
- Assessment API → Host results and analytics: dispatches to
- Assessment API → Analytics service: dispatches to
- Assessment API → Spreadsheet import: dispatches to
