📖 Casos de Uso - ecosif-reports

📋 Visão Geral

Este documento descreve os principais casos de uso do serviço ecosif-reports.

📦 Caso de Uso 1: Gerar Balancete Mensal

Descrição

Contador gera balancete mensal para análise de saldos.

Atores

• Contador: Usuário que gera relatório
• Sistema: Gera relatório

Pré-condições

• Usuário autenticado
• Dados contábeis disponíveis
• Período válido

Fluxo Principal

1. Contador solicita via POST /reports/monthlyTrialBalance
2. Sistema valida dados
3. Sistema busca saldos do período
4. Sistema compila template
5. Sistema gera PDF
6. Sistema retorna em base64

📦 Caso de Uso 2: Consultar Saldos

Descrição

Analista consulta saldos mensais de forma paginada.

Atores

• Analista: Usuário que consulta saldos
• Sistema: Retorna dados

Pré-condições

• Usuário autenticado
• Empresa/filial válidas

Fluxo Principal

1. Analista solicita via GET /api/v1/saldos/plano-saldo
2. Sistema valida parâmetros
3. Sistema busca dados paginados
4. Sistema retorna JSON com dados

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