How johnenderson/challenge-itau works
This repository implements a simulated PIX payment flow across three Spring services: pixms accepts and validates payment requests, checks fraud, persists charges, and enqueues them; pix-sub processes queued charges against a PSP/Bacen integration and emits confirmations; pix-confirm consumes confirmations and updates transaction status. MongoDB, SQS, and mocked external APIs support the flow. The README documents the overall integrations; arrows between queue stages are dashed because the listener queue wiring was not shown in the sampled source.
Main entry points: CobService.java Charge orchestration · PixSubService.java Payment processing · CobController.java Charge endpoint · PixConfirmService.java Status update
Components 23
Charge API
- Charge endpoint
pixms/src/main/java/com/itau/pixms/controller/v1/controller/CobController.java - Charge payload
pixms/src/main/java/com/itau/pixms/controller/dto/CobDto.java - Charge orchestration
pixms/src/main/java/com/itau/pixms/service/CobService.java - Payload rules
pixms/src/main/java/com/itau/pixms/validation - Charge mapping
pixms/src/main/java/com/itau/pixms/mapper/CobMapper.java - Charge store
pixms/src/main/java/com/itau/pixms/infrastructure/repository/CobRepository.java - API auth
pixms/src/main/java/com/itau/pixms/service/AuthService.java
Payment Dispatch
- Payment listener
pix-sub/src/main/java/com/itau/pixsub/listener/PixListener.java - Payment processing
pix-sub/src/main/java/com/itau/pixsub/service/PixSubService.java - PSP payment client
pix-sub/src/main/java/com/itau/pixsub/client/SendPspPayment.java - Payment response
pix-sub/src/main/java/com/itau/pixsub/client/dto/SendPspPaymentResponse.java - API auth
pix-sub/src/main/java/com/itau/pixsub/service/AuthService.java
Confirmation
- Confirmation listener
pix-confirm/src/main/java/com/itau/pixconfirm/listener/PixConfirmListener.java - Status update
pix-confirm/src/main/java/com/itau/pixconfirm/service/PixConfirmService.java - Confirmation payload
pix-confirm/src/main/java/com/itau/pixconfirm/dto/ConfirmationDto.java - Charge store
pix-confirm/src/main/java/com/itau/pixconfirm/infrastructure/repository/CobRepository.java
External Integrations
- Fraud API client
pixms/src/main/java/com/itau/pixms/client/FraudMarkersClient.java - OAuth client
pixms/src/main/java/com/itau/pixms/client/OAuth2Client.java - SQS
- OAuth client
pix-sub/src/main/java/com/itau/pixsub/client/OAuth2Client.java - PSP / Bacen
- MongoDB
Other components
- Front end
Connections 25
- Front end → Charge endpoint: submits request
README.md - Charge endpoint → Charge payload: accepts payload
pixms/src/main/java/com/itau/pixms/controller/v1/controller/CobController.java - Charge endpoint → Charge orchestration: delegates to
pixms/src/main/java/com/itau/pixms/controller/v1/controller/CobController.java - Charge orchestration → Payload rules: runs rules
pixms/src/main/java/com/itau/pixms/service/CobService.java - Charge orchestration → API auth: gets token
pixms/src/main/java/com/itau/pixms/service/CobService.java - Charge orchestration → Fraud API client: checks key
pixms/src/main/java/com/itau/pixms/service/CobService.java - Charge orchestration → Charge mapping: maps charge
pixms/src/main/java/com/itau/pixms/service/CobService.java - Charge orchestration → Charge store: saves charge
pixms/src/main/java/com/itau/pixms/service/CobService.java - Charge orchestration → SQS: enqueues charge
pixms/src/main/java/com/itau/pixms/service/CobService.java - API auth → OAuth client: requests token
pixms/src/main/java/com/itau/pixms/service/AuthService.java - OAuth client → Fraud API client
- Charge store → MongoDB: persists records
README.md - SQS → Payment listener: delivers charge
- Payment listener → Payment processing: passes messages
pix-sub/src/main/java/com/itau/pixsub/listener/PixListener.java - Payment processing → API auth: gets token
pix-sub/src/main/java/com/itau/pixsub/service/PixSubService.java - API auth → OAuth client: requests token
pix-sub/src/main/java/com/itau/pixsub/service/AuthService.java - Payment processing → PSP payment client: sends charge
pix-sub/src/main/java/com/itau/pixsub/service/PixSubService.java - PSP payment client → PSP / Bacen: submits payment
README.md - Payment processing → Payment response: checks response
pix-sub/src/main/java/com/itau/pixsub/service/PixSubService.java - Payment processing → SQS: sends confirmation
pix-sub/src/main/java/com/itau/pixsub/service/PixSubService.java - SQS → Confirmation listener: delivers confirmation
- Confirmation listener → Status update: delegates confirmations
pix-confirm/src/main/java/com/itau/pixconfirm/listener/PixConfirmListener.java - Status update → Confirmation payload: processes payload
pix-confirm/src/main/java/com/itau/pixconfirm/service/PixConfirmService.java - Status update → Charge store: updates status
pix-confirm/src/main/java/com/itau/pixconfirm/service/PixConfirmService.java - Charge store → MongoDB: updates records
README.md