PORTAL BILLING — BACKOFFICE FINANCEIRO B2B

Portal Billing é uma SPA corporativa B2B para operação financeira, cobrindo desde cobranças e inadimplência até webhooks, uploads CSV e agendamento automático de relatórios. A arquitetura foi organizada por domínio, com separação clara entre páginas, componentes, hooks, services, schemas e tipos.

Módulos e funcionalidades:

• Gestão de cobranças com filtros avançados, paginação, colunas configuráveis e totais financeiros
• Relatórios de inadimplência e comissões com exportação em PDF, XLS e JSON
• Upload de arquivos CSV para processamento financeiro em lote
• Módulo de webhooks com CRUD, ping, reenvio e histórico de request/response
• Agendamento automático de relatórios por email, FTP, FTPS e SFTP
• Dashboard financeiro com gráficos Recharts e KPIs de inadimplência e comissões
• Cadastros de clientes e corretoras com formulários validados e busca por CEP
• White-label por domínio com favicon, background e mensagens configuráveis

Arquitetura e decisões técnicas:

• Arquitetura por domínio: pages → components → hooks → services → Axios
• TanStack Query para cache de servidor, staleTime, placeholderData e invalidação pós-mutation
• React Hook Form + Zod para formulários tipados com validação de CPF/CNPJ, incluindo CNPJ alfanumérico da RFB
• RBAC com guards de rota, sidebar dinâmica por permissão e rotas restritas a super admin
• Rotas lazy-loaded com React.lazy e Suspense para carregamento otimizado
• Zustand para estado local de modais e dialogs
• i18next com suporte a PT-BR, EN e ES e detecção automática de idioma
• Sentry com tracing e replay, error boundaries globais e estados padronizados de loading/erro

Qualidade e entrega:

• TypeScript strict, ESLint, Prettier, Husky e lint-staged
• Testes unitários com Vitest cobrindo validação de documentos e casos de borda
• Pipeline Jenkins parametrizado para ambientes sandbox e produção
• Deploy via Firebase Hosting com sourcemaps e Sentry DSN por ambiente