Pular para conteúdo

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: