# johnenderson/challenge-itau architecture

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

- Interactive diagram: https://gitdiagram.com/johnenderson/challenge-itau
- Repository: https://github.com/johnenderson/challenge-itau

## Overview

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: [`pixms/src/main/java/com/itau/pixms/service/CobService.java`](https://github.com/johnenderson/challenge-itau/blob/master/pixms/src/main/java/com/itau/pixms/service/CobService.java) (Charge orchestration), [`pix-sub/src/main/java/com/itau/pixsub/service/PixSubService.java`](https://github.com/johnenderson/challenge-itau/blob/master/pix-sub/src/main/java/com/itau/pixsub/service/PixSubService.java) (Payment processing), [`pixms/src/main/java/com/itau/pixms/controller/v1/controller/CobController.java`](https://github.com/johnenderson/challenge-itau/blob/master/pixms/src/main/java/com/itau/pixms/controller/v1/controller/CobController.java) (Charge endpoint), [`pix-confirm/src/main/java/com/itau/pixconfirm/service/PixConfirmService.java`](https://github.com/johnenderson/challenge-itau/blob/master/pix-confirm/src/main/java/com/itau/pixconfirm/service/PixConfirmService.java) (Status update)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_pixms["Charge API"]
  node_api["Charge endpoint<br/>[CobController.java]"]
  node_request["Charge payload<br/>[CobDto.java]"]
  node_charge["Charge orchestration<br/>[CobService.java]"]
  node_validation["Payload rules"]
  node_mapping["Charge mapping<br/>[CobMapper.java]"]
  node_charges[("Charge store<br/>[CobRepository.java]")]
  node_pixms_auth["API auth<br/>[AuthService.java]"]
end

subgraph group_pixsub["Payment Dispatch"]
  node_listener["Payment listener<br/>[PixListener.java]"]
  node_dispatch["Payment processing<br/>[PixSubService.java]"]
  node_payment_client["PSP payment client"]
  node_payment_response["Payment response"]
  node_sub_auth["API auth<br/>[AuthService.java]"]
end

subgraph group_confirm["Confirmation"]
  node_confirm_listener["Confirmation listener"]
  node_confirm_service["Status update"]
  node_confirmations["Confirmation payload"]
  node_confirm_store[("Charge store<br/>[CobRepository.java]")]
end

subgraph group_integrations["External Integrations"]
  node_fraud["Fraud API client"]
  node_pixms_oauth["OAuth client<br/>[OAuth2Client.java]"]
  node_sqs["SQS"]
  node_sub_oauth["OAuth client<br/>[OAuth2Client.java]"]
  node_bacen["PSP / Bacen"]
  node_mongo[("MongoDB")]
end

node_frontend(("Front end"))

node_frontend -->|"submits request"| node_api
node_api -->|"accepts payload"| node_request
node_api -->|"delegates to"| node_charge
node_charge -->|"runs rules"| node_validation
node_charge -->|"gets token"| node_pixms_auth
node_charge -->|"checks key"| node_fraud
node_charge -->|"maps charge"| node_mapping
node_charge -->|"saves charge"| node_charges
node_charge -->|"enqueues charge"| node_sqs
node_pixms_auth -->|"requests token"| node_pixms_oauth
node_pixms_oauth -.-> node_fraud
node_charges -->|"persists records"| node_mongo
node_sqs -.->|"delivers charge"| node_listener
node_listener -->|"passes messages"| node_dispatch
node_dispatch -->|"gets token"| node_sub_auth
node_sub_auth -->|"requests token"| node_sub_oauth
node_dispatch -->|"sends charge"| node_payment_client
node_payment_client -->|"submits payment"| node_bacen
node_dispatch -->|"checks response"| node_payment_response
node_dispatch -->|"sends confirmation"| node_sqs
node_sqs -.->|"delivers confirmation"| node_confirm_listener
node_confirm_listener -->|"delegates confirmations"| node_confirm_service
node_confirm_service -->|"processes payload"| node_confirmations
node_confirm_service -->|"updates status"| node_confirm_store
node_confirm_store -->|"updates records"| node_mongo

click node_api "https://github.com/johnenderson/challenge-itau/blob/master/pixms/src/main/java/com/itau/pixms/controller/v1/controller/CobController.java"
click node_request "https://github.com/johnenderson/challenge-itau/blob/master/pixms/src/main/java/com/itau/pixms/controller/dto/CobDto.java"
click node_charge "https://github.com/johnenderson/challenge-itau/blob/master/pixms/src/main/java/com/itau/pixms/service/CobService.java"
click node_validation "https://github.com/johnenderson/challenge-itau/tree/master/pixms/src/main/java/com/itau/pixms/validation"
click node_mapping "https://github.com/johnenderson/challenge-itau/blob/master/pixms/src/main/java/com/itau/pixms/mapper/CobMapper.java"
click node_charges "https://github.com/johnenderson/challenge-itau/blob/master/pixms/src/main/java/com/itau/pixms/infrastructure/repository/CobRepository.java"
click node_fraud "https://github.com/johnenderson/challenge-itau/blob/master/pixms/src/main/java/com/itau/pixms/client/FraudMarkersClient.java"
click node_pixms_auth "https://github.com/johnenderson/challenge-itau/blob/master/pixms/src/main/java/com/itau/pixms/service/AuthService.java"
click node_pixms_oauth "https://github.com/johnenderson/challenge-itau/blob/master/pixms/src/main/java/com/itau/pixms/client/OAuth2Client.java"
click node_listener "https://github.com/johnenderson/challenge-itau/blob/master/pix-sub/src/main/java/com/itau/pixsub/listener/PixListener.java"
click node_dispatch "https://github.com/johnenderson/challenge-itau/blob/master/pix-sub/src/main/java/com/itau/pixsub/service/PixSubService.java"
click node_payment_client "https://github.com/johnenderson/challenge-itau/blob/master/pix-sub/src/main/java/com/itau/pixsub/client/SendPspPayment.java"
click node_payment_response "https://github.com/johnenderson/challenge-itau/blob/master/pix-sub/src/main/java/com/itau/pixsub/client/dto/SendPspPaymentResponse.java"
click node_sub_auth "https://github.com/johnenderson/challenge-itau/blob/master/pix-sub/src/main/java/com/itau/pixsub/service/AuthService.java"
click node_sub_oauth "https://github.com/johnenderson/challenge-itau/blob/master/pix-sub/src/main/java/com/itau/pixsub/client/OAuth2Client.java"
click node_confirm_listener "https://github.com/johnenderson/challenge-itau/blob/master/pix-confirm/src/main/java/com/itau/pixconfirm/listener/PixConfirmListener.java"
click node_confirm_service "https://github.com/johnenderson/challenge-itau/blob/master/pix-confirm/src/main/java/com/itau/pixconfirm/service/PixConfirmService.java"
click node_confirmations "https://github.com/johnenderson/challenge-itau/blob/master/pix-confirm/src/main/java/com/itau/pixconfirm/dto/ConfirmationDto.java"
click node_confirm_store "https://github.com/johnenderson/challenge-itau/blob/master/pix-confirm/src/main/java/com/itau/pixconfirm/infrastructure/repository/CobRepository.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_api,node_request,node_charge,node_validation,node_mapping,node_charges,node_pixms_auth toneBlue
class node_listener,node_dispatch,node_payment_client,node_payment_response,node_sub_auth toneAmber
class node_confirm_listener,node_confirm_service,node_confirmations,node_confirm_store toneMint
class node_fraud,node_pixms_oauth,node_sqs,node_sub_oauth,node_bacen,node_mongo toneRose
class node_frontend toneIndigo
```

## Components

### Charge API

- [Charge endpoint](https://github.com/johnenderson/challenge-itau/blob/master/pixms/src/main/java/com/itau/pixms/controller/v1/controller/CobController.java): `pixms/src/main/java/com/itau/pixms/controller/v1/controller/CobController.java`
- [Charge payload](https://github.com/johnenderson/challenge-itau/blob/master/pixms/src/main/java/com/itau/pixms/controller/dto/CobDto.java): `pixms/src/main/java/com/itau/pixms/controller/dto/CobDto.java`
- [Charge orchestration](https://github.com/johnenderson/challenge-itau/blob/master/pixms/src/main/java/com/itau/pixms/service/CobService.java): `pixms/src/main/java/com/itau/pixms/service/CobService.java`
- [Payload rules](https://github.com/johnenderson/challenge-itau/tree/master/pixms/src/main/java/com/itau/pixms/validation): `pixms/src/main/java/com/itau/pixms/validation`
- [Charge mapping](https://github.com/johnenderson/challenge-itau/blob/master/pixms/src/main/java/com/itau/pixms/mapper/CobMapper.java): `pixms/src/main/java/com/itau/pixms/mapper/CobMapper.java`
- [Charge store](https://github.com/johnenderson/challenge-itau/blob/master/pixms/src/main/java/com/itau/pixms/infrastructure/repository/CobRepository.java): `pixms/src/main/java/com/itau/pixms/infrastructure/repository/CobRepository.java`
- [API auth](https://github.com/johnenderson/challenge-itau/blob/master/pixms/src/main/java/com/itau/pixms/service/AuthService.java): `pixms/src/main/java/com/itau/pixms/service/AuthService.java`

### Payment Dispatch

- [Payment listener](https://github.com/johnenderson/challenge-itau/blob/master/pix-sub/src/main/java/com/itau/pixsub/listener/PixListener.java): `pix-sub/src/main/java/com/itau/pixsub/listener/PixListener.java`
- [Payment processing](https://github.com/johnenderson/challenge-itau/blob/master/pix-sub/src/main/java/com/itau/pixsub/service/PixSubService.java): `pix-sub/src/main/java/com/itau/pixsub/service/PixSubService.java`
- [PSP payment client](https://github.com/johnenderson/challenge-itau/blob/master/pix-sub/src/main/java/com/itau/pixsub/client/SendPspPayment.java): `pix-sub/src/main/java/com/itau/pixsub/client/SendPspPayment.java`
- [Payment response](https://github.com/johnenderson/challenge-itau/blob/master/pix-sub/src/main/java/com/itau/pixsub/client/dto/SendPspPaymentResponse.java): `pix-sub/src/main/java/com/itau/pixsub/client/dto/SendPspPaymentResponse.java`
- [API auth](https://github.com/johnenderson/challenge-itau/blob/master/pix-sub/src/main/java/com/itau/pixsub/service/AuthService.java): `pix-sub/src/main/java/com/itau/pixsub/service/AuthService.java`

### Confirmation

- [Confirmation listener](https://github.com/johnenderson/challenge-itau/blob/master/pix-confirm/src/main/java/com/itau/pixconfirm/listener/PixConfirmListener.java): `pix-confirm/src/main/java/com/itau/pixconfirm/listener/PixConfirmListener.java`
- [Status update](https://github.com/johnenderson/challenge-itau/blob/master/pix-confirm/src/main/java/com/itau/pixconfirm/service/PixConfirmService.java): `pix-confirm/src/main/java/com/itau/pixconfirm/service/PixConfirmService.java`
- [Confirmation payload](https://github.com/johnenderson/challenge-itau/blob/master/pix-confirm/src/main/java/com/itau/pixconfirm/dto/ConfirmationDto.java): `pix-confirm/src/main/java/com/itau/pixconfirm/dto/ConfirmationDto.java`
- [Charge store](https://github.com/johnenderson/challenge-itau/blob/master/pix-confirm/src/main/java/com/itau/pixconfirm/infrastructure/repository/CobRepository.java): `pix-confirm/src/main/java/com/itau/pixconfirm/infrastructure/repository/CobRepository.java`

### External Integrations

- [Fraud API client](https://github.com/johnenderson/challenge-itau/blob/master/pixms/src/main/java/com/itau/pixms/client/FraudMarkersClient.java): `pixms/src/main/java/com/itau/pixms/client/FraudMarkersClient.java`
- [OAuth client](https://github.com/johnenderson/challenge-itau/blob/master/pixms/src/main/java/com/itau/pixms/client/OAuth2Client.java): `pixms/src/main/java/com/itau/pixms/client/OAuth2Client.java`
- **SQS**
- [OAuth client](https://github.com/johnenderson/challenge-itau/blob/master/pix-sub/src/main/java/com/itau/pixsub/client/OAuth2Client.java): `pix-sub/src/main/java/com/itau/pixsub/client/OAuth2Client.java`
- **PSP / Bacen**
- **MongoDB**

### Other components

- **Front end**

## Connections

- Front end → Charge endpoint: submits request (evidence: `README.md`)
- Charge endpoint → Charge payload: accepts payload (evidence: `pixms/src/main/java/com/itau/pixms/controller/v1/controller/CobController.java`)
- Charge endpoint → Charge orchestration: delegates to (evidence: `pixms/src/main/java/com/itau/pixms/controller/v1/controller/CobController.java`)
- Charge orchestration → Payload rules: runs rules (evidence: `pixms/src/main/java/com/itau/pixms/service/CobService.java`)
- Charge orchestration → API auth: gets token (evidence: `pixms/src/main/java/com/itau/pixms/service/CobService.java`)
- Charge orchestration → Fraud API client: checks key (evidence: `pixms/src/main/java/com/itau/pixms/service/CobService.java`)
- Charge orchestration → Charge mapping: maps charge (evidence: `pixms/src/main/java/com/itau/pixms/service/CobService.java`)
- Charge orchestration → Charge store: saves charge (evidence: `pixms/src/main/java/com/itau/pixms/service/CobService.java`)
- Charge orchestration → SQS: enqueues charge (evidence: `pixms/src/main/java/com/itau/pixms/service/CobService.java`)
- API auth → OAuth client: requests token (evidence: `pixms/src/main/java/com/itau/pixms/service/AuthService.java`)
- OAuth client → Fraud API client
- Charge store → MongoDB: persists records (evidence: `README.md`)
- SQS → Payment listener: delivers charge
- Payment listener → Payment processing: passes messages (evidence: `pix-sub/src/main/java/com/itau/pixsub/listener/PixListener.java`)
- Payment processing → API auth: gets token (evidence: `pix-sub/src/main/java/com/itau/pixsub/service/PixSubService.java`)
- API auth → OAuth client: requests token (evidence: `pix-sub/src/main/java/com/itau/pixsub/service/AuthService.java`)
- Payment processing → PSP payment client: sends charge (evidence: `pix-sub/src/main/java/com/itau/pixsub/service/PixSubService.java`)
- PSP payment client → PSP / Bacen: submits payment (evidence: `README.md`)
- Payment processing → Payment response: checks response (evidence: `pix-sub/src/main/java/com/itau/pixsub/service/PixSubService.java`)
- Payment processing → SQS: sends confirmation (evidence: `pix-sub/src/main/java/com/itau/pixsub/service/PixSubService.java`)
- SQS → Confirmation listener: delivers confirmation
- Confirmation listener → Status update: delegates confirmations (evidence: `pix-confirm/src/main/java/com/itau/pixconfirm/listener/PixConfirmListener.java`)
- Status update → Confirmation payload: processes payload (evidence: `pix-confirm/src/main/java/com/itau/pixconfirm/service/PixConfirmService.java`)
- Status update → Charge store: updates status (evidence: `pix-confirm/src/main/java/com/itau/pixconfirm/service/PixConfirmService.java`)
- Charge store → MongoDB: updates records (evidence: `README.md`)
