# aldo1609/payment-proyect architecture

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

- Interactive diagram: https://gitdiagram.com/aldo1609/payment-proyect
- Repository: https://github.com/aldo1609/payment-proyect

## Overview

##### Project type and purpose
- This is a Spring Boot–based, microservice-style, asynchronous payment processing system implementing the producer-consumer pattern.
- It comprises three services:
- An API Gateway (“gateway”) for routing, rate-limiting and logging.
- A payment-producer service (“payment-producer”) exposing a REST API, validating requests and writing PENDING transactions to the database, then publishing payment IDs to Kafka.
- A payment-consumer service (“payment-consumer”) consuming Kafka events, invoking an external payment gateway (e.g. Stripe), and updating transaction status to COMPLETED or FAILED.

##### File structure
- Top-level directories:
- gateway/ – Spring Cloud Gateway service (filters, fallback, Redis rate-limit resolver, YAML config)
- payment-producer/ – Producer microservice (controllers, DTOs, services, custom validation, persistence)
- payment-consumer/ – Consumer microservice (message listener, external gateway client, services, persistence)
- Shared patterns: Spring Boot apps with Maven build, application.yml, health controllers, OpenAPI config.
- Infrastructure files: RedisConfig in gateway, application.yml for DB/Kafka connections, Redis rate limiting, Kafka listener in consumer.

##### README for additional insights
- Architecturally: service-to-service decoupling via Apache Kafka.
- Technology stack: Java 17, Spring Boot, Kafka, PostgreSQL, Maven.
- External dependency: payment gateway (Stripe/PayPal).

##### Detail but avoid over-fragmentation
- Microservices, the queue, the database and the external payment gateway.
- Config modules (e.g. RedisConfig) as notes if needed for clarity.

## Diagram (Mermaid)

```mermaid
flowchart TD
  %% Clients
  Client["Client (Web/Mobile)"]:::external

  %% API Gateway
  subgraph "API Gateway" 
    direction TB
    GatewayApp["GatewayApplication"]:::internal
    GatewayConfig["GatewayConfig"]:::internal
    LoggingFilter["GlobalLoggingFilter"]:::internal
    RateFilter["RateLimitingFilter"]:::internal
    KeyResolver["RateLimitKeyResolver"]:::internal
    FallbackCtrl["FallbackController"]:::internal
    RedisCfg["RedisConfig"]:::internal
    YAML_GW["application.yml"]:::internal
  end

  %% Payment Producer
  subgraph "Payment Producer Service"
    direction TB
    ProdApp["PaymentApplication"]:::internal
    AppConfigP["AppConfig"]:::internal
    OpenApiP["OpenApiConfig"]:::internal
    PaymentCtrl["PaymentController"]:::internal
    HealthCtrlP["HealthController"]:::internal
    ServicePP["ProcessPaymentService"]:::internal
    MapperP["PaymentMapper"]:::internal
    RepoPagosP["PagosRepository"]:::internal
    RepoClientesP["ClientesRepository"]:::internal
    KafkaProd["Kafka Producer"]:::messaging
    YAML_PP["application.yml"]:::internal
  end

  %% Kafka
  subgraph "Kafka Cluster"
    direction TB
    Topic["payment-topic"]:::messaging
  end

  %% Payment Consumer
  subgraph "Payment Consumer Service"
    direction TB
    ConsApp["PaymentConsumerApplication"]:::internal
    AppConfigC["AppConfig"]:::internal
    OpenApiC["OpenApiConfig"]:::internal
    Listener["MessageListener"]:::internal
    ServicePC["PaymentProcessService"]:::internal
    StripeSvc["StripeService"]:::internal
    HealthCtrlC["HealthController"]:::internal
    HealthSvc["HealthService"]:::internal
    RepoPagosC["PagoRepository"]:::internal
    YAML_PC["application.yml"]:::internal
  end

  %% Data Stores & External
  Redis["Redis (Rate Limiting)"]:::db
  Postgres["PostgreSQL"]:::db
  External["External Payment Gateway<br/>(Stripe/PayPal)"]:::external

  %% Flows
  Client -->|HTTP Request| GatewayApp
  RateFilter -->|Resolve Key| Redis
  GatewayApp -->|Route to Producer| ProdApp
  PaymentCtrl -->|Validate & Persist| Postgres
  ProdApp -->|Save PENDING Transaction| Postgres
  ProdApp -->|Produce Payment ID| KafkaProd
  KafkaProd -->|Publish to Topic| Topic
  Topic -->|Consume Payment ID| Listener
  Listener -->|Load Transaction| Postgres
  Listener -->|Invoke External API| External
  Listener -->|Update Status| Postgres

  %% Click Events - Gateway
  click GatewayApp "https://github.com/aldo1609/payment-proyect/blob/master/gateway/src/main/java/com/aldob/gateway/GatewayApplication.java"
  click GatewayConfig "https://github.com/aldo1609/payment-proyect/blob/master/gateway/src/main/java/com/aldob/gateway/config/GatewayConfig.java"
  click LoggingFilter "https://github.com/aldo1609/payment-proyect/blob/master/gateway/src/main/java/com/aldob/gateway/filter/GlobalLoggingFilter.java"
  click RateFilter "https://github.com/aldo1609/payment-proyect/blob/master/gateway/src/main/java/com/aldob/gateway/filter/RateLimitingFilter.java"
  click KeyResolver "https://github.com/aldo1609/payment-proyect/blob/master/gateway/src/main/java/com/aldob/gateway/resolver/RateLimitKeyResolver.java"
  click FallbackCtrl "https://github.com/aldo1609/payment-proyect/blob/master/gateway/src/main/java/com/aldob/gateway/fallback/FallbackController.java"
  click RedisCfg "https://github.com/aldo1609/payment-proyect/blob/master/gateway/src/main/java/com/aldob/gateway/config/RedisConfig.java"
  click YAML_GW "https://github.com/aldo1609/payment-proyect/blob/master/gateway/src/main/resources/application.yml"

  %% Click Events - Producer
  click ProdApp "https://github.com/aldo1609/payment-proyect/blob/master/payment-producer/src/main/java/com/aldob/payment/PaymentApplication.java"
  click AppConfigP "https://github.com/aldo1609/payment-proyect/blob/master/payment-producer/src/main/java/com/aldob/payment/config/AppConfig.java"
  click OpenApiP "https://github.com/aldo1609/payment-proyect/blob/master/payment-producer/src/main/java/com/aldob/payment/config/OpenApiConfig.java"
  click PaymentCtrl "https://github.com/aldo1609/payment-proyect/blob/master/payment-producer/src/main/java/com/aldob/payment/controller/PaymentController.java"
  click HealthCtrlP "https://github.com/aldo1609/payment-proyect/blob/master/payment-producer/src/main/java/com/aldob/payment/controller/HealthController.java"
  click ServicePP "https://github.com/aldo1609/payment-proyect/blob/master/payment-producer/src/main/java/com/aldob/payment/service/ProcessPaymentService.java"
  click RepoPagosP "https://github.com/aldo1609/payment-proyect/blob/master/payment-producer/src/main/java/com/aldob/payment/repository/PagosRepository.java"
  click RepoClientesP "https://github.com/aldo1609/payment-proyect/blob/master/payment-producer/src/main/java/com/aldob/payment/repository/ClientesRepository.java"
  click YAML_PP "https://github.com/aldo1609/payment-proyect/blob/master/payment-producer/src/main/resources/application.yml"

  %% Click Events - Consumer
  click ConsApp "https://github.com/aldo1609/payment-proyect/blob/master/payment-consumer/src/main/java/com/aldob/payment/consumer/PaymentConsumerApplication.java"
  click AppConfigC "https://github.com/aldo1609/payment-proyect/blob/master/payment-consumer/src/main/java/com/aldob/payment/consumer/config/AppConfig.java"
  click OpenApiC "https://github.com/aldo1609/payment-proyect/blob/master/payment-consumer/src/main/java/com/aldob/payment/consumer/config/OpenApiConfig.java"
  click Listener "https://github.com/aldo1609/payment-proyect/blob/master/payment-consumer/src/main/java/com/aldob/payment/consumer/listener/MessageListener.java"
  click ServicePC "https://github.com/aldo1609/payment-proyect/blob/master/payment-consumer/src/main/java/com/aldob/payment/consumer/service/PaymentProcessService.java"
  click StripeSvc "https://github.com/aldo1609/payment-proyect/blob/master/payment-consumer/src/main/java/com/aldob/payment/consumer/service/impl/StripeService.java"
  click HealthCtrlC "https://github.com/aldo1609/payment-proyect/blob/master/payment-consumer/src/main/java/com/aldob/payment/consumer/controller/HealthController.java"
  click HealthSvc "https://github.com/aldo1609/payment-proyect/blob/master/payment-consumer/src/main/java/com/aldob/payment/consumer/service/impl/HealthServiceImpl.java"
  click RepoPagosC "https://github.com/aldo1609/payment-proyect/blob/master/payment-consumer/src/main/java/com/aldob/payment/consumer/repository/PagoRepository.java"
  click YAML_PC "https://github.com/aldo1609/payment-proyect/blob/master/payment-consumer/src/main/resources/application.yml"

  %% Styles
  classDef internal fill:#D0E8FF,stroke:#3399FF,color:#03396c
  classDef db fill:#DFF2BF,stroke:#4F8A10,color:#4F8A10
  classDef messaging fill:#FFE5B4,stroke:#FF8C00,color:#BF5700
  classDef external fill:#F0F0F0,stroke:#999999,color:#333333
```
