How gabs06dev/transaction-execution-api-challange works
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: TransactionService.java Transaction workflow · ExternalProviderService.java Provider handling · TransactionController.java Transaction endpoints · GlobalExceptionHandler.java Error mapping
Components 21
API boundary
- Transaction endpoints
src/main/java/com/gabsDev/transactionExecution/Controller/TransactionController.java - Error mapping
src/main/java/com/gabsDev/transactionExecution/Exception/GlobalExceptionHandler.java - API response model
src/main/java/com/gabsDev/transactionExecution/Remote/Dto/ResponseModel.java - Provider exception
src/main/java/com/gabsDev/transactionExecution/Exception/ExternalProviderException.java - Validation exception
src/main/java/com/gabsDev/transactionExecution/Exception/TransactionException.java
Transaction processing
- Transaction request
src/main/java/com/gabsDev/transactionExecution/Remote/Dto/TransactionRequest.java - Transaction workflow
src/main/java/com/gabsDev/transactionExecution/Service/TransactionService.java - Business validation
src/main/java/com/gabsDev/transactionExecution/Validator/TransactionValidator.java - Search filters
src/main/java/com/gabsDev/transactionExecution/Specification/TransactionSpecification.java - Transaction constants
src/main/java/Utils/Constantes.java
Provider integration
- Provider handling
src/main/java/com/gabsDev/transactionExecution/Remote/Service/ExternalProviderService.java - Feign provider client
src/main/java/com/gabsDev/transactionExecution/Remote/Repository/ExternalProviderRepository.java - Provider request
src/main/java/com/gabsDev/transactionExecution/Remote/Dto/ProviderRequest.java - Provider response
src/main/java/com/gabsDev/transactionExecution/Remote/Dto/ProviderResponse.java - Provider error payload
src/main/java/com/gabsDev/transactionExecution/Remote/Dto/ExternalProviderError.java
Transaction storage
- Transaction record
src/main/java/com/gabsDev/transactionExecution/Entity/Transaction.java - Transaction repository
src/main/java/com/gabsDev/transactionExecution/Repository/TransactionRepository.java - PostgreSQL
- Failed attempt recording
src/main/java/com/gabsDev/transactionExecution/Service/FailedTransactionService.java
Other components
- API client
- External provider
Connections 27
- API client → Transaction endpoints: calls endpoints
README.md - Transaction endpoints → Transaction request: accepts
src/main/java/com/gabsDev/transactionExecution/Controller/TransactionController.java - Transaction endpoints → Transaction workflow: delegates to
src/main/java/com/gabsDev/transactionExecution/Controller/TransactionController.java - Transaction endpoints → Error mapping: errors handled by
- Error mapping → API response model: builds
src/main/java/com/gabsDev/transactionExecution/Exception/GlobalExceptionHandler.java - Error mapping → Provider exception: handles
src/main/java/com/gabsDev/transactionExecution/Exception/GlobalExceptionHandler.java - Error mapping → Validation exception: handles
src/main/java/com/gabsDev/transactionExecution/Exception/GlobalExceptionHandler.java - Transaction workflow → Business validation: validates with
src/main/java/com/gabsDev/transactionExecution/Service/TransactionService.java - Transaction workflow → Search filters: builds filters
src/main/java/com/gabsDev/transactionExecution/Service/TransactionService.java - Transaction workflow → Provider request: creates
src/main/java/com/gabsDev/transactionExecution/Service/TransactionService.java - Transaction workflow → Provider handling: requests execution
src/main/java/com/gabsDev/transactionExecution/Service/TransactionService.java - Provider handling → Feign provider client: calls
src/main/java/com/gabsDev/transactionExecution/Remote/Service/ExternalProviderService.java - Feign provider client → External provider: posts transaction
src/main/java/com/gabsDev/transactionExecution/Remote/Repository/ExternalProviderRepository.java - Feign provider client → Provider request: sends
src/main/java/com/gabsDev/transactionExecution/Remote/Repository/ExternalProviderRepository.java - Feign provider client → Provider response: receives
src/main/java/com/gabsDev/transactionExecution/Remote/Repository/ExternalProviderRepository.java - Provider handling → Failed attempt recording: records failure
src/main/java/com/gabsDev/transactionExecution/Remote/Service/ExternalProviderService.java - Provider handling → Provider error payload: parses
src/main/java/com/gabsDev/transactionExecution/Remote/Service/ExternalProviderService.java - Provider handling → Provider exception: raises
src/main/java/com/gabsDev/transactionExecution/Remote/Service/ExternalProviderService.java - Provider handling → Transaction constants: uses codes
src/main/java/com/gabsDev/transactionExecution/Remote/Service/ExternalProviderService.java - Business validation → Validation exception: raises
src/main/java/com/gabsDev/transactionExecution/Validator/TransactionValidator.java - Business validation → Transaction constants: checks constants
src/main/java/com/gabsDev/transactionExecution/Validator/TransactionValidator.java - Transaction workflow → Provider response: uses result
src/main/java/com/gabsDev/transactionExecution/Service/TransactionService.java - Transaction workflow → Transaction repository: queries and saves
src/main/java/com/gabsDev/transactionExecution/Service/TransactionService.java - Transaction workflow → Transaction record: creates record
src/main/java/com/gabsDev/transactionExecution/Service/TransactionService.java - Failed attempt recording → Transaction repository: saves failed record
src/main/java/com/gabsDev/transactionExecution/Service/FailedTransactionService.java - Transaction repository → PostgreSQL: persists records
- Search filters → Transaction record: filters records
src/main/java/com/gabsDev/transactionExecution/Specification/TransactionSpecification.java