# ricardolmessias/auth-crud-api architecture

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

- Interactive diagram: https://gitdiagram.com/ricardolmessias/auth-crud-api
- Repository: https://github.com/ricardolmessias/auth-crud-api

## Overview

Auth CRUD API is a Spring REST service for account management, JWT login, and role-based access. The main workflows are user requests through controllers and services to persistence, and login through credential verification to token generation; later requests can be authenticated by the JWT filter. The README documents role-specific access and standard error responses. Some subsystem links are based on the README or SOURCE INDEX rather than full excerpts, so those links are identified by their evidence source.

Main entry points: [`src/main/java/com/ricardo/authcrud/repository/UserRepository.java`](https://github.com/ricardolmessias/auth-crud-api/blob/main/src/main/java/com/ricardo/authcrud/repository/UserRepository.java) (User Repository), [`src/main/java/com/ricardo/authcrud/service/AuthService.java`](https://github.com/ricardolmessias/auth-crud-api/blob/main/src/main/java/com/ricardo/authcrud/service/AuthService.java) (Authentication Service), [`src/main/java/com/ricardo/authcrud/security/JwtAuthenticationFilter.java`](https://github.com/ricardolmessias/auth-crud-api/blob/main/src/main/java/com/ricardo/authcrud/security/JwtAuthenticationFilter.java) (JWT Authentication Filter), [`src/main/java/com/ricardo/authcrud/service/UserService.java`](https://github.com/ricardolmessias/auth-crud-api/blob/main/src/main/java/com/ricardo/authcrud/service/UserService.java) (User Service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["REST API"]
  node_auth_controller["Auth Controller"]
  node_user_controller["User Controller"]
  node_api_dtos["Request And Response DTOs"]
end

subgraph group_identity["Identity And Access"]
  node_auth_service["Authentication Service<br/>[AuthService.java]"]
  node_jwt_service["JWT Service<br/>[JwtService.java]"]
  node_jwt_filter["JWT Authentication Filter"]
  node_security_config["Security Configuration"]
  node_password_encoder["Password Encoder"]
end

subgraph group_users["User Management"]
  node_user_service["User Service<br/>[UserService.java]"]
  node_user_entity["User Entity<br/>[User.java]"]
  node_role["Access Roles<br/>[Role.java]"]
end

subgraph group_persistence["Persistence And Errors"]
  node_user_repository["User Repository"]
  node_mysql[("MySQL Database")]
  node_error_handler["Global Error Handler"]
end

node_client(("API Client"))

node_client -->|"logs in"| node_auth_controller
node_client -->|"manages users"| node_user_controller
node_auth_controller -->|"delegates to"| node_auth_service
node_user_controller -->|"delegates to"| node_user_service
node_auth_controller -->|"accepts and returns"| node_api_dtos
node_user_controller -->|"accepts and returns"| node_api_dtos
node_auth_service -->|"looks up account"| node_user_repository
node_auth_service -->|"checks password"| node_password_encoder
node_auth_service -->|"generates token"| node_jwt_service
node_user_service -->|"reads and writes"| node_user_repository
node_user_service -->|"hashes password"| node_password_encoder
node_user_service -->|"assigns and checks"| node_role
node_user_repository -->|"persists"| node_user_entity
node_user_repository -.->|"stores records"| node_mysql
node_security_config -->|"configures filter"| node_jwt_filter
node_jwt_filter -->|"validates token"| node_jwt_service
node_jwt_filter -->|"loads account"| node_user_repository
node_jwt_filter -->|"sets authority"| node_role
node_error_handler -->|"formats errors"| node_api_dtos

click node_auth_controller "https://github.com/ricardolmessias/auth-crud-api/blob/main/src/main/java/com/ricardo/authcrud/controller/AuthController.java"
click node_user_controller "https://github.com/ricardolmessias/auth-crud-api/blob/main/src/main/java/com/ricardo/authcrud/controller/UserController.java"
click node_api_dtos "https://github.com/ricardolmessias/auth-crud-api/tree/main/src/main/java/com/ricardo/authcrud/dto"
click node_auth_service "https://github.com/ricardolmessias/auth-crud-api/blob/main/src/main/java/com/ricardo/authcrud/service/AuthService.java"
click node_jwt_service "https://github.com/ricardolmessias/auth-crud-api/blob/main/src/main/java/com/ricardo/authcrud/service/JwtService.java"
click node_jwt_filter "https://github.com/ricardolmessias/auth-crud-api/blob/main/src/main/java/com/ricardo/authcrud/security/JwtAuthenticationFilter.java"
click node_security_config "https://github.com/ricardolmessias/auth-crud-api/blob/main/src/main/java/com/ricardo/authcrud/config/SecurityConfig.java"
click node_user_service "https://github.com/ricardolmessias/auth-crud-api/blob/main/src/main/java/com/ricardo/authcrud/service/UserService.java"
click node_user_entity "https://github.com/ricardolmessias/auth-crud-api/blob/main/src/main/java/com/ricardo/authcrud/entity/User.java"
click node_role "https://github.com/ricardolmessias/auth-crud-api/blob/main/src/main/java/com/ricardo/authcrud/entity/Role.java"
click node_user_repository "https://github.com/ricardolmessias/auth-crud-api/blob/main/src/main/java/com/ricardo/authcrud/repository/UserRepository.java"
click node_error_handler "https://github.com/ricardolmessias/auth-crud-api/blob/main/src/main/java/com/ricardo/authcrud/exception/GlobalExceptionHandler.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_user_controller,node_api_dtos,node_client toneBlue
class node_auth_service,node_jwt_service,node_jwt_filter,node_security_config,node_password_encoder toneAmber
class node_user_service,node_user_entity,node_role toneMint
class node_user_repository,node_mysql,node_error_handler toneRose
```

## Components

### REST API

- [Auth Controller](https://github.com/ricardolmessias/auth-crud-api/blob/main/src/main/java/com/ricardo/authcrud/controller/AuthController.java): `src/main/java/com/ricardo/authcrud/controller/AuthController.java`
- [User Controller](https://github.com/ricardolmessias/auth-crud-api/blob/main/src/main/java/com/ricardo/authcrud/controller/UserController.java): `src/main/java/com/ricardo/authcrud/controller/UserController.java`
- [Request And Response DTOs](https://github.com/ricardolmessias/auth-crud-api/tree/main/src/main/java/com/ricardo/authcrud/dto): `src/main/java/com/ricardo/authcrud/dto`

### Identity And Access

- [Authentication Service](https://github.com/ricardolmessias/auth-crud-api/blob/main/src/main/java/com/ricardo/authcrud/service/AuthService.java): `src/main/java/com/ricardo/authcrud/service/AuthService.java`
- [JWT Service](https://github.com/ricardolmessias/auth-crud-api/blob/main/src/main/java/com/ricardo/authcrud/service/JwtService.java): `src/main/java/com/ricardo/authcrud/service/JwtService.java`
- [JWT Authentication Filter](https://github.com/ricardolmessias/auth-crud-api/blob/main/src/main/java/com/ricardo/authcrud/security/JwtAuthenticationFilter.java): `src/main/java/com/ricardo/authcrud/security/JwtAuthenticationFilter.java`
- [Security Configuration](https://github.com/ricardolmessias/auth-crud-api/blob/main/src/main/java/com/ricardo/authcrud/config/SecurityConfig.java): `src/main/java/com/ricardo/authcrud/config/SecurityConfig.java`
- **Password Encoder**

### User Management

- [User Service](https://github.com/ricardolmessias/auth-crud-api/blob/main/src/main/java/com/ricardo/authcrud/service/UserService.java): `src/main/java/com/ricardo/authcrud/service/UserService.java`
- [User Entity](https://github.com/ricardolmessias/auth-crud-api/blob/main/src/main/java/com/ricardo/authcrud/entity/User.java): `src/main/java/com/ricardo/authcrud/entity/User.java`
- [Access Roles](https://github.com/ricardolmessias/auth-crud-api/blob/main/src/main/java/com/ricardo/authcrud/entity/Role.java): `src/main/java/com/ricardo/authcrud/entity/Role.java`

### Persistence And Errors

- [User Repository](https://github.com/ricardolmessias/auth-crud-api/blob/main/src/main/java/com/ricardo/authcrud/repository/UserRepository.java): `src/main/java/com/ricardo/authcrud/repository/UserRepository.java`
- **MySQL Database**
- [Global Error Handler](https://github.com/ricardolmessias/auth-crud-api/blob/main/src/main/java/com/ricardo/authcrud/exception/GlobalExceptionHandler.java): `src/main/java/com/ricardo/authcrud/exception/GlobalExceptionHandler.java`

### Other components

- **API Client**

## Connections

- API Client → Auth Controller: logs in (evidence: `README.md`)
- API Client → User Controller: manages users (evidence: `README.md`)
- Auth Controller → Authentication Service: delegates to (evidence: `src/main/java/com/ricardo/authcrud/controller/AuthController.java`)
- User Controller → User Service: delegates to (evidence: `src/main/java/com/ricardo/authcrud/controller/UserController.java`)
- Auth Controller → Request And Response DTOs: accepts and returns (evidence: `src/main/java/com/ricardo/authcrud/controller/AuthController.java`)
- User Controller → Request And Response DTOs: accepts and returns (evidence: `src/main/java/com/ricardo/authcrud/controller/UserController.java`)
- Authentication Service → User Repository: looks up account (evidence: `src/main/java/com/ricardo/authcrud/service/AuthService.java`)
- Authentication Service → Password Encoder: checks password (evidence: `src/main/java/com/ricardo/authcrud/service/AuthService.java`)
- Authentication Service → JWT Service: generates token (evidence: `src/main/java/com/ricardo/authcrud/service/AuthService.java`)
- User Service → User Repository: reads and writes (evidence: `src/main/java/com/ricardo/authcrud/service/UserService.java`)
- User Service → Password Encoder: hashes password (evidence: `src/main/java/com/ricardo/authcrud/service/UserService.java`)
- User Service → Access Roles: assigns and checks (evidence: `src/main/java/com/ricardo/authcrud/service/UserService.java`)
- User Repository → User Entity: persists (evidence: `src/main/java/com/ricardo/authcrud/repository/UserRepository.java`)
- User Repository → MySQL Database: stores records
- Security Configuration → JWT Authentication Filter: configures filter (evidence: `src/main/java/com/ricardo/authcrud/config/SecurityConfig.java`)
- JWT Authentication Filter → JWT Service: validates token (evidence: `src/main/java/com/ricardo/authcrud/security/JwtAuthenticationFilter.java`)
- JWT Authentication Filter → User Repository: loads account (evidence: `src/main/java/com/ricardo/authcrud/security/JwtAuthenticationFilter.java`)
- JWT Authentication Filter → Access Roles: sets authority (evidence: `src/main/java/com/ricardo/authcrud/security/JwtAuthenticationFilter.java`)
- Global Error Handler → Request And Response DTOs: formats errors (evidence: `src/main/java/com/ricardo/authcrud/exception/GlobalExceptionHandler.java`)
