2.5 KiB
C202 — Gates de upload/retry/delete de gravações usam os predicados do dono
Status: rascunho Atualizado em: 2026-09-18 Issue: C202 Depende de: C199 (#1166) Priority: P2 Impeccable: A (só backend) Appetite: ~0,5 dia eng — trocar o gate de leitura pelos predicados de escrita onde a ação é escrita
Contexto
O C199 entregou src/utilities/access/recordings.ts com três predicados: canReadRecording, canUploadRecording e canDeleteRecording — os dois últimos existem justamente para que ampliar a leitura não conceda upload/delete. Mas as rotas e ações de gravação gateiam por canReadCommunicationCatalog(actor.role) (o predicado de papel da vertical), que hoje é equivalente aos três. O desvio é silencioso: uma futura ampliação da leitura (ex.: advisor ganha leitura do acervo) passaria a valer para upload/retry/delete sem tocar no dono.
Abordagem
Expor no dono (utilities/access/recordings.ts) um predicado de papel compartilhado (ou usar os Access existentes via um helper de rota que receba o usuário fresco), e consumi-lo nas superfícies de escrita:
POST .../gravacoes/enviar(route.ts— gate cru de sessão e origem).retryRecordingForActor,deleteRecordingForActor(actions/recording.ts).labelRecordingSpeakerForActor(actions/recording.ts; absorvido do C200 #1167 — a action gateia no action-level comcanReadCommunicationCatalogenquanto a collection usacanUploadRecording).getRecordingStatusesForActoré leitura: mantémcanReadCommunicationCatalog.
Rejeitadas: duplicar o corpo dos predicados nas rotas (gêmeo); criar um quarto predicado (o dono já tem os três).
Fases
- Helper/consumo no dono + rotas/ações; unit dos predicados e int de matriz de papéis (communicator/coordinator/candidate passam; advisor/leader negados) já existentes no
tests/int/recording.int.spec.tscontinuam a rede. - Gates —
pnpm gate:fast; push viapnpm push.
Rabbit holes / Não escopo
- Renomear
canReadCommunicationCatalog(fora: o predicado é da vertical e está estável). - Enforcement por coleção (já existe: os
Accessdas três collections). - Mudança de comportamento visível: nenhuma esperada hoje (os conjuntos coincidem).
Riscos
- Divergência futura coberta por teste de matriz de papéis no int, que passa a apontar o predicado de escrita.
Aceite de engenharia
- Upload/retry/delete gateados pelo predicado de escrita do dono; status/leitura pelo de leitura.
- Matriz de papéis verde no int; nenhuma regressão de comportamento.