📐 Camadas - ecosif-reports

📋 Visão Geral

O serviço ecosif-reports segue uma arquitetura em camadas focada em geração de relatórios, utilizando JasperReports para renderização.

🏗️ Estrutura de Camadas

┌─────────────────────────────────────────────────────────┐
│              Camada de Apresentação (REST)              │
│                                                         │
│  Controllers                                            │
│  • ReportsController                                    │
│  • PlanoSaldoController                                 │
│  • LancamentoContabilController                         │
│                                                         │
│  Responsabilidades:                                     │
│  • Receber requisições HTTP                             │
│  • Validação básica de entrada                          │
│  • Chamar services de geração                           │
│  • Retornar relatórios em base64                        │
└────────────────────┬────────────────────────────────────┘
                     │
                     │ usa
                     ▼
┌─────────────────────────────────────────────────────────┐
│            Camada de Aplicação (Services)               │
│                                                         │
│  Services                                               │
│  • PrintReportService                                   │
│  • ProcedureBalanceteGeralService                       │
│  • ProcedureRazaoService                                │
│                                                         │
│  Responsabilidades:                                     │
│  • Lógica de geração de relatórios                      │
│  • Preparação de dados                                  │
│  • Compilação de templates                              │
│  • Exportação para formatos                             │
└────────────────────┬────────────────────────────────────┘
                     │
                     │ usa
                     ▼
┌─────────────────────────────────────────────────────────┐
│           Camada de Persistência (Repositories)         │
│                                                         │
│  Repositories                                           │
│  • AccountbalanceRepository                             │
│  • MonthlyAccountBalanceRepository                      │
│  • EntryRepository                                      │
│                                                         │
│  Responsabilidades:                                     │
│  • Acesso a dados                                       │
│  • Queries customizadas                                 │
│  • Chamadas de procedures                               │
└────────────────────┬────────────────────────────────────┘
                     │
                     │ persiste
                     ▼
┌─────────────────────────────────────────────────────────┐
│              Camada de Dados (Entities)                 │
│                                                         │
│  ecosif-database (Biblioteca Compartilhada)             │
│  • Entry • Balance • ChartOfAccounts                    │
│  • Document • Batch • CompanyOptions                    │
│  • ... (52+ entidades)                                  │
└─────────────────────────────────────────────────────────┘

🔄 Fluxo de Dados: Geração de Relatório

Cliente HTTP
    │
    ▼
ReportsController
    │ Valida entrada
    │
    ▼
PrintReportService
    │ Busca dados via Repository
    │
    ▼
Repositories
    │ Queries/Procedures
    │
    ▼
PostgreSQL
    │ Dados contábeis
    │
    ▼
PrintReportService
    │ Prepara dados (DTOs)
    │ Compila template (.jrxml)
    │ Preenche template
    │
    ▼
ExportReportsHelper
    │ Exporta para PDF/CSV/TXT
    │ Converte para base64
    │
    ▼
Controller
    │ Retorna RetornoGenerico
    │
    ▼
Cliente HTTP

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