# francesc05cervera/backend-moneyboard2.0 architecture

> Architecture diagram of the GitHub repository francesc05cervera/backend-moneyboard2.0, 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/francesc05cervera/backend-moneyboard2.0
- Repository: https://github.com/francesc05cervera/backend-moneyboard2.0

## Overview

MoneyBoard 2.0 is a JWT-protected REST backend for personal savings sections and their income/expense transactions. The main workflow is a client registering or logging in, then using the token to manage its sections and transactions; transaction operations enforce ownership and update section balances. Services also handle password hashing and token validation, while Spring Data repositories persist the JPA entities. The README documents PostgreSQL persistence and the controller-to-service-to-repository layering; some controller and configuration internals were not sampled.

Main entry points: [`src/main/java/com/MoneyBoard2/Service/ServiceTransazione.java`](https://github.com/francesc05cervera/backend-moneyboard2.0/blob/main/src/main/java/com/MoneyBoard2/Service/ServiceTransazione.java) (Transaction service), [`src/main/java/com/MoneyBoard2/NEW_CONTROLLER_JWT/UsrCtrl.java`](https://github.com/francesc05cervera/backend-moneyboard2.0/blob/main/src/main/java/com/MoneyBoard2/NEW_CONTROLLER_JWT/UsrCtrl.java) (User endpoints), [`src/main/java/com/MoneyBoard2/Service/ServiceSezione.java`](https://github.com/francesc05cervera/backend-moneyboard2.0/blob/main/src/main/java/com/MoneyBoard2/Service/ServiceSezione.java) (Section service), [`src/main/java/com/MoneyBoard2/Repository/UtenteRepository.java`](https://github.com/francesc05cervera/backend-moneyboard2.0/blob/main/src/main/java/com/MoneyBoard2/Repository/UtenteRepository.java) (User repository)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["REST API"]
  node_user_api["User endpoints<br/>[UsrCtrl.java]"]
  node_section_api["Section endpoints<br/>[SezioneCtrl.java]"]
  node_transaction_api["Transaction endpoints"]
  node_ping["Health ping<br/>[Ping.java]"]
  node_user_dto["User DTOs"]
  node_login_dto["Login DTOs<br/>[LoginRequest.java]"]
  node_section_dto["Section DTO"]
  node_transaction_dto["Transaction DTO"]
  node_auth_response["Auth responses<br/>[LoginResponse.java]"]
end

subgraph group_business["Business Services"]
  node_user_service["User service<br/>[ServiceUtente.java]"]
  node_section_service["Section service"]
  node_transaction_service["Transaction service"]
end

subgraph group_persistence["Persistence"]
  node_user_repo["User repository"]
  node_section_repo["Section repository"]
  node_transaction_repo["Transaction repository"]
  node_user_model["User entity<br/>[Utente.java]"]
  node_section_model["Savings section"]
  node_transaction_model["Transaction entity<br/>[Transazione.java]"]
end

subgraph group_security["Authentication"]
  node_jwt_service["JWT service<br/>[JwtService.java]"]
  node_security_config["Security config"]
  node_jwt_config["JWT config<br/>[JwtConfig.java]"]
end

node_client(("API client"))
node_postgres[("PostgreSQL")]

node_client -->|"calls"| node_user_api
node_client -->|"calls"| node_section_api
node_client -->|"calls"| node_transaction_api
node_client -->|"checks"| node_ping
node_user_api -->|"delegates to"| node_user_service
node_section_api -->|"delegates to"| node_section_service
node_transaction_api -->|"delegates to"| node_transaction_service
node_user_api -->|"accepts"| node_user_dto
node_user_api -->|"accepts"| node_login_dto
node_section_api -->|"accepts"| node_section_dto
node_transaction_api -->|"accepts"| node_transaction_dto
node_user_api -->|"returns"| node_auth_response
node_user_service -->|"reads/writes"| node_user_repo
node_user_service -->|"issues token"| node_jwt_service
node_section_service -->|"validates token"| node_jwt_service
node_section_service -->|"reads/writes"| node_section_repo
node_section_service -->|"loads owner"| node_user_repo
node_transaction_service -->|"validates token"| node_jwt_service
node_transaction_service -->|"reads/writes"| node_section_repo
node_transaction_service -->|"reads/writes"| node_transaction_repo
node_transaction_service -->|"loads owner"| node_user_repo
node_transaction_service -->|"updates balance via"| node_section_service
node_user_repo -->|"maps entity"| node_user_model
node_section_repo -->|"maps entity"| node_section_model
node_transaction_repo -->|"maps entity"| node_transaction_model
node_section_model -->|"belongs to"| node_user_model
node_transaction_model -->|"belongs to"| node_section_model
node_transaction_model -->|"belongs to"| node_user_model
node_jwt_config -->|"configures"| node_jwt_service
node_user_service -.->|"uses password encoder"| node_security_config
node_user_repo -.->|"persists via JPA"| node_postgres
node_section_repo -.->|"persists via JPA"| node_postgres
node_transaction_repo -.->|"persists via JPA"| node_postgres

click node_user_api "https://github.com/francesc05cervera/backend-moneyboard2.0/blob/main/src/main/java/com/MoneyBoard2/NEW_CONTROLLER_JWT/UsrCtrl.java"
click node_section_api "https://github.com/francesc05cervera/backend-moneyboard2.0/blob/main/src/main/java/com/MoneyBoard2/NEW_CONTROLLER_JWT/SezioneCtrl.java"
click node_transaction_api "https://github.com/francesc05cervera/backend-moneyboard2.0/blob/main/src/main/java/com/MoneyBoard2/NEW_CONTROLLER_JWT/TransazioneCtrl.java"
click node_ping "https://github.com/francesc05cervera/backend-moneyboard2.0/blob/main/src/main/java/com/MoneyBoard2/NEW_CONTROLLER_JWT/Ping.java"
click node_user_dto "https://github.com/francesc05cervera/backend-moneyboard2.0/blob/main/src/main/java/com/MoneyBoard2/Request/UserCreateRequest.java"
click node_login_dto "https://github.com/francesc05cervera/backend-moneyboard2.0/blob/main/src/main/java/com/MoneyBoard2/Request/LoginRequest.java"
click node_section_dto "https://github.com/francesc05cervera/backend-moneyboard2.0/blob/main/src/main/java/com/MoneyBoard2/Request/SectionCreateRequest.java"
click node_transaction_dto "https://github.com/francesc05cervera/backend-moneyboard2.0/blob/main/src/main/java/com/MoneyBoard2/Request/CreateTransactionRequest.java"
click node_auth_response "https://github.com/francesc05cervera/backend-moneyboard2.0/blob/main/src/main/java/com/MoneyBoard2/Response/LoginResponse.java"
click node_user_service "https://github.com/francesc05cervera/backend-moneyboard2.0/blob/main/src/main/java/com/MoneyBoard2/Service/ServiceUtente.java"
click node_section_service "https://github.com/francesc05cervera/backend-moneyboard2.0/blob/main/src/main/java/com/MoneyBoard2/Service/ServiceSezione.java"
click node_transaction_service "https://github.com/francesc05cervera/backend-moneyboard2.0/blob/main/src/main/java/com/MoneyBoard2/Service/ServiceTransazione.java"
click node_jwt_service "https://github.com/francesc05cervera/backend-moneyboard2.0/blob/main/src/main/java/com/MoneyBoard2/security/JwtService.java"
click node_security_config "https://github.com/francesc05cervera/backend-moneyboard2.0/blob/main/src/main/java/com/MoneyBoard2/config/SecurityConfig.java"
click node_jwt_config "https://github.com/francesc05cervera/backend-moneyboard2.0/blob/main/src/main/java/com/MoneyBoard2/config/JwtConfig.java"
click node_user_repo "https://github.com/francesc05cervera/backend-moneyboard2.0/blob/main/src/main/java/com/MoneyBoard2/Repository/UtenteRepository.java"
click node_section_repo "https://github.com/francesc05cervera/backend-moneyboard2.0/blob/main/src/main/java/com/MoneyBoard2/Repository/SezioneRisparmioRepository.java"
click node_transaction_repo "https://github.com/francesc05cervera/backend-moneyboard2.0/blob/main/src/main/java/com/MoneyBoard2/Repository/TransazioneRepository.java"
click node_user_model "https://github.com/francesc05cervera/backend-moneyboard2.0/blob/main/src/main/java/com/MoneyBoard2/Model/Utente.java"
click node_section_model "https://github.com/francesc05cervera/backend-moneyboard2.0/blob/main/src/main/java/com/MoneyBoard2/Model/SezioneRisparmio.java"
click node_transaction_model "https://github.com/francesc05cervera/backend-moneyboard2.0/blob/main/src/main/java/com/MoneyBoard2/Model/Transazione.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_user_api,node_section_api,node_transaction_api,node_ping,node_user_dto,node_login_dto,node_section_dto,node_transaction_dto,node_auth_response,node_client toneBlue
class node_user_service,node_section_service,node_transaction_service,node_postgres toneAmber
class node_user_repo,node_section_repo,node_transaction_repo,node_user_model,node_section_model,node_transaction_model toneMint
class node_jwt_service,node_security_config,node_jwt_config toneRose
```

## Components

### REST API

- [User endpoints](https://github.com/francesc05cervera/backend-moneyboard2.0/blob/main/src/main/java/com/MoneyBoard2/NEW_CONTROLLER_JWT/UsrCtrl.java): `src/main/java/com/MoneyBoard2/NEW_CONTROLLER_JWT/UsrCtrl.java`
- [Section endpoints](https://github.com/francesc05cervera/backend-moneyboard2.0/blob/main/src/main/java/com/MoneyBoard2/NEW_CONTROLLER_JWT/SezioneCtrl.java): `src/main/java/com/MoneyBoard2/NEW_CONTROLLER_JWT/SezioneCtrl.java`
- [Transaction endpoints](https://github.com/francesc05cervera/backend-moneyboard2.0/blob/main/src/main/java/com/MoneyBoard2/NEW_CONTROLLER_JWT/TransazioneCtrl.java): `src/main/java/com/MoneyBoard2/NEW_CONTROLLER_JWT/TransazioneCtrl.java`
- [Health ping](https://github.com/francesc05cervera/backend-moneyboard2.0/blob/main/src/main/java/com/MoneyBoard2/NEW_CONTROLLER_JWT/Ping.java): `src/main/java/com/MoneyBoard2/NEW_CONTROLLER_JWT/Ping.java`
- [User DTOs](https://github.com/francesc05cervera/backend-moneyboard2.0/blob/main/src/main/java/com/MoneyBoard2/Request/UserCreateRequest.java): `src/main/java/com/MoneyBoard2/Request/UserCreateRequest.java`
- [Login DTOs](https://github.com/francesc05cervera/backend-moneyboard2.0/blob/main/src/main/java/com/MoneyBoard2/Request/LoginRequest.java): `src/main/java/com/MoneyBoard2/Request/LoginRequest.java`
- [Section DTO](https://github.com/francesc05cervera/backend-moneyboard2.0/blob/main/src/main/java/com/MoneyBoard2/Request/SectionCreateRequest.java): `src/main/java/com/MoneyBoard2/Request/SectionCreateRequest.java`
- [Transaction DTO](https://github.com/francesc05cervera/backend-moneyboard2.0/blob/main/src/main/java/com/MoneyBoard2/Request/CreateTransactionRequest.java): `src/main/java/com/MoneyBoard2/Request/CreateTransactionRequest.java`
- [Auth responses](https://github.com/francesc05cervera/backend-moneyboard2.0/blob/main/src/main/java/com/MoneyBoard2/Response/LoginResponse.java): `src/main/java/com/MoneyBoard2/Response/LoginResponse.java`

### Business Services

- [User service](https://github.com/francesc05cervera/backend-moneyboard2.0/blob/main/src/main/java/com/MoneyBoard2/Service/ServiceUtente.java): `src/main/java/com/MoneyBoard2/Service/ServiceUtente.java`
- [Section service](https://github.com/francesc05cervera/backend-moneyboard2.0/blob/main/src/main/java/com/MoneyBoard2/Service/ServiceSezione.java): `src/main/java/com/MoneyBoard2/Service/ServiceSezione.java`
- [Transaction service](https://github.com/francesc05cervera/backend-moneyboard2.0/blob/main/src/main/java/com/MoneyBoard2/Service/ServiceTransazione.java): `src/main/java/com/MoneyBoard2/Service/ServiceTransazione.java`

### Persistence

- [User repository](https://github.com/francesc05cervera/backend-moneyboard2.0/blob/main/src/main/java/com/MoneyBoard2/Repository/UtenteRepository.java): `src/main/java/com/MoneyBoard2/Repository/UtenteRepository.java`
- [Section repository](https://github.com/francesc05cervera/backend-moneyboard2.0/blob/main/src/main/java/com/MoneyBoard2/Repository/SezioneRisparmioRepository.java): `src/main/java/com/MoneyBoard2/Repository/SezioneRisparmioRepository.java`
- [Transaction repository](https://github.com/francesc05cervera/backend-moneyboard2.0/blob/main/src/main/java/com/MoneyBoard2/Repository/TransazioneRepository.java): `src/main/java/com/MoneyBoard2/Repository/TransazioneRepository.java`
- [User entity](https://github.com/francesc05cervera/backend-moneyboard2.0/blob/main/src/main/java/com/MoneyBoard2/Model/Utente.java): `src/main/java/com/MoneyBoard2/Model/Utente.java`
- [Savings section](https://github.com/francesc05cervera/backend-moneyboard2.0/blob/main/src/main/java/com/MoneyBoard2/Model/SezioneRisparmio.java): `src/main/java/com/MoneyBoard2/Model/SezioneRisparmio.java`
- [Transaction entity](https://github.com/francesc05cervera/backend-moneyboard2.0/blob/main/src/main/java/com/MoneyBoard2/Model/Transazione.java): `src/main/java/com/MoneyBoard2/Model/Transazione.java`

### Authentication

- [JWT service](https://github.com/francesc05cervera/backend-moneyboard2.0/blob/main/src/main/java/com/MoneyBoard2/security/JwtService.java): `src/main/java/com/MoneyBoard2/security/JwtService.java`
- [Security config](https://github.com/francesc05cervera/backend-moneyboard2.0/blob/main/src/main/java/com/MoneyBoard2/config/SecurityConfig.java): `src/main/java/com/MoneyBoard2/config/SecurityConfig.java`
- [JWT config](https://github.com/francesc05cervera/backend-moneyboard2.0/blob/main/src/main/java/com/MoneyBoard2/config/JwtConfig.java): `src/main/java/com/MoneyBoard2/config/JwtConfig.java`

### Other components

- **API client**
- **PostgreSQL**

## Connections

- API client → User endpoints: calls (evidence: `README.md`)
- API client → Section endpoints: calls (evidence: `README.md`)
- API client → Transaction endpoints: calls (evidence: `README.md`)
- API client → Health ping: checks (evidence: `README.md`)
- User endpoints → User service: delegates to (evidence: `src/main/java/com/MoneyBoard2/NEW_CONTROLLER_JWT/UsrCtrl.java`)
- Section endpoints → Section service: delegates to (evidence: `src/main/java/com/MoneyBoard2/NEW_CONTROLLER_JWT/SezioneCtrl.java`)
- Transaction endpoints → Transaction service: delegates to (evidence: `src/main/java/com/MoneyBoard2/NEW_CONTROLLER_JWT/TransazioneCtrl.java`)
- User endpoints → User DTOs: accepts (evidence: `src/main/java/com/MoneyBoard2/NEW_CONTROLLER_JWT/UsrCtrl.java`)
- User endpoints → Login DTOs: accepts (evidence: `src/main/java/com/MoneyBoard2/NEW_CONTROLLER_JWT/UsrCtrl.java`)
- Section endpoints → Section DTO: accepts (evidence: `src/main/java/com/MoneyBoard2/NEW_CONTROLLER_JWT/SezioneCtrl.java`)
- Transaction endpoints → Transaction DTO: accepts (evidence: `src/main/java/com/MoneyBoard2/NEW_CONTROLLER_JWT/TransazioneCtrl.java`)
- User endpoints → Auth responses: returns (evidence: `src/main/java/com/MoneyBoard2/NEW_CONTROLLER_JWT/UsrCtrl.java`)
- User service → User repository: reads/writes (evidence: `src/main/java/com/MoneyBoard2/Service/ServiceUtente.java`)
- User service → JWT service: issues token (evidence: `src/main/java/com/MoneyBoard2/Service/ServiceUtente.java`)
- Section service → JWT service: validates token (evidence: `src/main/java/com/MoneyBoard2/Service/ServiceSezione.java`)
- Section service → Section repository: reads/writes (evidence: `src/main/java/com/MoneyBoard2/Service/ServiceSezione.java`)
- Section service → User repository: loads owner (evidence: `src/main/java/com/MoneyBoard2/Service/ServiceSezione.java`)
- Transaction service → JWT service: validates token (evidence: `src/main/java/com/MoneyBoard2/Service/ServiceTransazione.java`)
- Transaction service → Section repository: reads/writes (evidence: `src/main/java/com/MoneyBoard2/Service/ServiceTransazione.java`)
- Transaction service → Transaction repository: reads/writes (evidence: `src/main/java/com/MoneyBoard2/Service/ServiceTransazione.java`)
- Transaction service → User repository: loads owner (evidence: `src/main/java/com/MoneyBoard2/Service/ServiceTransazione.java`)
- Transaction service → Section service: updates balance via (evidence: `src/main/java/com/MoneyBoard2/Service/ServiceTransazione.java`)
- User repository → User entity: maps entity (evidence: `src/main/java/com/MoneyBoard2/Repository/UtenteRepository.java`)
- Section repository → Savings section: maps entity (evidence: `src/main/java/com/MoneyBoard2/Repository/SezioneRisparmioRepository.java`)
- Transaction repository → Transaction entity: maps entity (evidence: `src/main/java/com/MoneyBoard2/Repository/TransazioneRepository.java`)
- Savings section → User entity: belongs to (evidence: `src/main/java/com/MoneyBoard2/Model/SezioneRisparmio.java`)
- Transaction entity → Savings section: belongs to (evidence: `src/main/java/com/MoneyBoard2/Model/Transazione.java`)
- Transaction entity → User entity: belongs to (evidence: `src/main/java/com/MoneyBoard2/Model/Transazione.java`)
- JWT config → JWT service: configures (evidence: `src/main/java/com/MoneyBoard2/config/JwtConfig.java`)
- User service → Security config: uses password encoder
- User repository → PostgreSQL: persists via JPA
- Section repository → PostgreSQL: persists via JPA
- Transaction repository → PostgreSQL: persists via JPA
