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

2.6 KiB
Raw Permalink Blame History

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.