Fornece a um agente de codificação de IA os fatos, regras, limites e exemplos necessários para aplicar regras de negócio de forma consistente. Define limites de adoção e evidências observáveis de falha, mantendo os limites específicos do ambiente configuráveis.
Status do pacote: contexto de referência pronto para revisão humana. O contrato e os cenários de teste estão completos, mas não se afirma que uma implementação adotante os tenha aprovado.
Decisão
Para Regras de negócio, adote instruções de repositório versionado delimitadas por caminho e tarefa. Implemente o comportamento por meio de um caminho autoritativo de escrita, interfaces tipadas, estado explícito e tratamento idempotente de efeitos colaterais. Este pacote é um contrato de referência: a equipe adotante deve escolher limites numéricos, provedores, jurisdições e responsáveis operacionais a partir de evidências em seu próprio ambiente.
Escopo
- Os atores, entradas, saídas, estados, versões de política ou esquema e resultados visíveis externamente descritos por este bloco de implementação.
- Interfaces primárias e alternativas, trabalhos em segundo plano, caches, integrações, caminhos de suporte e evidências que podem exercer o mesmo limite.
- Configuração específica de adoção, implantação, recuperação e responsabilidades de verificação necessárias para aplicar a referência com segurança.
Fora deste bloco
- Escolher um fornecedor universal, framework, jurisdição, limite numérico, período de retenção ou objetivo de nível de serviço para todos os adotantes.
- Afirmar que os cenários empacotados foram executados contra uma implementação a jusante ou que esta referência concede certificação legal, de segurança ou acessibilidade.
Contrato
- Declarar precedência de instruções, caminhos aplicáveis, verificações obrigatórias, alterações proibidas e as evidências esperadas na transferência.
- Derivar comandos, versões, arquitetura e localizações de arquivos a partir das fontes do repositório em vez de memória ou projeto vizinho.
- Manter a verificação executável separada das afirmações em prosa e registrar quando uma verificação não foi executada ou não pôde ser concluída.
- Exigir que o agente preserve alterações não relacionadas e pare quando credenciais, escopo destrutivo ou autoridade do produto estiverem ausentes.
- Validar entradas uma vez na fronteira e preservar a representação normalizada usada pela lógica a jusante.
- Persistir a transição de negócio antes ou atomicamente com um registro de outbox; consumidores deduplicam por identidade durável da operação.
- Declarar cada regra com proprietário, entradas, precedência, versão efetiva, resultado, exceções e exemplos concretos positivos e negativos na fronteira do domínio.
- Manter um caminho autoritativo de implementação e rastrear mudanças de regra para migrações, comportamento de compatibilidade, testes, documentação e evidências operacionais.
Orientações de implementação
- Enviar primeiro alterações aditivas de armazenamento e interface, preencher observavelmente, depois aposentar caminhos antigos após evidência de compatibilidade.
- Modelar entradas, saídas, atores, estados, invariantes, efeitos colaterais e evidências das Regras de negócio antes de selecionar detalhes de framework ou fornecedor.
- Armazenar a versão aplicável do contrato ou política de Regras de negócio com estado material para que migrações, reprodução e decisões de suporte permaneçam atribuíveis.
- Introduzir o caminho por trás de implantação controlada, comparar resultados esperados e observados, e manter uma rota de recuperação testada até que a evidência de adoção esteja completa.
Tratamento de falhas e salvaguardas
- Contexto conflitante ou desatualizado é apresentado como um bloqueio com fontes exatas; o agente não inventa um critério de desempate que altere o comportamento do projeto.
- Estado inválido ou contraditório das Regras de negócio é rejeitado ou colocado em quarentena; a implementação nunca supõe um valor que amplie autoridade ou duplique um efeito.
- Retentativas são limitadas e usam identidade durável; após esgotamento, o trabalho alcança um estado terminal inspecionável com um responsável contabilizável.
Verificação e operações
- Injetar falha de dependência antes e depois da persistência e provar que a retentativa converge para um resultado externamente visível.
- Monitorar sucesso, negação, falha de validação, falha de dependência, esgotamento de retentativas e recuperação das Regras de negócio por versão do contrato sem dimensões sensíveis do payload.
- Reexecutar fixtures positivos e negativos pareados após mudanças de política, esquema, dependência, migração ou limite e preservar as evidências resultantes.
Premissas de adoção
- Nomes e valores no exemplo são um fixture concreto, não padrões universais; adotantes os substituem por meio de evidências documentadas e propriedade.
- O sistema adotante pode fornecer identidade autenticada, versões duráveis de operação ou registro, telemetria limitada e um caminho controlado para mudança.
Os exemplos com aparência executável neste pacote são fixtures e contratos de aceitação. Execute o validador da coleção para verificar estrutura e metadados, depois traduza e execute os cenários no repositório alvo antes de registrar evidências da implementação.