Documentação/Evidências
FEATURE ROLLOUT · DOCUMENTAÇÃO

Anexando evidências

Uma evidência útil prova o comportamento observado e carrega contexto suficiente para ser auditada depois.

Tipos de evidência

O visualizador possui dois contratos de apresentação: imagem para screenshots e texto para JSON, XML, logs, YAML e outros formatos legíveis. Vídeos, traces e ZIPs continuam registrados como artefatos externos.

IMAGEPNG, JPEG, WebP ou GIF exibido no próprio painel
TEXTJSON formatado, XML, YAML, CSV, log ou texto puro
BINARYVídeo, trace ou ZIP preservado no CI por URL HTTPS
json
{
  "results": {
    "tool": { "name": "playwright", "version": "1.56.0" },
    "summary": {
      "tests": 1,
      "passed": 1,
      "failed": 0,
      "pending": 0,
      "skipped": 0,
      "other": 0,
      "start": 1785888000000,
      "stop": 1785888001420
    },
    "tests": [{
      "name": "CT-PIX-001 cria autorização válida",
      "status": "passed",
      "duration": 1420,
      "tags": ["CT-PIX-001"],
      "extra": { "scenarioId": "CT-PIX-001" },
      "attachments": [{
        "name": "authorization.json",
        "description": "Resposta que comprova status ATIVA e o ID persistido.",
        "doubleChecked": true,
        "contentType": "application/json",
        "content": "{\"status\":\"ATIVA\",\"authorizationId\":\"auth_123\"}",
        "encoding": "utf8"
      }]
    }]
  }
}

Rastreabilidade mínima

Toda evidência deve apontar para execução, teste e, quando possível, cenário de aceite. O campo description explica em linguagem humana o que o arquivo representa; doubleChecked só deve ser marcado quando um segundo modelo de IA tiver confirmado a evidência. Commit, ambiente e data vêm da execução e não precisam ser duplicados no nome do arquivo.

Referências, não uploads pesados

A API normaliza metadados de artefatos. Vídeos e traces grandes devem permanecer no CI ou em storage dedicado, usando uma URL HTTPS.

Vínculo com cenários

Inclua IDs como CT-03 no nome ou nas tags do teste, ou envie uma label scenario. O backend valida se o cenário pertence à mesma feature.