Pular para conteúdo
jvictordev
menu
Voltar
KGX Capital

De "Taxa de Perda 33,8%" para 3% real — sem quebrar uma única página.

Dashboard executivo SPA que consolida jornada do lead, P&L por convênio, LTV/recorrência e performance por FIDC, com correção semântica de enums que estavam mentindo para o C-level.

  • Cliente
    KGX Capital
  • Ano
    2026
  • Papel
    Solo · dashboard SPA end-to-end
  • Status
    Em produção · sob NDA
Problema

Dois enums de Status semanticamente distintos (jornada do lead vs ciclo do consignado) eram tratados como o mesmo — "Taxa de Perda" exibida ao C-level era 33,8% por incluir leads em etapa intermediária; valor real é 3,0%.

Solução

Sprint 1: refatoração semântica em comercialConstants.ts com aliases @deprecated para não quebrar imports legados durante a migração. Sprint 2: módulo financeiro completo (carteira, P&L, LTV, FIDC) com Health Score multidimensional ponderado e auditoria visual.

Resultado

Bug de produção corrigido com impacto direto na decisão executiva, sem quebrar uma única página. Privacy by default na borda do query (CPF/Email omitidos). Threshold de alertas recalibrado de 40% para 15%.

Decisões técnicas
  1. Aliases @deprecated nas constantes — refatoração de semântica em uma sprint sem migrar simultaneamente todas as páginas. Risco controlado, dívida explícita.

  2. Convenio Health Score ponderado em 5 dimensões (Quitação 30%, Perda 25%, Aging 20%, Volume 15%, Tempo 10%) com volume em escala log relativa à mediana.

  3. onAuthStateChange antes de getSession — ordem deliberada para evitar race entre hidratação e primeiro evento de auth.

Métricas
  • 33.8% → 3%
    bug de Taxa de Perda em produção
  • 18
    tabelas Postgres tipadas
  • 14
    RPCs Postgres expostas
  • 5
    dimensões no Health Score
  • 11
    rotas autenticadas (comercial + financeiro)
Stack
  • TypeScript 5.8 strict
  • Vite 5 + React 18
  • Tailwind + shadcn/ui (49 componentes)
  • TanStack Query 5
  • React Hook Form + Zod
  • Recharts 2
  • Supabase (Auth, Postgres 15, RLS, RPCs)
  • Vitest + Playwright
Vamos construir

Pronto pra parar de fazer slide?

Se você é empresário e tem uma operação real que precisa de IA real, fala comigo direto no WhatsApp. Resposta em horas, não dias.