# krish-2466/exam-portal architecture

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

- Interactive diagram: https://gitdiagram.com/krish-2466/exam-portal
- Repository: https://github.com/krish-2466/exam-portal

## Overview

QuizVault is a React and Spring Boot assessment platform. Admins create and configure quizzes, author questions manually or with AI, grant access, and inspect attempts; students see eligible live quizzes, start or resume timed attempts, submit answers, and review results and history. The graph shows the documented end-to-end workflow and major capabilities, with backend business and persistence layers. Backend implementation details and AI/PDF wiring were not excerpted, so those documented relationships are represented as unverified dashed links.

Main entry points: [`backend/src/main/java/com/example/backend/controller`](https://github.com/krish-2466/exam-portal/tree/main/backend/src/main/java/com/example/backend/controller) (REST controllers), [`frontend/src/api/axiosInstance.js`](https://github.com/krish-2466/exam-portal/blob/main/frontend/src/api/axiosInstance.js) (HTTP client), [`backend/src/main/java/com/example/backend/repository`](https://github.com/krish-2466/exam-portal/tree/main/backend/src/main/java/com/example/backend/repository) (JPA repositories), [`frontend/src/pages/admin/QuizDetails.js`](https://github.com/krish-2466/exam-portal/blob/main/frontend/src/pages/admin/QuizDetails.js) (Quiz management)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Web application"]
  node_app["Route application<br/>[App.js]"]
  node_authui["Sign in / register<br/>[RegisterPage.js]"]
  node_authstate["Auth context<br/>[AuthContext.js]"]
  node_adminui["Quiz management<br/>[QuizDetails.js]"]
  node_questionsui["Question editor<br/>[QuestionManager.js]"]
  node_accessui["Access manager<br/>[AccessManager.js]"]
  node_aiui["AI generator"]
  node_attemptsadmin["Attempt review<br/>[AttemptsList.js]"]
  node_studentui["Student quiz flow<br/>[LiveQuizzes.js]"]
  node_takeui["Timed quiz<br/>[TakeQuiz.js]"]
  node_resultui["Results and history<br/>[QuizResult.js]"]
  node_authapi["Auth API client<br/>[authApi.js]"]
  node_adminapi["Admin API clients<br/>[adminQuizApi.js]"]
  node_accessapi["Access API client<br/>[adminAccessApi.js]"]
  node_aiapi["AI API client<br/>[adminAiApi.js]"]
  node_adminattemptapi["Attempt API client<br/>[adminAttemptApi.js]"]
  node_studentapi["Student API client<br/>[studentApi.js]"]
  node_http["HTTP client<br/>[axiosInstance.js]"]
end

subgraph group_backend["API and domain"]
  node_api["REST controllers"]
  node_quizservice["Quiz service<br/>[QuizService.java]"]
  node_questionservice["Question service"]
  node_accessservice["Quiz access service"]
  node_aiservice["AI question service"]
  node_studentservice["Student quiz service"]
  node_attemptservice["Attempt service"]
end

subgraph group_security["Identity and security"]
  node_authservice["Authentication service<br/>[AuthService.java]"]
  node_jwt["JWT security<br/>[JwtAuthFilter.java]"]
end

subgraph group_persistence["Persistence"]
  node_repositories["JPA repositories"]
  node_database[("PostgreSQL")]
end

node_admin(("Instructor"))
node_student(("Student"))
node_groq{{"Groq LLM"}}
node_pdfbox["PDF text extraction"]

node_app -->|"provides auth"| node_authstate
node_app -->|"routes to"| node_authui
node_app -->|"routes to"| node_adminui
node_app -->|"routes to"| node_studentui
node_admin -.->|"manages quizzes"| node_adminui
node_student -.->|"accesses quizzes"| node_studentui
node_authui -->|"submits credentials"| node_authapi
node_authui -->|"stores session"| node_authstate
node_authapi -->|"sends requests"| node_http
node_adminui -->|"loads and updates"| node_adminapi
node_adminui -->|"renders"| node_questionsui
node_adminui -->|"renders"| node_accessui
node_adminui -->|"renders"| node_attemptsadmin
node_questionsui -->|"manages questions"| node_adminapi
node_questionsui -->|"renders"| node_aiui
node_aiui -->|"requests generation"| node_aiapi
node_accessui -->|"grants and revokes"| node_accessapi
node_attemptsadmin -->|"loads attempts"| node_adminattemptapi
node_studentui -->|"loads live quizzes"| node_studentapi
node_takeui -->|"starts and submits"| node_studentapi
node_resultui -.->|"loads attempt detail"| node_studentapi
node_adminapi -->|"sends requests"| node_http
node_accessapi -.->|"sends requests"| node_http
node_aiapi -.->|"sends requests"| node_http
node_adminattemptapi -.->|"sends requests"| node_http
node_studentapi -->|"sends requests"| node_http
node_http -.->|"calls REST endpoints"| node_api
node_api -.->|"delegates auth"| node_authservice
node_api -.->|"delegates quiz ops"| node_quizservice
node_api -.->|"delegates question ops"| node_questionservice
node_api -.->|"delegates access ops"| node_accessservice
node_api -.->|"delegates generation"| node_aiservice
node_api -.->|"delegates student flow"| node_studentservice
node_api -.->|"delegates reviews"| node_attemptservice
node_jwt -.->|"resolves identity"| node_authservice
node_authservice -.->|"uses user data"| node_repositories
node_quizservice -.->|"uses quiz data"| node_repositories
node_questionservice -.->|"uses question data"| node_repositories
node_accessservice -.->|"uses access data"| node_repositories
node_aiservice -.->|"generates questions"| node_groq
node_aiservice -.->|"extracts PDF text"| node_pdfbox
node_studentservice -.->|"uses quiz and access data"| node_repositories
node_attemptservice -.->|"uses attempt data"| node_repositories
node_repositories -.->|"persists domain data"| node_database

click node_app "https://github.com/krish-2466/exam-portal/blob/main/frontend/src/App.js"
click node_authui "https://github.com/krish-2466/exam-portal/blob/main/frontend/src/pages/auth/RegisterPage.js"
click node_authstate "https://github.com/krish-2466/exam-portal/blob/main/frontend/src/context/AuthContext.js"
click node_adminui "https://github.com/krish-2466/exam-portal/blob/main/frontend/src/pages/admin/QuizDetails.js"
click node_questionsui "https://github.com/krish-2466/exam-portal/blob/main/frontend/src/pages/admin/QuestionManager.js"
click node_accessui "https://github.com/krish-2466/exam-portal/blob/main/frontend/src/pages/admin/AccessManager.js"
click node_aiui "https://github.com/krish-2466/exam-portal/blob/main/frontend/src/pages/admin/AIQuestionGenerator.js"
click node_attemptsadmin "https://github.com/krish-2466/exam-portal/blob/main/frontend/src/pages/admin/AttemptsList.js"
click node_studentui "https://github.com/krish-2466/exam-portal/blob/main/frontend/src/pages/student/LiveQuizzes.js"
click node_takeui "https://github.com/krish-2466/exam-portal/blob/main/frontend/src/pages/student/TakeQuiz.js"
click node_resultui "https://github.com/krish-2466/exam-portal/blob/main/frontend/src/pages/student/QuizResult.js"
click node_authapi "https://github.com/krish-2466/exam-portal/blob/main/frontend/src/api/authApi.js"
click node_adminapi "https://github.com/krish-2466/exam-portal/blob/main/frontend/src/api/adminQuizApi.js"
click node_accessapi "https://github.com/krish-2466/exam-portal/blob/main/frontend/src/api/adminAccessApi.js"
click node_aiapi "https://github.com/krish-2466/exam-portal/blob/main/frontend/src/api/adminAiApi.js"
click node_adminattemptapi "https://github.com/krish-2466/exam-portal/blob/main/frontend/src/api/adminAttemptApi.js"
click node_studentapi "https://github.com/krish-2466/exam-portal/blob/main/frontend/src/api/studentApi.js"
click node_http "https://github.com/krish-2466/exam-portal/blob/main/frontend/src/api/axiosInstance.js"
click node_api "https://github.com/krish-2466/exam-portal/tree/main/backend/src/main/java/com/example/backend/controller"
click node_authservice "https://github.com/krish-2466/exam-portal/blob/main/backend/src/main/java/com/example/backend/service/AuthService.java"
click node_quizservice "https://github.com/krish-2466/exam-portal/blob/main/backend/src/main/java/com/example/backend/service/QuizService.java"
click node_questionservice "https://github.com/krish-2466/exam-portal/blob/main/backend/src/main/java/com/example/backend/service/QuestionService.java"
click node_accessservice "https://github.com/krish-2466/exam-portal/blob/main/backend/src/main/java/com/example/backend/service/QuizAccessService.java"
click node_aiservice "https://github.com/krish-2466/exam-portal/blob/main/backend/src/main/java/com/example/backend/service/AIQuestionService.java"
click node_studentservice "https://github.com/krish-2466/exam-portal/blob/main/backend/src/main/java/com/example/backend/service/StudentQuizService.java"
click node_attemptservice "https://github.com/krish-2466/exam-portal/blob/main/backend/src/main/java/com/example/backend/service/AttemptService.java"
click node_jwt "https://github.com/krish-2466/exam-portal/blob/main/backend/src/main/java/com/example/backend/security/JwtAuthFilter.java"
click node_repositories "https://github.com/krish-2466/exam-portal/tree/main/backend/src/main/java/com/example/backend/repository"
click node_database "https://github.com/krish-2466/exam-portal/tree/main/backend/src/main/java/com/example/backend/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_app,node_authui,node_authstate,node_adminui,node_questionsui,node_accessui,node_aiui,node_attemptsadmin,node_studentui,node_takeui,node_resultui,node_authapi,node_adminapi,node_accessapi,node_aiapi,node_adminattemptapi,node_studentapi,node_http toneBlue
class node_api,node_quizservice,node_questionservice,node_accessservice,node_aiservice,node_studentservice,node_attemptservice toneAmber
class node_authservice,node_jwt toneMint
class node_repositories,node_database toneRose
class node_admin,node_student,node_groq,node_pdfbox toneIndigo
```

## Components

### Web application

- [Route application](https://github.com/krish-2466/exam-portal/blob/main/frontend/src/App.js): `frontend/src/App.js`
- [Sign in / register](https://github.com/krish-2466/exam-portal/blob/main/frontend/src/pages/auth/RegisterPage.js): `frontend/src/pages/auth/RegisterPage.js`
- [Auth context](https://github.com/krish-2466/exam-portal/blob/main/frontend/src/context/AuthContext.js): `frontend/src/context/AuthContext.js`
- [Quiz management](https://github.com/krish-2466/exam-portal/blob/main/frontend/src/pages/admin/QuizDetails.js): `frontend/src/pages/admin/QuizDetails.js`
- [Question editor](https://github.com/krish-2466/exam-portal/blob/main/frontend/src/pages/admin/QuestionManager.js): `frontend/src/pages/admin/QuestionManager.js`
- [Access manager](https://github.com/krish-2466/exam-portal/blob/main/frontend/src/pages/admin/AccessManager.js): `frontend/src/pages/admin/AccessManager.js`
- [AI generator](https://github.com/krish-2466/exam-portal/blob/main/frontend/src/pages/admin/AIQuestionGenerator.js): `frontend/src/pages/admin/AIQuestionGenerator.js`
- [Attempt review](https://github.com/krish-2466/exam-portal/blob/main/frontend/src/pages/admin/AttemptsList.js): `frontend/src/pages/admin/AttemptsList.js`
- [Student quiz flow](https://github.com/krish-2466/exam-portal/blob/main/frontend/src/pages/student/LiveQuizzes.js): `frontend/src/pages/student/LiveQuizzes.js`
- [Timed quiz](https://github.com/krish-2466/exam-portal/blob/main/frontend/src/pages/student/TakeQuiz.js): `frontend/src/pages/student/TakeQuiz.js`
- [Results and history](https://github.com/krish-2466/exam-portal/blob/main/frontend/src/pages/student/QuizResult.js): `frontend/src/pages/student/QuizResult.js`
- [Auth API client](https://github.com/krish-2466/exam-portal/blob/main/frontend/src/api/authApi.js): `frontend/src/api/authApi.js`
- [Admin API clients](https://github.com/krish-2466/exam-portal/blob/main/frontend/src/api/adminQuizApi.js): `frontend/src/api/adminQuizApi.js`
- [Access API client](https://github.com/krish-2466/exam-portal/blob/main/frontend/src/api/adminAccessApi.js): `frontend/src/api/adminAccessApi.js`
- [AI API client](https://github.com/krish-2466/exam-portal/blob/main/frontend/src/api/adminAiApi.js): `frontend/src/api/adminAiApi.js`
- [Attempt API client](https://github.com/krish-2466/exam-portal/blob/main/frontend/src/api/adminAttemptApi.js): `frontend/src/api/adminAttemptApi.js`
- [Student API client](https://github.com/krish-2466/exam-portal/blob/main/frontend/src/api/studentApi.js): `frontend/src/api/studentApi.js`
- [HTTP client](https://github.com/krish-2466/exam-portal/blob/main/frontend/src/api/axiosInstance.js): `frontend/src/api/axiosInstance.js`

### API and domain

- [REST controllers](https://github.com/krish-2466/exam-portal/tree/main/backend/src/main/java/com/example/backend/controller): `backend/src/main/java/com/example/backend/controller`
- [Quiz service](https://github.com/krish-2466/exam-portal/blob/main/backend/src/main/java/com/example/backend/service/QuizService.java): `backend/src/main/java/com/example/backend/service/QuizService.java`
- [Question service](https://github.com/krish-2466/exam-portal/blob/main/backend/src/main/java/com/example/backend/service/QuestionService.java): `backend/src/main/java/com/example/backend/service/QuestionService.java`
- [Quiz access service](https://github.com/krish-2466/exam-portal/blob/main/backend/src/main/java/com/example/backend/service/QuizAccessService.java): `backend/src/main/java/com/example/backend/service/QuizAccessService.java`
- [AI question service](https://github.com/krish-2466/exam-portal/blob/main/backend/src/main/java/com/example/backend/service/AIQuestionService.java): `backend/src/main/java/com/example/backend/service/AIQuestionService.java`
- [Student quiz service](https://github.com/krish-2466/exam-portal/blob/main/backend/src/main/java/com/example/backend/service/StudentQuizService.java): `backend/src/main/java/com/example/backend/service/StudentQuizService.java`
- [Attempt service](https://github.com/krish-2466/exam-portal/blob/main/backend/src/main/java/com/example/backend/service/AttemptService.java): `backend/src/main/java/com/example/backend/service/AttemptService.java`

### Identity and security

- [Authentication service](https://github.com/krish-2466/exam-portal/blob/main/backend/src/main/java/com/example/backend/service/AuthService.java): `backend/src/main/java/com/example/backend/service/AuthService.java`
- [JWT security](https://github.com/krish-2466/exam-portal/blob/main/backend/src/main/java/com/example/backend/security/JwtAuthFilter.java): `backend/src/main/java/com/example/backend/security/JwtAuthFilter.java`

### Persistence

- [JPA repositories](https://github.com/krish-2466/exam-portal/tree/main/backend/src/main/java/com/example/backend/repository): `backend/src/main/java/com/example/backend/repository`
- [PostgreSQL](https://github.com/krish-2466/exam-portal/tree/main/backend/src/main/java/com/example/backend/entity): `backend/src/main/java/com/example/backend/entity`

### Other components

- **Instructor**
- **Student**
- **Groq LLM**
- **PDF text extraction**

## Connections

- Route application → Auth context: provides auth (evidence: `frontend/src/App.js`)
- Route application → Sign in / register: routes to (evidence: `frontend/src/App.js`)
- Route application → Quiz management: routes to (evidence: `frontend/src/App.js`)
- Route application → Student quiz flow: routes to (evidence: `frontend/src/App.js`)
- Instructor → Quiz management: manages quizzes (evidence: `README.md`)
- Student → Student quiz flow: accesses quizzes (evidence: `README.md`)
- Sign in / register → Auth API client: submits credentials (evidence: `frontend/src/pages/auth/RegisterPage.js`)
- Sign in / register → Auth context: stores session (evidence: `frontend/src/pages/auth/RegisterPage.js`)
- Auth API client → HTTP client: sends requests (evidence: `frontend/src/api/authApi.js`)
- Quiz management → Admin API clients: loads and updates (evidence: `frontend/src/pages/admin/QuizDetails.js`)
- Quiz management → Question editor: renders (evidence: `frontend/src/pages/admin/QuizDetails.js`)
- Quiz management → Access manager: renders (evidence: `frontend/src/pages/admin/QuizDetails.js`)
- Quiz management → Attempt review: renders (evidence: `frontend/src/pages/admin/QuizDetails.js`)
- Question editor → Admin API clients: manages questions (evidence: `frontend/src/pages/admin/QuestionManager.js`)
- Question editor → AI generator: renders (evidence: `frontend/src/pages/admin/QuestionManager.js`)
- AI generator → AI API client: requests generation (evidence: `frontend/src/pages/admin/AIQuestionGenerator.js`)
- Access manager → Access API client: grants and revokes (evidence: `frontend/src/pages/admin/AccessManager.js`)
- Attempt review → Attempt API client: loads attempts (evidence: `frontend/src/pages/admin/AttemptsList.js`)
- Student quiz flow → Student API client: loads live quizzes (evidence: `frontend/src/pages/student/LiveQuizzes.js`)
- Timed quiz → Student API client: starts and submits (evidence: `frontend/src/api/studentApi.js`)
- Results and history → Student API client: loads attempt detail
- Admin API clients → HTTP client: sends requests (evidence: `frontend/src/api/adminQuizApi.js`)
- Access API client → HTTP client: sends requests (evidence: `frontend/src/api/adminAccessApi.js`)
- AI API client → HTTP client: sends requests (evidence: `frontend/src/api/adminAiApi.js`)
- Attempt API client → HTTP client: sends requests (evidence: `frontend/src/api/adminAttemptApi.js`)
- Student API client → HTTP client: sends requests (evidence: `frontend/src/api/studentApi.js`)
- HTTP client → REST controllers: calls REST endpoints (evidence: `README.md`)
- REST controllers → Authentication service: delegates auth
- REST controllers → Quiz service: delegates quiz ops
- REST controllers → Question service: delegates question ops
- REST controllers → Quiz access service: delegates access ops
- REST controllers → AI question service: delegates generation
- REST controllers → Student quiz service: delegates student flow
- REST controllers → Attempt service: delegates reviews
- JWT security → Authentication service: resolves identity
- Authentication service → JPA repositories: uses user data
- Quiz service → JPA repositories: uses quiz data
- Question service → JPA repositories: uses question data
- Quiz access service → JPA repositories: uses access data
- AI question service → Groq LLM: generates questions (evidence: `README.md`)
- AI question service → PDF text extraction: extracts PDF text (evidence: `README.md`)
- Student quiz service → JPA repositories: uses quiz and access data
- Attempt service → JPA repositories: uses attempt data
- JPA repositories → PostgreSQL: persists domain data (evidence: `README.md`)
