# rahulshah1256/examportal-application architecture

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

- Interactive diagram: https://gitdiagram.com/rahulshah1256/examportal-application
- Repository: https://github.com/rahulshah1256/examportal-application

## Overview

ExamPortal is a multi-role online examination and assessment platform. The main learner journey is to authenticate, browse and start a quiz, take it under server-managed session/proctoring, and review results; instructors also create and manage quiz content. The repository adds question-bank workflows, coding assessments, AI assistance, analytics, community discussion, and notifications. The excerpts show selected service calls and routing; other connections below are documented product-level flows, not claims that every unsampled implementation path was inspected.

Main entry points: [`ExamPortal-Frontend-React/src/App.jsx`](https://github.com/rahulshah1256/examportal-application/blob/main/ExamPortal-Frontend-React/src/App.jsx) (React application), [`ExamPortal-Backend/examserver/src/main/java/com/exam/coding/service/CodingJudgeService.java`](https://github.com/rahulshah1256/examportal-application/blob/main/ExamPortal-Backend/examserver/src/main/java/com/exam/coding/service/CodingJudgeService.java) (Coding judge), [`ExamPortal-Backend/examserver/src/main/java/com/exam/questionbank/service/QuestionBankService.java`](https://github.com/rahulshah1256/examportal-application/blob/main/ExamPortal-Backend/examserver/src/main/java/com/exam/questionbank/service/QuestionBankService.java) (Question bank), [`ExamPortal-Backend/examserver/src/main/java/com/exam/ai/service/AiQuestionGenerationService.java`](https://github.com/rahulshah1256/examportal-application/blob/main/ExamPortal-Backend/examserver/src/main/java/com/exam/ai/service/AiQuestionGenerationService.java) (AI question generation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web client"]
  node_webapp["React application<br/>[App.jsx]"]
  node_loginui["Login flow<br/>[useLogin.js]"]
  node_liveui["Live exam UI<br/>[LiveExamPage.tsx]"]
  node_bankui["Question-bank UI"]
  node_codingui["Coding assessment UI"]
  node_aiui["AI assistant UI"]
end

subgraph group_exam["Quiz delivery"]
  node_backend["Exam API"]
  node_quizapi["Quiz and result APIs"]
  node_quizservices["Quiz and result services"]
  node_examdata[("Quiz data<br/>[Quiz.java]")]
  node_sessions["Realtime exam sessions"]
end

subgraph group_authoring["Assessment authoring"]
  node_bank["Question bank"]
  node_csv["Question CSV"]
  node_bankdata[("Question-bank data<br/>[BankQuestion.java]")]
end

subgraph group_extended["Assessment extensions"]
  node_coding["Coding judge"]
  node_problems["Problem management"]
  node_engine["Execution engine"]
  node_aigen["AI question generation"]
  node_ai["AI gateway<br/>[AiGateway.java]"]
  node_analytics["Analytics"]
  node_community["Coding discussions"]
end

subgraph group_platform["Platform services"]
  node_auth["JWT and refresh auth"]
  node_authstore[("User and token data")]
  node_notifications["Notifications"]
  node_database[("Relational database")]
end

node_learner(("Learner / instructor"))
node_provider{{"AI provider"}}

node_learner -->|"uses"| node_webapp
node_webapp -->|"routes to"| node_loginui
node_loginui -.->|"authenticates"| node_auth
node_webapp -->|"routes to"| node_liveui
node_liveui -.->|"exchanges session events"| node_sessions
node_webapp -.->|"uses API"| node_backend
node_backend -.->|"routes requests"| node_quizapi
node_quizapi -.->|"delegates"| node_quizservices
node_quizservices -.->|"manages quiz data"| node_examdata
node_sessions -.->|"persists sessions"| node_database
node_auth -.->|"uses token repository"| node_authstore
node_bankui -.->|"manages questions"| node_bank
node_bank -.->|"creates and reviews"| node_bankdata
node_csv -.->|"imports questions"| node_bank
node_codingui -.->|"submits code"| node_coding
node_coding -->|"loads problem"| node_problems
node_coding -->|"executes test cases"| node_engine
node_coding -.->|"stores submissions"| node_database
node_aiui -.->|"requests generation"| node_aigen
node_aigen -->|"requests completion"| node_ai
node_aigen -->|"persists draft"| node_bank
node_ai -.->|"calls provider"| node_provider
node_analytics -.->|"reads assessment data"| node_database
node_community -->|"notifies reply author"| node_notifications
node_notifications -.->|"stores notifications"| node_database

click node_webapp "https://github.com/rahulshah1256/examportal-application/blob/main/ExamPortal-Frontend-React/src/App.jsx"
click node_loginui "https://github.com/rahulshah1256/examportal-application/blob/main/ExamPortal-Frontend-React/src/pages/auth/useLogin.js"
click node_liveui "https://github.com/rahulshah1256/examportal-application/blob/main/ExamPortal-Frontend-React/src/features/exam/LiveExamPage.tsx"
click node_backend "https://github.com/rahulshah1256/examportal-application/blob/main/ExamPortal-Backend/examserver/src/main/java/com/exam/ExamserverApplication.java"
click node_quizapi "https://github.com/rahulshah1256/examportal-application/blob/main/ExamPortal-Backend/examserver/src/main/java/com/exam/controller/QuizController.java"
click node_quizservices "https://github.com/rahulshah1256/examportal-application/blob/main/ExamPortal-Backend/examserver/src/main/java/com/exam/service/impl/QuizServiceImpl.java"
click node_examdata "https://github.com/rahulshah1256/examportal-application/blob/main/ExamPortal-Backend/examserver/src/main/java/com/exam/model/exam/Quiz.java"
click node_sessions "https://github.com/rahulshah1256/examportal-application/blob/main/ExamPortal-Backend/examserver/src/main/java/com/exam/realtime/service/ExamSessionService.java"
click node_auth "https://github.com/rahulshah1256/examportal-application/blob/main/ExamPortal-Backend/examserver/src/main/java/com/exam/auth/service/RefreshTokenService.java"
click node_authstore "https://github.com/rahulshah1256/examportal-application/blob/main/ExamPortal-Backend/examserver/src/main/java/com/exam/auth/repo/RefreshTokenRepository.java"
click node_bankui "https://github.com/rahulshah1256/examportal-application/blob/main/ExamPortal-Frontend-React/src/features/questionbank/QuestionBankPage.tsx"
click node_bank "https://github.com/rahulshah1256/examportal-application/blob/main/ExamPortal-Backend/examserver/src/main/java/com/exam/questionbank/service/QuestionBankService.java"
click node_csv "https://github.com/rahulshah1256/examportal-application/blob/main/ExamPortal-Backend/examserver/src/main/java/com/exam/questionbank/service/QuestionCsvService.java"
click node_bankdata "https://github.com/rahulshah1256/examportal-application/blob/main/ExamPortal-Backend/examserver/src/main/java/com/exam/questionbank/model/BankQuestion.java"
click node_codingui "https://github.com/rahulshah1256/examportal-application/blob/main/ExamPortal-Frontend-React/src/features/coding/CodingProblemDetailPage.tsx"
click node_coding "https://github.com/rahulshah1256/examportal-application/blob/main/ExamPortal-Backend/examserver/src/main/java/com/exam/coding/service/CodingJudgeService.java"
click node_problems "https://github.com/rahulshah1256/examportal-application/blob/main/ExamPortal-Backend/examserver/src/main/java/com/exam/coding/service/CodingProblemService.java"
click node_engine "https://github.com/rahulshah1256/examportal-application/blob/main/ExamPortal-Backend/examserver/src/main/java/com/exam/coding/judge/SimulatedExecutionEngine.java"
click node_aiui "https://github.com/rahulshah1256/examportal-application/blob/main/ExamPortal-Frontend-React/src/features/ai/AiAssistantPage.tsx"
click node_aigen "https://github.com/rahulshah1256/examportal-application/blob/main/ExamPortal-Backend/examserver/src/main/java/com/exam/ai/service/AiQuestionGenerationService.java"
click node_ai "https://github.com/rahulshah1256/examportal-application/blob/main/ExamPortal-Backend/examserver/src/main/java/com/exam/ai/service/AiGateway.java"
click node_analytics "https://github.com/rahulshah1256/examportal-application/blob/main/ExamPortal-Backend/examserver/src/main/java/com/exam/analytics/service/AnalyticsService.java"
click node_community "https://github.com/rahulshah1256/examportal-application/blob/main/ExamPortal-Backend/examserver/src/main/java/com/exam/community/service/CommunityService.java"
click node_notifications "https://github.com/rahulshah1256/examportal-application/blob/main/ExamPortal-Backend/examserver/src/main/java/com/exam/notification/service/NotificationService.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_webapp,node_loginui,node_liveui,node_bankui,node_codingui,node_aiui toneBlue
class node_backend,node_quizapi,node_quizservices,node_examdata,node_sessions toneAmber
class node_bank,node_csv,node_bankdata toneMint
class node_coding,node_problems,node_engine,node_aigen,node_ai,node_analytics,node_community toneRose
class node_auth,node_authstore,node_notifications,node_database,node_learner,node_provider toneIndigo
```

## Components

### Web client

- [React application](https://github.com/rahulshah1256/examportal-application/blob/main/ExamPortal-Frontend-React/src/App.jsx): `ExamPortal-Frontend-React/src/App.jsx`
- [Login flow](https://github.com/rahulshah1256/examportal-application/blob/main/ExamPortal-Frontend-React/src/pages/auth/useLogin.js): `ExamPortal-Frontend-React/src/pages/auth/useLogin.js`
- [Live exam UI](https://github.com/rahulshah1256/examportal-application/blob/main/ExamPortal-Frontend-React/src/features/exam/LiveExamPage.tsx): `ExamPortal-Frontend-React/src/features/exam/LiveExamPage.tsx`
- [Question-bank UI](https://github.com/rahulshah1256/examportal-application/blob/main/ExamPortal-Frontend-React/src/features/questionbank/QuestionBankPage.tsx): `ExamPortal-Frontend-React/src/features/questionbank/QuestionBankPage.tsx`
- [Coding assessment UI](https://github.com/rahulshah1256/examportal-application/blob/main/ExamPortal-Frontend-React/src/features/coding/CodingProblemDetailPage.tsx): `ExamPortal-Frontend-React/src/features/coding/CodingProblemDetailPage.tsx`
- [AI assistant UI](https://github.com/rahulshah1256/examportal-application/blob/main/ExamPortal-Frontend-React/src/features/ai/AiAssistantPage.tsx): `ExamPortal-Frontend-React/src/features/ai/AiAssistantPage.tsx`

### Quiz delivery

- [Exam API](https://github.com/rahulshah1256/examportal-application/blob/main/ExamPortal-Backend/examserver/src/main/java/com/exam/ExamserverApplication.java): `ExamPortal-Backend/examserver/src/main/java/com/exam/ExamserverApplication.java`
- [Quiz and result APIs](https://github.com/rahulshah1256/examportal-application/blob/main/ExamPortal-Backend/examserver/src/main/java/com/exam/controller/QuizController.java): `ExamPortal-Backend/examserver/src/main/java/com/exam/controller/QuizController.java`
- [Quiz and result services](https://github.com/rahulshah1256/examportal-application/blob/main/ExamPortal-Backend/examserver/src/main/java/com/exam/service/impl/QuizServiceImpl.java): `ExamPortal-Backend/examserver/src/main/java/com/exam/service/impl/QuizServiceImpl.java`
- [Quiz data](https://github.com/rahulshah1256/examportal-application/blob/main/ExamPortal-Backend/examserver/src/main/java/com/exam/model/exam/Quiz.java): `ExamPortal-Backend/examserver/src/main/java/com/exam/model/exam/Quiz.java`
- [Realtime exam sessions](https://github.com/rahulshah1256/examportal-application/blob/main/ExamPortal-Backend/examserver/src/main/java/com/exam/realtime/service/ExamSessionService.java): `ExamPortal-Backend/examserver/src/main/java/com/exam/realtime/service/ExamSessionService.java`

### Assessment authoring

- [Question bank](https://github.com/rahulshah1256/examportal-application/blob/main/ExamPortal-Backend/examserver/src/main/java/com/exam/questionbank/service/QuestionBankService.java): `ExamPortal-Backend/examserver/src/main/java/com/exam/questionbank/service/QuestionBankService.java`
- [Question CSV](https://github.com/rahulshah1256/examportal-application/blob/main/ExamPortal-Backend/examserver/src/main/java/com/exam/questionbank/service/QuestionCsvService.java): `ExamPortal-Backend/examserver/src/main/java/com/exam/questionbank/service/QuestionCsvService.java`
- [Question-bank data](https://github.com/rahulshah1256/examportal-application/blob/main/ExamPortal-Backend/examserver/src/main/java/com/exam/questionbank/model/BankQuestion.java): `ExamPortal-Backend/examserver/src/main/java/com/exam/questionbank/model/BankQuestion.java`

### Assessment extensions

- [Coding judge](https://github.com/rahulshah1256/examportal-application/blob/main/ExamPortal-Backend/examserver/src/main/java/com/exam/coding/service/CodingJudgeService.java): `ExamPortal-Backend/examserver/src/main/java/com/exam/coding/service/CodingJudgeService.java`
- [Problem management](https://github.com/rahulshah1256/examportal-application/blob/main/ExamPortal-Backend/examserver/src/main/java/com/exam/coding/service/CodingProblemService.java): `ExamPortal-Backend/examserver/src/main/java/com/exam/coding/service/CodingProblemService.java`
- [Execution engine](https://github.com/rahulshah1256/examportal-application/blob/main/ExamPortal-Backend/examserver/src/main/java/com/exam/coding/judge/SimulatedExecutionEngine.java): `ExamPortal-Backend/examserver/src/main/java/com/exam/coding/judge/SimulatedExecutionEngine.java`
- [AI question generation](https://github.com/rahulshah1256/examportal-application/blob/main/ExamPortal-Backend/examserver/src/main/java/com/exam/ai/service/AiQuestionGenerationService.java): `ExamPortal-Backend/examserver/src/main/java/com/exam/ai/service/AiQuestionGenerationService.java`
- [AI gateway](https://github.com/rahulshah1256/examportal-application/blob/main/ExamPortal-Backend/examserver/src/main/java/com/exam/ai/service/AiGateway.java): `ExamPortal-Backend/examserver/src/main/java/com/exam/ai/service/AiGateway.java`
- [Analytics](https://github.com/rahulshah1256/examportal-application/blob/main/ExamPortal-Backend/examserver/src/main/java/com/exam/analytics/service/AnalyticsService.java): `ExamPortal-Backend/examserver/src/main/java/com/exam/analytics/service/AnalyticsService.java`
- [Coding discussions](https://github.com/rahulshah1256/examportal-application/blob/main/ExamPortal-Backend/examserver/src/main/java/com/exam/community/service/CommunityService.java): `ExamPortal-Backend/examserver/src/main/java/com/exam/community/service/CommunityService.java`

### Platform services

- [JWT and refresh auth](https://github.com/rahulshah1256/examportal-application/blob/main/ExamPortal-Backend/examserver/src/main/java/com/exam/auth/service/RefreshTokenService.java): `ExamPortal-Backend/examserver/src/main/java/com/exam/auth/service/RefreshTokenService.java`
- [User and token data](https://github.com/rahulshah1256/examportal-application/blob/main/ExamPortal-Backend/examserver/src/main/java/com/exam/auth/repo/RefreshTokenRepository.java): `ExamPortal-Backend/examserver/src/main/java/com/exam/auth/repo/RefreshTokenRepository.java`
- [Notifications](https://github.com/rahulshah1256/examportal-application/blob/main/ExamPortal-Backend/examserver/src/main/java/com/exam/notification/service/NotificationService.java): `ExamPortal-Backend/examserver/src/main/java/com/exam/notification/service/NotificationService.java`
- **Relational database**

### Other components

- **Learner / instructor**
- **AI provider**

## Connections

- Learner / instructor → React application: uses (evidence: `README.md`)
- React application → Login flow: routes to (evidence: `ExamPortal-Frontend-React/src/App.jsx`)
- Login flow → JWT and refresh auth: authenticates
- React application → Live exam UI: routes to (evidence: `ExamPortal-Frontend-React/src/App.jsx`)
- Live exam UI → Realtime exam sessions: exchanges session events
- React application → Exam API: uses API
- Exam API → Quiz and result APIs: routes requests
- Quiz and result APIs → Quiz and result services: delegates
- Quiz and result services → Quiz data: manages quiz data
- Realtime exam sessions → Relational database: persists sessions
- JWT and refresh auth → User and token data: uses token repository (evidence: `ExamPortal-Backend/examserver/src/main/java/com/exam/auth/service/RefreshTokenService.java`)
- Question-bank UI → Question bank: manages questions
- Question bank → Question-bank data: creates and reviews (evidence: `ExamPortal-Backend/examserver/src/main/java/com/exam/questionbank/service/QuestionBankService.java`)
- Question CSV → Question bank: imports questions (evidence: `ExamPortal-Backend/examserver/src/main/java/com/exam/questionbank/service/QuestionCsvService.java`)
- Coding assessment UI → Coding judge: submits code
- Coding judge → Problem management: loads problem (evidence: `ExamPortal-Backend/examserver/src/main/java/com/exam/coding/service/CodingJudgeService.java`)
- Coding judge → Execution engine: executes test cases (evidence: `ExamPortal-Backend/examserver/src/main/java/com/exam/coding/service/CodingJudgeService.java`)
- Coding judge → Relational database: stores submissions
- AI assistant UI → AI question generation: requests generation
- AI question generation → AI gateway: requests completion (evidence: `ExamPortal-Backend/examserver/src/main/java/com/exam/ai/service/AiQuestionGenerationService.java`)
- AI question generation → Question bank: persists draft (evidence: `ExamPortal-Backend/examserver/src/main/java/com/exam/ai/service/AiQuestionGenerationService.java`)
- AI gateway → AI provider: calls provider
- Analytics → Relational database: reads assessment data
- Coding discussions → Notifications: notifies reply author (evidence: `ExamPortal-Backend/examserver/src/main/java/com/exam/community/service/CommunityService.java`)
- Notifications → Relational database: stores notifications
