# klu2300031823/examportal architecture

> Architecture diagram of the GitHub repository klu2300031823/examportal, 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/klu2300031823/examportal
- Repository: https://github.com/klu2300031823/examportal

## Overview

The repository is a React and Spring Boot exam portal with administrator and user roles. The documented workflow is sign-in or registration, role-specific access, question management or a timed exam, then instant scoring. Sampled code shows question creation, listing, and submission/scoring, plus user registration and token-based credential handling. The README also describes editing/deleting questions and viewing users’ marks, but those implementations were not sampled. Links for those and other unsampled frontend-to-backend interactions are therefore omitted or marked unverified.

Main entry points: [`frontend/src/App.jsx`](https://github.com/klu2300031823/examportal/blob/main/frontend/src/App.jsx) (Role routing), [`backend/src/main/java/com/klu/UsersManager.java`](https://github.com/klu2300031823/examportal/blob/main/backend/src/main/java/com/klu/UsersManager.java) (User operations), [`backend/src/main/java/com/klu/ExamController.java`](https://github.com/klu2300031823/examportal/blob/main/backend/src/main/java/com/klu/ExamController.java) (Exam operations), [`backend/src/main/java/com/klu/UsersRepository.java`](https://github.com/klu2300031823/examportal/blob/main/backend/src/main/java/com/klu/UsersRepository.java) (User repository)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["React Portal"]
  node_app["Role routing<br/>[App.jsx]"]
  node_login["Login form<br/>[Login.jsx]"]
  node_register["Registration form<br/>[Register.jsx]"]
  node_admin["Admin panel<br/>[AdminPanel.jsx]"]
  node_user["User panel<br/>[UserPanel.jsx]"]
  node_api["API helper<br/>[api.js]"]
end

subgraph group_identity["Identity Services"]
  node_logincontroller["Login endpoint"]
  node_loginservice["Login validation<br/>[LoginService.java]"]
  node_usercontroller["User endpoints"]
  node_usersmanager["User operations<br/>[UsersManager.java]"]
  node_jwt["JWT manager<br/>[JWTManager.java]"]
end

subgraph group_exam["Exam Services"]
  node_examcontroller["Exam operations"]
  node_timedexam["Timed exam"]
  node_adminfeatures["Admin question and marks"]
end

subgraph group_persistence["Domain Persistence"]
  node_question["Question entity<br/>[Question.java]"]
  node_questionrepo[("Question repository")]
  node_users["User entity<br/>[Users.java]"]
  node_usersrepo[("User repository")]
end

node_actor(("Portal visitor"))
node_mysql[("MySQL-compatible store")]

node_actor -->|"opens"| node_app
node_app -->|"renders"| node_login
node_app -->|"renders"| node_register
node_app -->|"renders by role"| node_admin
node_app -->|"renders by role"| node_user
node_logincontroller -->|"delegates to"| node_loginservice
node_loginservice -->|"looks up users"| node_usersrepo
node_loginservice -->|"checks credentials"| node_users
node_usercontroller -->|"delegates to"| node_usersmanager
node_usersmanager -->|"generates and validates"| node_jwt
node_usersmanager -->|"reads and writes"| node_usersrepo
node_usersmanager -->|"uses records"| node_users
node_examcontroller -->|"reads and saves"| node_questionrepo
node_examcontroller -->|"scores answers"| node_question
node_questionrepo -->|"stores"| node_question
node_usersrepo -->|"stores"| node_users
node_user -.->|"takes exam"| node_timedexam
node_timedexam -.->|"submits answers"| node_examcontroller
node_admin -.->|"manages questions"| node_adminfeatures
node_adminfeatures -.->|"uses exam operations"| node_examcontroller
node_questionrepo -.->|"persists to"| node_mysql
node_usersrepo -.->|"persists to"| node_mysql

click node_app "https://github.com/klu2300031823/examportal/blob/main/frontend/src/App.jsx"
click node_login "https://github.com/klu2300031823/examportal/blob/main/frontend/src/components/Login.jsx"
click node_register "https://github.com/klu2300031823/examportal/blob/main/frontend/src/components/Register.jsx"
click node_admin "https://github.com/klu2300031823/examportal/blob/main/frontend/src/components/AdminPanel.jsx"
click node_user "https://github.com/klu2300031823/examportal/blob/main/frontend/src/components/UserPanel.jsx"
click node_api "https://github.com/klu2300031823/examportal/blob/main/frontend/src/components/api.js"
click node_logincontroller "https://github.com/klu2300031823/examportal/blob/main/backend/src/main/java/com/klu/LoginController.java"
click node_loginservice "https://github.com/klu2300031823/examportal/blob/main/backend/src/main/java/com/klu/LoginService.java"
click node_usercontroller "https://github.com/klu2300031823/examportal/blob/main/backend/src/main/java/com/klu/UserController.java"
click node_usersmanager "https://github.com/klu2300031823/examportal/blob/main/backend/src/main/java/com/klu/UsersManager.java"
click node_jwt "https://github.com/klu2300031823/examportal/blob/main/backend/src/main/java/com/klu/JWTManager.java"
click node_examcontroller "https://github.com/klu2300031823/examportal/blob/main/backend/src/main/java/com/klu/ExamController.java"
click node_timedexam "https://github.com/klu2300031823/examportal/tree/main/backend/src/main/java/com/klu"
click node_adminfeatures "https://github.com/klu2300031823/examportal/tree/main/backend/src/main/java/com/klu"
click node_question "https://github.com/klu2300031823/examportal/blob/main/backend/src/main/java/com/klu/Question.java"
click node_questionrepo "https://github.com/klu2300031823/examportal/blob/main/backend/src/main/java/com/klu/QuestionRepository.java"
click node_users "https://github.com/klu2300031823/examportal/blob/main/backend/src/main/java/com/klu/Users.java"
click node_usersrepo "https://github.com/klu2300031823/examportal/blob/main/backend/src/main/java/com/klu/UsersRepository.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_login,node_register,node_admin,node_user,node_api toneBlue
class node_logincontroller,node_loginservice,node_usercontroller,node_usersmanager,node_jwt,node_mysql toneAmber
class node_examcontroller,node_timedexam,node_adminfeatures toneMint
class node_question,node_questionrepo,node_users,node_usersrepo toneRose
class node_actor toneIndigo
```

## Components

### React Portal

- [Role routing](https://github.com/klu2300031823/examportal/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Login form](https://github.com/klu2300031823/examportal/blob/main/frontend/src/components/Login.jsx): `frontend/src/components/Login.jsx`
- [Registration form](https://github.com/klu2300031823/examportal/blob/main/frontend/src/components/Register.jsx): `frontend/src/components/Register.jsx`
- [Admin panel](https://github.com/klu2300031823/examportal/blob/main/frontend/src/components/AdminPanel.jsx): `frontend/src/components/AdminPanel.jsx`
- [User panel](https://github.com/klu2300031823/examportal/blob/main/frontend/src/components/UserPanel.jsx): `frontend/src/components/UserPanel.jsx`
- [API helper](https://github.com/klu2300031823/examportal/blob/main/frontend/src/components/api.js): `frontend/src/components/api.js`

### Identity Services

- [Login endpoint](https://github.com/klu2300031823/examportal/blob/main/backend/src/main/java/com/klu/LoginController.java): `backend/src/main/java/com/klu/LoginController.java`
- [Login validation](https://github.com/klu2300031823/examportal/blob/main/backend/src/main/java/com/klu/LoginService.java): `backend/src/main/java/com/klu/LoginService.java`
- [User endpoints](https://github.com/klu2300031823/examportal/blob/main/backend/src/main/java/com/klu/UserController.java): `backend/src/main/java/com/klu/UserController.java`
- [User operations](https://github.com/klu2300031823/examportal/blob/main/backend/src/main/java/com/klu/UsersManager.java): `backend/src/main/java/com/klu/UsersManager.java`
- [JWT manager](https://github.com/klu2300031823/examportal/blob/main/backend/src/main/java/com/klu/JWTManager.java): `backend/src/main/java/com/klu/JWTManager.java`

### Exam Services

- [Exam operations](https://github.com/klu2300031823/examportal/blob/main/backend/src/main/java/com/klu/ExamController.java): `backend/src/main/java/com/klu/ExamController.java`
- [Timed exam](https://github.com/klu2300031823/examportal/tree/main/backend/src/main/java/com/klu): `backend/src/main/java/com/klu`
- [Admin question and marks](https://github.com/klu2300031823/examportal/tree/main/backend/src/main/java/com/klu): `backend/src/main/java/com/klu`

### Domain Persistence

- [Question entity](https://github.com/klu2300031823/examportal/blob/main/backend/src/main/java/com/klu/Question.java): `backend/src/main/java/com/klu/Question.java`
- [Question repository](https://github.com/klu2300031823/examportal/blob/main/backend/src/main/java/com/klu/QuestionRepository.java): `backend/src/main/java/com/klu/QuestionRepository.java`
- [User entity](https://github.com/klu2300031823/examportal/blob/main/backend/src/main/java/com/klu/Users.java): `backend/src/main/java/com/klu/Users.java`
- [User repository](https://github.com/klu2300031823/examportal/blob/main/backend/src/main/java/com/klu/UsersRepository.java): `backend/src/main/java/com/klu/UsersRepository.java`

### Other components

- **Portal visitor**
- **MySQL-compatible store**

## Connections

- Portal visitor → Role routing: opens
- Role routing → Login form: renders (evidence: `frontend/src/App.jsx`)
- Role routing → Registration form: renders (evidence: `frontend/src/App.jsx`)
- Role routing → Admin panel: renders by role (evidence: `frontend/src/App.jsx`)
- Role routing → User panel: renders by role (evidence: `frontend/src/App.jsx`)
- Login endpoint → Login validation: delegates to (evidence: `backend/src/main/java/com/klu/LoginController.java`)
- Login validation → User repository: looks up users (evidence: `backend/src/main/java/com/klu/LoginService.java`)
- Login validation → User entity: checks credentials (evidence: `backend/src/main/java/com/klu/LoginService.java`)
- User endpoints → User operations: delegates to (evidence: `backend/src/main/java/com/klu/UserController.java`)
- User operations → JWT manager: generates and validates (evidence: `backend/src/main/java/com/klu/UsersManager.java`)
- User operations → User repository: reads and writes (evidence: `backend/src/main/java/com/klu/UsersManager.java`)
- User operations → User entity: uses records (evidence: `backend/src/main/java/com/klu/UsersManager.java`)
- Exam operations → Question repository: reads and saves (evidence: `backend/src/main/java/com/klu/ExamController.java`)
- Exam operations → Question entity: scores answers (evidence: `backend/src/main/java/com/klu/ExamController.java`)
- Question repository → Question entity: stores (evidence: `backend/src/main/java/com/klu/QuestionRepository.java`)
- User repository → User entity: stores (evidence: `backend/src/main/java/com/klu/UsersRepository.java`)
- User panel → Timed exam: takes exam (evidence: `README.md`)
- Timed exam → Exam operations: submits answers (evidence: `backend/src/main/java/com/klu/ExamController.java`)
- Admin panel → Admin question and marks: manages questions (evidence: `README.md`)
- Admin question and marks → Exam operations: uses exam operations (evidence: `backend/src/main/java/com/klu/ExamController.java`)
- Question repository → MySQL-compatible store: persists to
- User repository → MySQL-compatible store: persists to
