📊 Visão Geral Funcional - ecosif-moviments¶

📋 Sobre o Projeto¶

ecosif-moviments é um microserviço Spring Boot responsável pelo gerenciamento de lançamentos contábeis no sistema eCosif. Este serviço processa, valida e armazena movimentações contábeis, além de realizar operações como consolidação, importação e cálculo de cotas.

🎯 Objetivo do Serviço¶

O serviço tem como objetivo centralizar e gerenciar todas as operações relacionadas a movimentações contábeis, garantindo:

✅ Integridade contábil - Validação de partidas dobradas
✅ Rastreabilidade - Histórico completo de alterações
✅ Performance - Processamento eficiente de grandes volumes
✅ Confiabilidade - Transações seguras e consistentes

🏢 Contexto no Sistema eCosif¶

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

ecosif-auth: Autenticação e autorização
ecosif-masterdata: Cadastros mestres (empresas, planos de contas)
ecosif-querys: Consultas e relatórios
ecosif-reports: Geração de relatórios
ecosif-compliance: Validações de conformidade

📦 Funcionalidades Principais¶

1. Gerenciamento de Lotes¶

Criação, consulta e exclusão de lotes contábeis
Agrupamento lógico de movimentações
Controle de períodos (ano/mês)
Validação de abertura/fechamento

2. Gerenciamento de Documentos¶

CRUD completo de documentos contábeis
Associação a lotes
Validação de quantidade de lançamentos
Histórico de alterações

3. Gerenciamento de Lançamentos¶

Criação individual de lançamentos
Validação de partidas dobradas
Controle de débitos e créditos
Validação de contas contábeis

4. Importação de Arquivos¶

Importação de arquivos CSV
Importação de arquivos IPL (formato legado)
Validação em lote
Upload automático para S3

5. Consolidação Contábil¶

Consolidação de saldos por período
Processamento assíncrono
Atualização de calendário
Validação de períodos anteriores

6. Cálculo de Cotas Tributárias¶

Cálculo automático de cotas de fundos
Validação de patrimônio líquido
Integração com calendário contábil
Persistência de valores calculados

7. Abertura/Fechamento de Períodos¶

Abertura de novos meses contábeis
Geração automática de calendário
Controle de dias úteis/finais de semana
Validação de períodos base

8. Purging de Dados¶

Arquivamento de dados antigos
Restauração de histórico
Validação de consolidação
Upload de dumps para S3

📊 Estatísticas¶

12 controllers REST
34 endpoints documentados
29 services com lógica de negócio
31 repositories JPA
32 DTOs para transferência de dados

🔄 Fluxos Principais¶

Fluxo Contábil Básico¶

1. Criar Lote
   ↓
2. Criar Documentos no Lote
   ↓
3. Criar Lançamentos nos Documentos
   ↓
4. Validar Partidas Dobradas
   ↓
5. Consolidar Período
   ↓
6. Calcular Cotas (se aplicável)

Fluxo de Importação¶

1. Upload de Arquivo (CSV/IPL)
   ↓
2. Parse e Validação
   ↓
3. Criação de Lotes/Documentos/Lançamentos
   ↓
4. Validação de Integridade
   ↓
5. Persistência
   ↓
6. Upload para S3 (arquivo processado)

🎓 Público-Alvo¶

Usuários Finais¶

Contadores e analistas contábeis
Gestores financeiros
Administradores de sistemas contábeis

Integradores¶

Desenvolvedores que integram com a API
Sistemas externos que consomem dados contábeis

📝 Notas Importantes¶

Partidas Dobradas: Sempre validadas automaticamente
Transações: Operações críticas são transacionais
Assíncrono: Consolidação executa em background
Histórico: Todas as alterações são registradas
Integridade: Validações em múltiplas camadas

Última Atualização: 2025-11-27