# gabs06dev/transaction-execution-api-challange architecture

> Architecture diagram of the GitHub repository gabs06dev/transaction-execution-api-challange, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/gabs06dev/transaction-execution-api-challange
- Repository: https://github.com/gabs06dev/transaction-execution-api-challange

## Overview

This is a Spring Boot financial transaction API. Clients can search transactions by status, account and type, or submit a transaction for validation, external-provider execution and persistence. Provider failures are translated into API errors, with failed attempts also recorded. PostgreSQL and the provider integration are documented product dependencies; the sampled code confirms the Feign call and persistence interfaces, but does not expose database configuration details or all runtime wiring.

Main entry points: [`src/main/java/com/gabsDev/transactionExecution/Service/TransactionService.java`](https://github.com/gabs06dev/transaction-execution-api-challange/blob/main/src/main/java/com/gabsDev/transactionExecution/Service/TransactionService.java) (Transaction workflow), [`src/main/java/com/gabsDev/transactionExecution/Remote/Service/ExternalProviderService.java`](https://github.com/gabs06dev/transaction-execution-api-challange/blob/main/src/main/java/com/gabsDev/transactionExecution/Remote/Service/ExternalProviderService.java) (Provider handling), [`src/main/java/com/gabsDev/transactionExecution/Controller/TransactionController.java`](https://github.com/gabs06dev/transaction-execution-api-challange/blob/main/src/main/java/com/gabsDev/transactionExecution/Controller/TransactionController.java) (Transaction endpoints), [`src/main/java/com/gabsDev/transactionExecution/Exception/GlobalExceptionHandler.java`](https://github.com/gabs06dev/transaction-execution-api-challange/blob/main/src/main/java/com/gabsDev/transactionExecution/Exception/GlobalExceptionHandler.java) (Error mapping)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API boundary"]
  node_controller["Transaction endpoints"]
  node_handler["Error mapping"]
  node_response["API response model<br/>[ResponseModel.java]"]
  node_provider_exception["Provider exception"]
  node_transaction_exception["Validation exception"]
end

subgraph group_processing["Transaction processing"]
  node_request["Transaction request"]
  node_service["Transaction workflow"]
  node_validator["Business validation"]
  node_specification["Search filters"]
  node_constants["Transaction constants<br/>[Constantes.java]"]
end

subgraph group_provider["Provider integration"]
  node_provider_service["Provider handling"]
  node_provider_repo["Feign provider client"]
  node_provider_request["Provider request"]
  node_provider_response["Provider response"]
  node_provider_error["Provider error payload"]
end

subgraph group_storage["Transaction storage"]
  node_transaction["Transaction record<br/>[Transaction.java]"]
  node_repository["Transaction repository"]
  node_database[("PostgreSQL")]
  node_failed_service["Failed attempt recording"]
end

node_client(("API client"))
node_provider(("External provider"))

node_client -->|"calls endpoints"| node_controller
node_controller -->|"accepts"| node_request
node_controller -->|"delegates to"| node_service
node_controller -.->|"errors handled by"| node_handler
node_handler -->|"builds"| node_response
node_handler -->|"handles"| node_provider_exception
node_handler -->|"handles"| node_transaction_exception
node_service -->|"validates with"| node_validator
node_service -->|"builds filters"| node_specification
node_service -->|"creates"| node_provider_request
node_service -->|"requests execution"| node_provider_service
node_provider_service -->|"calls"| node_provider_repo
node_provider_repo -->|"posts transaction"| node_provider
node_provider_repo -->|"sends"| node_provider_request
node_provider_repo -->|"receives"| node_provider_response
node_provider_service -->|"records failure"| node_failed_service
node_provider_service -->|"parses"| node_provider_error
node_provider_service -->|"raises"| node_provider_exception
node_provider_service -->|"uses codes"| node_constants
node_validator -->|"raises"| node_transaction_exception
node_validator -->|"checks constants"| node_constants
node_service -->|"uses result"| node_provider_response
node_service -->|"queries and saves"| node_repository
node_service -->|"creates record"| node_transaction
node_failed_service -->|"saves failed record"| node_repository
node_repository -.->|"persists records"| node_database
node_specification -->|"filters records"| node_transaction

click node_controller "https://github.com/gabs06dev/transaction-execution-api-challange/blob/main/src/main/java/com/gabsDev/transactionExecution/Controller/TransactionController.java"
click node_handler "https://github.com/gabs06dev/transaction-execution-api-challange/blob/main/src/main/java/com/gabsDev/transactionExecution/Exception/GlobalExceptionHandler.java"
click node_response "https://github.com/gabs06dev/transaction-execution-api-challange/blob/main/src/main/java/com/gabsDev/transactionExecution/Remote/Dto/ResponseModel.java"
click node_request "https://github.com/gabs06dev/transaction-execution-api-challange/blob/main/src/main/java/com/gabsDev/transactionExecution/Remote/Dto/TransactionRequest.java"
click node_service "https://github.com/gabs06dev/transaction-execution-api-challange/blob/main/src/main/java/com/gabsDev/transactionExecution/Service/TransactionService.java"
click node_validator "https://github.com/gabs06dev/transaction-execution-api-challange/blob/main/src/main/java/com/gabsDev/transactionExecution/Validator/TransactionValidator.java"
click node_specification "https://github.com/gabs06dev/transaction-execution-api-challange/blob/main/src/main/java/com/gabsDev/transactionExecution/Specification/TransactionSpecification.java"
click node_transaction "https://github.com/gabs06dev/transaction-execution-api-challange/blob/main/src/main/java/com/gabsDev/transactionExecution/Entity/Transaction.java"
click node_repository "https://github.com/gabs06dev/transaction-execution-api-challange/blob/main/src/main/java/com/gabsDev/transactionExecution/Repository/TransactionRepository.java"
click node_provider_service "https://github.com/gabs06dev/transaction-execution-api-challange/blob/main/src/main/java/com/gabsDev/transactionExecution/Remote/Service/ExternalProviderService.java"
click node_provider_repo "https://github.com/gabs06dev/transaction-execution-api-challange/blob/main/src/main/java/com/gabsDev/transactionExecution/Remote/Repository/ExternalProviderRepository.java"
click node_provider_request "https://github.com/gabs06dev/transaction-execution-api-challange/blob/main/src/main/java/com/gabsDev/transactionExecution/Remote/Dto/ProviderRequest.java"
click node_provider_response "https://github.com/gabs06dev/transaction-execution-api-challange/blob/main/src/main/java/com/gabsDev/transactionExecution/Remote/Dto/ProviderResponse.java"
click node_failed_service "https://github.com/gabs06dev/transaction-execution-api-challange/blob/main/src/main/java/com/gabsDev/transactionExecution/Service/FailedTransactionService.java"
click node_provider_error "https://github.com/gabs06dev/transaction-execution-api-challange/blob/main/src/main/java/com/gabsDev/transactionExecution/Remote/Dto/ExternalProviderError.java"
click node_provider_exception "https://github.com/gabs06dev/transaction-execution-api-challange/blob/main/src/main/java/com/gabsDev/transactionExecution/Exception/ExternalProviderException.java"
click node_transaction_exception "https://github.com/gabs06dev/transaction-execution-api-challange/blob/main/src/main/java/com/gabsDev/transactionExecution/Exception/TransactionException.java"
click node_constants "https://github.com/gabs06dev/transaction-execution-api-challange/blob/main/src/main/java/Utils/Constantes.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_controller,node_handler,node_response,node_provider_exception,node_transaction_exception,node_client toneBlue
class node_request,node_service,node_validator,node_specification,node_constants toneAmber
class node_provider_service,node_provider_repo,node_provider_request,node_provider_response,node_provider_error toneMint
class node_transaction,node_repository,node_database,node_failed_service toneRose
class node_provider toneIndigo
```

## Components

### API boundary

- [Transaction endpoints](https://github.com/gabs06dev/transaction-execution-api-challange/blob/main/src/main/java/com/gabsDev/transactionExecution/Controller/TransactionController.java): `src/main/java/com/gabsDev/transactionExecution/Controller/TransactionController.java`
- [Error mapping](https://github.com/gabs06dev/transaction-execution-api-challange/blob/main/src/main/java/com/gabsDev/transactionExecution/Exception/GlobalExceptionHandler.java): `src/main/java/com/gabsDev/transactionExecution/Exception/GlobalExceptionHandler.java`
- [API response model](https://github.com/gabs06dev/transaction-execution-api-challange/blob/main/src/main/java/com/gabsDev/transactionExecution/Remote/Dto/ResponseModel.java): `src/main/java/com/gabsDev/transactionExecution/Remote/Dto/ResponseModel.java`
- [Provider exception](https://github.com/gabs06dev/transaction-execution-api-challange/blob/main/src/main/java/com/gabsDev/transactionExecution/Exception/ExternalProviderException.java): `src/main/java/com/gabsDev/transactionExecution/Exception/ExternalProviderException.java`
- [Validation exception](https://github.com/gabs06dev/transaction-execution-api-challange/blob/main/src/main/java/com/gabsDev/transactionExecution/Exception/TransactionException.java): `src/main/java/com/gabsDev/transactionExecution/Exception/TransactionException.java`

### Transaction processing

- [Transaction request](https://github.com/gabs06dev/transaction-execution-api-challange/blob/main/src/main/java/com/gabsDev/transactionExecution/Remote/Dto/TransactionRequest.java): `src/main/java/com/gabsDev/transactionExecution/Remote/Dto/TransactionRequest.java`
- [Transaction workflow](https://github.com/gabs06dev/transaction-execution-api-challange/blob/main/src/main/java/com/gabsDev/transactionExecution/Service/TransactionService.java): `src/main/java/com/gabsDev/transactionExecution/Service/TransactionService.java`
- [Business validation](https://github.com/gabs06dev/transaction-execution-api-challange/blob/main/src/main/java/com/gabsDev/transactionExecution/Validator/TransactionValidator.java): `src/main/java/com/gabsDev/transactionExecution/Validator/TransactionValidator.java`
- [Search filters](https://github.com/gabs06dev/transaction-execution-api-challange/blob/main/src/main/java/com/gabsDev/transactionExecution/Specification/TransactionSpecification.java): `src/main/java/com/gabsDev/transactionExecution/Specification/TransactionSpecification.java`
- [Transaction constants](https://github.com/gabs06dev/transaction-execution-api-challange/blob/main/src/main/java/Utils/Constantes.java): `src/main/java/Utils/Constantes.java`

### Provider integration

- [Provider handling](https://github.com/gabs06dev/transaction-execution-api-challange/blob/main/src/main/java/com/gabsDev/transactionExecution/Remote/Service/ExternalProviderService.java): `src/main/java/com/gabsDev/transactionExecution/Remote/Service/ExternalProviderService.java`
- [Feign provider client](https://github.com/gabs06dev/transaction-execution-api-challange/blob/main/src/main/java/com/gabsDev/transactionExecution/Remote/Repository/ExternalProviderRepository.java): `src/main/java/com/gabsDev/transactionExecution/Remote/Repository/ExternalProviderRepository.java`
- [Provider request](https://github.com/gabs06dev/transaction-execution-api-challange/blob/main/src/main/java/com/gabsDev/transactionExecution/Remote/Dto/ProviderRequest.java): `src/main/java/com/gabsDev/transactionExecution/Remote/Dto/ProviderRequest.java`
- [Provider response](https://github.com/gabs06dev/transaction-execution-api-challange/blob/main/src/main/java/com/gabsDev/transactionExecution/Remote/Dto/ProviderResponse.java): `src/main/java/com/gabsDev/transactionExecution/Remote/Dto/ProviderResponse.java`
- [Provider error payload](https://github.com/gabs06dev/transaction-execution-api-challange/blob/main/src/main/java/com/gabsDev/transactionExecution/Remote/Dto/ExternalProviderError.java): `src/main/java/com/gabsDev/transactionExecution/Remote/Dto/ExternalProviderError.java`

### Transaction storage

- [Transaction record](https://github.com/gabs06dev/transaction-execution-api-challange/blob/main/src/main/java/com/gabsDev/transactionExecution/Entity/Transaction.java): `src/main/java/com/gabsDev/transactionExecution/Entity/Transaction.java`
- [Transaction repository](https://github.com/gabs06dev/transaction-execution-api-challange/blob/main/src/main/java/com/gabsDev/transactionExecution/Repository/TransactionRepository.java): `src/main/java/com/gabsDev/transactionExecution/Repository/TransactionRepository.java`
- **PostgreSQL**
- [Failed attempt recording](https://github.com/gabs06dev/transaction-execution-api-challange/blob/main/src/main/java/com/gabsDev/transactionExecution/Service/FailedTransactionService.java): `src/main/java/com/gabsDev/transactionExecution/Service/FailedTransactionService.java`

### Other components

- **API client**
- **External provider**

## Connections

- API client → Transaction endpoints: calls endpoints (evidence: `README.md`)
- Transaction endpoints → Transaction request: accepts (evidence: `src/main/java/com/gabsDev/transactionExecution/Controller/TransactionController.java`)
- Transaction endpoints → Transaction workflow: delegates to (evidence: `src/main/java/com/gabsDev/transactionExecution/Controller/TransactionController.java`)
- Transaction endpoints → Error mapping: errors handled by
- Error mapping → API response model: builds (evidence: `src/main/java/com/gabsDev/transactionExecution/Exception/GlobalExceptionHandler.java`)
- Error mapping → Provider exception: handles (evidence: `src/main/java/com/gabsDev/transactionExecution/Exception/GlobalExceptionHandler.java`)
- Error mapping → Validation exception: handles (evidence: `src/main/java/com/gabsDev/transactionExecution/Exception/GlobalExceptionHandler.java`)
- Transaction workflow → Business validation: validates with (evidence: `src/main/java/com/gabsDev/transactionExecution/Service/TransactionService.java`)
- Transaction workflow → Search filters: builds filters (evidence: `src/main/java/com/gabsDev/transactionExecution/Service/TransactionService.java`)
- Transaction workflow → Provider request: creates (evidence: `src/main/java/com/gabsDev/transactionExecution/Service/TransactionService.java`)
- Transaction workflow → Provider handling: requests execution (evidence: `src/main/java/com/gabsDev/transactionExecution/Service/TransactionService.java`)
- Provider handling → Feign provider client: calls (evidence: `src/main/java/com/gabsDev/transactionExecution/Remote/Service/ExternalProviderService.java`)
- Feign provider client → External provider: posts transaction (evidence: `src/main/java/com/gabsDev/transactionExecution/Remote/Repository/ExternalProviderRepository.java`)
- Feign provider client → Provider request: sends (evidence: `src/main/java/com/gabsDev/transactionExecution/Remote/Repository/ExternalProviderRepository.java`)
- Feign provider client → Provider response: receives (evidence: `src/main/java/com/gabsDev/transactionExecution/Remote/Repository/ExternalProviderRepository.java`)
- Provider handling → Failed attempt recording: records failure (evidence: `src/main/java/com/gabsDev/transactionExecution/Remote/Service/ExternalProviderService.java`)
- Provider handling → Provider error payload: parses (evidence: `src/main/java/com/gabsDev/transactionExecution/Remote/Service/ExternalProviderService.java`)
- Provider handling → Provider exception: raises (evidence: `src/main/java/com/gabsDev/transactionExecution/Remote/Service/ExternalProviderService.java`)
- Provider handling → Transaction constants: uses codes (evidence: `src/main/java/com/gabsDev/transactionExecution/Remote/Service/ExternalProviderService.java`)
- Business validation → Validation exception: raises (evidence: `src/main/java/com/gabsDev/transactionExecution/Validator/TransactionValidator.java`)
- Business validation → Transaction constants: checks constants (evidence: `src/main/java/com/gabsDev/transactionExecution/Validator/TransactionValidator.java`)
- Transaction workflow → Provider response: uses result (evidence: `src/main/java/com/gabsDev/transactionExecution/Service/TransactionService.java`)
- Transaction workflow → Transaction repository: queries and saves (evidence: `src/main/java/com/gabsDev/transactionExecution/Service/TransactionService.java`)
- Transaction workflow → Transaction record: creates record (evidence: `src/main/java/com/gabsDev/transactionExecution/Service/TransactionService.java`)
- Failed attempt recording → Transaction repository: saves failed record (evidence: `src/main/java/com/gabsDev/transactionExecution/Service/FailedTransactionService.java`)
- Transaction repository → PostgreSQL: persists records
- Search filters → Transaction record: filters records (evidence: `src/main/java/com/gabsDev/transactionExecution/Specification/TransactionSpecification.java`)
