Modelagem de DRE Conforme Lei 6.404/76 e DFC em Filament 4 sem Rotas Virtuais Quebradas

[!NOTE] Resumo Executivo (DEV-2026-139): Estruturamos as demonstrações financeiras brasileiras (DRE e DFC) desacopladas em serviços com visão comparativa de 12 meses. Corrigimos a resolução de breadcrumbs virtuais em clusters do Filament 4.


🚨 O Desafio Técnico / Contexto

Ao registrar páginas analíticas dentro de clusters no Filament 4, o componente de navegação buscava rotas de breadcrumb para clusters sem rota inicial associada, lançando RouteNotFoundException. Além disso, o ERP não dispunha de demonstrações no padrão contábil brasileiro exigido pelo CPC e Lei nº 6.404/76.


💡 Principais Lições Aprendidas & Descobertas

  • 💡 A DRE brasileira exige segregação rígida: Receita Bruta, Deduções, Receita Líquida, CPV/CSP, Lucro Bruto, EBITDA e Lucro Líquido.
  • 💡 O Fluxo de Caixa Operacional (DFC) consolida títulos a vencer (previstos) com liquidações bancárias (realizadas).
  • 💡 Sobrescrever getBreadcrumbs() na página Filament evita exceções quando o cluster atua apenas como agrupador de menu.
  • 💡 DomPDF exige layout em A4 Paisagem (landscape) com DejaVu Sans para renderizar tabelas financeiras de 13 colunas.

🛠️ Especificação Técnica & Código-Chave

public function getBreadcrumbs(): array
{
    return [
        'Relatórios' => '#',
        'DRE',
    ];
}

📈 Impacto no Ecossistema & Valor Prático

Painel executivo com DRE anual de 12 meses, DFC projetado e exportação em PDF corporativo no padrão contábil nacional.

  • Projetos Relacionados: laravel-ERP
  • Registro de Origem: _data/daily.dev-23.yml

Publicado originalmente como parte do Diário de Desenvolvimento 2026 do ecossistema Artes do Sul & Araguaci.