📊 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