teqo-backup/docs/changelog/2026-09-16-c175.md

1 line
2.2 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

**C175 — preview do trecho na listagem de falas (2026-09-16):** a listagem do acervo (`/campanha/comunicacao/acervo`) ganha a miniatura do trecho no card quando a fala tem vídeo do YouTube — a assessoria reconhece a cena na varredura em vez de abrir fala por fala. O dado já vinha no `speechListSelect` (`youtubeUrl`), então a entrega é aditiva: nova função pura `youtubeThumbnailUrl(videoId)` em `src/lib/speechVod.ts` (variante `hqdefault`, a mesma do repo; `object-cover` corta as barras 4:3) e campo `thumbnailUrl: string | null` no `SpeechListItemViewModel`, montado com `parseYoutubeVideoId` — sem query, migration, access ou Consent novos. A UI é a ilha client `SpeechResultThumbnail` (novo), port classe-a-classe do design aprovado: slot fixo 128×80 (sem layout shift) sobre `<img loading="lazy" decoding="async">` hotlinkado do CDN do YouTube (precedente raw `<img>` — o otimizador quebraria o e2e, que nunca alcança `i.ytimg.com`), com `Skeleton` pulsando até a imagem pintar (cena 03; `onError` degrada para o slot neutro e `img.complete` no mount cobre imagem de cache) e `Link` para o mesmo `watchHref` do CTA, com o mesmo nome acessível. O `SpeechResultCard` passa a montar o excerto em flex condicional — miniatura à esquerda no desktop e empilhada no mobile (`sm:flex-row`), e **nenhum** espaço de mídia quando não há vídeo. Guardrails preservados: sem player/autoplay/hover-play, sem extração de frame/ffmpeg/mirroring ("meio do trecho" é a melhor miniatura padrão, nunca um seek), busca/excerto/highlight intocados e `leader`/`advisor` seguem fora do acervo. Testes: unit de `youtubeThumbnailUrl` em `tests/unit/speechVod.unit.spec.ts` e novo `tests/unit/speechViewModels.unit.spec.ts` (thumbnail presente/`null`/URL não-YouTube, `sourceUrl` intocado); int em `tests/int/speechAcervo.int.spec.ts` provando a propagação no loader; e2e do acervo com a URL no HTML do card e a ausência dela na fala sem vídeo. Crítica final do `designer` certificada (tier `openai/gpt-5.6-sol`, sem ajustes) contra o artefato `docs/plans/acervo-preview-do-trecho-na-listagem-ui-design.html`; débitos de consolidação do contrato `i.ytimg.com` e da ilha client deferidos com gatilho no `*-impl.md`. Issue #1085.