portal_publico/portal_api/dashboard_contabil/README.md

Relatório Contábil (Relatórios > Contabilidade)

Ver CLAUDE.md nesta mesma pasta para o detalhamento técnico (extração do PDF, regras de auditoria, models). Ver CLAUDE.md na raiz para arquitetura geral/transversal do Portal. Chamado de "Dashboard Contábil" até uma rodada anterior — renomeado a pedido do usuário (rótulo visível só, nomes técnicos internos continuam dashboard_contabil/Contabil*).

Otimiza a conferência de balancetes hoje feita manualmente pelo Fisco/Contábil: o contador anexa o PDF de Balancete + DRE de uma empresa (mesmo relatório modelo Questor hoje enviado ao cliente), a ferramenta extrai as contas automaticamente e roda um conjunto de checagens de auditoria (saldos negativos de caixa, contas transitórias/genéricas com saldo, contas que deveriam estar zeradas, diferença débito/crédito, variações atípicas mês a mês) — o contador revisa os achados, marca contas/linhas como validadas, registra observações por conta/linha (editor inline na própria tabela, com um toggle "mostrar ao cliente" que nasce desmarcado), escreve um resumo livre do fechamento (considerações/análises, texto rico com imagem) e conclui a análise. Quando o PDF traz a seção "Demonstração Mensal (Análise Vertical)" (histórico de 3 meses, valor+variação percentual por linha), ela também é extraída e ganha sua própria aba de revisão (mesmos recursos de observação/validado/ocultar do Balancete/D.R.E.). Se o arquivo original estava errado/incompleto, o botão "Reprocessar" reanexa um PDF novo pra mesma empresa/competência sem perder nada já registrado — conta/linha sem mudança mantém observação e validação, a que mudou volta pra "não validada" com um alerta, e achado já tratado nunca é apagado ou tem sua justificativa sobrescrita. O botão "Gerar Relatório" gera um relatório HTML autocontido (resumo do fechamento, indicadores financeiros, gráfico de evolução, DRE/Balancete/Análise Vertical agrupados, observações do contador) com a marca do escritório, pronto pra enviar ao administrador da empresa.

Ainda fora de escopo: exportação em XLSX; consolidação entre várias empresas/competências ao mesmo tempo (é sempre uma apuração por vez).

Onde mexer

• portal_api/dashboard_contabil/ — parser.py (extração do PDF via pdfplumber), regras.py (motor de regras de auditoria), indicadores.py (indicadores financeiros do relatório), pipeline.py (orquestração), modelos.py (dataclasses).
• ContabilApuracao/ContabilConta/ContabilLinhaDre/ContabilLinhaAnaliseVertical/ContabilAchado (portal_api/models.py).
• dashboard-contabil.html / static/js/dashboard-contabil.js / static/css/dashboard-contabil.css.
• dashboard-contabil-relatorio.html (relatório em si) / portal_api/templatetags/contabil_extras.py (filtros de formatação).