T-337 - Mostrar ao auditor as simulações, a finalização e o que mudou entre versões

• Componente: frontend.
• Depende de: T-307 (área do auditor e dossiê), T-333 (contrato do resumo) e T-335 implantada para a verificação manual.
• Data máxima: 17/11/2026
• Estimativa: 5 pontos (Fibonacci)

Entregável

• Aba "Simulações e finalização" do dossiê da regra.
• Comparação entre versões na aba "Regra e versões".
• Número da versão vigente no cabeçalho do dossiê.
• Testes.

Descrição

O auditor precisa ver cada simulação da regra, com os parâmetros, o resultado e a situação, comparar uma simulação com a anterior, saber como a regra foi finalizada e ver o que mudou de uma versão para a outra. Esta tarefa acrescenta ao dossiê da T-307 a aba "Simulações e finalização" e a comparação entre versões, conforme o mockup.

Contexto e decisões tomadas

• Os contadores, a versão vigente, as alterações de cada versão e a comparação entre simulações vêm prontos de GET /auditoria/jobs/{id}/resumo (T-333 e T-335). O frontend não calcula valor exibido.
• Os dados de cada simulação vêm de GET /auditoria/jobs/{id}, já carregada pela T-307: simulacoes, resultados (totais, veredito, decomposição, asserções e diagnóstico), versoes (núcleo e parâmetros), acoes e sugestoes_meta.
• A simulação percorre a base histórica inteira das competências da regra, e o cargo é a menor granularidade. A "memória de cálculo" de um vendedor e a matrícula do mockup não existem. No lugar delas, a tela mostra os totais e a quebra da diferença por loja, marca, cargo e competência. A quebra por matrícula não aparece.
• No vocabulário do mockup, produto é marca, canal é loja e funcionário é cargo. Loja, marca e cargo aparecem pelo código, e simulações e códigos pelo id.
• A trilha cronológica do mockup lê o painel de eventos e fica com a T-338.

Escopo

Dentro do escopo

• Os componentes da aba e da comparação de versões na feature src/features/auditoria/, a chamada do resumo no serviço da feature e os specs.

Fora do escopo

• Trilha cronológica (T-338) e fontes dos dados (T-328).
• Arquivos quentes listados em frontend/AGENTS.md.

Requisitos

1. Acrescentar ao serviço e a types.ts da feature a rota do resumo, espelhando o contrato.
2. Mostrar os contadores do resumo: simulações registradas, concluídas, com falha e versão vigente. A versão vigente aparece também no cabeçalho do dossiê.
3. Listar as simulações com o id, o número da versão e o id do código, o horário, os parâmetros (competências, orçamento e meta de venda), os totais (baseline, simulado e diferença) e a situação (status do resultado e veredito). Simulação sem resultado de sucesso mostra a situação sem totais.
4. Ao escolher uma simulação, mostrar os códigos de loja, marca e cargo da versão usada, as competências, o orçamento, a meta de venda, os totais, o veredito e a quebra da diferença por loja, marca, cargo e competência.
5. Mostrar a comparação da simulação escolhida com a anterior, com o valor anterior, o atual e a variação de cada indicador, como vieram do resumo. Simulação sem comparação não mostra o bloco.
6. Mostrar a finalização: a ação de fechamento (confirmar_liberar, salvar, arquivar ou cancelar) com o horário, a versão vigente e o aceite da meta sugerida quando houver.
7. Na aba "Regra e versões", o auditor escolhe uma versão com origem e vê só as partes alteradas, com o valor anterior e o novo, como vieram do resumo.
8. Valores só são formatados (moeda, percentual, data e hora de Brasília). Nenhum valor é calculado.
9. Registrar as falhas da chamada do resumo pelo transporte de telemetria existente, com nome de operação fixo e o código do erro, sem valores.

Contexto técnico

• Entradas: as respostas de GET /auditoria/jobs/{id} e GET /auditoria/jobs/{id}/resumo.
• Saídas: a aba "Simulações e finalização", a comparação de versões e a versão vigente no cabeçalho.
• Componentes afetados: a feature src/features/auditoria/.
• Restrições: nenhuma importação de outra feature; views com até cerca de 200 linhas, com o excedente em composables.
• Referências: frontend/AGENTS.md, contracts/http/openapi.yaml, contracts/domain/resultado-totais.schema.json, contracts/domain/resultado-decomposicao.schema.json, frontend/src/components/TotaisDetalhamento.vue como exemplo de apresentação da decomposição.

Critérios de aceitação

• Num job com a simulação 1 em erro_codigo e as simulações 2 e 3 em sucesso, a aba mostra 3, 2 e 1, a simulação 3 com a comparação à 2, e a simulação 1 sem totais.
• A variação mostrada é a do resumo, só formatada.
• A comparação de versões mostra só as partes alteradas.
• Nenhuma tela mostra matrícula nem rótulo de loja, marca ou cargo.

Definição de concluído (DoD)

• make check no frontend sem falha.
• Specs da aba, da comparação de versões, do serviço e dos estados sem resultado e sem comparação.
• Uso no navegador contra a API local com uma conta de auditor, num job com uma simulação com falha e duas com sucesso.
• Emissão da telemetria das falhas conferida no navegador; a coleta ponta a ponta é informada como verificação separada.