# anushkagupta12/spring-boot-authentication-system architecture

> Architecture diagram of the GitHub repository anushkagupta12/spring-boot-authentication-system, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/anushkagupta12/spring-boot-authentication-system
- Repository: https://github.com/anushkagupta12/spring-boot-authentication-system

## Overview

This is a Spring Boot REST authentication system. Its main user journey is registration, login to obtain a JWT, then use of that token on protected, role-restricted routes. The graph reflects the README’s documented controller/service/repository layers, persistence, security, caching, API documentation, and monitoring. Source excerpts were unavailable, so relationships are based on README statements; implementation-level call ownership cannot be verified.

Main entry points: [`src/main/java/org/example/controller/AuthController.java`](https://github.com/anushkagupta12/spring-boot-authentication-system/blob/main/src/main/java/org/example/controller/AuthController.java) (Auth Controller), [`src/main/java/org/example/service/AuthService.java`](https://github.com/anushkagupta12/spring-boot-authentication-system/blob/main/src/main/java/org/example/service/AuthService.java) (Auth Service), [`src/main/java/org/example/repository/UserRepository.java`](https://github.com/anushkagupta12/spring-boot-authentication-system/blob/main/src/main/java/org/example/repository/UserRepository.java) (User Repository), [`src/main/java/org/example/controller/TestController.java`](https://github.com/anushkagupta12/spring-boot-authentication-system/blob/main/src/main/java/org/example/controller/TestController.java) (Protected Routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["REST API"]
  node_auth_controller["Auth Controller"]
  node_test_controller["Protected Routes"]
  node_request_models["Auth Request DTOs"]
  node_exception_handler["Error Responses"]
end

subgraph group_identity["Identity &amp; Security"]
  node_auth_service["Auth Service<br/>[AuthService.java]"]
  node_jwt_service["JWT Service<br/>[JwtService.java]"]
  node_jwt_filter["JWT Filter"]
  node_security_config["Security Rules"]
  node_user_details["User Details"]
end

subgraph group_data["Data &amp; Caching"]
  node_user_entity["User Entity<br/>[User.java]"]
  node_user_repository["User Repository"]
  node_mysql[("MySQL")]
  node_cache_service["Cache Demo Service"]
  node_redis_config["Redis Configuration<br/>[RedisConfig.java]"]
  node_redis[("Redis")]
end

subgraph group_operations["API &amp; Operations"]
  node_openapi["OpenAPI Configuration<br/>[OpenApiConfig.java]"]
  node_actuator["Health &amp; Metrics"]
end

node_client(("API Client"))

node_client -->|"submits auth requests"| node_auth_controller
node_client -->|"calls protected routes"| node_test_controller
node_auth_controller -->|"controller to service"| node_auth_service
node_test_controller -->|"subject to access rules"| node_security_config
node_auth_service -->|"service to repository"| node_user_repository
node_user_repository -->|"persists user data"| node_mysql
node_auth_service -.->|"issues JWT"| node_jwt_service
node_client -->|"sends bearer token"| node_jwt_filter
node_jwt_filter -->|"enters security chain"| node_security_config
node_user_details -.->|"loads user"| node_user_repository
node_auth_controller -->|"accepts validated input"| node_request_models
node_cache_service -->|"uses cache"| node_redis
node_redis_config -.->|"configures connection"| node_redis
node_auth_controller -->|"errors handled centrally"| node_exception_handler
node_client -->|"explores API"| node_openapi
node_client -->|"checks health and metrics"| node_actuator

click node_auth_controller "https://github.com/anushkagupta12/spring-boot-authentication-system/blob/main/src/main/java/org/example/controller/AuthController.java"
click node_test_controller "https://github.com/anushkagupta12/spring-boot-authentication-system/blob/main/src/main/java/org/example/controller/TestController.java"
click node_auth_service "https://github.com/anushkagupta12/spring-boot-authentication-system/blob/main/src/main/java/org/example/service/AuthService.java"
click node_jwt_service "https://github.com/anushkagupta12/spring-boot-authentication-system/blob/main/src/main/java/org/example/service/JwtService.java"
click node_jwt_filter "https://github.com/anushkagupta12/spring-boot-authentication-system/blob/main/src/main/java/org/example/config/JwtAuthenticationFilter.java"
click node_security_config "https://github.com/anushkagupta12/spring-boot-authentication-system/blob/main/src/main/java/org/example/config/SecurityConfig.java"
click node_user_details "https://github.com/anushkagupta12/spring-boot-authentication-system/blob/main/src/main/java/org/example/service/CustomUserDetailsService.java"
click node_request_models "https://github.com/anushkagupta12/spring-boot-authentication-system/tree/main/src/main/java/org/example/dto"
click node_user_entity "https://github.com/anushkagupta12/spring-boot-authentication-system/blob/main/src/main/java/org/example/entity/User.java"
click node_user_repository "https://github.com/anushkagupta12/spring-boot-authentication-system/blob/main/src/main/java/org/example/repository/UserRepository.java"
click node_cache_service "https://github.com/anushkagupta12/spring-boot-authentication-system/blob/main/src/main/java/org/example/service/CacheDemoService.java"
click node_redis_config "https://github.com/anushkagupta12/spring-boot-authentication-system/blob/main/src/main/java/org/example/config/RedisConfig.java"
click node_exception_handler "https://github.com/anushkagupta12/spring-boot-authentication-system/blob/main/src/main/java/org/example/exception/GlobalExceptionHandler.java"
click node_openapi "https://github.com/anushkagupta12/spring-boot-authentication-system/blob/main/src/main/java/org/example/config/OpenApiConfig.java"
click node_actuator "https://github.com/anushkagupta12/spring-boot-authentication-system/tree/main/src/main/resources"

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_auth_controller,node_test_controller,node_request_models,node_exception_handler,node_client toneBlue
class node_auth_service,node_jwt_service,node_jwt_filter,node_security_config,node_user_details toneAmber
class node_user_entity,node_user_repository,node_mysql,node_cache_service,node_redis_config,node_redis toneMint
class node_openapi,node_actuator toneRose
```

## Components

### REST API

- [Auth Controller](https://github.com/anushkagupta12/spring-boot-authentication-system/blob/main/src/main/java/org/example/controller/AuthController.java): `src/main/java/org/example/controller/AuthController.java`
- [Protected Routes](https://github.com/anushkagupta12/spring-boot-authentication-system/blob/main/src/main/java/org/example/controller/TestController.java): `src/main/java/org/example/controller/TestController.java`
- [Auth Request DTOs](https://github.com/anushkagupta12/spring-boot-authentication-system/tree/main/src/main/java/org/example/dto): `src/main/java/org/example/dto`
- [Error Responses](https://github.com/anushkagupta12/spring-boot-authentication-system/blob/main/src/main/java/org/example/exception/GlobalExceptionHandler.java): `src/main/java/org/example/exception/GlobalExceptionHandler.java`

### Identity & Security

- [Auth Service](https://github.com/anushkagupta12/spring-boot-authentication-system/blob/main/src/main/java/org/example/service/AuthService.java): `src/main/java/org/example/service/AuthService.java`
- [JWT Service](https://github.com/anushkagupta12/spring-boot-authentication-system/blob/main/src/main/java/org/example/service/JwtService.java): `src/main/java/org/example/service/JwtService.java`
- [JWT Filter](https://github.com/anushkagupta12/spring-boot-authentication-system/blob/main/src/main/java/org/example/config/JwtAuthenticationFilter.java): `src/main/java/org/example/config/JwtAuthenticationFilter.java`
- [Security Rules](https://github.com/anushkagupta12/spring-boot-authentication-system/blob/main/src/main/java/org/example/config/SecurityConfig.java): `src/main/java/org/example/config/SecurityConfig.java`
- [User Details](https://github.com/anushkagupta12/spring-boot-authentication-system/blob/main/src/main/java/org/example/service/CustomUserDetailsService.java): `src/main/java/org/example/service/CustomUserDetailsService.java`

### Data & Caching

- [User Entity](https://github.com/anushkagupta12/spring-boot-authentication-system/blob/main/src/main/java/org/example/entity/User.java): `src/main/java/org/example/entity/User.java`
- [User Repository](https://github.com/anushkagupta12/spring-boot-authentication-system/blob/main/src/main/java/org/example/repository/UserRepository.java): `src/main/java/org/example/repository/UserRepository.java`
- **MySQL**
- [Cache Demo Service](https://github.com/anushkagupta12/spring-boot-authentication-system/blob/main/src/main/java/org/example/service/CacheDemoService.java): `src/main/java/org/example/service/CacheDemoService.java`
- [Redis Configuration](https://github.com/anushkagupta12/spring-boot-authentication-system/blob/main/src/main/java/org/example/config/RedisConfig.java): `src/main/java/org/example/config/RedisConfig.java`
- **Redis**

### API & Operations

- [OpenAPI Configuration](https://github.com/anushkagupta12/spring-boot-authentication-system/blob/main/src/main/java/org/example/config/OpenApiConfig.java): `src/main/java/org/example/config/OpenApiConfig.java`
- [Health & Metrics](https://github.com/anushkagupta12/spring-boot-authentication-system/tree/main/src/main/resources): `src/main/resources`

### Other components

- **API Client**

## Connections

- API Client → Auth Controller: submits auth requests (evidence: `README.md`)
- API Client → Protected Routes: calls protected routes (evidence: `README.md`)
- Auth Controller → Auth Service: controller to service (evidence: `README.md`)
- Protected Routes → Security Rules: subject to access rules (evidence: `README.md`)
- Auth Service → User Repository: service to repository (evidence: `README.md`)
- User Repository → MySQL: persists user data (evidence: `README.md`)
- Auth Service → JWT Service: issues JWT
- API Client → JWT Filter: sends bearer token (evidence: `README.md`)
- JWT Filter → Security Rules: enters security chain (evidence: `README.md`)
- User Details → User Repository: loads user
- Auth Controller → Auth Request DTOs: accepts validated input (evidence: `README.md`)
- Cache Demo Service → Redis: uses cache (evidence: `README.md`)
- Redis Configuration → Redis: configures connection
- Auth Controller → Error Responses: errors handled centrally (evidence: `README.md`)
- API Client → OpenAPI Configuration: explores API (evidence: `README.md`)
- API Client → Health & Metrics: checks health and metrics (evidence: `README.md`)
