fix(platform): make the PR-data query opt-in and localize its steps

[cpenaforte-clickbus]

Contexto e Motivação

Uma revisão da pilha de plataforma (#282 e #283) antes do merge achou problemas reais. O marcador de dado incompleto não aparecia nos cards da comparação no celular. A consulta nova obrigava o banco a agregar o payload de todos os runs para todo chamador de getOrgReposSummary — a página de repositórios e a de exposição a IA também —, embora só a comparação precise do campo. O fallback repetia a consulta sem o campo em qualquer erro, mascarando timeout. E o tooltip mostrava os identificadores internos dos passos em inglês, até no texto em português.

Refs #236

Mudanças

• A leitura de payload->pr_enrichment_degraded passa a ser opt-in em getOrgReposSummary: só a comparação liga; os outros chamadores voltam a não pedir o campo.
• O fallback só repete sem o campo quando a coluna não existe (código 42703 ou mensagem citando o payload); timeout e erro de permissão seguem o caminho normal de erro. O filtro por organização vale nos dois caminhos.
• As linhas do resumo ganham uma interface tipada no lugar de Record<string, any>.
• Os passos aparecem com rótulos traduzidos (en-US e pt-BR; o es-ES cai no en-US), sem repetição, e o aviso do dashboard lista no máximo cinco repositórios, com "e mais N".
• O marcador aparece também nos cards do celular, com a legenda valendo para os dois layouts; o ponto tem title com os passos e texto para leitor de tela.
• A verificação de "algum marcado" fica inline no componente, e o comentário da página do repositório deixa de afirmar que os painéis somem sempre que a leitura degrada.

Plano de Teste

• npx vitest run tests/compare-pr-degraded.test.ts tests/pr-enrichment.test.ts tests/pr-degraded-repos.test.ts — o select sem payload para quem não pede; o fallback no 42703 e a ausência de nova tentativa no timeout; os rótulos nos dois idiomas; a deduplicação; o corte em cinco nomes — rodado em d9c6a38: 21 passed
• npm run lint, npx tsc --noEmit, npm run test:coverage, npm run build — os passos do job platform do CI — rodado em d9c6a38: lint 0 erros, tsc ok, test:coverage 424 passed, build ok
• Manual: comparação no desktop e no celular com um repositório degradado; dashboard com mais de cinco degradados — verificado de ponta a ponta no topo da pilha (fix(platform): make the PR-data marker readable on touch and keyboard #293, em 4911e6d, com o rótulo corrigido conferido depois em 8e83ca4), que contém este PR: plataforma rodando sobre as migrações reais e um PostgREST, com payloads do engine em sete cenários de falha, no Playwright em desktop, celular (390 px), só teclado, leitor de tela, tema escuro, pt-BR, en-US e es-ES; nos cards do celular, os passos ficam numa linha própria sob o nome; o dashboard com 7 degradados lista 5 e "e mais 2"

A verificação roda fora da máquina de quem construiu: o job platform do CI (RFC 0029, PM-4).

Impacto e Risco

• Áreas afetadas: a consulta de resumo por repositório e seus chamadores, a comparação, o aviso do dashboard e as strings de tradução.
• Compatibilidade: sem migração; sem o campo no payload, nada aparece, como antes.
• Performance: melhora — a página de repositórios e a de exposição a IA deixam de pagar a agregação do payload; um timeout deixa de virar duas consultas.
• Segurança: o filtro por organização continua nos dois caminhos da consulta; os passos passam pela lista de valores permitidos antes de chegar à tela.
• Acessibilidade: marcador com texto para leitor de tela e legenda visível nos dois layouts; o PR seguinte mostra os passos como texto para quem usa toque ou teclado.
• Custo AWS: N/A.

Sobre o tamanho (RFC 0028 §2.4): 377 linhas, faixa 251–500. São os achados da revisão da plataforma, um commit por assunto; os ajustes de acessibilidade pedidos na revisão final foram para o PR seguinte para caber.

Plano de Rollback

git revert do merge. Volta o comportamento do #283; nada a migrar.

Referências

• Issue: [DEBT] PR enrichment degrades silently when the GraphQL step fails; the report carries no signal #236
• Depends on feat(platform): mark incomplete PR data on compare and dashboard #283 — PR empilhado: a base é a branch dele
• Blocks fix(platform): make the PR-data marker readable on touch and keyboard #293
• RFC 0025, RFC 0028, RFC 0029 PM-4

Autoria Assistida

• Agente: Claude Code — Claude Sonnet 5.5 nos commits e na revisão da task; Claude Opus 5.5 na varredura, na orquestração e na revisão final
• Escopo da assistência: revisão de bugs e implementação guiada por testes
• Revisão humana: pendente — o autor revisa antes do merge

🤖 Generated with Claude Code

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated
clickbus-iris	Ready	Preview	Oct 8, 2026 1:24pm UTC