Todos os projetos
EmpresaJun – Out 2026Em produção

Débito de Pasta — Conciliação Financeira

Substituiu um processo em papel que levava de uma a duas semanas: conciliação bancária, premiação e débito na comissão dos representantes agora saem em minutos.

Desenvolvedor Full Stack · Grupo Vila Nova

Semanas → min

processo que era feito em papel

0

testes automatizados

~0 mil

títulos resumidos num ranking

O problema

Todo mês o Financeiro conciliava o retorno do banco com os títulos do ERP, trocava espécies, apurava a premiação e calculava quanto debitar da comissão de cada representante por título em aberto — em papel e planilha. O ciclo levava de uma a duas semanas, dependia de quem sabia o caminho e não deixava rastro de quem alterou o quê.

A solução

Sistema full stack (React + FastAPI + Oracle) que faz o ciclo inteiro em alguns cliques: o arquivo do banco é conciliado contra uma view dos títulos no ERP, a premiação entra por planilha versionada e os lotes de débito saem prontos por representante. Cada escrita é auditada na mesma transação, o acesso é por perfil via Keycloak e a tela inicial virou um ranking por representante em vez de paginar ~68 mil títulos.

Arquitetura

Como os dados fluem

ExternoServiçoDadosFront-endUsuário
arraste os blocos
Destaques técnicos

O que fez diferença

  1. 01

    De 1–2 semanas em papel para minutos: conciliação, troca de espécie, premiação e débito no mesmo fluxo

  2. 02

    Importação de premiação versionada (3 planilhas por mês): substituir exige lastro, e conflito devolve 409 com o retrato do que já existe — ninguém sobrescreve sem ver

  3. 03

    Auditoria de toda escrita na mesma transação do dado; sync horário de espécies com o ERP que só insere e atualiza, nunca apaga

  4. 04

    RBAC com Keycloak (PKCE + client roles) e menu montado pelo servidor: a permissão mora num lugar só

  5. 05

    Diagnóstico de cold start: a validação de token buscava as chaves (JWKS) de forma síncrona e travava o event loop — a tela ficava em branco por minutos

Stack

Tecnologias

React 19TypeScriptVite 7shadcn/uiPython 3.11FastAPIOracleKeycloakDocker