02 / RECONCILIAÇÃO FINANCEIRA · FULL STACK
ClearLedger
Do pedido ao depósito bancário. Reconciliação financeira com importações rastreáveis, identificação de divergências e relatórios imutáveis.
O projeto
ClearLedger reconcilia pedidos com cobranças e estornos e compara repasses líquidos com depósitos bancários. Transforma registros CSV validados em relatórios auditáveis e destaca divergências para investigação.
O que está implementado
- Importações CSV atômicas com hash de conteúdo, idempotência e detecção de conflitos.
- Conciliação de cobranças, estornos, taxas, pagamentos divididos e depósitos bancários.
- Detecção de pagamentos ausentes, valores divergentes, pedidos desconhecidos e moedas incompatíveis.
- Snapshots de importações e relatórios de reconciliação imutáveis em SQLite.
- Endpoints FastAPI autenticados, CLI e exportações JSON/CSV.
- Dashboard bilíngue em Next.js com filtros, tabelas, detalhes de execuções e temas claro/escuro.
Como foi construído
Regras puras de reconciliação ficam separadas da ingestão CSV, persistência SQLite, API HTTP e CLI. Transações e triggers protegem os relatórios imutáveis. O frontend Next.js acessa o FastAPI por uma camada no servidor; endpoints de negócio exigem uma chave de API.
Minha participação
Projeto pessoal no repositório vrascode de Matheus Sulino, conectando regras de reconciliação, persistência, contratos de API e um dashboard para investigar divergências.
Testes e verificação
64 testes de backend e 51 de frontend aprovados em 27 de outubro de 2026. Incluem geração real de relatórios em Python/SQLite, validação, imutabilidade, conflitos, estornos e comportamento da API. Permanece um aviso de depreciação Starlette/httpx. Os testes de navegador não foram repetidos nesta análise das fontes.
Escopo atual
Protótipo para um único host. Não movimenta fundos nem se conecta a bancos em tempo real. Capturas e exemplos usam dados sintéticos; não há alegação de implantação comercial.