# peterrsm/mini-autorizador architecture

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

## Overview

mini-autorizador is a Spring Boot card authorization service. A client obtains a JWT, then creates cards, checks balances, or submits transfers; transfer processing validates card number, password, and funds before reducing the balance. The graph covers the documented REST and Vaadin entry points, domain and persistence layers, and JWT protection. Source excerpts confirm the REST-to-service-to-repository flow; some dashboard and security wiring is included from README or index references, so those links are marked as documented or unverified.

Main entry points: [`src/main/java/com/pedromiranda/miniautorizador/service/Impl/CartaoServiceImpl.java`](https://github.com/peterrsm/mini-autorizador/blob/main/src/main/java/com/pedromiranda/miniautorizador/service/Impl/CartaoServiceImpl.java) (Card operations), [`src/main/java/com/pedromiranda/miniautorizador/controller/impl/CartaoControllerImpl.java`](https://github.com/peterrsm/mini-autorizador/blob/main/src/main/java/com/pedromiranda/miniautorizador/controller/impl/CartaoControllerImpl.java) (Card REST API), [`src/main/java/com/pedromiranda/miniautorizador/entity/Cartao.java`](https://github.com/peterrsm/mini-autorizador/blob/main/src/main/java/com/pedromiranda/miniautorizador/entity/Cartao.java) (Card and transfer models), [`src/main/java/com/pedromiranda/miniautorizador/views/DashboardView.java`](https://github.com/peterrsm/mini-autorizador/blob/main/src/main/java/com/pedromiranda/miniautorizador/views/DashboardView.java) (Vaadin dashboard)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API and interfaces"]
  node_rest["Card REST API"]
  node_contract["Card API contract"]
  node_dashboard["Vaadin dashboard<br/>[DashboardView.java]"]
  node_errors["API error mapping"]
end

subgraph group_auth["Authentication"]
  node_authapi["Login endpoint"]
  node_security["Security configuration"]
  node_jwtfilter["JWT filter"]
  node_jwt["JWT service<br/>[JwtService.java]"]
end

subgraph group_domain["Card domain"]
  node_service["Card operations"]
  node_models["Card and transfer models<br/>[Cartao.java]"]
  node_identifiers["Card and password values<br/>[CardNumber.java]"]
  node_request["Transfer request<br/>[Transacao.java]"]
  node_carddto["Card DTO<br/>[CartaoDTO.java]"]
  node_balance["Balance response"]
  node_mapper["Card mapper<br/>[CartaoMapper.java]"]
end

subgraph group_persistence["Persistence"]
  node_repository["Card repository"]
  node_database[("MySQL card store")]
end

node_client(("API client"))

node_client -->|"requests login"| node_authapi
node_authapi -->|"generates token"| node_jwt
node_client -->|"sends card requests"| node_rest
node_rest -->|"implements endpoints"| node_contract
node_rest -->|"delegates operations"| node_service
node_client -->|"opens dashboard"| node_dashboard
node_dashboard -->|"uses card operations"| node_service
node_security -->|"registers filter"| node_jwtfilter
node_jwtfilter -->|"validates token"| node_jwt
node_rest -->|"accepts transfers"| node_request
node_rest -->|"accepts and returns"| node_carddto
node_rest -->|"returns balance"| node_balance
node_service -->|"maps card DTO"| node_mapper
node_mapper -->|"builds card model"| node_models
node_service -->|"reads and writes"| node_repository
node_repository -.->|"persists cards"| node_database
node_service -->|"validates and debits"| node_models
node_service -->|"checks transfer data"| node_request
node_service -->|"creates balance response"| node_balance
node_service -->|"returns card data"| node_carddto
node_service -->|"raises domain errors"| node_errors
node_models -->|"embeds values"| node_identifiers

click node_rest "https://github.com/peterrsm/mini-autorizador/blob/main/src/main/java/com/pedromiranda/miniautorizador/controller/impl/CartaoControllerImpl.java"
click node_contract "https://github.com/peterrsm/mini-autorizador/blob/main/src/main/java/com/pedromiranda/miniautorizador/controller/interfaces/ICartaoController.java"
click node_dashboard "https://github.com/peterrsm/mini-autorizador/blob/main/src/main/java/com/pedromiranda/miniautorizador/views/DashboardView.java"
click node_authapi "https://github.com/peterrsm/mini-autorizador/blob/main/src/main/java/com/pedromiranda/miniautorizador/controller/AuthController.java"
click node_security "https://github.com/peterrsm/mini-autorizador/blob/main/src/main/java/com/pedromiranda/miniautorizador/config/security/SecurityConfiguration.java"
click node_jwtfilter "https://github.com/peterrsm/mini-autorizador/blob/main/src/main/java/com/pedromiranda/miniautorizador/security/JwtAuthenticationFilter.java"
click node_jwt "https://github.com/peterrsm/mini-autorizador/blob/main/src/main/java/com/pedromiranda/miniautorizador/security/JwtService.java"
click node_service "https://github.com/peterrsm/mini-autorizador/blob/main/src/main/java/com/pedromiranda/miniautorizador/service/Impl/CartaoServiceImpl.java"
click node_models "https://github.com/peterrsm/mini-autorizador/blob/main/src/main/java/com/pedromiranda/miniautorizador/entity/Cartao.java"
click node_identifiers "https://github.com/peterrsm/mini-autorizador/blob/main/src/main/java/com/pedromiranda/miniautorizador/entity/CardNumber.java"
click node_request "https://github.com/peterrsm/mini-autorizador/blob/main/src/main/java/com/pedromiranda/miniautorizador/entity/Transacao.java"
click node_carddto "https://github.com/peterrsm/mini-autorizador/blob/main/src/main/java/com/pedromiranda/miniautorizador/entity/dto/CartaoDTO.java"
click node_balance "https://github.com/peterrsm/mini-autorizador/blob/main/src/main/java/com/pedromiranda/miniautorizador/entity/dto/ResponseCartaoSaldo.java"
click node_mapper "https://github.com/peterrsm/mini-autorizador/blob/main/src/main/java/com/pedromiranda/miniautorizador/entity/mapper/CartaoMapper.java"
click node_errors "https://github.com/peterrsm/mini-autorizador/blob/main/src/main/java/com/pedromiranda/miniautorizador/controller/exceptions/ControllerExceptionHandler.java"
click node_repository "https://github.com/peterrsm/mini-autorizador/blob/main/src/main/java/com/pedromiranda/miniautorizador/repository/CartaoRepository.java"
click node_database "https://github.com/peterrsm/mini-autorizador/blob/main/src/main/java/com/pedromiranda/miniautorizador/repository/CartaoRepository.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_rest,node_contract,node_dashboard,node_errors,node_client toneBlue
class node_authapi,node_security,node_jwtfilter,node_jwt toneAmber
class node_service,node_models,node_identifiers,node_request,node_carddto,node_balance,node_mapper toneMint
class node_repository,node_database toneRose
```

## Components

### API and interfaces

- [Card REST API](https://github.com/peterrsm/mini-autorizador/blob/main/src/main/java/com/pedromiranda/miniautorizador/controller/impl/CartaoControllerImpl.java): `src/main/java/com/pedromiranda/miniautorizador/controller/impl/CartaoControllerImpl.java`
- [Card API contract](https://github.com/peterrsm/mini-autorizador/blob/main/src/main/java/com/pedromiranda/miniautorizador/controller/interfaces/ICartaoController.java): `src/main/java/com/pedromiranda/miniautorizador/controller/interfaces/ICartaoController.java`
- [Vaadin dashboard](https://github.com/peterrsm/mini-autorizador/blob/main/src/main/java/com/pedromiranda/miniautorizador/views/DashboardView.java): `src/main/java/com/pedromiranda/miniautorizador/views/DashboardView.java`
- [API error mapping](https://github.com/peterrsm/mini-autorizador/blob/main/src/main/java/com/pedromiranda/miniautorizador/controller/exceptions/ControllerExceptionHandler.java): `src/main/java/com/pedromiranda/miniautorizador/controller/exceptions/ControllerExceptionHandler.java`

### Authentication

- [Login endpoint](https://github.com/peterrsm/mini-autorizador/blob/main/src/main/java/com/pedromiranda/miniautorizador/controller/AuthController.java): `src/main/java/com/pedromiranda/miniautorizador/controller/AuthController.java`
- [Security configuration](https://github.com/peterrsm/mini-autorizador/blob/main/src/main/java/com/pedromiranda/miniautorizador/config/security/SecurityConfiguration.java): `src/main/java/com/pedromiranda/miniautorizador/config/security/SecurityConfiguration.java`
- [JWT filter](https://github.com/peterrsm/mini-autorizador/blob/main/src/main/java/com/pedromiranda/miniautorizador/security/JwtAuthenticationFilter.java): `src/main/java/com/pedromiranda/miniautorizador/security/JwtAuthenticationFilter.java`
- [JWT service](https://github.com/peterrsm/mini-autorizador/blob/main/src/main/java/com/pedromiranda/miniautorizador/security/JwtService.java): `src/main/java/com/pedromiranda/miniautorizador/security/JwtService.java`

### Card domain

- [Card operations](https://github.com/peterrsm/mini-autorizador/blob/main/src/main/java/com/pedromiranda/miniautorizador/service/Impl/CartaoServiceImpl.java): `src/main/java/com/pedromiranda/miniautorizador/service/Impl/CartaoServiceImpl.java`
- [Card and transfer models](https://github.com/peterrsm/mini-autorizador/blob/main/src/main/java/com/pedromiranda/miniautorizador/entity/Cartao.java): `src/main/java/com/pedromiranda/miniautorizador/entity/Cartao.java`
- [Card and password values](https://github.com/peterrsm/mini-autorizador/blob/main/src/main/java/com/pedromiranda/miniautorizador/entity/CardNumber.java): `src/main/java/com/pedromiranda/miniautorizador/entity/CardNumber.java`
- [Transfer request](https://github.com/peterrsm/mini-autorizador/blob/main/src/main/java/com/pedromiranda/miniautorizador/entity/Transacao.java): `src/main/java/com/pedromiranda/miniautorizador/entity/Transacao.java`
- [Card DTO](https://github.com/peterrsm/mini-autorizador/blob/main/src/main/java/com/pedromiranda/miniautorizador/entity/dto/CartaoDTO.java): `src/main/java/com/pedromiranda/miniautorizador/entity/dto/CartaoDTO.java`
- [Balance response](https://github.com/peterrsm/mini-autorizador/blob/main/src/main/java/com/pedromiranda/miniautorizador/entity/dto/ResponseCartaoSaldo.java): `src/main/java/com/pedromiranda/miniautorizador/entity/dto/ResponseCartaoSaldo.java`
- [Card mapper](https://github.com/peterrsm/mini-autorizador/blob/main/src/main/java/com/pedromiranda/miniautorizador/entity/mapper/CartaoMapper.java): `src/main/java/com/pedromiranda/miniautorizador/entity/mapper/CartaoMapper.java`

### Persistence

- [Card repository](https://github.com/peterrsm/mini-autorizador/blob/main/src/main/java/com/pedromiranda/miniautorizador/repository/CartaoRepository.java): `src/main/java/com/pedromiranda/miniautorizador/repository/CartaoRepository.java`
- [MySQL card store](https://github.com/peterrsm/mini-autorizador/blob/main/src/main/java/com/pedromiranda/miniautorizador/repository/CartaoRepository.java): `src/main/java/com/pedromiranda/miniautorizador/repository/CartaoRepository.java`

### Other components

- **API client**

## Connections

- API client → Login endpoint: requests login (evidence: `README.md`)
- Login endpoint → JWT service: generates token (evidence: `src/main/java/com/pedromiranda/miniautorizador/controller/AuthController.java`)
- API client → Card REST API: sends card requests (evidence: `README.md`)
- Card REST API → Card API contract: implements endpoints (evidence: `src/main/java/com/pedromiranda/miniautorizador/controller/impl/CartaoControllerImpl.java`)
- Card REST API → Card operations: delegates operations (evidence: `src/main/java/com/pedromiranda/miniautorizador/controller/impl/CartaoControllerImpl.java`)
- API client → Vaadin dashboard: opens dashboard (evidence: `README.md`)
- Vaadin dashboard → Card operations: uses card operations (evidence: `src/main/java/com/pedromiranda/miniautorizador/views/DashboardView.java`)
- Security configuration → JWT filter: registers filter (evidence: `src/main/java/com/pedromiranda/miniautorizador/config/security/SecurityConfiguration.java`)
- JWT filter → JWT service: validates token (evidence: `src/main/java/com/pedromiranda/miniautorizador/security/JwtAuthenticationFilter.java`)
- Card REST API → Transfer request: accepts transfers (evidence: `src/main/java/com/pedromiranda/miniautorizador/controller/impl/CartaoControllerImpl.java`)
- Card REST API → Card DTO: accepts and returns (evidence: `src/main/java/com/pedromiranda/miniautorizador/controller/impl/CartaoControllerImpl.java`)
- Card REST API → Balance response: returns balance (evidence: `src/main/java/com/pedromiranda/miniautorizador/controller/impl/CartaoControllerImpl.java`)
- Card operations → Card mapper: maps card DTO (evidence: `src/main/java/com/pedromiranda/miniautorizador/service/Impl/CartaoServiceImpl.java`)
- Card mapper → Card and transfer models: builds card model (evidence: `src/main/java/com/pedromiranda/miniautorizador/entity/mapper/CartaoMapper.java`)
- Card operations → Card repository: reads and writes (evidence: `src/main/java/com/pedromiranda/miniautorizador/service/Impl/CartaoServiceImpl.java`)
- Card repository → MySQL card store: persists cards (evidence: `README.md`)
- Card operations → Card and transfer models: validates and debits (evidence: `src/main/java/com/pedromiranda/miniautorizador/service/Impl/CartaoServiceImpl.java`)
- Card operations → Transfer request: checks transfer data (evidence: `src/main/java/com/pedromiranda/miniautorizador/service/Impl/CartaoServiceImpl.java`)
- Card operations → Balance response: creates balance response (evidence: `src/main/java/com/pedromiranda/miniautorizador/service/Impl/CartaoServiceImpl.java`)
- Card operations → Card DTO: returns card data (evidence: `src/main/java/com/pedromiranda/miniautorizador/service/Impl/CartaoServiceImpl.java`)
- Card operations → API error mapping: raises domain errors (evidence: `src/main/java/com/pedromiranda/miniautorizador/controller/exceptions/ControllerExceptionHandler.java`)
- Card and transfer models → Card and password values: embeds values (evidence: `src/main/java/com/pedromiranda/miniautorizador/entity/Cartao.java`)
