T-315 - Obter da PO as decisões da explicação da simulação

• Componente: raiz (PO).
• Depende de: nenhuma tarefa.
• Data máxima: 05/11/2026
• Estimativa: 1 ponto (Fibonacci)

Entregável

Entregar as respostas da PO às perguntas abaixo, registradas na issue, para que as tarefas da US05 sigam sem suposição.

• Resposta sobre quem vê a explicação.
• Resposta sobre quais simulações recebem explicação.
• Resposta sobre a interpretação do resultado.
• Resposta sobre o que significa extrair a explicação para conferência.
• Resposta sobre o que a tela mostra quando não há explicação.
• Resposta sobre os números que a explicação pode citar.

Descrição

A US05 pede que o sistema explique as decisões tomadas na simulação, com a explicação atrelada ao registro da simulação e disponível para extração e conferência técnica pela equipe de RH. Quando o modelo de IA não devolve a explicação, o resultado vale e a simulação é marcada com baixa rastreabilidade. As tarefas da US05 foram escritas com decisões assumidas que cabem à PO. Esta tarefa reúne as perguntas. Cada uma traz a opção assumida, para que a resposta possa ser só a confirmação, e diz o que muda se a resposta for outra.

Contexto e decisões tomadas

• A explicação é um texto curto em linguagem de negócio. Ele diz o que a regra fez com o custo da comissão, o que puxou a diferença em relação ao cenário atual e o que isso significa para o orçamento.
• O texto é escrito pelo modelo de IA, mas os números não. Todos os números vêm da simulação, que roda sobre os dados reais. O sistema confere cada número citado no texto antes de mostrá-lo.
• As respostas são transcritas para a DEC-087 na tarefa do contrato da explicação.

Perguntas

1. Quem vê a explicação

O profissional de RH vê a explicação no relatório da simulação, e o auditor a vê na consulta de auditoria?

• Assumido: sim, os dois. O RH vê só a explicação aprovada na conferência. O auditor vê também a reprovada, marcada como tal.
• Se só o auditor: o relatório do RH não muda, e a tarefa de exibição no frontend sai da sprint.
• Se só o RH: a consulta de auditoria deixa de mostrar as explicações.

2. Quais simulações recebem explicação

Toda simulação que produziu um resultado válido recebe explicação, inclusive a simulação de uma alternativa sugerida pelo sistema?

• Assumido: sim. Simulações que falharam não recebem explicação, porque não há número a explicar.
• Meta aceita: quando o usuário aceita a meta de venda sugerida, o resultado mostrado passa a ser o da meta. Assumido: esse resultado não recebe explicação nesta versão, e a tela não mostra a explicação do resultado anterior, cujos números são outros. Se a PO quiser a explicação também nesse caso, uma tarefa nova a acrescenta.

3. Interpretação do resultado

A explicação inclui o que puxou a diferença (por exemplo, "a diferença se concentrou em duas lojas"), em vez de uma etapa separada de interpretação?

• Assumido: sim, a explicação inclui a interpretação.
• Se não: uma tarefa nova cria a etapa de interpretação separada.

4. Extração para conferência

A US05 diz que a explicação fica "disponível para extração e conferência técnica pela equipe de RH". Isso é poder copiar o texto da explicação a partir do relatório?

• Assumido: sim, uma ação de copiar o texto.
• Se for outra forma (baixar um arquivo, exportar o relatório com a explicação): a tarefa de exibição no frontend muda conforme a resposta.

5. Tela sem explicação

Quando o modelo não devolve explicação, ou quando a explicação reprova na conferência dos números, o que o relatório do RH mostra?

• Assumido: uma mensagem neutra de que a explicação não está disponível para esta simulação, sem termos internos como "flag" ou "rastreabilidade". O resultado aparece normalmente.
• Se for outra: o mockup e a tela usam o texto definido pela PO.

6. Números que a explicação pode citar

A explicação só pode citar números que existem na simulação (totais, diferença, orçamento, contribuições por loja, marca, cargo e competência) ou na própria regra (percentuais, códigos e período). Uma explicação que cite qualquer outro número, como uma porcentagem calculada pelo modelo, é reprovada e não aparece. Essa regra está correta?

• Assumido: sim. É a garantia de que nenhum número mostrado ao usuário vem do modelo de IA.
• Se não: a regra de conferência muda antes da tarefa da etapa de explicação.

Critérios de aceitação

• As seis perguntas têm resposta da PO registrada na issue.
• Cada resposta diferente da assumida tem a tarefa afetada indicada no comentário da resposta.

Definição de concluído (DoD)

• Respostas registradas na issue e comunicadas aos responsáveis pelas tarefas da US05.