📊 Visão Geral Funcional - ecosif-compliance¶

📋 Sobre o Projeto¶

ecosif-compliance é um microserviço Python/Flask especializado em validação de conformidade contábil no sistema eCosif. Utiliza um sistema de regras configuráveis com DSL customizada para identificar possíveis inconsistências ou indícios de problemas contábeis.

🎯 Objetivo do Serviço¶

O serviço tem como objetivo fornecer validação automatizada de conformidade contábil, com:

✅ Sistema de regras flexível - Regras configuráveis via DSL
✅ Identificação de indícios - Classificação de problemas encontrados
✅ Auditoria - Histórico de execuções
✅ Integração - Integrado com dados contábeis do eCosif

🏢 Contexto no Sistema eCosif¶

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

ecosif-auth: Autenticação e autorização
ecosif-masterdata: Dados mestres (empresas, planos de contas)
ecosif-moviments: Lançamentos contábeis (dados validados)
ecosif-querys: Consultas (dados consultados para validação)
ecosif-reports: Relatórios (pode incluir resultados de compliance)

📦 Funcionalidades Principais¶

1. Gerenciamento de Regras¶

Cadastro de regras de validação
Edição de regras existentes
Listagem de regras
Scripts DSL para definição de lógica

2. Execução de Validações¶

Validação por empresa/filial
Validação por documento
Validação por período
Execução em lote

3. Tipos de Indício¶

Classificação de problemas encontrados
Múltiplos tipos de indício configuráveis
Severidade de problemas

4. Histórico de Execuções¶

Listagem de processos executados
Detalhamento de resultados
Filtros por data e empresa

📊 Estatísticas¶

1 aplicação Flask
11 endpoints REST documentados
3 services principais
9 DAOs para acesso a dados
9 entidades SQLAlchemy
1 DSL customizada com parser PLY

🔄 Fluxos Principais¶

Fluxo de Validação¶

1. Usuário solicita validação com parâmetros
   ↓
2. Serviço busca regras aplicáveis
   ↓
3. Para cada regra:
   - Compila script DSL
   - Executa sobre dados contábeis
   - Coleta resultados
   ↓
4. Persiste resultados no banco
   ↓
5. Retorna resultados ao usuário

🎓 Público-Alvo¶

Usuários Finais¶

Contadores e analistas contábeis
Auditores
Gestores financeiros
Compliance officers

Integradores¶

Desenvolvedores que precisam integrar validações
Sistemas externos que validam conformidade
Frontend Angular que exibe resultados

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