# sebs210/prueba-detsu architecture

> Architecture diagram of the GitHub repository sebs210/prueba-detsu, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-04-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/sebs210/prueba-detsu
- Repository: https://github.com/sebs210/prueba-detsu

## Overview

##### Main Components
- Microservice Cliente:
- Serves CRUD operations for “Cliente” and “Persona”.
- Contains layers for configuration (e.g. RabbitMQConfig), controller (ClienteController), domain (Cliente and Persona), repository, and service (ClienteMessageSender).
- Connects to its own PostgreSQL instance (“cliente_db” as defined in the BaseDatos.sql and docker-compose).
- Microservice Cuenta:
- Manages “Cuenta” and “Movimiento” including CRUD operations, report generation, and error handling.
- Contains similar layers (configuration with its RabbitMQConfig, controllers such as CuentaController and MovimientoController, domain objects, DTOs, repository, service with a message listener for asynchronous account creation).
- Uses a separate PostgreSQL instance (“cuenta_db”).
- RabbitMQ:
- Acts as the intermediary for asynchronous communication. When a client is created in microservice-cliente, a message is sent to microservice-cuenta to automatically initialize an account.
- Databases:
- Two PostgreSQL databases (one for each microservice).
- Docker and Docker Compose:
- The overall deployment mechanism tying together the microservices, databases, and RabbitMQ.

##### Relationships and Interactions
- Microservice-cliente sends an asynchronous message via RabbitMQ every time a new client is created.
- Microservice-cuenta listens for these messages (using its message listener) and then creates a corresponding bank account.
- Both services expose RESTful endpoints (different ports: 8081 for cliente, 8082 for cuenta) and interact with their own databases.
- Docker Compose orchestrates the startup order and network connectivity among the two services, RabbitMQ server, and the PostgreSQL containers.

##### Architectural Patterns and Design Principles
- Microservices Architecture: The project is naturally split into independent services that work together.
- Asynchronous Messaging: RabbitMQ is used to decouple operations (client creation triggers account creation asynchronously).
- Layered (N-tier) design: Each service separates concerns (controller, service, repository, configuration, domain) which is typical in Spring Boot applications.
- Containerization: Docker and Docker Compose simplify deployment and simulate production-like environments.

##### Relevant Technologies
- Backend: Spring Boot (Java 17)
- Databases: PostgreSQL (version 15)
- Messaging: RabbitMQ (version 3)
- Build Tool: Maven (with supporting wrapper scripts)
- Testing: JUnit 5, Integration tests inside the respective microservice folders
- Deployment: Docker and Docker Compose

##### Elements
- Each container/component should be clearly labeled (e.g., “Microservice Cliente”, “Microservice Cuenta”, “RabbitMQ Broker”, “PostgreSQL for Cliente”, “PostgreSQL for Cuenta”).
- HTTP request flows between external consumers and each service.
- The message flow from microservice-cliente to microservice-cuenta via RabbitMQ.
- Data access flows between microservices and their particular PostgreSQL database.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% External and Deployment Nodes
    extClient["External Client"]:::external
    deployment["Docker Compose Orchestration"]:::container
    broker["RabbitMQ Broker"]:::broker
    clienteDB["PostgreSQL - ClienteDB"]:::db
    cuentaDB["PostgreSQL - CuentaDB"]:::db
    cl_db_sql["Cliente DB Init Script"]:::db
    cu_db_sql["Cuenta DB Init Script"]:::db

    %% Microservice Cliente Subgraph
    subgraph "Microservice Cliente"
        cl_app["Cliente Main Application"]:::microservice
        cl_config["RabbitMQ Config"]:::microservice
        cl_controller["Cliente Controller"]:::microservice
        cl_cliente["Domain: Cliente"]:::domain
        cl_persona["Domain: Persona"]:::domain
        cl_repository["Cliente Repository"]:::microservice
        cl_sender["Cliente Message Sender"]:::microservice
    end

    %% Microservice Cuenta Subgraph
    subgraph "Microservice Cuenta"
        cu_app["Cuenta Main Application"]:::microservice
        cu_config["RabbitMQ Config"]:::microservice
        cu_controller["Cuenta Controller"]:::microservice
        mv_controller["Movimiento Controller"]:::microservice
        cu_domain["Domain: Cuenta"]:::domain
        mv_domain["Domain: Movimiento"]:::domain
        dto1["DTO: CuentaReporteDTO"]:::dto
        dto2["DTO: MovimientoDTO"]:::dto
        dto3["DTO: ReporteEstadoCuentaDTO"]:::dto
        exc1["Global Exception Handler"]:::exception
        exc2["SaldoInsuficiente Exception"]:::exception
        cu_repository["Cuenta Repository"]:::microservice
        mv_repository["Movimiento Repository"]:::microservice
        cu_listener["Cliente Message Listener"]:::microservice
        mv_service["Movimiento Service"]:::microservice
    end

    %% Relationships for External Access and Deployment
    extClient -->|"HTTP Request"| cl_controller
    extClient -->|"HTTP Request"| cu_controller
    deployment --> cl_app
    deployment --> cu_app
    deployment --> broker
    deployment --> clienteDB
    deployment --> cuentaDB

    %% Relationships within Microservice Cliente
    cl_app --> cl_config
    cl_config --> cl_controller
    cl_controller --> cl_repository
    cl_controller --> cl_sender
    cl_sender -->|"Sends Msg"| broker
    cl_repository -->|"Data Access"| clienteDB

    %% Link Cliente DB Init Script to ClienteDB
    cl_db_sql --- clienteDB

    %% Relationships within Microservice Cuenta
    cu_app --> cu_config
    cu_config --> cu_controller
    cu_app --> mv_controller
    cu_controller --> cu_repository
    mv_controller --> mv_repository
    cu_controller --> cu_domain
    mv_controller --> mv_domain
    cu_controller --> dto1
    cu_controller --> dto2
    cu_controller --> dto3
    cu_controller --> exc1
    cu_controller --> exc2
    broker --> cu_listener
    cu_listener --> cu_domain
    cu_listener --> mv_service
    cu_repository -->|"Data Access"| cuentaDB
    mv_repository -->|"Data Access"| cuentaDB

    %% Link Cuenta DB Init Script to CuentaDB
    cu_db_sql --- cuentaDB

    %% Styling
    classDef microservice fill:#ADD8E6,stroke:#000,stroke-width:2px;
    classDef domain fill:#FFB6C1,stroke:#000,stroke-width:2px;
    classDef dto fill:#DDA0DD,stroke:#000,stroke-width:2px;
    classDef exception fill:#FFA07A,stroke:#000,stroke-width:2px;
    classDef external fill:#90EE90,stroke:#000,stroke-width:2px;
    classDef broker fill:#FFFF99,stroke:#000,stroke-width:2px;
    classDef db fill:#98FB98,stroke:#000,stroke-width:2px;
    classDef container fill:#FFD700,stroke:#000,stroke-width:2px;

    %% Click Events for Microservice Cliente
    click cl_app "https://github.com/sebs210/prueba-detsu/blob/master/microservice-cliente/src/main/java/com/example/microservicecliente/MicroserviceClienteApplication.java"
    click cl_config "https://github.com/sebs210/prueba-detsu/blob/master/microservice-cliente/src/main/java/com/example/microservicecliente/config/RabbitMQConfig.java"
    click cl_controller "https://github.com/sebs210/prueba-detsu/blob/master/microservice-cliente/src/main/java/com/example/microservicecliente/controller/ClienteController.java"
    click cl_cliente "https://github.com/sebs210/prueba-detsu/blob/master/microservice-cliente/src/main/java/com/example/microservicecliente/domain/Cliente.java"
    click cl_persona "https://github.com/sebs210/prueba-detsu/blob/master/microservice-cliente/src/main/java/com/example/microservicecliente/domain/Persona.java"
    click cl_repository "https://github.com/sebs210/prueba-detsu/blob/master/microservice-cliente/src/main/java/com/example/microservicecliente/repository/ClienteRepository.java"
    click cl_sender "https://github.com/sebs210/prueba-detsu/blob/master/microservice-cliente/src/main/java/com/example/microservicecliente/service/ClienteMessageSender.java"

    %% Click Events for Microservice Cuenta
    click cu_app "https://github.com/sebs210/prueba-detsu/blob/master/microservice-cuenta/src/main/java/com/example/microservicecuenta/MicroserviceCuentaApplication.java"
    click cu_config "https://github.com/sebs210/prueba-detsu/blob/master/microservice-cuenta/src/main/java/com/example/microservicecuenta/config/RabbitMQConfig.java"
    click cu_controller "https://github.com/sebs210/prueba-detsu/blob/master/microservice-cuenta/src/main/java/com/example/microservicecuenta/controller/CuentaController.java"
    click mv_controller "https://github.com/sebs210/prueba-detsu/blob/master/microservice-cuenta/src/main/java/com/example/microservicecuenta/controller/MovimientoController.java"
    click cu_domain "https://github.com/sebs210/prueba-detsu/blob/master/microservice-cuenta/src/main/java/com/example/microservicecuenta/domain/Cuenta.java"
    click mv_domain "https://github.com/sebs210/prueba-detsu/blob/master/microservice-cuenta/src/main/java/com/example/microservicecuenta/domain/Movimiento.java"
    click dto1 "https://github.com/sebs210/prueba-detsu/blob/master/microservice-cuenta/src/main/java/com/example/microservicecuenta/dto/CuentaReporteDTO.java"
    click dto2 "https://github.com/sebs210/prueba-detsu/blob/master/microservice-cuenta/src/main/java/com/example/microservicecuenta/dto/MovimientoDTO.java"
    click dto3 "https://github.com/sebs210/prueba-detsu/blob/master/microservice-cuenta/src/main/java/com/example/microservicecuenta/dto/ReporteEstadoCuentaDTO.java"
    click exc1 "https://github.com/sebs210/prueba-detsu/blob/master/microservice-cuenta/src/main/java/com/example/microservicecuenta/exception/GlobalExceptionHandler.java"
    click exc2 "https://github.com/sebs210/prueba-detsu/blob/master/microservice-cuenta/src/main/java/com/example/microservicecuenta/exception/SaldoInsuficienteException.java"
    click cu_repository "https://github.com/sebs210/prueba-detsu/blob/master/microservice-cuenta/src/main/java/com/example/microservicecuenta/repository/CuentaRepository.java"
    click mv_repository "https://github.com/sebs210/prueba-detsu/blob/master/microservice-cuenta/src/main/java/com/example/microservicecuenta/repository/MovimientoRepository.java"
    click cu_listener "https://github.com/sebs210/prueba-detsu/blob/master/microservice-cuenta/src/main/java/com/example/microservicecuenta/service/ClienteMessageListener.java"
    click mv_service "https://github.com/sebs210/prueba-detsu/blob/master/microservice-cuenta/src/main/java/com/example/microservicecuenta/service/MovimientoService.java"

    %% Click Events for Deployment and DB Scripts
    click deployment "https://github.com/sebs210/prueba-detsu/blob/master/docker-compose.yml"
    click cl_db_sql "https://github.com/sebs210/prueba-detsu/blob/master/BaseDatos.sql"
    click cu_db_sql "https://github.com/sebs210/prueba-detsu/blob/master/microservice-cuenta/BaseDatos.sql"
```
