📐 Camadas - ecosif-compliance
📋 Visão Geral
O serviço ecosif-compliance segue uma arquitetura em camadas focada em validação de conformidade, utilizando Flask para API REST e SQLAlchemy para persistência.
🏗️ Estrutura de Camadas
┌─────────────────────────────────────────────────────────┐
│ Camada de Apresentação (REST) │
│ │
│ Flask + Flask-RESTX │
│ • starter.py │
│ • Endpoints REST (@api.route) │
│ • Swagger UI automático │
│ │
│ Responsabilidades: │
│ • Receber requisições HTTP │
│ • Validação de entrada │
│ • Serialização de respostas │
│ • Tratamento de erros HTTP │
└────────────────────┬────────────────────────────────────┘
│
│ chama
▼
┌─────────────────────────────────────────────────────────┐
│ Camada de Aplicação (Services) │
│ │
│ Services │
│ • compliance.py - Validação principal │
│ • rule.py - Gerenciamento de regras │
│ • account.py - Operações com contas │
│ │
│ Responsabilidades: │
│ • Lógica de validação │
│ • Execução de regras DSL │
│ • Processamento de dados │
│ • Orquestração de operações │
└────────────────────┬────────────────────────────────────┘
│
│ usa
▼
┌─────────────────────────────────────────────────────────┐
│ Camada de Persistência (DAOs) │
│ │
│ Data Access Objects │
│ • RuleDao │
│ • DocumentDao │
│ • ProcessDao │
│ • ClueTypeDao │
│ │
│ Responsabilidades: │
│ • Acesso a dados │
│ • Queries otimizadas │
│ • Mapeamento objeto-relacional │
└────────────────────┬────────────────────────────────────┘
│
│ usa
▼
┌─────────────────────────────────────────────────────────┐
│ Camada de Dados (ORM) │
│ │
│ SQLAlchemy Entities │
│ • RuleEntity │
│ • DocumentEntity │
│ • ProcessEntity │
│ • ... │
│ │
│ Responsabilidades: │
│ • Mapeamento ORM │
│ • Validações de modelo │
│ • Relacionamentos │
└────────────────────┬────────────────────────────────────┘
│
│ persiste
▼
┌─────────────────────────────────────────────────────────┐
│ PostgreSQL Database │
│ • Tabelas de regras │
│ • Tabelas de processos │
│ • Dados contábeis │
└─────────────────────────────────────────────────────────┘
🔄 Fluxo de Dados: Execução de Validação
Cliente HTTP
│
▼
Flask Endpoint (POST /api/compliance/run)
│ Valida parâmetros
│
▼
ComplianceService.run()
│ Busca regras aplicáveis via RuleDao
│
▼
RuleDao
│ Query SQLAlchemy
│
▼
PostgreSQL
│ Dados de regras
│
▼
ComplianceService
│ Para cada regra:
│ - Compila script DSL (PLY parser)
│ - Executa sobre dados contábeis
│ - Coleta resultados
│
▼
ProcessDao
│ Persiste resultados
│
▼
PostgreSQL
│ Dados persistidos
│
▼
Flask
│ Retorna JSON com resultados
│
▼
Cliente HTTP
Última Atualização: 2025-12-01