# nibinrj/quiz architecture

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

## Overview

Quiz System is a Spring Boot backend for user registration and authentication and quiz-question management. The visible request flow runs from HTTP controllers through services to Spring Data repositories; JWT filtering and user-details loading support protected requests. The model also defines quizzes, categories, subscriptions, and attempts, although their full runtime flows are not shown. The README describes a containerized AWS App Runner deployment with a private RDS PostgreSQL database reached through a VPC Connector. Cloud links reflect that documentation; unsampled quiz lifecycle wiring is omitted.

Main entry points: [`src/main/java/com/nibin/quiz/Service/UserService.java`](https://github.com/nibinrj/quiz/blob/master/src/main/java/com/nibin/quiz/Service/UserService.java) (User Service), [`src/main/java/com/nibin/quiz/Controller/Usercontroller.java`](https://github.com/nibinrj/quiz/blob/master/src/main/java/com/nibin/quiz/Controller/Usercontroller.java) (User Controller), [`src/main/java/com/nibin/quiz/config/JwtFilter.java`](https://github.com/nibinrj/quiz/blob/master/src/main/java/com/nibin/quiz/config/JwtFilter.java) (JWT Filter), [`src/main/java/com/nibin/quiz/Repository/UserRepo.java`](https://github.com/nibinrj/quiz/blob/master/src/main/java/com/nibin/quiz/Repository/UserRepo.java) (User Repository)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["HTTP API"]
  node_user_controller["User Controller"]
  node_quiz_controller["Quiz Controller"]
  node_request_dtos["Request DTOs"]
  node_response_dtos["Response DTOs"]
end

subgraph group_identity["Identity and Security"]
  node_user_service["User Service<br/>[UserService.java]"]
  node_jwt_service["JWT Service<br/>[JWTservice.java]"]
  node_jwt_filter["JWT Filter<br/>[JwtFilter.java]"]
  node_user_details["User Details"]
  node_security_config["Security Configuration"]
  node_user_records["User and Categories<br/>[Users.java]"]
end

subgraph group_quiz["Quiz Domain"]
  node_quiz_service["Quiz Service<br/>[QuizService.java]"]
  node_quiz_records["Quiz and Questions<br/>[Quiz.java]"]
  node_attempt_records["Quiz Attempts<br/>[QuizAttempt.java]"]
end

subgraph group_persistence["Persistence and Cloud"]
  node_user_repo["User Repository<br/>[UserRepo.java]"]
  node_quiz_repo["Quiz Repository<br/>[QuizRepo.java]"]
  node_attempt_repo["Attempt Repository"]
  node_app_runner["AWS App Runner"]
  node_vpc_connector{{"VPC Connector"}}
  node_rds[("RDS PostgreSQL")]
end

node_client(("API Client"))

node_client -->|"sends requests"| node_user_controller
node_client -->|"sends requests"| node_quiz_controller
node_user_controller -->|"delegates to"| node_user_service
node_user_controller -->|"accepts"| node_request_dtos
node_user_controller -->|"returns"| node_response_dtos
node_quiz_controller -->|"delegates to"| node_quiz_service
node_user_service -->|"saves users"| node_user_repo
node_user_service -->|"generates tokens"| node_jwt_service
node_user_service -->|"creates users"| node_user_records
node_user_service -->|"reads registration"| node_request_dtos
node_user_service -->|"builds response"| node_response_dtos
node_jwt_filter -->|"validates tokens"| node_jwt_service
node_jwt_filter -->|"loads identity"| node_user_details
node_user_details -->|"looks up user"| node_user_repo
node_security_config -->|"registers filter"| node_jwt_filter
node_quiz_service -->|"reads and writes"| node_quiz_repo
node_quiz_repo -->|"persists"| node_quiz_records
node_user_repo -->|"persists"| node_user_records
node_attempt_repo -->|"persists"| node_attempt_records
node_quiz_records -->|"references categories"| node_user_records
node_app_runner -.->|"connects privately"| node_vpc_connector
node_vpc_connector -.->|"reaches database"| node_rds

click node_user_controller "https://github.com/nibinrj/quiz/blob/master/src/main/java/com/nibin/quiz/Controller/Usercontroller.java"
click node_quiz_controller "https://github.com/nibinrj/quiz/blob/master/src/main/java/com/nibin/quiz/Controller/QuizController.java"
click node_request_dtos "https://github.com/nibinrj/quiz/tree/master/src/main/java/com/nibin/quiz/DTO"
click node_response_dtos "https://github.com/nibinrj/quiz/tree/master/src/main/java/com/nibin/quiz/DTO"
click node_user_service "https://github.com/nibinrj/quiz/blob/master/src/main/java/com/nibin/quiz/Service/UserService.java"
click node_jwt_service "https://github.com/nibinrj/quiz/blob/master/src/main/java/com/nibin/quiz/Service/JWTservice.java"
click node_jwt_filter "https://github.com/nibinrj/quiz/blob/master/src/main/java/com/nibin/quiz/config/JwtFilter.java"
click node_user_details "https://github.com/nibinrj/quiz/blob/master/src/main/java/com/nibin/quiz/Service/MyUserDetailsService.java"
click node_security_config "https://github.com/nibinrj/quiz/blob/master/src/main/java/com/nibin/quiz/config/securityconfig.java"
click node_quiz_service "https://github.com/nibinrj/quiz/blob/master/src/main/java/com/nibin/quiz/Service/QuizService.java"
click node_quiz_records "https://github.com/nibinrj/quiz/blob/master/src/main/java/com/nibin/quiz/Model/Quiz.java"
click node_attempt_records "https://github.com/nibinrj/quiz/blob/master/src/main/java/com/nibin/quiz/Model/QuizAttempt.java"
click node_user_records "https://github.com/nibinrj/quiz/blob/master/src/main/java/com/nibin/quiz/Model/Users.java"
click node_user_repo "https://github.com/nibinrj/quiz/blob/master/src/main/java/com/nibin/quiz/Repository/UserRepo.java"
click node_quiz_repo "https://github.com/nibinrj/quiz/blob/master/src/main/java/com/nibin/quiz/Repository/QuizRepo.java"
click node_attempt_repo "https://github.com/nibinrj/quiz/blob/master/src/main/java/com/nibin/quiz/Repository/QuizAttemptRepo.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_user_controller,node_quiz_controller,node_request_dtos,node_response_dtos,node_client toneBlue
class node_user_service,node_jwt_service,node_jwt_filter,node_user_details,node_security_config,node_user_records toneAmber
class node_quiz_service,node_quiz_records,node_attempt_records toneMint
class node_user_repo,node_quiz_repo,node_attempt_repo,node_app_runner,node_vpc_connector,node_rds toneRose
```

## Components

### HTTP API

- [User Controller](https://github.com/nibinrj/quiz/blob/master/src/main/java/com/nibin/quiz/Controller/Usercontroller.java): `src/main/java/com/nibin/quiz/Controller/Usercontroller.java`
- [Quiz Controller](https://github.com/nibinrj/quiz/blob/master/src/main/java/com/nibin/quiz/Controller/QuizController.java): `src/main/java/com/nibin/quiz/Controller/QuizController.java`
- [Request DTOs](https://github.com/nibinrj/quiz/tree/master/src/main/java/com/nibin/quiz/DTO): `src/main/java/com/nibin/quiz/DTO`
- [Response DTOs](https://github.com/nibinrj/quiz/tree/master/src/main/java/com/nibin/quiz/DTO): `src/main/java/com/nibin/quiz/DTO`

### Identity and Security

- [User Service](https://github.com/nibinrj/quiz/blob/master/src/main/java/com/nibin/quiz/Service/UserService.java): `src/main/java/com/nibin/quiz/Service/UserService.java`
- [JWT Service](https://github.com/nibinrj/quiz/blob/master/src/main/java/com/nibin/quiz/Service/JWTservice.java): `src/main/java/com/nibin/quiz/Service/JWTservice.java`
- [JWT Filter](https://github.com/nibinrj/quiz/blob/master/src/main/java/com/nibin/quiz/config/JwtFilter.java): `src/main/java/com/nibin/quiz/config/JwtFilter.java`
- [User Details](https://github.com/nibinrj/quiz/blob/master/src/main/java/com/nibin/quiz/Service/MyUserDetailsService.java): `src/main/java/com/nibin/quiz/Service/MyUserDetailsService.java`
- [Security Configuration](https://github.com/nibinrj/quiz/blob/master/src/main/java/com/nibin/quiz/config/securityconfig.java): `src/main/java/com/nibin/quiz/config/securityconfig.java`
- [User and Categories](https://github.com/nibinrj/quiz/blob/master/src/main/java/com/nibin/quiz/Model/Users.java): `src/main/java/com/nibin/quiz/Model/Users.java`

### Quiz Domain

- [Quiz Service](https://github.com/nibinrj/quiz/blob/master/src/main/java/com/nibin/quiz/Service/QuizService.java): `src/main/java/com/nibin/quiz/Service/QuizService.java`
- [Quiz and Questions](https://github.com/nibinrj/quiz/blob/master/src/main/java/com/nibin/quiz/Model/Quiz.java): `src/main/java/com/nibin/quiz/Model/Quiz.java`
- [Quiz Attempts](https://github.com/nibinrj/quiz/blob/master/src/main/java/com/nibin/quiz/Model/QuizAttempt.java): `src/main/java/com/nibin/quiz/Model/QuizAttempt.java`

### Persistence and Cloud

- [User Repository](https://github.com/nibinrj/quiz/blob/master/src/main/java/com/nibin/quiz/Repository/UserRepo.java): `src/main/java/com/nibin/quiz/Repository/UserRepo.java`
- [Quiz Repository](https://github.com/nibinrj/quiz/blob/master/src/main/java/com/nibin/quiz/Repository/QuizRepo.java): `src/main/java/com/nibin/quiz/Repository/QuizRepo.java`
- [Attempt Repository](https://github.com/nibinrj/quiz/blob/master/src/main/java/com/nibin/quiz/Repository/QuizAttemptRepo.java): `src/main/java/com/nibin/quiz/Repository/QuizAttemptRepo.java`
- **AWS App Runner**
- **VPC Connector**
- **RDS PostgreSQL**

### Other components

- **API Client**

## Connections

- API Client → User Controller: sends requests (evidence: `src/main/java/com/nibin/quiz/Controller/Usercontroller.java`)
- API Client → Quiz Controller: sends requests (evidence: `src/main/java/com/nibin/quiz/Controller/QuizController.java`)
- User Controller → User Service: delegates to (evidence: `src/main/java/com/nibin/quiz/Controller/Usercontroller.java`)
- User Controller → Request DTOs: accepts (evidence: `src/main/java/com/nibin/quiz/Controller/Usercontroller.java`)
- User Controller → Response DTOs: returns (evidence: `src/main/java/com/nibin/quiz/Controller/Usercontroller.java`)
- Quiz Controller → Quiz Service: delegates to (evidence: `src/main/java/com/nibin/quiz/Controller/QuizController.java`)
- User Service → User Repository: saves users (evidence: `src/main/java/com/nibin/quiz/Service/UserService.java`)
- User Service → JWT Service: generates tokens (evidence: `src/main/java/com/nibin/quiz/Service/UserService.java`)
- User Service → User and Categories: creates users (evidence: `src/main/java/com/nibin/quiz/Service/UserService.java`)
- User Service → Request DTOs: reads registration (evidence: `src/main/java/com/nibin/quiz/Service/UserService.java`)
- User Service → Response DTOs: builds response (evidence: `src/main/java/com/nibin/quiz/Service/UserService.java`)
- JWT Filter → JWT Service: validates tokens (evidence: `src/main/java/com/nibin/quiz/config/JwtFilter.java`)
- JWT Filter → User Details: loads identity (evidence: `src/main/java/com/nibin/quiz/config/JwtFilter.java`)
- User Details → User Repository: looks up user (evidence: `src/main/java/com/nibin/quiz/Service/MyUserDetailsService.java`)
- Security Configuration → JWT Filter: registers filter (evidence: `src/main/java/com/nibin/quiz/config/securityconfig.java`)
- Quiz Service → Quiz Repository: reads and writes (evidence: `src/main/java/com/nibin/quiz/Service/QuizService.java`)
- Quiz Repository → Quiz and Questions: persists (evidence: `src/main/java/com/nibin/quiz/Repository/QuizRepo.java`)
- User Repository → User and Categories: persists (evidence: `src/main/java/com/nibin/quiz/Repository/UserRepo.java`)
- Attempt Repository → Quiz Attempts: persists (evidence: `src/main/java/com/nibin/quiz/Repository/QuizAttemptRepo.java`)
- Quiz and Questions → User and Categories: references categories (evidence: `src/main/java/com/nibin/quiz/Model/Quiz.java`)
- AWS App Runner → VPC Connector: connects privately (evidence: `README.md`)
- VPC Connector → RDS PostgreSQL: reaches database (evidence: `README.md`)
