Skip to content

T-314 - Obter da PO as decisões da consulta do auditor #388

Closed

Description

@pedro-fs-garcia

T-314 - Obter da PO as decisões da consulta do auditor

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

Entregável

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

  • Resposta sobre o texto da entrada na consulta do auditor.
  • Resposta sobre o áudio na consulta do auditor.
  • Resposta sobre o detalhamento por matrícula na consulta do auditor.
  • Resposta sobre identificadores, versões e estados internos na tela do auditor.
  • Resposta sobre a forma do registro estruturado do cenário 1.
  • Resposta sobre a retenção do registro do cenário 2.
  • Resposta sobre as contas de demonstração do staging.

Descrição

As tarefas da US04 (T-304 a T-313) foram escritas com decisões assumidas que cabem à PO. Esta tarefa reúne as perguntas, explica cada uma e diz o que muda conforme a resposta. Cada pergunta tem a opção que as tarefas assumiram, para que a resposta possa ser só a confirmação.

Contexto e decisões tomadas

  • O auditor é um papel não operacional que averigua o que aconteceu num job (DEC-087). Ele consulta um registro com as entradas, as versões da regra, as etapas do processamento, as chamadas ao modelo de IA, o código executado, os resultados e as decisões do usuário.
  • As respostas são transcritas para a DEC-087 na T-304.

Perguntas

1. Texto da entrada

O auditor deve ver o texto que o usuário digitou ou que foi transcrito do áudio, e o conteúdo do formulário?

  • Assumido: sim. Os prompts enviados ao modelo, que o auditor vê, já contêm esse texto.
  • Se não: a T-304 e a T-305 retiram as entradas da consulta, e os prompts precisam ser omitidos ou mascarados, o que exige outra tarefa.

2. Áudio

O auditor deve ouvir o áudio enviado pelo usuário?

  • Assumido: não nesta versão.
  • Se sim: uma tarefa nova acrescenta uma rota que devolve o áudio ao auditor e o reprodutor na tela.

3. Detalhamento por matrícula

O auditor deve ver o detalhamento da simulação por colaborador, loja, marca e cargo em cada competência, que hoje só o profissional de RH vê no relatório?

  • Assumido: não nesta versão.
  • Se sim: uma tarefa nova libera ao auditor a consulta do detalhamento e o mostra na tela dele.

4. Informação interna na tela do auditor

A tela do auditor pode mostrar identificadores, horários, versões da regra e estados internos do processamento?

  • Assumido: sim. A US04 exige o id da simulação, o horário e a versão exata da regra. A regra de não mostrar lógica interna continua valendo para as telas do profissional de RH.
  • Se não: o mockup (T-306) e a tela (T-307) precisam de outra forma de identificar a simulação e a versão.

5. Forma do registro estruturado (cenário 1)

O cenário 1 pede gravar "um registro estruturado (ex: JSON) do fluxo principal". O sistema grava o registro em tabelas ligadas entre si, uma linha por etapa, e a consulta do auditor monta e devolve o JSON completo do job. Isso atende o cenário?

  • Assumido: sim.
  • Se não: uma tarefa nova grava, ao fim de cada simulação, um JSON único com o registro daquela simulação.

6. Retenção do registro (cenário 2)

O cenário 2 pede reter o registro "em memória ou em um arquivo local seguro" quando a gravação falha. No sistema, o registro de cada etapa viaja numa mensagem que fica guardada na fila até ser gravada, e a simulação continua mesmo que a gravação falhe. Essa retenção pela fila atende o cenário?

  • Assumido: sim. A T-313 registra a decisão e prova o comportamento.
  • Se não: uma tarefa nova implementa a retenção em memória ou em arquivo.

7. Contas de demonstração do staging

A conta [email protected], usada nas revisões, continua como profissional de RH, e a auditoria ganha uma conta própria, [email protected]?

  • Assumido: sim. A T-308 cria a conta de auditor e acerta o papel de [email protected] no script de dados de demonstração.
  • Se não: a T-308 muda conforme a resposta.

Critérios de aceitação

  • As sete 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 T-304, T-306, T-307, T-308 e T-313.

Activity

  1. added this to the Sprint 3 milestone on Nov 3, 2026
  2. borroniff commented on Nov 5, 2026

    @borroniff
    Collaborator

    Segue link contendo as respostas a todas as perguntas:
    Link do documento

  3. pedro-fs-garcia commented on Nov 5, 2026

    @pedro-fs-garcia
    CollaboratorAuthor

    Respostas da PO, transcritas do documento linkado acima, com o efeito de cada uma nas tarefas.

    # Pergunta Resposta da PO Efeito
    1 Texto da entrada e conteúdo do formulário Sim. Confirma o assumido (T-304, T-305).
    2 Áudio O auditor deve ouvir o áudio, para saber se a transcrição foi feita da maneira correta. Muda o assumido. T-330 (rota do áudio na API) e T-331 (reprodutor no frontend) foram criadas. T-306 passa a incluir o reprodutor no mockup, e T-304 registra a decisão.
    3 Detalhamento por matrícula Não é necessário. Confirma o assumido.
    4 Informação interna na tela do auditor Sim. Confirma o assumido (T-306, T-307).
    5 Forma do registro estruturado Sim. Confirma o assumido (T-304, T-305).
    6 Retenção do registro quando a gravação falha Deve-se manter o fluxo atual. Confirma o assumido: a retenção é a da fila (T-313).
    7 Contas de demonstração do staging Sim, porque o acesso é para informações e fluxo diferentes. Confirma o assumido (T-308).
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

POtarefa dedicada ao PO

Type

No type

Projects

No projects

    Milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions