HRD — Histórias de Regra de Decisão (B)

Ponto de vista: ESP — Especificação · Pasta: ESP (Especificação)/02-historias/HRD/

O que é

Condições lógicas explícitas: tabelas de decisão, regras de elegibilidade, validações, critérios de exceção, parâmetros e lógicas automatizáveis pela solução.

São especialmente importantes em soluções que tomam decisões sobre pessoas — toda lógica não trivial deve ter uma HRD correspondente para garantir rastreabilidade e auditabilidade.

Como usar

Elabore e refine conforme Regras de validação e o fluxo de vida das histórias.
Critérios de aceite mensuráveis; respeite HNI e demais histórias de nível superior quando aplicável.
Monorepo: ESP (Especificação)/02-historias/<TIPO>/ (pasta deste tipo de história).

Exemplo

---
id: ESP-HRD-0001
tipo: HRD
titulo: "Regra de bloqueio de cadastro duplicado"
status: rascunho
autor: fulano.de.tal
data: 2026-04-11
versao: "1.0"
hne-vinculadas:
  - ESP-HNE-0001
criticidade: alta
nivel-autonomia: 2   # 1=Rotineiro | 2=Relevante | 3=Crítico
tipo-decisao: automatica   # automatica | assistida | humana-obrigatoria
criterios-de-aceite:
  - "CPF já cadastrado deve bloquear novo cadastro e exibir mensagem informativa"
  - "Tentativa de duplicata deve gerar log de auditoria"
---

Bloco de regras

regras:
  - condicao: "CPF já cadastrado"
    resultado: "Bloquear cadastro e exibir mensagem"
    acao: "Log de auditoria + notificação ao gestor"
  - condicao: "CPF não encontrado"
    resultado: "Prosseguir com o cadastro"
  - condicao: "CPF inválido (formato)"
    resultado: "Rejeitar com mensagem de validação"

Tipos de decisão

Tipo	Quando usar
`automatica`	IA executa dentro de regras pré-aprovadas — Nível 1 ou 2
`assistida`	IA sugere, humano confirma antes do impacto — Nível 2
`humana-obrigatoria`	Decisão administrativa com efeito sobre direitos — Nível 3

Onde se aplica

Destino	Link
Framework ESP	/framework/esp/
Índice ESP	/artefatos/esp/
Fluxo de vida	/artefatos/esp/fluxo-de-vida/
IMP	/framework/imp/

Trânsito entre artefatos

Artefato	Direção
HNE, HNU	Regras de decisão derivadas do negócio
HS	Comportamentos de sistema que implementam as HRD
IMP-TDD	Casos de teste para cada regra
GTI-ADR	Decisões sobre o mecanismo de regras (motor de regras, código, etc.)

← HS · HUX →