# deviron01/authenticationsystem architecture

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

- Interactive diagram: https://gitdiagram.com/deviron01/authenticationsystem
- Repository: https://github.com/deviron01/authenticationsystem

## Overview

This is a Spring Boot JWT authentication service. Clients register or log in through the auth API; the service stores BCrypt-hashed credentials and returns a signed JWT. Later requests pass through the JWT filter, which reloads the user and establishes Spring Security authentication for protected resources. The README also describes admin management and role-based access, but the tree contains no admin controller or service, so those capabilities are shown as documented, not verified implementation. Edges reflect sampled source references or README statements; unsampled admin wiring is not asserted.

Main entry points: [`src/main/java/com/deviron/AuthenticationSystem/Controller/AuthController.java`](https://github.com/deviron01/authenticationsystem/blob/main/src/main/java/com/deviron/AuthenticationSystem/Controller/AuthController.java) (Auth endpoints), [`src/main/java/com/deviron/AuthenticationSystem/Service/IMPL/AuthServiceImpl.java`](https://github.com/deviron01/authenticationsystem/blob/main/src/main/java/com/deviron/AuthenticationSystem/Service/IMPL/AuthServiceImpl.java) (Registration and login), [`src/main/java/com/deviron/AuthenticationSystem/Security/JwtAuthFilter.java`](https://github.com/deviron01/authenticationsystem/blob/main/src/main/java/com/deviron/AuthenticationSystem/Security/JwtAuthFilter.java) (Bearer token filter), [`src/main/java/com/deviron/AuthenticationSystem/Repository/UserRepo.java`](https://github.com/deviron01/authenticationsystem/blob/main/src/main/java/com/deviron/AuthenticationSystem/Repository/UserRepo.java) (User repository)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["REST API"]
  node_auth_controller["Auth endpoints"]
  node_admin_api["Admin management"]
  node_register_dto["Registration input<br/>[RegisterDTO.java]"]
  node_login_dto["Login input<br/>[LoginDTO.java]"]
  node_auth_response["Token response"]
end

subgraph group_auth["Authentication"]
  node_auth_service["Auth contract<br/>[AuthService.java]"]
  node_auth_impl["Registration and login"]
  node_app_config["Password encoder config"]
end

subgraph group_security["Request Security"]
  node_jwt_service["JWT issuance and parsing<br/>[JwtService.java]"]
  node_security_config["Security policy"]
  node_jwt_filter["Bearer token filter<br/>[JwtAuthFilter.java]"]
end

subgraph group_data["User Data"]
  node_user["User entity<br/>[User.java]"]
  node_user_repo["User repository<br/>[UserRepo.java]"]
end

node_client(("API client"))
node_mysql[("MySQL database")]

node_client -->|"calls auth API"| node_auth_controller
node_client -->|"calls admin API"| node_admin_api
node_auth_controller -->|"delegates to"| node_auth_service
node_auth_controller -->|"accepts registration"| node_register_dto
node_auth_controller -->|"accepts credentials"| node_login_dto
node_auth_controller -->|"returns token response"| node_auth_response
node_auth_service -->|"implemented by"| node_auth_impl
node_auth_impl -->|"checks and persists"| node_user_repo
node_auth_impl -->|"issues token"| node_jwt_service
node_auth_impl -.->|"uses password encoder"| node_app_config
node_auth_impl -->|"creates user"| node_user
node_user_repo -->|"stores entity"| node_user
node_user_repo -->|"reads and writes"| node_mysql
node_security_config -->|"registers filter"| node_jwt_filter
node_jwt_filter -->|"validates token"| node_jwt_service
node_jwt_filter -->|"loads current user"| node_user_repo
node_jwt_filter -->|"sets authenticated user"| node_user
node_client -->|"sends bearer token"| node_jwt_filter

click node_auth_controller "https://github.com/deviron01/authenticationsystem/blob/main/src/main/java/com/deviron/AuthenticationSystem/Controller/AuthController.java"
click node_admin_api "https://github.com/deviron01/authenticationsystem/tree/main/src/main/java/com/deviron/AuthenticationSystem/Controller"
click node_register_dto "https://github.com/deviron01/authenticationsystem/blob/main/src/main/java/com/deviron/AuthenticationSystem/DTO/RegisterDTO.java"
click node_login_dto "https://github.com/deviron01/authenticationsystem/blob/main/src/main/java/com/deviron/AuthenticationSystem/DTO/LoginDTO.java"
click node_auth_response "https://github.com/deviron01/authenticationsystem/blob/main/src/main/java/com/deviron/AuthenticationSystem/DTO/AuthResponseDTO.java"
click node_auth_service "https://github.com/deviron01/authenticationsystem/blob/main/src/main/java/com/deviron/AuthenticationSystem/Service/AuthService.java"
click node_auth_impl "https://github.com/deviron01/authenticationsystem/blob/main/src/main/java/com/deviron/AuthenticationSystem/Service/IMPL/AuthServiceImpl.java"
click node_jwt_service "https://github.com/deviron01/authenticationsystem/blob/main/src/main/java/com/deviron/AuthenticationSystem/Security/JwtService.java"
click node_security_config "https://github.com/deviron01/authenticationsystem/blob/main/src/main/java/com/deviron/AuthenticationSystem/Security/SecurityConfig.java"
click node_jwt_filter "https://github.com/deviron01/authenticationsystem/blob/main/src/main/java/com/deviron/AuthenticationSystem/Security/JwtAuthFilter.java"
click node_app_config "https://github.com/deviron01/authenticationsystem/blob/main/src/main/java/com/deviron/AuthenticationSystem/Config/ApplicationConfig.java"
click node_user "https://github.com/deviron01/authenticationsystem/blob/main/src/main/java/com/deviron/AuthenticationSystem/Entity/User.java"
click node_user_repo "https://github.com/deviron01/authenticationsystem/blob/main/src/main/java/com/deviron/AuthenticationSystem/Repository/UserRepo.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_auth_controller,node_admin_api,node_register_dto,node_login_dto,node_auth_response,node_client toneBlue
class node_auth_service,node_auth_impl,node_app_config,node_mysql toneAmber
class node_jwt_service,node_security_config,node_jwt_filter toneMint
class node_user,node_user_repo toneRose
```

## Components

### REST API

- [Auth endpoints](https://github.com/deviron01/authenticationsystem/blob/main/src/main/java/com/deviron/AuthenticationSystem/Controller/AuthController.java): `src/main/java/com/deviron/AuthenticationSystem/Controller/AuthController.java`
- [Admin management](https://github.com/deviron01/authenticationsystem/tree/main/src/main/java/com/deviron/AuthenticationSystem/Controller): `src/main/java/com/deviron/AuthenticationSystem/Controller`
- [Registration input](https://github.com/deviron01/authenticationsystem/blob/main/src/main/java/com/deviron/AuthenticationSystem/DTO/RegisterDTO.java): `src/main/java/com/deviron/AuthenticationSystem/DTO/RegisterDTO.java`
- [Login input](https://github.com/deviron01/authenticationsystem/blob/main/src/main/java/com/deviron/AuthenticationSystem/DTO/LoginDTO.java): `src/main/java/com/deviron/AuthenticationSystem/DTO/LoginDTO.java`
- [Token response](https://github.com/deviron01/authenticationsystem/blob/main/src/main/java/com/deviron/AuthenticationSystem/DTO/AuthResponseDTO.java): `src/main/java/com/deviron/AuthenticationSystem/DTO/AuthResponseDTO.java`

### Authentication

- [Auth contract](https://github.com/deviron01/authenticationsystem/blob/main/src/main/java/com/deviron/AuthenticationSystem/Service/AuthService.java): `src/main/java/com/deviron/AuthenticationSystem/Service/AuthService.java`
- [Registration and login](https://github.com/deviron01/authenticationsystem/blob/main/src/main/java/com/deviron/AuthenticationSystem/Service/IMPL/AuthServiceImpl.java): `src/main/java/com/deviron/AuthenticationSystem/Service/IMPL/AuthServiceImpl.java`
- [Password encoder config](https://github.com/deviron01/authenticationsystem/blob/main/src/main/java/com/deviron/AuthenticationSystem/Config/ApplicationConfig.java): `src/main/java/com/deviron/AuthenticationSystem/Config/ApplicationConfig.java`

### Request Security

- [JWT issuance and parsing](https://github.com/deviron01/authenticationsystem/blob/main/src/main/java/com/deviron/AuthenticationSystem/Security/JwtService.java): `src/main/java/com/deviron/AuthenticationSystem/Security/JwtService.java`
- [Security policy](https://github.com/deviron01/authenticationsystem/blob/main/src/main/java/com/deviron/AuthenticationSystem/Security/SecurityConfig.java): `src/main/java/com/deviron/AuthenticationSystem/Security/SecurityConfig.java`
- [Bearer token filter](https://github.com/deviron01/authenticationsystem/blob/main/src/main/java/com/deviron/AuthenticationSystem/Security/JwtAuthFilter.java): `src/main/java/com/deviron/AuthenticationSystem/Security/JwtAuthFilter.java`

### User Data

- [User entity](https://github.com/deviron01/authenticationsystem/blob/main/src/main/java/com/deviron/AuthenticationSystem/Entity/User.java): `src/main/java/com/deviron/AuthenticationSystem/Entity/User.java`
- [User repository](https://github.com/deviron01/authenticationsystem/blob/main/src/main/java/com/deviron/AuthenticationSystem/Repository/UserRepo.java): `src/main/java/com/deviron/AuthenticationSystem/Repository/UserRepo.java`

### Other components

- **API client**
- **MySQL database**

## Connections

- API client → Auth endpoints: calls auth API (evidence: `README.md`)
- API client → Admin management: calls admin API (evidence: `README.md`)
- Auth endpoints → Auth contract: delegates to (evidence: `src/main/java/com/deviron/AuthenticationSystem/Controller/AuthController.java`)
- Auth endpoints → Registration input: accepts registration (evidence: `src/main/java/com/deviron/AuthenticationSystem/Controller/AuthController.java`)
- Auth endpoints → Login input: accepts credentials (evidence: `src/main/java/com/deviron/AuthenticationSystem/Controller/AuthController.java`)
- Auth endpoints → Token response: returns token response (evidence: `src/main/java/com/deviron/AuthenticationSystem/Controller/AuthController.java`)
- Auth contract → Registration and login: implemented by (evidence: `src/main/java/com/deviron/AuthenticationSystem/Service/IMPL/AuthServiceImpl.java`)
- Registration and login → User repository: checks and persists (evidence: `src/main/java/com/deviron/AuthenticationSystem/Service/IMPL/AuthServiceImpl.java`)
- Registration and login → JWT issuance and parsing: issues token (evidence: `src/main/java/com/deviron/AuthenticationSystem/Service/IMPL/AuthServiceImpl.java`)
- Registration and login → Password encoder config: uses password encoder
- Registration and login → User entity: creates user (evidence: `src/main/java/com/deviron/AuthenticationSystem/Service/IMPL/AuthServiceImpl.java`)
- User repository → User entity: stores entity (evidence: `src/main/java/com/deviron/AuthenticationSystem/Repository/UserRepo.java`)
- User repository → MySQL database: reads and writes (evidence: `README.md`)
- Security policy → Bearer token filter: registers filter (evidence: `src/main/java/com/deviron/AuthenticationSystem/Security/SecurityConfig.java`)
- Bearer token filter → JWT issuance and parsing: validates token (evidence: `src/main/java/com/deviron/AuthenticationSystem/Security/JwtAuthFilter.java`)
- Bearer token filter → User repository: loads current user (evidence: `src/main/java/com/deviron/AuthenticationSystem/Security/JwtAuthFilter.java`)
- Bearer token filter → User entity: sets authenticated user (evidence: `src/main/java/com/deviron/AuthenticationSystem/Security/JwtAuthFilter.java`)
- API client → Bearer token filter: sends bearer token (evidence: `README.md`)
