teqo-backup/docs/changelog/2026-09-23-s28.md
Francisco Solla 68065032f5
Some checks are pending
Deploy / preflight (push) Waiting to run
Deploy / verify (push) Blocked by required conditions
Deploy / deploy staging (teqo-staging) (push) Blocked by required conditions
Deploy / requeue when main advanced (push) Blocked by required conditions
Deploy / deploy production (teqo-1313) (push) Blocked by required conditions
fix(S28): lê os headers só no caminho de tema e estabiliza o e2e do streaming
2026-09-23 15:35:21 -03:00

3.2 KiB
Raw Blame History

Busca por tema na Central de Conteúdos pública (S28, 2026-09-23): o campo de busca de /conteudos ganhou o modo visível "Buscar por: Termo exato | ✦ Por tema" (exato é o padrão; a escolha vive na URL — mode=tema, só com q — e o form GET continua funcionando sem JS: Enter busca, mudar o modo submete; o botão de submit do S27 saiu, o CTA de pedido de voto segue no hero). O mecanismo é o do C192 generalizado por corpus (expandSearchTheme(theme, 'speech' | 'contentPiece'), mesmo contrato de falha/sanitização; o acervo de falas segue byte-idêntico), e o catálogo público passou a OR-ar o termo literal com os termos expandidos, sempre sobre as peças publicadas (kill switch intacto). Cada resultado diz por que apareceu: selo "✦ Tema" com o trecho real que casa (janela do transcript/descrição com a frase destacada) ou "Termo exato" quando só o q casou; quando o casamento veio de tema/cidade/instituição, o bloco mostra um trecho real, curto e rotulado, sem destaque — nunca score, nunca "parecido" enganoso, e o transcript completo não sai do servidor. Vazio honesto do tema ("Nenhuma peça combina bem com esse tema") com três saídas (reformular, usar termo exato, limpar filtros); indisponibilidade (sem chave, timeout, limite ou pedido não-browser) degrada para a busca exata com aviso âmbar discreto + "Tentar por tema novamente". A rota é pública e sem login, então nasceu a guarda anônima (themeSearchGuard): limiter in-memory por IP (8/15min, cf-connecting-ip→x-forwarded-for→x-real-ip→unknown), gate por Fetch Metadata (navigate/cors; no-cors recusado, scraper sem os headers fica no literal) e cache in-memory TTL 30min por termo normalizado (hit não consome cota; {terms:[]} legítimo é cacheado, null nunca) — estouro degrada, nunca 429. Achado do app renderizado: o Next 15 consome RSC/Next-Router-Prefetch antes do userland (o gate original por rsc degradava toda navegação client-side) — a correção usa os headers que chegam ao server e a UI mantém prefetch={false} em todo link que preserva o modo; e a página não chama headers() (o loader lê os headers só no caminho de tema), porque a API dinâmica no render defere a página inteira atrás do loading.tsx e o shell chega em cópia oculta S: no build de produção — o catálogo literal (todo o S27) fica sem o artefato e o caminho de tema espera o settle no e2e (padrão C106). Testes: 1 unit spec novo (guarda: elegibilidade/chave/limiter/cache) e 1 estendido (catálogo: modo/OR/proveniência), unit do expansor generalizado, 6 casos int no contentPiece (expansão injetada, degradação, lista sem termos, inelegível, sem modo, rascunho) e o e2e frontendConteudos estendido (segmented, degradação com aviso, Enter sem JS); pins do E2E_AFFECTED_MANIFEST (contentPieceThemeSearch na superfície S27; frontendConteudos no risk prefix src/utilities/ai). Sem migration/schema/Consent/access novo. Design: port classe-a-classe das cenas 01–09, crítica final certificada pelo tier primário (Design tier: openai/gpt-5.6-sol) contra o app renderizado (12 screenshots desktop/mobile + hover/foco), após duas rodadas que pediram evidência dos estados de hover/foco, do {terms:[]} e do vazio.