# ameya050506/ten-major-project architecture

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

- Interactive diagram: https://gitdiagram.com/ameya050506/ten-major-project
- Repository: https://github.com/ameya050506/ten-major-project

## Overview

CodeJudge is an assessment platform with candidate and administrator experiences backed by a React client and Spring application. Candidates authenticate, browse assessments, follow instructions, attempt timed questions, submit answers, and view results or history; administrators manage tests and questions and review candidates, results, analytics, leaderboards, and exports. The client services use API requests with local-storage fallbacks. The sampled result service shows server-side scoring and persistence. Source excerpts establish selected routes and service interactions; many page and controller internals were not sampled, so uncertain links are omitted.

Main entry points: [`src/routes/AppRoutes.jsx`](https://github.com/ameya050506/ten-major-project/blob/main/src/routes/AppRoutes.jsx) (Application routes), [`src/services/testService.js`](https://github.com/ameya050506/ten-major-project/blob/main/src/services/testService.js) (Test service), [`src/services/questionService.js`](https://github.com/ameya050506/ten-major-project/blob/main/src/services/questionService.js) (Question service), [`src/services/resultService.js`](https://github.com/ameya050506/ten-major-project/blob/main/src/services/resultService.js) (Result service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Client shell"]
  node_routing["Application routes<br/>[AppRoutes.jsx]"]
  node_auth["Authentication state<br/>[AuthContext.jsx]"]
  node_authsvc["Authentication service<br/>[authService.js]"]
  node_assessmentstate["Assessment state"]
  node_testclient["Test service<br/>[testService.js]"]
  node_questionclient["Question service<br/>[questionService.js]"]
  node_localstore[("Local data store<br/>[apiClient.js]")]
  node_apimode["Data source mode<br/>[dataSource.js]"]
end

subgraph group_candidate["Candidate experience"]
  node_candidatepages["Candidate assessment pages"]
  node_assessmentui["Attempt interface"]
  node_resultclient["Result service<br/>[resultService.js]"]
  node_candidateextras["Candidate account and insights"]
end

subgraph group_admin["Admin console"]
  node_adminpages["Test and question management"]
  node_admindrawer["Test detail preview"]
  node_admininsights["Admin reporting and insights"]
end

subgraph group_backend["Assessment backend"]
  node_testcontroller["Test endpoints"]
  node_questioncontroller["Question endpoints"]
  node_resultcontroller["Result endpoints"]
  node_testservice["Test operations<br/>[TestService.java]"]
  node_questionservice["Question operations"]
  node_resultservice["Scoring and results<br/>[ResultService.java]"]
  node_repositories[("Persistence repositories")]
  node_domain["Assessment domain entities"]
end

node_user(("Candidate or admin"))
node_api{{"Assessment API"}}

node_user -->|"opens pages"| node_routing
node_routing -->|"routes candidate"| node_candidatepages
node_routing -->|"routes admin"| node_adminpages
node_auth -->|"delegates auth"| node_authsvc
node_assessmentstate -->|"uses results"| node_resultclient
node_candidatepages -.->|"presents attempt"| node_assessmentui
node_candidatepages -.->|"submits answers"| node_resultclient
node_routing -->|"routes insights"| node_candidateextras
node_routing -->|"routes reports"| node_admininsights
node_admindrawer -->|"loads test data"| node_testclient
node_admindrawer -->|"loads questions"| node_questionclient
node_adminpages -.->|"manages tests"| node_testclient
node_adminpages -.->|"manages questions"| node_questionclient
node_testclient -->|"requests tests"| node_api
node_questionclient -->|"requests questions"| node_api
node_resultclient -->|"submits and reads"| node_api
node_testclient -->|"falls back locally"| node_localstore
node_questionclient -->|"falls back locally"| node_localstore
node_resultclient -->|"stores fallback results"| node_localstore
node_testclient -->|"sets source mode"| node_apimode
node_questionclient -->|"sets source mode"| node_apimode
node_resultclient -->|"sets source mode"| node_apimode
node_api -.->|"routes test requests"| node_testcontroller
node_api -.->|"routes question requests"| node_questioncontroller
node_api -.->|"routes result requests"| node_resultcontroller
node_testcontroller -->|"delegates tests"| node_testservice
node_questioncontroller -->|"delegates questions"| node_questionservice
node_resultcontroller -->|"delegates results"| node_resultservice
node_testservice -->|"reads and writes"| node_repositories
node_questionservice -->|"uses repository"| node_repositories
node_resultservice -->|"loads and saves"| node_repositories
node_resultservice -->|"scores answers"| node_domain
node_testservice -->|"manages tests"| node_domain
node_questionservice -->|"manages questions"| node_domain

click node_routing "https://github.com/ameya050506/ten-major-project/blob/main/src/routes/AppRoutes.jsx"
click node_auth "https://github.com/ameya050506/ten-major-project/blob/main/src/context/AuthContext.jsx"
click node_authsvc "https://github.com/ameya050506/ten-major-project/blob/main/src/services/authService.js"
click node_assessmentstate "https://github.com/ameya050506/ten-major-project/blob/main/src/context/AssessmentContext.jsx"
click node_candidatepages "https://github.com/ameya050506/ten-major-project/tree/main/src/pages/candidate"
click node_assessmentui "https://github.com/ameya050506/ten-major-project/tree/main/src/components/assessment"
click node_resultclient "https://github.com/ameya050506/ten-major-project/blob/main/src/services/resultService.js"
click node_candidateextras "https://github.com/ameya050506/ten-major-project/tree/main/src/pages/candidate"
click node_adminpages "https://github.com/ameya050506/ten-major-project/tree/main/src/pages/admin"
click node_admindrawer "https://github.com/ameya050506/ten-major-project/blob/main/src/components/admin/TestDetailDrawer.jsx"
click node_admininsights "https://github.com/ameya050506/ten-major-project/tree/main/src/pages/admin"
click node_testclient "https://github.com/ameya050506/ten-major-project/blob/main/src/services/testService.js"
click node_questionclient "https://github.com/ameya050506/ten-major-project/blob/main/src/services/questionService.js"
click node_localstore "https://github.com/ameya050506/ten-major-project/blob/main/src/services/apiClient.js"
click node_apimode "https://github.com/ameya050506/ten-major-project/blob/main/src/services/dataSource.js"
click node_testcontroller "https://github.com/ameya050506/ten-major-project/blob/main/backend/src/main/java/com/ten/assessment/controller/TestController.java"
click node_questioncontroller "https://github.com/ameya050506/ten-major-project/blob/main/backend/src/main/java/com/ten/assessment/controller/QuestionController.java"
click node_resultcontroller "https://github.com/ameya050506/ten-major-project/blob/main/backend/src/main/java/com/ten/assessment/controller/ResultController.java"
click node_testservice "https://github.com/ameya050506/ten-major-project/blob/main/backend/src/main/java/com/ten/assessment/service/TestService.java"
click node_questionservice "https://github.com/ameya050506/ten-major-project/blob/main/backend/src/main/java/com/ten/assessment/service/QuestionService.java"
click node_resultservice "https://github.com/ameya050506/ten-major-project/blob/main/backend/src/main/java/com/ten/assessment/service/ResultService.java"
click node_repositories "https://github.com/ameya050506/ten-major-project/tree/main/backend/src/main/java/com/ten/assessment/repository"
click node_domain "https://github.com/ameya050506/ten-major-project/tree/main/backend/src/main/java/com/ten/assessment/entity"

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_routing,node_auth,node_authsvc,node_assessmentstate,node_testclient,node_questionclient,node_localstore,node_apimode toneBlue
class node_candidatepages,node_assessmentui,node_resultclient,node_candidateextras toneAmber
class node_adminpages,node_admindrawer,node_admininsights,node_api toneMint
class node_testcontroller,node_questioncontroller,node_resultcontroller,node_testservice,node_questionservice,node_resultservice,node_repositories,node_domain toneRose
class node_user toneIndigo
```

## Components

### Client shell

- [Application routes](https://github.com/ameya050506/ten-major-project/blob/main/src/routes/AppRoutes.jsx): `src/routes/AppRoutes.jsx`
- [Authentication state](https://github.com/ameya050506/ten-major-project/blob/main/src/context/AuthContext.jsx): `src/context/AuthContext.jsx`
- [Authentication service](https://github.com/ameya050506/ten-major-project/blob/main/src/services/authService.js): `src/services/authService.js`
- [Assessment state](https://github.com/ameya050506/ten-major-project/blob/main/src/context/AssessmentContext.jsx): `src/context/AssessmentContext.jsx`
- [Test service](https://github.com/ameya050506/ten-major-project/blob/main/src/services/testService.js): `src/services/testService.js`
- [Question service](https://github.com/ameya050506/ten-major-project/blob/main/src/services/questionService.js): `src/services/questionService.js`
- [Local data store](https://github.com/ameya050506/ten-major-project/blob/main/src/services/apiClient.js): `src/services/apiClient.js`
- [Data source mode](https://github.com/ameya050506/ten-major-project/blob/main/src/services/dataSource.js): `src/services/dataSource.js`

### Candidate experience

- [Candidate assessment pages](https://github.com/ameya050506/ten-major-project/tree/main/src/pages/candidate): `src/pages/candidate`
- [Attempt interface](https://github.com/ameya050506/ten-major-project/tree/main/src/components/assessment): `src/components/assessment`
- [Result service](https://github.com/ameya050506/ten-major-project/blob/main/src/services/resultService.js): `src/services/resultService.js`
- [Candidate account and insights](https://github.com/ameya050506/ten-major-project/tree/main/src/pages/candidate): `src/pages/candidate`

### Admin console

- [Test and question management](https://github.com/ameya050506/ten-major-project/tree/main/src/pages/admin): `src/pages/admin`
- [Test detail preview](https://github.com/ameya050506/ten-major-project/blob/main/src/components/admin/TestDetailDrawer.jsx): `src/components/admin/TestDetailDrawer.jsx`
- [Admin reporting and insights](https://github.com/ameya050506/ten-major-project/tree/main/src/pages/admin): `src/pages/admin`

### Assessment backend

- [Test endpoints](https://github.com/ameya050506/ten-major-project/blob/main/backend/src/main/java/com/ten/assessment/controller/TestController.java): `backend/src/main/java/com/ten/assessment/controller/TestController.java`
- [Question endpoints](https://github.com/ameya050506/ten-major-project/blob/main/backend/src/main/java/com/ten/assessment/controller/QuestionController.java): `backend/src/main/java/com/ten/assessment/controller/QuestionController.java`
- [Result endpoints](https://github.com/ameya050506/ten-major-project/blob/main/backend/src/main/java/com/ten/assessment/controller/ResultController.java): `backend/src/main/java/com/ten/assessment/controller/ResultController.java`
- [Test operations](https://github.com/ameya050506/ten-major-project/blob/main/backend/src/main/java/com/ten/assessment/service/TestService.java): `backend/src/main/java/com/ten/assessment/service/TestService.java`
- [Question operations](https://github.com/ameya050506/ten-major-project/blob/main/backend/src/main/java/com/ten/assessment/service/QuestionService.java): `backend/src/main/java/com/ten/assessment/service/QuestionService.java`
- [Scoring and results](https://github.com/ameya050506/ten-major-project/blob/main/backend/src/main/java/com/ten/assessment/service/ResultService.java): `backend/src/main/java/com/ten/assessment/service/ResultService.java`
- [Persistence repositories](https://github.com/ameya050506/ten-major-project/tree/main/backend/src/main/java/com/ten/assessment/repository): `backend/src/main/java/com/ten/assessment/repository`
- [Assessment domain entities](https://github.com/ameya050506/ten-major-project/tree/main/backend/src/main/java/com/ten/assessment/entity): `backend/src/main/java/com/ten/assessment/entity`

### Other components

- **Candidate or admin**
- **Assessment API**

## Connections

- Candidate or admin → Application routes: opens pages (evidence: `src/routes/AppRoutes.jsx`)
- Application routes → Candidate assessment pages: routes candidate (evidence: `src/routes/AppRoutes.jsx`)
- Application routes → Test and question management: routes admin (evidence: `src/routes/AppRoutes.jsx`)
- Authentication state → Authentication service: delegates auth (evidence: `src/context/AuthContext.jsx`)
- Assessment state → Result service: uses results (evidence: `src/context/AssessmentContext.jsx`)
- Candidate assessment pages → Attempt interface: presents attempt
- Candidate assessment pages → Result service: submits answers
- Application routes → Candidate account and insights: routes insights (evidence: `src/routes/AppRoutes.jsx`)
- Application routes → Admin reporting and insights: routes reports (evidence: `src/routes/AppRoutes.jsx`)
- Test detail preview → Test service: loads test data (evidence: `src/components/admin/TestDetailDrawer.jsx`)
- Test detail preview → Question service: loads questions (evidence: `src/components/admin/TestDetailDrawer.jsx`)
- Test and question management → Test service: manages tests (evidence: `src/pages/admin/AdminTestPreview.jsx`)
- Test and question management → Question service: manages questions (evidence: `src/pages/admin/AdminTestPreview.jsx`)
- Test service → Assessment API: requests tests (evidence: `src/services/testService.js`)
- Question service → Assessment API: requests questions (evidence: `src/services/questionService.js`)
- Result service → Assessment API: submits and reads (evidence: `src/services/resultService.js`)
- Test service → Local data store: falls back locally (evidence: `src/services/testService.js`)
- Question service → Local data store: falls back locally (evidence: `src/services/questionService.js`)
- Result service → Local data store: stores fallback results (evidence: `src/services/resultService.js`)
- Test service → Data source mode: sets source mode (evidence: `src/services/testService.js`)
- Question service → Data source mode: sets source mode (evidence: `src/services/questionService.js`)
- Result service → Data source mode: sets source mode (evidence: `src/services/resultService.js`)
- Assessment API → Test endpoints: routes test requests
- Assessment API → Question endpoints: routes question requests
- Assessment API → Result endpoints: routes result requests
- Test endpoints → Test operations: delegates tests (evidence: `backend/src/main/java/com/ten/assessment/controller/TestController.java`)
- Question endpoints → Question operations: delegates questions (evidence: `backend/src/main/java/com/ten/assessment/controller/QuestionController.java`)
- Result endpoints → Scoring and results: delegates results (evidence: `backend/src/main/java/com/ten/assessment/controller/ResultController.java`)
- Test operations → Persistence repositories: reads and writes (evidence: `backend/src/main/java/com/ten/assessment/service/TestService.java`)
- Question operations → Persistence repositories: uses repository (evidence: `backend/src/main/java/com/ten/assessment/service/QuestionService.java`)
- Scoring and results → Persistence repositories: loads and saves (evidence: `backend/src/main/java/com/ten/assessment/service/ResultService.java`)
- Scoring and results → Assessment domain entities: scores answers (evidence: `backend/src/main/java/com/ten/assessment/service/ResultService.java`)
- Test operations → Assessment domain entities: manages tests (evidence: `backend/src/main/java/com/ten/assessment/service/TestService.java`)
- Question operations → Assessment domain entities: manages questions (evidence: `backend/src/main/java/com/ten/assessment/service/QuestionService.java`)
