mirror of
https://github.com/fsolla/teqo.git
synced 2026-11-20 18:24:45 +00:00
68 lines
3.5 KiB
Markdown
68 lines
3.5 KiB
Markdown
# C165-F1 — Activity: update access fecha município nulo/fora da carteira (bypass REST)
|
|
|
|
Status: rascunho
|
|
Atualizado em: 2026-09-15
|
|
Issue: (registrada junto do PR do C165)
|
|
Pai: #1010 (C165) — `depends: [1010]`
|
|
Priority: P2
|
|
Kind: defect
|
|
Appetite: ~0,25 dia eng (sem UI, sem migration)
|
|
Responsável: —
|
|
|
|
> Débito registrado na triage do `/simplify` do C165
|
|
> ([c165-importar-eventos-google-impl.md](c165-importar-eventos-google-impl.md)).
|
|
|
|
## Contexto
|
|
|
|
O C165 tornou `municipality` opcional na `Activity` e decidiu (Decisão G do impl plan) que o
|
|
guard de **valor** do município vive na server action: advisor não cria sem município, não
|
|
limpa (`null`) e não reaponta para fora da carteira — cada caso com mensagem nomeada
|
|
(`ACTIVITY_UNSCOPED_ADVISOR_MESSAGE` / `ACTIVITY_OUT_OF_SCOPE_MESSAGE`).
|
|
|
|
O access cobre a **linha** (`canUpdateActivity` devolve um `Where` que alcança a atividade),
|
|
não o **valor**: uma escrita que passe direto pelo Local API/REST com credencial de campanha
|
|
(ex.: `PATCH /api/activity/:id` com o JWT no header `Authorization`, caminho já declarado no
|
|
threat model de `src/utilities/access/shared.ts`) consegue gravar `municipality: null` ou um
|
|
id fora da carteira. Na prática o comportamento é simétrico ao lado `create` (que já valida
|
|
`data`), e o cookie `campaign-token` é path-scoped `/campanha` — o caminho exigiria JWT
|
|
copiado à mão; ainda assim é o eixo de access e fecha por construção.
|
|
|
|
## Evidência
|
|
|
|
- `src/utilities/access/activities.ts` — `canCreateActivity` é `data`-aware (C165);
|
|
`canUpdateActivity` devolve `Where`/`boolean` sem inspecionar `data.municipality`.
|
|
- `src/app/(campaign)/campanha/actions/activity.ts` — guard equivalente no `updateActivityRecord`
|
|
(mensagens nomeadas) cobre o caminho da UI.
|
|
- `src/utilities/access/shared.ts:100-104` — caminho REST/GraphQL com JWT de campanha no threat model.
|
|
|
|
## Objetivo e aceite
|
|
|
|
- `canUpdateActivity`, para advisor (staff não-unrestricted), inspeciona `data.municipality`
|
|
quando presente: `null` → `false`; número fora do write scope → `false`; ausente → o `Where`
|
|
de linha atual (nada muda para quem só edita outros campos).
|
|
- Coordenador/candidato/admin intocados; `editing: 'tudo'` continua alcançando qualquer
|
|
atividade **com** município, mas limpar para `null` segue coordenação/candidato-only.
|
|
- A action mantém o guard/UX (Decisão G do C165) — defesa em profundidade, sem mensagem nova.
|
|
- Pin int com `overrideAccess: false` e um advisor (`campaignActivity.int.spec.ts`): limpar
|
|
município e reapontar para fora da carteira são recusados pelo access; editar outro campo
|
|
da mesma atividade continua funcionando.
|
|
|
|
## Fora de escopo
|
|
|
|
- Field access por **valor** para `municipality` (Payload field access recebe o valor, não o
|
|
documento; a assimetria é do próprio modelo — o guard na collection access é o dono).
|
|
- Hardening equivalente nas demais collections (decisão sistêmica separada; cada domínio tem
|
|
seu dono e seu precedente).
|
|
- Mudança de UX/copy/mensagens da action.
|
|
|
|
## Riscos
|
|
|
|
- Advisor com `editing: 'tudo'` que hoje limpa município pela action: já era recusado
|
|
(C165) — o access só antecipa a mesma recusa em outros caminhos.
|
|
- Leitura do perfil fresco no access update (mesmo `getFreshCampaignUser` já usado) mantém
|
|
o custo por request dentro do padrão do módulo.
|
|
|
|
## Aceite de engenharia
|
|
|
|
- [ ] `pnpm gate:fast` verde; int pinado em `tests/int/campaignActivity.int.spec.ts`.
|
|
- [ ] Sem migration, sem Consent, sem UI; URL/slug intactos.
|