teqo-backup/docs/changelog/2026-09-18-c193.md

2.3 KiB

C193 — Reel privado no CMS: modelo, arquivos privados e kill switch (2026-09-18): a assessoria produz os Reels de tutorial fora do Teqo e eles não tinham onde existir. Entregou-se a base no /campanha: (1) collection reel (grupo Comunicação) com title, feature (lista fechada, começando cards), status draft→published→unpublished, e os artefatos como uploads 1:1 — video (MP4 sem áudio, primário, required), videoWithAudio, narrationAudio, captions (.srt), cover (required) — mais transcript em texto, publishedAt carimbado na transição para published e createdBy do ator; (2) collection de upload privada reelMedia separada de media (que é leitura pública por contrato, pinada no lockdown): read/create/update/delete só para communicator/coordinator/candidate + admin, registrada no plugin S3 (reelMedia: true) para não cair em disco efêmero em produção; (3) rota autenticada de mídia GET /campanha/comunicacao/reels/[id]/media/[kind] — sob /campanha de propósito, porque é o path do cookie campaign-token que <video>/<img> enviam; gate pelo mesmo predicado da vertical, Local API com overrideAccess: false, e kill switch de verdade: só published serve, draft/unpublished respondem 404 silencioso (sem vazar existência); streaming direto do bucket privado via GetObjectCommand/Range (helpers do payload/internal) com fallback de disco em dev/test, content-type allowlisted (o que não for mídia segura vira application/octet-stream + attachment, sem XSS no origin da campanha), Content-Disposition com filename* e Cache-Control: private, no-store; (4) RBAC: canReadSpeechCatalog → canReadCommunicationCatalog (o predicado é da vertical inteira; sem twin) com src/utilities/access/reels.ts (canReadReel/canDeleteReel, delete como predicado próprio) reexportado pelo barrel; (5) migration 20260918_201009_add_reel (tabelas, enums, FKs, rels) aplicada local; (6) testes: unit do vocabulário/headers (9) e int do modelo + rota com matriz de 5 papéis, anônimo, Range 206, download, kill switch e 404s (9). Sem UI (Impeccable A), sem Consent, sem publicação em rede social e site público intocado. pnpm gate:fast verde (355 arquivos / 3724 testes) + knip limpo; follow-up do ramo S3 sem teste registrado em C198 (#1162).