Skip to content

Relatório de validação mais legível: CSV objetivo (problema/ação de correção) + novo relatório HTML agrupado por gravidade e categoria #34

Description

@Rossi-Luciano

Descrição da nova funcionalidade

Eu, como técnico da equipe de Publicação, gostaria que os resultados de validação fossem apresentados de forma mais direta e organizada — tanto no CSV existente quanto em um novo relatório HTML —, então eu conseguiria localizar e agir sobre as ocorrências relevantes sem precisar interpretar campos técnicos de depuração nem percorrer uma planilha extensa e sem agrupamento.

Critérios de aceitação

1. Adequação do CSV

  • Remover o campo data do CSV exportado (hoje é o dump bruto do resultado de validação do packtools, com chaves técnicas como got_value, expected_value, validation_type, úteis para depuração da ferramenta, não para o uso operacional).
  • Adicionar ao CSV o campo message do resultado de validação do packtools (o diagnóstico, ex. "Got <valor obtido>, expected <valor esperado>") sob o cabeçalho "problema" — hoje esse campo não é repassado ao CSV pelo spsvalidator.
  • Renomear, no CSV, a coluna atual (que hoje recebe o campo advice do packtools sob o rótulo genérico message) para o cabeçalho "ação de correção".
  • Manter as colunas package, status (gravidade) e subject/categoria.

2. Novo relatório em HTML

  • Criar uma nova visualização (ex.: rota /validation/<id>/report.html) que apresente as ocorrências agrupadas hierarquicamente: primeiro por gravidade (CRITICAL, ERROR, WARNING) e, dentro de cada gravidade, por categoria — usando o campo group que o packtools já calcula (ex. "history", "contrib", "reference"), correspondente às seções do exemplo dado ("Datas de histórico", "Autoria", "Referências").
  • Cada ocorrência deve exibir de forma resumida o "problema" e a "ação de correção" (mesmos textos do item 1).
  • Detalhes técnicos adicionais (valores brutos, campos de depuração) devem ficar disponíveis apenas mediante expansão/interação do usuário, não visíveis por padrão.
  • O CSV continua disponível como exportação/artefato de apoio técnico, mas deixa de ser a interface principal de consulta dos resultados.

Anexos

N/A

Referências

Feedback de usabilidade da equipe de Publicação sobre a versão atual do SPS Validator (2026-07-24).

Metadata

Metadata

Assignees

Labels

enhancementNew feature or request

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions