3.4 KiB
3.4 KiB
DRE Gerencial - Documentação do Sistema
Visão Geral
O DRE Gerencial é um sistema web desenvolvido em Next.js para análise e visualização de dados financeiros através de uma Demonstração do Resultado do Exercício (DRE) hierárquica e interativa.
Objetivo Principal
O sistema tem como objetivo principal fornecer uma interface intuitiva para análise de dados financeiros empresariais, permitindo:
- Visualização hierárquica de dados financeiros (Grupo → Subgrupo → Centro de Custo → Conta)
- Análise temporal por períodos mensais
- Drill-down analítico para detalhamento de transações
- Exportação de dados para Excel
- Cálculo de percentuais baseados em grupos de referência
Características Principais
1. Interface Hierárquica
- Estrutura em árvore expansível (Grupo → Subgrupo → Centro de Custo → Conta)
- Visualização de valores e percentuais por mês
- Ordenação por descrição ou valor total
- Seleção de linhas para análise detalhada
2. Análise Analítica
- Drill-down a partir de qualquer nível hierárquico
- Filtros por período, centro de custo, grupo, subgrupo e conta
- Visualização detalhada de transações individuais
- Exportação para Excel com múltiplas abas
3. Cálculos Automáticos
- Percentuais baseados no Grupo 03 como referência
- Totais consolidados por nível hierárquico
- Valores por mês com formatação monetária brasileira
Estrutura do Projeto
src/
├── app/
│ ├── api/
│ │ ├── analitico/route.ts # API para dados analíticos
│ │ └── dre/route.ts # API para dados DRE
│ ├── DRE/
│ │ ├── analitico.tsx # Componente de análise analítica
│ │ ├── page.tsx # Página principal
│ │ └── teste.tsx # Componente principal DRE
│ └── layout.tsx # Layout da aplicação
├── components/
│ └── ui/ # Componentes UI reutilizáveis
├── db/
│ ├── index.ts # Configuração do banco
│ └── schema.ts # Schema do banco de dados
└── lib/
└── utils.ts # Utilitários
Tecnologias Utilizadas
- Frontend: Next.js 15, React 19, TypeScript
- Styling: Tailwind CSS 4
- Database: PostgreSQL com Drizzle ORM
- UI Components: Radix UI, Lucide React
- Export: XLSX para Excel
Documentação Detalhada
- Arquitetura do Sistema
- Banco de Dados
- APIs
- Componentes
- Guia de Desenvolvimento
- Deploy e Configuração
- Troubleshooting
Quick Start
- Instalar dependências:
npm install - Configurar variáveis de ambiente (ver Deploy)
- Executar:
npm run dev - Acessar:
http://localhost:3000/DRE
Manutenção
Para manter o sistema sem perder suas características:
- Preserve a hierarquia: Grupo → Subgrupo → Centro de Custo → Conta
- Mantenha os cálculos: Percentuais baseados no Grupo 03
- Conserve a funcionalidade: Drill-down e exportação Excel
- Atualize dados: Mantenha sincronização com fonte de dados
- Teste filtros: Valide todos os filtros analíticos
Última atualização: $(date)