Motor de regras
Como condições comerciais se transformam em decisões verificáveis de distribuição.
Função
O motor de regras interpreta a matriz vinculada ao contrato e avalia as condições aplicáveis à operação.
Ele responde a três perguntas:
- qual versão da regra está vigente;
- quais condições foram satisfeitas;
- qual distribuição deve ser apresentada para validação.
O resultado do motor não substitui as aprovações exigidas pelo Fechamento.
Componentes de uma regra
| Componente | Exemplo de uso |
|---|---|
| Âmbito | Organização, empreendimento, contrato ou unidade |
| Condição | Parcela, vencimento, marco contratual ou aprovação |
| Efeito | Incluir, suspender ou ajustar uma participação |
| Prioridade | Resolver a ordem quando mais de uma regra se aplica |
| Vigência | Definir quando a versão pode ser utilizada |
| Evidência | Preservar entradas, versão e resultado |
Regras devem usar referências de negócio compreensíveis. Evite condições que dependam de texto livre ou interpretação ambígua.
Ciclo de avaliação
- localize o contrato e a versão de matriz aplicável;
- reúna os dados necessários para as condições;
- avalie as regras na ordem definida;
- calcule a distribuição em centavos;
- verifique soma, limites e participantes;
- apresente o resultado em modo seguro;
- preserve a evidência da avaliação;
- encaminhe a operação para Fechamento.
Modo seguro
Toda regra deve poder ser avaliada sem produzir efeito financeiro.
O modo seguro permite:
- testar um cenário antes da vigência;
- comparar uma alteração com a versão anterior;
- explicar por que uma parte entrou ou saiu da distribuição;
- verificar arredondamento e soma;
- produzir evidência para revisão.
Uma avaliação válida não equivale a uma autorização de execução.
Versionamento
Uma versão aprovada não deve ser alterada retroativamente.
Quando a regra comercial mudar:
- crie uma nova versão;
- informe a vigência;
- valide com cenários representativos;
- registre o responsável pela aprovação;
- preserve a relação com a versão anterior;
- use a nova versão somente nas operações compatíveis com sua vigência.
Operações históricas continuam ligadas à versão utilizada no momento da decisão.
Controles de consistência
Antes do Fechamento, verifique:
- recebedores habilitados;
- percentuais dentro dos limites permitidos;
- soma fechada segundo a regra do contrato;
- valores em centavos sem diferença residual indevida;
- condições explicáveis;
- ausência de conflito entre regras;
- versão e vigência corretas;
- evidência disponível.
Integração
Sistemas integrados devem enviar referências estáveis do contrato e os fatos necessários à avaliação. A resposta deve ser tratada como uma decisão versionada, ligada ao mesmo identificador de correlação da operação.
Detalhes executáveis do ambiente contratado são fornecidos no onboarding técnico.
Relacionado
- Matriz de rateio: composição da distribuição
- Fechamento: validação e aprovação
- Referência de API: princípios de integração
- Auditoria e prova: preservação da decisão