# antonioxa/paymentchain architecture

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

- Interactive diagram: https://gitdiagram.com/antonioxa/paymentchain
- Repository: https://github.com/antonioxa/paymentchain

## Overview

Basado en el árbol de archivos y el contenido del README, el repositorio corresponde a un proyecto de microservicios desarrollado en Spring Boot con Java 17, con un enfoque modular y escalable. La arquitectura se divide en dos grandes dominios: el Businessdomain, que contiene los microservicios centrales (Customer, Product y Transaction), y el Infraestructuradomain, que incluye componentes compartidos de infraestructura (Eureka Server, ConfigServer y Spring Boot Admin). Además, existe un módulo padre (paymentchainparent, implícito en el README) y una carpeta config-server-repo para los perfiles de configuración centralizada.

Para dibujar el diagrama de arquitectura siguiendo estos lineamientos, te sugiero lo siguiente:

##### Componentes Principales
- Infraestructura:
- Eureka Server: Registro y descubrimiento de servicios.
- ConfigServer: Servidor de configuración centralizado mediante Spring Cloud Config.
- Spring Boot Admin: Herramienta para monitorización de microservicios.
- Microservicios de Negocio (Businessdomain):
- Customer Service: Gestiona información de clientes (CRUD).
- Product Service: Administra productos asociados a clientes (CRUD).
- Transaction Service: Controla las transacciones (CRUD).
- ConfigServer-Repo: Repositorio dedicado a los perfiles de configuración externalizada.
- Documentación:
- SpringDoc/Swagger UI: Para la documentación y pruebas interactivas de las APIs REST.

##### Relaciones e Interacciones
- Dibujar los microservicios Individualmente y conectarlos mediante flechas que indiquen comunicación.
- Específicamente, resalta que el Customer microservice utiliza WebClient para interactuar con los servicios Product y Transaction.
- Indicar que todos los microservicios se registran en Eureka Server para descubrimiento dinámico.
- Mostrar que la ConfigServer centraliza y distribuye la configuración a cada microservicio.
- Incluir Spring Boot Admin como elemento externo que monitoriza todos los microservicios.

##### Patrones Arquitectónicos y Elementos de Diseño
- Arquitectura de microservicios con desacoplamiento e independencia en despliegue.
- Uso de Spring Cloud para configuraciones centralizadas y descubrimiento de servicios.
- Implementación de documentación automatizada de APIs (con SpringDoc/Swagger UI).
- Nota sobre próximas implementaciones: la intención de dockerizar los microservicios y agregar Spring Security.

##### Tecnologías y Frameworks Relevantes
- Spring Boot (con Java 17) para el desarrollo de cada microservicio.
- Spring Cloud Config para la centralización de configuraciones.
- Netflix Eureka para el registro y descubrimiento de servicios.
- Spring Boot Admin para la monitorización.
- SpringDoc para la generación de documentación de APIs.

##### Guía para Adaptar el Diagrama
- Dado que se trata de una aplicación de microservicios, separa claramente las capas de Infraestructura (Eureka, ConfigServer, Spring Boot Admin) y las del Businessdomain (Customer, Product, Transaction).
- Usa contenedores o secciones diferenciadas para agrupar servicios de negocios versus servicios de infraestructura.
- Emplea flechas direccionales que indiquen el flujo de datos: desde el Customer microservice hacia Product y Transaction, demostrando el uso de WebClient para la comunicación.
- Resalta que todos los componentes (microservicios) están susceptibles a recibir configuraciones externas del ConfigServer, y que se registran/detectan a través del Eureka Server.

##### Elementos Esenciales a Incluir en el Diagrama
- Etiquetas claras para cada microservicio e infraestructura (por ejemplo, “Customer Service”, “Product Service”, “Transaction Service”, “Eureka Server”, “ConfigServer”, “Spring Boot Admin”).
- Flechas direccionales que muestren la comunicación e interdependencia, como:
- Customer Service → Product Service.
- Customer Service → Transaction Service.
- Microservicios ↔ Eureka Server (registro y descubrimiento).
- ConfigServer → Todos los microservicios (distribución de configuraciones).

Siguiendo esta estructura y consejos, el diagrama deberá capturar de forma detallada y precisa la arquitectura del sistema, ilustrando tanto la organización en microservicios como el uso de patrones de comunicación y los componentes de infraestructura que apoyan la operación global del proyecto.

En resumen, crea el diagrama separando los componentes en dos bloques principales (infraestructura y microservicios de negocio), utilizando etiquetas precisas, flechas direccionales para el flujo de datos, y colores o formas para diferenciar los distintos tipos de servicios. Esto proporcionará una visión completa y accesible de la arquitectura para el equipo de desarrollo y las partes interesadas.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Infraestructura
    subgraph "Infraestructura"
        EUREKA["Eureka Server"]:::infra
        CONFIG["Config Server"]:::infra
        ADMIN["Spring Boot Admin"]:::infra
    end

    %% Microservicios de Negocio
    subgraph "Microservicios de Negocio"
        CUSTOMER["Customer Service"]:::business
        PRODUCT["Product Service"]:::business
        TRANSACTION["Transaction Service"]:::business
    end

    %% Config Repository (External)
    CONFIGREPO["ConfigServer-Repo"]:::infra

    %% Interacciones entre microservicios (comunicacion WebClient)
    CUSTOMER -->|"callsWebClient"| PRODUCT
    CUSTOMER -->|"callsWebClient"| TRANSACTION

    %% Registro en Eureka Server (bidireccional)
    CUSTOMER <-->|"registers"| EUREKA
    PRODUCT <-->|"registers"| EUREKA
    TRANSACTION <-->|"registers"| EUREKA

    %% Distribucion de Configuracion desde Config Server a Microservicios
    CONFIG -->|"configures"| CUSTOMER
    CONFIG -->|"configures"| PRODUCT
    CONFIG -->|"configures"| TRANSACTION

    %% Monitoreo de Microservicios mediante Spring Boot Admin
    ADMIN -->|"monitors"| CUSTOMER
    ADMIN -->|"monitors"| PRODUCT
    ADMIN -->|"monitors"| TRANSACTION

    %% Click Events
    click CUSTOMER "https://github.com/antonioxa/paymentchain/tree/main/businessdomain/customer"
    click PRODUCT "https://github.com/antonioxa/paymentchain/tree/main/businessdomain/product"
    click TRANSACTION "https://github.com/antonioxa/paymentchain/tree/main/businessdomain/Transactions"
    click EUREKA "https://github.com/antonioxa/paymentchain/tree/main/infraestructuradomain/eurekaserver"
    click CONFIG "https://github.com/antonioxa/paymentchain/tree/main/infraestructuradomain/configServer"
    click ADMIN "https://github.com/antonioxa/paymentchain/tree/main/infraestructuradomain/SpringBootAdmin"
    click CONFIGREPO "https://github.com/antonioxa/paymentchain/tree/main/config-server-repo"

    %% Estilos
    classDef business fill:#ccffcc,stroke:#333,stroke-width:2px;
    classDef infra fill:#99ccff,stroke:#333,stroke-width:2px;
```
