# alejandrogit549/bancodistribuido architecture

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

- Interactive diagram: https://gitdiagram.com/alejandrogit549/bancodistribuido
- Repository: https://github.com/alejandrogit549/bancodistribuido

## Overview

BancoDistribuido is a banking API backed by separate PostgreSQL (accounts and movements) and SQL Server (customer state) databases. Its principal workflow accepts a transaction request, handles it in the application layer, and persists it through the unit of work to PostgreSQL; the API also exposes account creation and financial-state queries. The graph includes the documented customer-data integration and database/session layer. Some endpoints and handlers are unsampled, so their connections are shown only where the SOURCE INDEX supports them; uncertain links are omitted.

Main entry points: [`src/Application/Features/Transacciones/RegistrarTransaccion/RegistrarTransaccionCommandHandler.cs`](https://github.com/alejandrogit549/bancodistribuido/blob/master/src/Application/Features/Transacciones/RegistrarTransaccion/RegistrarTransaccionCommandHandler.cs) (Register transaction), [`src/Application/Features/Cuentas/CrearCuenta/CrearCuentaCommandHandler.cs`](https://github.com/alejandrogit549/bancodistribuido/blob/master/src/Application/Features/Cuentas/CrearCuenta/CrearCuentaCommandHandler.cs) (Create account), [`src/Api/Endpoints`](https://github.com/alejandrogit549/bancodistribuido/tree/master/src/Api/Endpoints) (Endpoints), [`src/Infrastructure/Persistence/Repositories`](https://github.com/alejandrogit549/bancodistribuido/tree/master/src/Infrastructure/Persistence/Repositories) (Database repositories)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["HTTP API"]
  node_api["Endpoints"]
  node_contracts["Request contracts"]
  node_errors["Exception middleware"]
end

subgraph group_application["Application workflows"]
  node_create["Create account"]
  node_register["Register transaction"]
  node_financial["Financial state query"]
  node_validation["Request validation"]
  node_persistence_contracts["Persistence abstractions"]
  node_user_context["User context"]
end

subgraph group_domain["Banking domain"]
  node_domain_models["Accounts and movements"]
  node_catalogs["Business catalogs"]
  node_business_errors["Business errors"]
end

subgraph group_infrastructure["Persistence infrastructure"]
  node_uow["Unit of work<br/>[UnitOfWork.cs]"]
  node_repositories["Database repositories"]
  node_sessions["Database sessions<br/>[DbSession.cs]"]
  node_connection_factories["Connection factories"]
end

node_caller(("API caller"))
node_postgres[("PostgreSQL")]
node_sqlserver[("SQL Server")]

node_caller -->|"sends request"| node_api
node_api -->|"binds request"| node_contracts
node_api -.->|"dispatches query"| node_financial
node_api -.->|"dispatches command"| node_register
node_create -->|"uses unit of work"| node_persistence_contracts
node_register -->|"uses unit of work"| node_persistence_contracts
node_financial -->|"uses unit of work"| node_persistence_contracts
node_create -->|"reads user"| node_user_context
node_register -->|"reads user"| node_user_context
node_create -->|"creates account"| node_domain_models
node_register -->|"builds movement"| node_domain_models
node_create -->|"checks account type"| node_catalogs
node_register -->|"checks movement type"| node_catalogs
node_create -->|"raises rule errors"| node_business_errors
node_register -->|"raises rule errors"| node_business_errors
node_api -->|"handles exceptions"| node_errors
node_uow -->|"exposes repositories"| node_repositories
node_repositories -->|"uses sessions"| node_sessions
node_sessions -->|"creates connections"| node_connection_factories
node_repositories -->|"calls procedures"| node_postgres
node_repositories -->|"queries customers"| node_sqlserver
node_connection_factories -.->|"connects to"| node_postgres
node_connection_factories -.->|"connects to"| node_sqlserver

click node_api "https://github.com/alejandrogit549/bancodistribuido/tree/master/src/Api/Endpoints"
click node_contracts "https://github.com/alejandrogit549/bancodistribuido/tree/master/src/Api/Contracts"
click node_errors "https://github.com/alejandrogit549/bancodistribuido/blob/master/src/Api/Middleware/ExceptionHandlingMiddleware.cs"
click node_create "https://github.com/alejandrogit549/bancodistribuido/blob/master/src/Application/Features/Cuentas/CrearCuenta/CrearCuentaCommandHandler.cs"
click node_register "https://github.com/alejandrogit549/bancodistribuido/blob/master/src/Application/Features/Transacciones/RegistrarTransaccion/RegistrarTransaccionCommandHandler.cs"
click node_financial "https://github.com/alejandrogit549/bancodistribuido/blob/master/src/Application/Features/Clientes/ObtenerEstadoFinanciero/ObtenerEstadoFinancieroQueryHandler.cs"
click node_validation "https://github.com/alejandrogit549/bancodistribuido/blob/master/src/Application/Behaviors/ValidationBehavior.cs"
click node_persistence_contracts "https://github.com/alejandrogit549/bancodistribuido/tree/master/src/Application/Abstractions/Persistence"
click node_user_context "https://github.com/alejandrogit549/bancodistribuido/blob/master/src/Application/Abstractions/Services/IUsuarioContexto.cs"
click node_domain_models "https://github.com/alejandrogit549/bancodistribuido/tree/master/src/Domain/Entities"
click node_catalogs "https://github.com/alejandrogit549/bancodistribuido/tree/master/src/Domain/Catalogos"
click node_business_errors "https://github.com/alejandrogit549/bancodistribuido/tree/master/src/Domain/Exceptions"
click node_uow "https://github.com/alejandrogit549/bancodistribuido/blob/master/src/Infrastructure/Persistence/UnitOfWork.cs"
click node_repositories "https://github.com/alejandrogit549/bancodistribuido/tree/master/src/Infrastructure/Persistence/Repositories"
click node_sessions "https://github.com/alejandrogit549/bancodistribuido/blob/master/src/Infrastructure/Persistence/Connections/DbSession.cs"
click node_connection_factories "https://github.com/alejandrogit549/bancodistribuido/tree/master/src/Infrastructure/Persistence/Connections"

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_api,node_contracts,node_errors toneBlue
class node_create,node_register,node_financial,node_validation,node_persistence_contracts,node_user_context,node_postgres,node_sqlserver toneAmber
class node_domain_models,node_catalogs,node_business_errors,node_caller toneMint
class node_uow,node_repositories,node_sessions,node_connection_factories toneRose
```

## Components

### HTTP API

- [Endpoints](https://github.com/alejandrogit549/bancodistribuido/tree/master/src/Api/Endpoints): `src/Api/Endpoints`
- [Request contracts](https://github.com/alejandrogit549/bancodistribuido/tree/master/src/Api/Contracts): `src/Api/Contracts`
- [Exception middleware](https://github.com/alejandrogit549/bancodistribuido/blob/master/src/Api/Middleware/ExceptionHandlingMiddleware.cs): `src/Api/Middleware/ExceptionHandlingMiddleware.cs`

### Application workflows

- [Create account](https://github.com/alejandrogit549/bancodistribuido/blob/master/src/Application/Features/Cuentas/CrearCuenta/CrearCuentaCommandHandler.cs): `src/Application/Features/Cuentas/CrearCuenta/CrearCuentaCommandHandler.cs`
- [Register transaction](https://github.com/alejandrogit549/bancodistribuido/blob/master/src/Application/Features/Transacciones/RegistrarTransaccion/RegistrarTransaccionCommandHandler.cs): `src/Application/Features/Transacciones/RegistrarTransaccion/RegistrarTransaccionCommandHandler.cs`
- [Financial state query](https://github.com/alejandrogit549/bancodistribuido/blob/master/src/Application/Features/Clientes/ObtenerEstadoFinanciero/ObtenerEstadoFinancieroQueryHandler.cs): `src/Application/Features/Clientes/ObtenerEstadoFinanciero/ObtenerEstadoFinancieroQueryHandler.cs`
- [Request validation](https://github.com/alejandrogit549/bancodistribuido/blob/master/src/Application/Behaviors/ValidationBehavior.cs): `src/Application/Behaviors/ValidationBehavior.cs`
- [Persistence abstractions](https://github.com/alejandrogit549/bancodistribuido/tree/master/src/Application/Abstractions/Persistence): `src/Application/Abstractions/Persistence`
- [User context](https://github.com/alejandrogit549/bancodistribuido/blob/master/src/Application/Abstractions/Services/IUsuarioContexto.cs): `src/Application/Abstractions/Services/IUsuarioContexto.cs`

### Banking domain

- [Accounts and movements](https://github.com/alejandrogit549/bancodistribuido/tree/master/src/Domain/Entities): `src/Domain/Entities`
- [Business catalogs](https://github.com/alejandrogit549/bancodistribuido/tree/master/src/Domain/Catalogos): `src/Domain/Catalogos`
- [Business errors](https://github.com/alejandrogit549/bancodistribuido/tree/master/src/Domain/Exceptions): `src/Domain/Exceptions`

### Persistence infrastructure

- [Unit of work](https://github.com/alejandrogit549/bancodistribuido/blob/master/src/Infrastructure/Persistence/UnitOfWork.cs): `src/Infrastructure/Persistence/UnitOfWork.cs`
- [Database repositories](https://github.com/alejandrogit549/bancodistribuido/tree/master/src/Infrastructure/Persistence/Repositories): `src/Infrastructure/Persistence/Repositories`
- [Database sessions](https://github.com/alejandrogit549/bancodistribuido/blob/master/src/Infrastructure/Persistence/Connections/DbSession.cs): `src/Infrastructure/Persistence/Connections/DbSession.cs`
- [Connection factories](https://github.com/alejandrogit549/bancodistribuido/tree/master/src/Infrastructure/Persistence/Connections): `src/Infrastructure/Persistence/Connections`

### Other components

- **API caller**
- **PostgreSQL**
- **SQL Server**

## Connections

- API caller → Endpoints: sends request
- Endpoints → Request contracts: binds request (evidence: `src/Api/Endpoints/TransaccionesEndpoints.cs`)
- Endpoints → Financial state query: dispatches query
- Endpoints → Register transaction: dispatches command
- Create account → Persistence abstractions: uses unit of work (evidence: `src/Application/Features/Cuentas/CrearCuenta/CrearCuentaCommandHandler.cs`)
- Register transaction → Persistence abstractions: uses unit of work (evidence: `src/Application/Features/Transacciones/RegistrarTransaccion/RegistrarTransaccionCommandHandler.cs`)
- Financial state query → Persistence abstractions: uses unit of work (evidence: `src/Application/Features/Clientes/ObtenerEstadoFinanciero/ObtenerEstadoFinancieroQueryHandler.cs`)
- Create account → User context: reads user (evidence: `src/Application/Features/Cuentas/CrearCuenta/CrearCuentaCommandHandler.cs`)
- Register transaction → User context: reads user (evidence: `src/Application/Features/Transacciones/RegistrarTransaccion/RegistrarTransaccionCommandHandler.cs`)
- Create account → Accounts and movements: creates account (evidence: `src/Application/Features/Cuentas/CrearCuenta/CrearCuentaCommandHandler.cs`)
- Register transaction → Accounts and movements: builds movement (evidence: `src/Application/Features/Transacciones/RegistrarTransaccion/RegistrarTransaccionCommandHandler.cs`)
- Create account → Business catalogs: checks account type (evidence: `src/Application/Features/Cuentas/CrearCuenta/CrearCuentaCommandHandler.cs`)
- Register transaction → Business catalogs: checks movement type (evidence: `src/Application/Features/Transacciones/RegistrarTransaccion/RegistrarTransaccionCommandHandler.cs`)
- Create account → Business errors: raises rule errors (evidence: `src/Application/Features/Cuentas/CrearCuenta/CrearCuentaCommandHandler.cs`)
- Register transaction → Business errors: raises rule errors (evidence: `src/Application/Features/Transacciones/RegistrarTransaccion/RegistrarTransaccionCommandHandler.cs`)
- Endpoints → Exception middleware: handles exceptions
- Unit of work → Database repositories: exposes repositories
- Database repositories → Database sessions: uses sessions (evidence: `src/Infrastructure/Persistence/Repositories/TransaccionRepository.cs`)
- Database sessions → Connection factories: creates connections (evidence: `src/Infrastructure/Persistence/Connections/DbSession.cs`)
- Database repositories → PostgreSQL: calls procedures (evidence: `src/Infrastructure/Persistence/Repositories/TransaccionRepository.cs`)
- Database repositories → SQL Server: queries customers (evidence: `src/Infrastructure/Persistence/Repositories/ClienteRepository.cs`)
- Connection factories → PostgreSQL: connects to
- Connection factories → SQL Server: connects to
