Visão Geral Funcional - ecosif-masterdata

O que é o ecosif-masterdata?

O ecosif-masterdata é o serviço central de gerenciamento de dados mestres do ecossistema eCosif. Ele é responsável por:

• Gerenciar todas as informações estruturais do sistema contábil
• Fornecer APIs REST para cadastro, consulta e manutenção de dados mestres
• Suportar o funcionamento de todos os outros serviços do ecossistema eCosif

Contexto no Ecossistema eCosif

O ecosif-masterdata atua como a base de dados mestres para todos os outros serviços:

┌─────────────────┐
│   Cliente       │
│  (Frontend)     │
└────────┬────────┘
         │
         ▼
┌─────────────────────────────┐
│     ecosif-auth             │
│  (Autenticação & JWT)       │
└────────┬────────────────────┘
         │
         │ Token JWT
         ▼
┌──────────────────────────────────────────┐
│     ecosif-masterdata                    │
│  (Dados Mestres)                         │
│  - Empresas/Filiais                      │
│  - Plano de Contas                       │
│  - Calendários                           │
│  - Documentos/Lançamentos                │
└────────┬─────────────────────────────────┘
         │
         │ Dados Mestres
         ▼
┌──────────────────────────────────────────┐
│  Outros Serviços eCosif                  │
│  - ecosif-moviments                      │
│  - ecosif-querys                         │
│  - ecosif-reports                        │
└──────────────────────────────────────────┘

Principais Funcionalidades

1. Gestão de Empresas e Filiais

• Cadastro completo de empresas com validação de CNPJ
• Gerenciamento de filiais por empresa
• Consulta de dados via APIs externas (CNPJ, CEP)
• Controle de acesso por empresa/filial

2. Plano de Contas

• Estrutura hierárquica completa (sintéticas e analíticas)
• Validação de hierarquia (contas filhas requerem conta pai)
• Código contábil e código reduzido
• Níveis e número de filhos
• Planos de contas de referência

3. Calendários Contábeis

• Períodos contábeis por empresa/filial
• Exercícios fiscais
• Controle de abertura/fechamento de meses
• Validação de dias disponíveis para lançamentos
• Indicadores de fechamento

4. Documentos e Lançamentos

• Gerenciamento de documentos contábeis
• Lançamentos contábeis (débito/crédito)
• Lotes contábeis
• Validações de consistência
• Resumos e totais

5. Configurações do Sistema

• Opções por empresa/filial
• Configurações de fundos
• Configurações de fechamento
• Configurações de cálculo de cotas
• Parâmetros contábeis

6. Consolidação Contábil

• Processamento de consolidação
• Cálculo de saldos
• Agregação de dados por empresa/filial
• Processamento assíncrono

7. Históricos Padrão

• Históricos pré-definidos para lançamentos
• Reutilização de históricos comuns

8. Controle de Acessos

• Rotinas do sistema
• Permissões por usuário/grupo
• Controle de acesso por empresa/filial/rotina

Público-Alvo

Usuários Finais

• Contadores e profissionais da área contábil
• Administradores do sistema
• Usuários que precisam manter dados cadastrais

Desenvolvedores

• Equipe de desenvolvimento eCosif
• Desenvolvedores de integrações externas
• Equipe de DevOps

Integradores

• Empresas que integram seus sistemas com eCosif
• Desenvolvedores de aplicações que consomem a API

Benefícios

Para Usuários

• ✅ Interface única para gerenciar todos os dados mestres
• ✅ Validações automáticas
• ✅ Integração com APIs externas (CNPJ, CEP)
• ✅ Consistência de dados

Para Desenvolvedores

• ✅ API REST completa e bem documentada
• ✅ Arquitetura clara e manutenível
• ✅ Código organizado e extensível

Para a Empresa

• ✅ Centralização dos dados mestres
• ✅ Reutilização de dados entre serviços
• ✅ Consistência e integridade dos dados
• ✅ Escalabilidade horizontal

Casos de Uso Principais

1. Cadastro de Empresa: Novo cliente é cadastrado no sistema
2. Configuração de Filial: Nova filial é configurada para uma empresa
3. Criação de Plano de Contas: Plano de contas é estruturado
4. Cadastro de Lançamento: Novo lançamento contábil é registrado
5. Consolidação: Processo de consolidação é executado

Tecnologias e Padrões

• REST API: Interface HTTP RESTful
• JWT: Autenticação via tokens JWT
• Spring Security: Segurança e autorização
• JPA/Hibernate: Persistência de dados
• OpenAPI/Swagger: Documentação interativa da API
• Multi-tenancy: Isolamento por empresa/filial

Próximos Passos

Para mais informações, consulte:

• Objetivos: Objetivos e metas do sistema
• Regras de Negócio: Regras e validações do sistema
• Casos de Uso: Casos de uso detalhados