📊 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

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

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