# diego-uzc-j/sistema-de-pagos-y-transferencias-en-tiempo-real architecture

> Architecture diagram of the GitHub repository diego-uzc-j/sistema-de-pagos-y-transferencias-en-tiempo-real, 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/diego-uzc-j/sistema-de-pagos-y-transferencias-en-tiempo-real
- Repository: https://github.com/diego-uzc-j/sistema-de-pagos-y-transferencias-en-tiempo-real

## Overview

This is a Spring REST core-banking API for customer registration, account opening and lookup, and monetary transfers. Its main workflow accepts and validates HTTP requests, delegates account or transfer operations to services, and persists the resulting entities through Spring Data repositories. Transfers lock accounts in ID order, check currency and funds, update balances, and record a transaction atomically. The README documents PostgreSQL and Flyway-backed schema setup. Edges reflect excerpts and explicit README or source-index references; unsampled deposit, withdrawal, and database wiring are not expanded beyond documented evidence.

Main entry points: [`src/main/java/com/bank/core/model`](https://github.com/diego-uzc-j/sistema-de-pagos-y-transferencias-en-tiempo-real/tree/main/src/main/java/com/bank/core/model) (JPA Entities), [`src/main/java/com/bank/core/service/AccountService.java`](https://github.com/diego-uzc-j/sistema-de-pagos-y-transferencias-en-tiempo-real/blob/main/src/main/java/com/bank/core/service/AccountService.java) (Account Service), [`src/main/java/com/bank/core/service/TransferService.java`](https://github.com/diego-uzc-j/sistema-de-pagos-y-transferencias-en-tiempo-real/blob/main/src/main/java/com/bank/core/service/TransferService.java) (Transfer Service), [`src/main/java/com/bank/core/repository/AccountRepository.java`](https://github.com/diego-uzc-j/sistema-de-pagos-y-transferencias-en-tiempo-real/blob/main/src/main/java/com/bank/core/repository/AccountRepository.java) (Account Repository)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["REST API"]
  node_users_api["User API"]
  node_accounts_api["Account API"]
  node_transactions_api["Transfer API"]
  node_contracts["Request/Response DTOs"]
end

subgraph group_business["Banking Services"]
  node_user_service["User Service<br/>[UserService.java]"]
  node_account_service["Account Service"]
  node_transfer_service["Transfer Service"]
end

subgraph group_persistence["Persistence"]
  node_user_repo["User Repository"]
  node_account_repo["Account Repository"]
  node_transaction_repo["Transaction Repository"]
  node_schema["Flyway Schema"]
  node_postgres[("PostgreSQL")]
end

subgraph group_domain["Domain Model"]
  node_entities["JPA Entities"]
end

subgraph group_errors["Error Handling"]
  node_exception_types["Domain Exceptions"]
  node_error_handler["Global Error Handler"]
  node_error_response["Error Response<br/>[ErrorResponse.java]"]
end

node_client(("API Client"))

node_client -->|"registers users"| node_users_api
node_client -->|"opens or reads"| node_accounts_api
node_client -->|"requests transfer"| node_transactions_api
node_users_api -->|"accepts and returns"| node_contracts
node_accounts_api -->|"accepts and returns"| node_contracts
node_transactions_api -->|"accepts and returns"| node_contracts
node_users_api -->|"delegates to"| node_user_service
node_accounts_api -->|"delegates to"| node_account_service
node_transactions_api -->|"delegates to"| node_transfer_service
node_user_service -->|"reads and saves"| node_user_repo
node_account_service -->|"finds account owner"| node_user_repo
node_account_service -->|"reads and saves"| node_account_repo
node_transfer_service -->|"locks and saves"| node_account_repo
node_transfer_service -->|"records transfer"| node_transaction_repo
node_user_service -->|"creates users"| node_entities
node_account_service -->|"updates accounts"| node_entities
node_transfer_service -->|"updates and records"| node_entities
node_user_repo -->|"persists users"| node_entities
node_account_repo -->|"persists accounts"| node_entities
node_transaction_repo -->|"persists transactions"| node_entities
node_account_service -->|"throws on failure"| node_exception_types
node_transfer_service -->|"throws on failure"| node_exception_types
node_error_handler -->|"handles exceptions"| node_exception_types
node_error_handler -->|"serializes errors"| node_error_response
node_account_repo -->|"accesses via JPA"| node_postgres
node_schema -->|"defines tables"| node_postgres

click node_users_api "https://github.com/diego-uzc-j/sistema-de-pagos-y-transferencias-en-tiempo-real/blob/main/src/main/java/com/bank/core/controller/UserController.java"
click node_accounts_api "https://github.com/diego-uzc-j/sistema-de-pagos-y-transferencias-en-tiempo-real/blob/main/src/main/java/com/bank/core/controller/AccountController.java"
click node_transactions_api "https://github.com/diego-uzc-j/sistema-de-pagos-y-transferencias-en-tiempo-real/blob/main/src/main/java/com/bank/core/controller/TransactionController.java"
click node_contracts "https://github.com/diego-uzc-j/sistema-de-pagos-y-transferencias-en-tiempo-real/tree/main/src/main/java/com/bank/core/dto"
click node_user_service "https://github.com/diego-uzc-j/sistema-de-pagos-y-transferencias-en-tiempo-real/blob/main/src/main/java/com/bank/core/service/UserService.java"
click node_account_service "https://github.com/diego-uzc-j/sistema-de-pagos-y-transferencias-en-tiempo-real/blob/main/src/main/java/com/bank/core/service/AccountService.java"
click node_transfer_service "https://github.com/diego-uzc-j/sistema-de-pagos-y-transferencias-en-tiempo-real/blob/main/src/main/java/com/bank/core/service/TransferService.java"
click node_user_repo "https://github.com/diego-uzc-j/sistema-de-pagos-y-transferencias-en-tiempo-real/blob/main/src/main/java/com/bank/core/repository/UserRepository.java"
click node_account_repo "https://github.com/diego-uzc-j/sistema-de-pagos-y-transferencias-en-tiempo-real/blob/main/src/main/java/com/bank/core/repository/AccountRepository.java"
click node_transaction_repo "https://github.com/diego-uzc-j/sistema-de-pagos-y-transferencias-en-tiempo-real/blob/main/src/main/java/com/bank/core/repository/TransactionRepository.java"
click node_schema "https://github.com/diego-uzc-j/sistema-de-pagos-y-transferencias-en-tiempo-real/blob/main/src/main/resources/db/migration/V1__init_schema.sql"
click node_entities "https://github.com/diego-uzc-j/sistema-de-pagos-y-transferencias-en-tiempo-real/tree/main/src/main/java/com/bank/core/model"
click node_exception_types "https://github.com/diego-uzc-j/sistema-de-pagos-y-transferencias-en-tiempo-real/tree/main/src/main/java/com/bank/core/exception"
click node_error_handler "https://github.com/diego-uzc-j/sistema-de-pagos-y-transferencias-en-tiempo-real/blob/main/src/main/java/com/bank/core/exception/GlobalExceptionHandler.java"
click node_error_response "https://github.com/diego-uzc-j/sistema-de-pagos-y-transferencias-en-tiempo-real/blob/main/src/main/java/com/bank/core/exception/ErrorResponse.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_users_api,node_accounts_api,node_transactions_api,node_contracts,node_client toneBlue
class node_user_service,node_account_service,node_transfer_service toneAmber
class node_user_repo,node_account_repo,node_transaction_repo,node_schema,node_postgres toneMint
class node_entities toneRose
class node_exception_types,node_error_handler,node_error_response toneIndigo
```

## Components

### REST API

- [User API](https://github.com/diego-uzc-j/sistema-de-pagos-y-transferencias-en-tiempo-real/blob/main/src/main/java/com/bank/core/controller/UserController.java): `src/main/java/com/bank/core/controller/UserController.java`
- [Account API](https://github.com/diego-uzc-j/sistema-de-pagos-y-transferencias-en-tiempo-real/blob/main/src/main/java/com/bank/core/controller/AccountController.java): `src/main/java/com/bank/core/controller/AccountController.java`
- [Transfer API](https://github.com/diego-uzc-j/sistema-de-pagos-y-transferencias-en-tiempo-real/blob/main/src/main/java/com/bank/core/controller/TransactionController.java): `src/main/java/com/bank/core/controller/TransactionController.java`
- [Request/Response DTOs](https://github.com/diego-uzc-j/sistema-de-pagos-y-transferencias-en-tiempo-real/tree/main/src/main/java/com/bank/core/dto): `src/main/java/com/bank/core/dto`

### Banking Services

- [User Service](https://github.com/diego-uzc-j/sistema-de-pagos-y-transferencias-en-tiempo-real/blob/main/src/main/java/com/bank/core/service/UserService.java): `src/main/java/com/bank/core/service/UserService.java`
- [Account Service](https://github.com/diego-uzc-j/sistema-de-pagos-y-transferencias-en-tiempo-real/blob/main/src/main/java/com/bank/core/service/AccountService.java): `src/main/java/com/bank/core/service/AccountService.java`
- [Transfer Service](https://github.com/diego-uzc-j/sistema-de-pagos-y-transferencias-en-tiempo-real/blob/main/src/main/java/com/bank/core/service/TransferService.java): `src/main/java/com/bank/core/service/TransferService.java`

### Persistence

- [User Repository](https://github.com/diego-uzc-j/sistema-de-pagos-y-transferencias-en-tiempo-real/blob/main/src/main/java/com/bank/core/repository/UserRepository.java): `src/main/java/com/bank/core/repository/UserRepository.java`
- [Account Repository](https://github.com/diego-uzc-j/sistema-de-pagos-y-transferencias-en-tiempo-real/blob/main/src/main/java/com/bank/core/repository/AccountRepository.java): `src/main/java/com/bank/core/repository/AccountRepository.java`
- [Transaction Repository](https://github.com/diego-uzc-j/sistema-de-pagos-y-transferencias-en-tiempo-real/blob/main/src/main/java/com/bank/core/repository/TransactionRepository.java): `src/main/java/com/bank/core/repository/TransactionRepository.java`
- [Flyway Schema](https://github.com/diego-uzc-j/sistema-de-pagos-y-transferencias-en-tiempo-real/blob/main/src/main/resources/db/migration/V1__init_schema.sql): `src/main/resources/db/migration/V1__init_schema.sql`
- **PostgreSQL**

### Domain Model

- [JPA Entities](https://github.com/diego-uzc-j/sistema-de-pagos-y-transferencias-en-tiempo-real/tree/main/src/main/java/com/bank/core/model): `src/main/java/com/bank/core/model`

### Error Handling

- [Domain Exceptions](https://github.com/diego-uzc-j/sistema-de-pagos-y-transferencias-en-tiempo-real/tree/main/src/main/java/com/bank/core/exception): `src/main/java/com/bank/core/exception`
- [Global Error Handler](https://github.com/diego-uzc-j/sistema-de-pagos-y-transferencias-en-tiempo-real/blob/main/src/main/java/com/bank/core/exception/GlobalExceptionHandler.java): `src/main/java/com/bank/core/exception/GlobalExceptionHandler.java`
- [Error Response](https://github.com/diego-uzc-j/sistema-de-pagos-y-transferencias-en-tiempo-real/blob/main/src/main/java/com/bank/core/exception/ErrorResponse.java): `src/main/java/com/bank/core/exception/ErrorResponse.java`

### Other components

- **API Client**

## Connections

- API Client → User API: registers users (evidence: `README.md`)
- API Client → Account API: opens or reads (evidence: `README.md`)
- API Client → Transfer API: requests transfer (evidence: `README.md`)
- User API → Request/Response DTOs: accepts and returns (evidence: `src/main/java/com/bank/core/controller/UserController.java`)
- Account API → Request/Response DTOs: accepts and returns (evidence: `src/main/java/com/bank/core/controller/AccountController.java`)
- Transfer API → Request/Response DTOs: accepts and returns (evidence: `src/main/java/com/bank/core/controller/TransactionController.java`)
- User API → User Service: delegates to (evidence: `src/main/java/com/bank/core/controller/UserController.java`)
- Account API → Account Service: delegates to (evidence: `src/main/java/com/bank/core/controller/AccountController.java`)
- Transfer API → Transfer Service: delegates to (evidence: `src/main/java/com/bank/core/controller/TransactionController.java`)
- User Service → User Repository: reads and saves (evidence: `src/main/java/com/bank/core/service/UserService.java`)
- Account Service → User Repository: finds account owner (evidence: `src/main/java/com/bank/core/service/AccountService.java`)
- Account Service → Account Repository: reads and saves (evidence: `src/main/java/com/bank/core/service/AccountService.java`)
- Transfer Service → Account Repository: locks and saves (evidence: `src/main/java/com/bank/core/service/TransferService.java`)
- Transfer Service → Transaction Repository: records transfer (evidence: `src/main/java/com/bank/core/service/TransferService.java`)
- User Service → JPA Entities: creates users (evidence: `src/main/java/com/bank/core/service/UserService.java`)
- Account Service → JPA Entities: updates accounts (evidence: `src/main/java/com/bank/core/service/AccountService.java`)
- Transfer Service → JPA Entities: updates and records (evidence: `src/main/java/com/bank/core/service/TransferService.java`)
- User Repository → JPA Entities: persists users (evidence: `src/main/java/com/bank/core/repository/UserRepository.java`)
- Account Repository → JPA Entities: persists accounts (evidence: `src/main/java/com/bank/core/repository/AccountRepository.java`)
- Transaction Repository → JPA Entities: persists transactions (evidence: `src/main/java/com/bank/core/repository/TransactionRepository.java`)
- Account Service → Domain Exceptions: throws on failure (evidence: `src/main/java/com/bank/core/service/AccountService.java`)
- Transfer Service → Domain Exceptions: throws on failure (evidence: `src/main/java/com/bank/core/service/TransferService.java`)
- Global Error Handler → Domain Exceptions: handles exceptions (evidence: `src/main/java/com/bank/core/exception/GlobalExceptionHandler.java`)
- Global Error Handler → Error Response: serializes errors (evidence: `src/main/java/com/bank/core/exception/GlobalExceptionHandler.java`)
- Account Repository → PostgreSQL: accesses via JPA (evidence: `README.md`)
- Flyway Schema → PostgreSQL: defines tables (evidence: `README.md`)
