vendaweb-api/docs

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

1. Instalar dependências: npm install
2. Configurar variáveis de ambiente (ver Deploy)
3. Executar: npm run dev
4. Acessar: http://localhost:3000/DRE

Manutenção

Para manter o sistema sem perder suas características:

1. Preserve a hierarquia: Grupo → Subgrupo → Centro de Custo → Conta
2. Mantenha os cálculos: Percentuais baseados no Grupo 03
3. Conserve a funcionalidade: Drill-down e exportação Excel
4. Atualize dados: Mantenha sincronização com fonte de dados
5. Teste filtros: Valide todos os filtros analíticos

---

Última atualização: $(date)