# joabss/minhas-financas-api architecture

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

- Interactive diagram: https://gitdiagram.com/joabss/minhas-financas-api
- Repository: https://github.com/joabss/minhas-financas-api

## Overview

Minhas Finanças API is a Spring-based personal-finance backend. Users register or authenticate, receive a JWT, and can manage income and expense entries, search them, update their status, and request a balance. The graph separates HTTP endpoints, authentication, business services, and persistence/domain models. The README gives no feature details, so capabilities are grounded in the controller excerpts; some service and security wiring is supported only by the source index, and unsampled behavior is not inferred.

Main entry points: [`src/main/java/com/joabss/financecontrol/service/impl/LancamentoServiceImpl.java`](https://github.com/joabss/minhas-financas-api/blob/master/src/main/java/com/joabss/financecontrol/service/impl/LancamentoServiceImpl.java) (Entry Rules and Operations), [`src/main/java/com/joabss/financecontrol/service/impl/UsuarioServiceImpl.java`](https://github.com/joabss/minhas-financas-api/blob/master/src/main/java/com/joabss/financecontrol/service/impl/UsuarioServiceImpl.java) (User Operations), [`src/main/java/com/joabss/financecontrol/api/controller/UsuarioController.java`](https://github.com/joabss/minhas-financas-api/blob/master/src/main/java/com/joabss/financecontrol/api/controller/UsuarioController.java) (User Endpoints), [`src/main/java/com/joabss/financecontrol/api/controller/LancamentoController.java`](https://github.com/joabss/minhas-financas-api/blob/master/src/main/java/com/joabss/financecontrol/api/controller/LancamentoController.java) (Entry Endpoints)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["REST API"]
  node_entry_api["Entry Endpoints"]
  node_user_api["User Endpoints"]
  node_api_dto["Request and Response DTOs"]
end

subgraph group_auth["Authentication"]
  node_security_config["Security Configuration"]
  node_jwt_filter["JWT Request Filter"]
  node_jwt_service["JWT Service"]
  node_user_details["User Details Lookup"]
end

subgraph group_services["Business Services"]
  node_entry_service["Entry Rules and Operations"]
  node_user_service["User Operations"]
end

subgraph group_domain["Domain and Persistence"]
  node_entries["Financial Entries<br/>[Lancamento.java]"]
  node_users["User Records<br/>[Usuario.java]"]
  node_entry_repo[("Entry Repository")]
  node_user_repo[("User Repository")]
  node_entry_enums["Entry Type and Status"]
  node_business_errors["Business Exceptions"]
  node_auth_errors["Authentication Exception"]
end

node_client(("API Client"))
node_app["Application Bootstrap"]

node_client -->|"calls endpoints"| node_entry_api
node_client -->|"calls endpoints"| node_user_api
node_entry_api -->|"uses DTOs"| node_api_dto
node_user_api -->|"uses DTOs"| node_api_dto
node_entry_api -->|"calls operations"| node_entry_service
node_entry_api -->|"looks up users"| node_user_service
node_user_api -->|"registers and authenticates"| node_user_service
node_user_api -->|"requests balance"| node_entry_service
node_user_api -->|"generates token"| node_jwt_service
node_security_config -->|"configures filter"| node_jwt_filter
node_security_config -->|"configures JWT"| node_jwt_service
node_security_config -->|"configures lookup"| node_user_details
node_jwt_filter -->|"validates tokens"| node_jwt_service
node_jwt_filter -->|"loads identity"| node_user_details
node_user_details -->|"finds by email"| node_user_repo
node_jwt_service -->|"uses user claims"| node_users
node_entry_service -->|"queries and persists"| node_entry_repo
node_entry_service -->|"applies entry rules"| node_entries
node_entry_service -->|"checks type and status"| node_entry_enums
node_entry_service -->|"raises rule errors"| node_business_errors
node_user_service -->|"queries and persists"| node_user_repo
node_user_service -->|"validates user data"| node_users
node_user_service -->|"raises rule errors"| node_business_errors
node_user_service -->|"raises auth errors"| node_auth_errors
node_entries -->|"stores enum fields"| node_entry_enums
node_entries -->|"references owner"| node_users

click node_app "https://github.com/joabss/minhas-financas-api/blob/master/src/main/java/com/joabss/financecontrol/FinanceControlApplication.java"
click node_entry_api "https://github.com/joabss/minhas-financas-api/blob/master/src/main/java/com/joabss/financecontrol/api/controller/LancamentoController.java"
click node_user_api "https://github.com/joabss/minhas-financas-api/blob/master/src/main/java/com/joabss/financecontrol/api/controller/UsuarioController.java"
click node_api_dto "https://github.com/joabss/minhas-financas-api/tree/master/src/main/java/com/joabss/financecontrol/api/dto"
click node_security_config "https://github.com/joabss/minhas-financas-api/blob/master/src/main/java/com/joabss/financecontrol/config/SecurityConfiguration.java"
click node_jwt_filter "https://github.com/joabss/minhas-financas-api/blob/master/src/main/java/com/joabss/financecontrol/api/JwtTokenFilter.java"
click node_jwt_service "https://github.com/joabss/minhas-financas-api/blob/master/src/main/java/com/joabss/financecontrol/service/impl/JwtServiceImpl.java"
click node_user_details "https://github.com/joabss/minhas-financas-api/blob/master/src/main/java/com/joabss/financecontrol/service/impl/SecurityUserDetailsService.java"
click node_entry_service "https://github.com/joabss/minhas-financas-api/blob/master/src/main/java/com/joabss/financecontrol/service/impl/LancamentoServiceImpl.java"
click node_user_service "https://github.com/joabss/minhas-financas-api/blob/master/src/main/java/com/joabss/financecontrol/service/impl/UsuarioServiceImpl.java"
click node_entries "https://github.com/joabss/minhas-financas-api/blob/master/src/main/java/com/joabss/financecontrol/model/entity/Lancamento.java"
click node_users "https://github.com/joabss/minhas-financas-api/blob/master/src/main/java/com/joabss/financecontrol/model/entity/Usuario.java"
click node_entry_repo "https://github.com/joabss/minhas-financas-api/blob/master/src/main/java/com/joabss/financecontrol/model/repository/LancamentoRepository.java"
click node_user_repo "https://github.com/joabss/minhas-financas-api/blob/master/src/main/java/com/joabss/financecontrol/model/repository/UsuarioRepository.java"
click node_entry_enums "https://github.com/joabss/minhas-financas-api/tree/master/src/main/java/com/joabss/financecontrol/model/enums"
click node_business_errors "https://github.com/joabss/minhas-financas-api/blob/master/src/main/java/com/joabss/financecontrol/exception/RegraNegocioException.java"
click node_auth_errors "https://github.com/joabss/minhas-financas-api/blob/master/src/main/java/com/joabss/financecontrol/exception/ErroAutenticacao.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_entry_api,node_user_api,node_api_dto,node_client toneBlue
class node_security_config,node_jwt_filter,node_jwt_service,node_user_details toneAmber
class node_entry_service,node_user_service toneMint
class node_entries,node_users,node_entry_repo,node_user_repo,node_entry_enums,node_business_errors,node_auth_errors toneRose
class node_app toneTeal
```

## Components

### REST API

- [Entry Endpoints](https://github.com/joabss/minhas-financas-api/blob/master/src/main/java/com/joabss/financecontrol/api/controller/LancamentoController.java): `src/main/java/com/joabss/financecontrol/api/controller/LancamentoController.java`
- [User Endpoints](https://github.com/joabss/minhas-financas-api/blob/master/src/main/java/com/joabss/financecontrol/api/controller/UsuarioController.java): `src/main/java/com/joabss/financecontrol/api/controller/UsuarioController.java`
- [Request and Response DTOs](https://github.com/joabss/minhas-financas-api/tree/master/src/main/java/com/joabss/financecontrol/api/dto): `src/main/java/com/joabss/financecontrol/api/dto`

### Authentication

- [Security Configuration](https://github.com/joabss/minhas-financas-api/blob/master/src/main/java/com/joabss/financecontrol/config/SecurityConfiguration.java): `src/main/java/com/joabss/financecontrol/config/SecurityConfiguration.java`
- [JWT Request Filter](https://github.com/joabss/minhas-financas-api/blob/master/src/main/java/com/joabss/financecontrol/api/JwtTokenFilter.java): `src/main/java/com/joabss/financecontrol/api/JwtTokenFilter.java`
- [JWT Service](https://github.com/joabss/minhas-financas-api/blob/master/src/main/java/com/joabss/financecontrol/service/impl/JwtServiceImpl.java): `src/main/java/com/joabss/financecontrol/service/impl/JwtServiceImpl.java`
- [User Details Lookup](https://github.com/joabss/minhas-financas-api/blob/master/src/main/java/com/joabss/financecontrol/service/impl/SecurityUserDetailsService.java): `src/main/java/com/joabss/financecontrol/service/impl/SecurityUserDetailsService.java`

### Business Services

- [Entry Rules and Operations](https://github.com/joabss/minhas-financas-api/blob/master/src/main/java/com/joabss/financecontrol/service/impl/LancamentoServiceImpl.java): `src/main/java/com/joabss/financecontrol/service/impl/LancamentoServiceImpl.java`
- [User Operations](https://github.com/joabss/minhas-financas-api/blob/master/src/main/java/com/joabss/financecontrol/service/impl/UsuarioServiceImpl.java): `src/main/java/com/joabss/financecontrol/service/impl/UsuarioServiceImpl.java`

### Domain and Persistence

- [Financial Entries](https://github.com/joabss/minhas-financas-api/blob/master/src/main/java/com/joabss/financecontrol/model/entity/Lancamento.java): `src/main/java/com/joabss/financecontrol/model/entity/Lancamento.java`
- [User Records](https://github.com/joabss/minhas-financas-api/blob/master/src/main/java/com/joabss/financecontrol/model/entity/Usuario.java): `src/main/java/com/joabss/financecontrol/model/entity/Usuario.java`
- [Entry Repository](https://github.com/joabss/minhas-financas-api/blob/master/src/main/java/com/joabss/financecontrol/model/repository/LancamentoRepository.java): `src/main/java/com/joabss/financecontrol/model/repository/LancamentoRepository.java`
- [User Repository](https://github.com/joabss/minhas-financas-api/blob/master/src/main/java/com/joabss/financecontrol/model/repository/UsuarioRepository.java): `src/main/java/com/joabss/financecontrol/model/repository/UsuarioRepository.java`
- [Entry Type and Status](https://github.com/joabss/minhas-financas-api/tree/master/src/main/java/com/joabss/financecontrol/model/enums): `src/main/java/com/joabss/financecontrol/model/enums`
- [Business Exceptions](https://github.com/joabss/minhas-financas-api/blob/master/src/main/java/com/joabss/financecontrol/exception/RegraNegocioException.java): `src/main/java/com/joabss/financecontrol/exception/RegraNegocioException.java`
- [Authentication Exception](https://github.com/joabss/minhas-financas-api/blob/master/src/main/java/com/joabss/financecontrol/exception/ErroAutenticacao.java): `src/main/java/com/joabss/financecontrol/exception/ErroAutenticacao.java`

### Other components

- **API Client**
- [Application Bootstrap](https://github.com/joabss/minhas-financas-api/blob/master/src/main/java/com/joabss/financecontrol/FinanceControlApplication.java): `src/main/java/com/joabss/financecontrol/FinanceControlApplication.java`

## Connections

- API Client → Entry Endpoints: calls endpoints (evidence: `src/main/java/com/joabss/financecontrol/api/controller/LancamentoController.java`)
- API Client → User Endpoints: calls endpoints (evidence: `src/main/java/com/joabss/financecontrol/api/controller/UsuarioController.java`)
- Entry Endpoints → Request and Response DTOs: uses DTOs (evidence: `src/main/java/com/joabss/financecontrol/api/controller/LancamentoController.java`)
- User Endpoints → Request and Response DTOs: uses DTOs (evidence: `src/main/java/com/joabss/financecontrol/api/controller/UsuarioController.java`)
- Entry Endpoints → Entry Rules and Operations: calls operations (evidence: `src/main/java/com/joabss/financecontrol/api/controller/LancamentoController.java`)
- Entry Endpoints → User Operations: looks up users (evidence: `src/main/java/com/joabss/financecontrol/api/controller/LancamentoController.java`)
- User Endpoints → User Operations: registers and authenticates (evidence: `src/main/java/com/joabss/financecontrol/api/controller/UsuarioController.java`)
- User Endpoints → Entry Rules and Operations: requests balance (evidence: `src/main/java/com/joabss/financecontrol/api/controller/UsuarioController.java`)
- User Endpoints → JWT Service: generates token (evidence: `src/main/java/com/joabss/financecontrol/api/controller/UsuarioController.java`)
- Security Configuration → JWT Request Filter: configures filter (evidence: `src/main/java/com/joabss/financecontrol/config/SecurityConfiguration.java`)
- Security Configuration → JWT Service: configures JWT (evidence: `src/main/java/com/joabss/financecontrol/config/SecurityConfiguration.java`)
- Security Configuration → User Details Lookup: configures lookup (evidence: `src/main/java/com/joabss/financecontrol/config/SecurityConfiguration.java`)
- JWT Request Filter → JWT Service: validates tokens (evidence: `src/main/java/com/joabss/financecontrol/api/JwtTokenFilter.java`)
- JWT Request Filter → User Details Lookup: loads identity (evidence: `src/main/java/com/joabss/financecontrol/api/JwtTokenFilter.java`)
- User Details Lookup → User Repository: finds by email (evidence: `src/main/java/com/joabss/financecontrol/service/impl/SecurityUserDetailsService.java`)
- JWT Service → User Records: uses user claims (evidence: `src/main/java/com/joabss/financecontrol/service/impl/JwtServiceImpl.java`)
- Entry Rules and Operations → Entry Repository: queries and persists (evidence: `src/main/java/com/joabss/financecontrol/service/impl/LancamentoServiceImpl.java`)
- Entry Rules and Operations → Financial Entries: applies entry rules (evidence: `src/main/java/com/joabss/financecontrol/service/impl/LancamentoServiceImpl.java`)
- Entry Rules and Operations → Entry Type and Status: checks type and status (evidence: `src/main/java/com/joabss/financecontrol/service/impl/LancamentoServiceImpl.java`)
- Entry Rules and Operations → Business Exceptions: raises rule errors (evidence: `src/main/java/com/joabss/financecontrol/service/impl/LancamentoServiceImpl.java`)
- User Operations → User Repository: queries and persists (evidence: `src/main/java/com/joabss/financecontrol/service/impl/UsuarioServiceImpl.java`)
- User Operations → User Records: validates user data (evidence: `src/main/java/com/joabss/financecontrol/service/impl/UsuarioServiceImpl.java`)
- User Operations → Business Exceptions: raises rule errors (evidence: `src/main/java/com/joabss/financecontrol/service/impl/UsuarioServiceImpl.java`)
- User Operations → Authentication Exception: raises auth errors (evidence: `src/main/java/com/joabss/financecontrol/service/impl/UsuarioServiceImpl.java`)
- Financial Entries → Entry Type and Status: stores enum fields (evidence: `src/main/java/com/joabss/financecontrol/model/entity/Lancamento.java`)
- Financial Entries → User Records: references owner (evidence: `src/main/java/com/joabss/financecontrol/model/entity/Lancamento.java`)
