Pitch: Como estruturei um motor financeiro de 30k linhas em JS para domar o caos do D+2 e saldos órfãos
Quem já precisou integrar APIs de corretoras ou construir consolidadores de carteira no Brasil sabe que o verdadeiro inferno na engenharia financeira não é plotar gráficos em um dashboard bonito. O pesadelo real é manter a integridade matemática do livro-razão.
O desafio fica crítico quando você precisa cruzar a ingestão de notas de corretagem com o descasamento temporal de liquidação bancária (o famoso T+2 ou D+2), somado aos eventos corporativos retrativos (splits, grupamentos e proventos). Se a sua base de dados não for construída com um rigor absurdo, você cria uma bomba-relógio contábil silenciosa cheia de saldos órfãos e cálculos de Preço Médio distorcidos.
Para resolver esse gargalo de Data Quality, construí do zero um ecossistema independente de gestão e auditoria de portfólio — um motor modular com mais de 30.000 linhas puras em JavaScript.
Não usei frameworks mágicos para mascarar a regra de negócio. O foco foi 100% em arquitetura lógica. Os principais pilares que estruturei foram:
Arquitetura de "Time-Travel" via Event-Sourcing: O sistema não apenas lê o saldo de hoje. Ele reconstrói a linha do tempo do portfólio diariamente, garantindo que o cálculo de Imposto de Renda e o rateio de custos na entrada estejam alinhados ao rigor da Receita Federal (benchmark ReVar).
Pipeline Anti-Erro (Deleção em Cascata): Implementei um transporte de estado rígido. Se uma Nota de Negociação é alterada ou excluída, o sistema deleta em cascata todos os eventos dependentes para garantir zero resíduo no banco de dados. A paridade contábil tem que bater no centavo.
Motor Matemático e Rebalanceamento: Integração de cálculos de TWR (via Método da Bisseção) e travas dinâmicas de rentabilidade atreladas a indicadores fundamentalistas (Fórmula de Bazin, Graham, P/VP), ditando alocações inteligentes e freando anomalias de valuation.
Fiz todo esse desenvolvimento atuando como Arquiteto de Lógica, orquestrando ferramentas de IA para acelerar a digitação do código, mas mantendo a governança estrita e o limite da janela de contexto nas minhas mãos. A IA digita, mas a arquitetura e a regra de negócio são humanas.
Disponibilizei o ambiente de simulação aberto. Quem trabalha em fintechs, wealthtechs ou consolidadores fiscais (calculadoras de IR) e quiser dar uma auditada na lógica de negócios rodando na prática, os links estão abaixo.
🔗 Sistema Demo Operacional: https://investments-demo.netlify.app/
🔗 Repositório / Documentação: https://github.com/gustmr/wealth-management-engine
Qualquer dúvida sobre como modelei a deleção em cascata ou o motor fiscal, fiquem à vontade para perguntar.
Um abraço,
Gustavo Martins Rocha
Technical Business Analyst | Arquiteto de Lógica