# Impl: Reel privado no CMS Status: aprovado Atualizado em: 2026-09-18 Issue: #1152 Intenção: docs/plans/reels-reel-privado.md Appetite restante: herdado (~1 dia eng; um reel registrável de ponta a ponta com arquivos privados e kill switch) ## Leitura da intenção - **Outcome:** uma collection `reel` na vertical de Comunicação registra título, funcionalidade-alvo (`cards`) e os artefatos do reel (vídeo sem áudio primário, variante com áudio, mp3 da narração, `.srt`, transcrição e capa), com `status` `draft | published | unpublished` funcionando como kill switch. Os arquivos são privados: só abrem com login de campanha; `unpublished` deixa de servi-los. O site público e os cards não mudam. C194 (biblioteca) consome o modelo e o caminho autenticado de mídia; C195 (ingestão Local API) escreve no mesmo modelo. - **O que NÃO negociar:** - Privacidade do arquivo: anônimo e navegador sem sessão recebem não; `Media.read` público intocado (`src/collections/Media.ts:16-21`, pino em `tests/int/collectionAccessLockdown.int.spec.ts:224-249`). - Site público e `#cards` idênticos; nenhuma URL pública nova. - Sem publicação automática no Instagram, sem segundo cadastro de pessoa, sem clone de voz, sem `Consent` novo (mídia interna de staff, sem PII). - Papéis da comunicação (`communicator`/`coordinator`/`candidate`); `advisor`/`leader` negados fail-closed. - Arquivos aceitos como enviados: sem transcode, compressão, thumb derivada ou versionamento. - **O que reavaliar:** - `revalidateDocumentById` no `afterChange`/`afterDelete` do `reel`: não há cache público nem `unstable_cache` do reel. Dispersável; documentado abaixo (mantido apenas se houver leitura cacheada — não há no C193). - e2e: sem UI no C193; a cobertura de fluxo fica para o C194. Registrado como decisão, não como lacuna. - A questão de produto "`unpublished` esconde só da listagem ou invalida o arquivo?" conflita com a recomendação do C194. O C193 **adota B (invalidar o arquivo)** e marca como decisão assumida a confirmar no gate. ## Abordagem recomendada ```mermaid flowchart TD A[Admin / C195 Local API] -->|create/update| R[(collection reel)] R --> V[video → reelMedia] R --> VA[videoWithAudio → reelMedia] R --> N[narrationAudio → reelMedia] R --> S[captions → reelMedia] R --> C[cover → reelMedia] B[Browser logado] -->|GET /campanha/comunicacao/reels/:id/media/:kind| G{getCampaignUser + canReadCommunicationCatalog} G -->|nega| N404[404] G -->|ok| L[Local API find reel
overrideAccess:false, user] L -->|status != published| N404 L -->|campo vazio| N404 L --> H{S3 enabled?} H -->|sim| S3[S3Client GetObjectCommand + Range] H -->|não| D[disco: path.resolve staticDir ou 'reelMedia'] S3 --> RESP[206/200 · Content-Type · Content-Length · Accept-Ranges
Content-Disposition · Cache-Control private,no-store] D --> RESP ``` **Opções consideradas:** A | B | C - **Serving privado — A (recomendada):** rota Next `GET /campanha/comunicacao/reels/[id]/media/[kind]/route.ts`; gate por `getCampaignUser()` + `canReadCommunicationCatalog`; carrega o `reel` com Local API `overrideAccess: false, user`; streama o objeto direto (S3 `GetObjectCommand` com `Range`, ou disco local). Reusa `parseRangeHeader`/`getRangeRequestInfo` de `payload/internal` (os mesmos helpers do handler local/S3, `node_modules/payload/dist/uploads/endpoints/getFile.js:19,51-53`). O cookie `campaign-token` tem `path='/campanha'` (`src/utilities/campaignAuth.ts:12-13`), e a rota vive sob `/campanha` — o cookie chega; `