Projeto pessoal·jul – set/2026
Pix Reconciliation API
Conciliação de recebimentos Pix, identificação de divergências e fechamento de caixa.
- classes de teste de regra
- 6
Problema
Conciliar o que se esperava receber com o que de fato entrou via Pix exige regras precisas e auditáveis.
Solução
Um núcleo de domínio puro, com portas e casos de uso, que classifica pagamentos (parcial, pago, excedente) e rejeita eventos que não pertencem ao caso.
Meu papel
Projeto individual com foco em modelagem de domínio e Clean Architecture.
- → Domínio financeiro: recebível, venda, evento de pagamento e caso de conciliação
- → Regras independentes de Spring, banco e HTTP
- → ddl-auto=validate, open-in-view desligado e credenciais por variável de ambiente
Decisões técnicas
BigDecimal sempre
Valores monetários nunca em double; comparações com compareTo.
Máquina de estados
Um caso de conciliação só pode ser analisado uma vez.
Domínio sem framework
As regras rodam e são testadas sem subir Spring.
Stack
- Java 21
- Spring Boot
- PostgreSQL
- Clean Architecture
- JUnit 5
- BigDecimal
Ao vivo do GitHub
- Java 100%
último commit: feat(application): adiciona caso de uso de recebivel e porta de repositorio com testes ·