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

1 line
2.6 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.

**C172 — Acervo: player e link abrem no ponto certo da fala (2026-09-16):** o `t=` do YouTube no detalhe da fala e no compartilhamento (C162/C166) caía alguns segundos **depois** do começo real da fala: o offset era `excerptTMs − eventStartAt`, tratando o relógio declarado da sessão como se o vídeo começasse nele. O dono `src/lib/speechVod.ts` ganhou `sessionLagSeconds` (instante ISO do `actualStartTime` × `eventStartAt` naive, ambos em relógio BRT, com guardas de não-positivo e plausibilidade de 1 h), `measuredVideoLagSeconds` (calendário de evidência datada `videoId → lag`, medido no browser) e `correctedExcerptOffsetSeconds`; o número continua nascendo no mesmo ponto (`toSpeechDetailViewModel`), então player, seek do transcrito (`start=`) e share seguem consumindo **um único** `youtubeOffsetSeconds`. A âncora automática vem do dono do cliente YouTube, `src/utilities/socialFeed/youtubeFeed.ts`: `videos.list?part=liveStreamingDetails` (`parseYouTubeLiveStartResponse`/`loadYouTubeVideoStart`, `fetchImpl` injetável, `AbortSignal.timeout(5 s)`), `getYouTubeVideoStart` em `unstable_cache` por `videoId` (tag `social-feed`, TTL longo, `try/catch` fail-closed → null) e leitura **só** de `youtubeApiKey` — o kill switch/plataforma do feed público da home não gateia o acervo. Precedência: medição verificada no browser vence a âncora (997 → 13 s, 641 → 37 s, 981 → 31 s, 973 → 10 s, sessão de 17/06 → 89 s); sem nenhuma das duas, comportamento de hoje (nunca palpite). O loader `loadSpeechDetailPageData` resolve a âncora por um resolver injetável (default `getYouTubeVideoStart`, o que mantém os int tests offline) e **não paga a consulta** quando o vídeo já tem medição. Medição real em 5 sessões (HTTP público, zero DB de prod): a âncora da API erra +44/+9/+6/+52 s (antes) e −22 s (depois) — não reproduz o lag medido e nenhum preditor derivável correlaciona com ele (o resíduo é, em parte, julgamento humano de onde a fala começa); o app atual abre 10–89 s depois do ponto em todas as amostras. Sem schema/migration/Consent; `excerptOffsetSeconds` intocado (o relatório de cidade da C163 segue com o 37 próprio, sem dupla subtração); contratos C162/C166/C167 e a forma da URL (`watch?v=&t=`) intactos. Testes: unit novos de `sessionLagSeconds`/`measuredVideoLagSeconds`/`correctedExcerptOffsetSeconds` e do parser/loader do YouTube (fetch mockado), int do nascimento corrigido com resolver stub + do pulo da consulta, e2e do acervo 13/13 e dos cortes 7/7 locais; pins de C162/C166 e de `cityReportBlocks` verdes. `pnpm gate:fast` verde (unit 3435). Plano: `docs/plans/acervo-video-no-ponto-da-fala-impl.md`.