📊 Visão Geral Funcional - ecosif-reports

📋 Sobre o Projeto

ecosif-reports é um microserviço Spring Boot especializado na geração de relatórios contábeis no sistema eCosif. Utiliza JasperReports para renderização e oferece uma ampla gama de relatórios em formatos PDF, CSV e TXT.

🎯 Objetivo do Serviço

O serviço tem como objetivo fornecer geração eficiente e padronizada de relatórios contábeis, com:

• ✅ Múltiplos formatos - PDF, CSV, TXT
• ✅ Templates reutilizáveis - JasperReports
• ✅ Relatórios regulatórios - COSIF, CVM
• ✅ Performance - Otimizado para grandes volumes

🏢 Contexto no Sistema eCosif

O ecosif-reports é parte do ecossistema eCosif, trabalhando em conjunto com:

• ecosif-auth: Autenticação e autorização
• ecosif-masterdata: Dados mestres
• ecosif-moviments: Lançamentos contábeis (dados fonte)
• ecosif-querys: Consultas (dados fonte)

📦 Funcionalidades Principais

1. Relatórios Contábeis

• Balancete mensal, diário e geral
• Balanço patrimonial
• Demonstração do resultado (DRE)
• Razão contábil
• Diário geral

2. Relatórios Regulatórios

• COSIF (Plano Contábil das Instituições do Sistema Financeiro)
• CVM (Comissão de Valores Mobiliários)

3. Consultas

• Saldos mensais e diários
• Lançamentos contábeis paginados

4. Exportação

• PDF para impressão
• CSV para planilhas
• TXT para sistemas legados

📊 Estatísticas

• 5 controllers REST
• 23 endpoints documentados
• 13+ services com lógica de negócio
• 31 repositories JPA
• 36+ templates JasperReports
• 31 DTOs para transferência de dados

🔄 Fluxos Principais

Fluxo de Geração de Relatório

1. Cliente solicita relatório com parâmetros
   ↓
2. Serviço valida dados
   ↓
3. Serviço busca dados no banco
   ↓
4. Serviço compila template JasperReports
   ↓
5. Serviço preenche template com dados
   ↓
6. Serviço exporta para formato solicitado
   ↓
7. Serviço retorna relatório em base64

🎓 Público-Alvo

Usuários Finais

• Contadores e analistas contábeis
• Gestores financeiros
• Auditores

Integradores

• Desenvolvedores que consomem relatórios
• Sistemas externos que precisam de relatórios
• Frontend Angular que exibe relatórios

Última Atualização: 2025-12-01