2.9 KiB
Escala pós-C141: options write-scoped para formulários de escrita
Status: rascunho Atualizado em: 2026-08-19 Issue: C144 (a criar) Priority: P2 Model: deepseek/deepseek-v4-flash Impeccable: A — backend de dados de formulário (o C142 cuida da apresentação) Appetite: ~0,5–1 dia eng
Contexto (achado do /simplify da entrega C141)
loadMunicipalityOptions (src/utilities/campaignRelationOptions.ts) resolve os
municípios oferecidos nos formulários de escrita com o escopo de LEITURA
(overrideAccess: false + access de canReadMunicipality). Desde o C141, um
assessor com Visão "Tudo" + Edição "Carteira" vê os 435 municípios nos
pickers de atividade/demanda/apoiador/liderança, mas o servidor rejeita o
submit fora da carteira (fail-closed, mensagem genérica) — e em atividade
o servidor hoje aceita (o create individual foi corrigido no C141, mas o
formulário continua oferecendo o estado inteiro). A apresentação por perfil é
o item irmão C142; este item entrega a base de dados correta para os
formulários de escrita.
Objetivo
- Os pickers de município dos formulários de escrita oferecem apenas
municípios no escopo de escrita do ator (
getWritableMunicipalityIds): unrestricted/tudo → todos; carteira → carteira; somente leitura → nenhum (formulários de escrita nem abrem para esse assessor). - Superfícies alvo: atividade (create/update + giro), demanda (criar), apoiador (novo), liderança (criar/editar), organização (vínculos).
- Leitura (listas/detalhes/mapa) continua read-scoped — não tocar.
- Sem mudança de enforcement (C141 já fail-closed no servidor).
Direção no codebase
src/utilities/campaignRelationOptions.ts(loadMunicipalityOptions) — variante write-scoped (parametroscope: 'read' | 'write'ou helper irmão) consumida pelos form actions/pages de escrita; manter o fragmento P3-D (advisorMunicipalityScopeWhere) e ogetWritableMunicipalityIdsdo C141.- Mapear os call sites dos pickers (atividades/agenda, demandas, apoiadores, lideranças, organizações) e trocar só os de escrita.
Fases
- Variante write-scoped + call sites de atividade (onde o servidor aceita) — tester int: picker de atividade reflete o eixo.
- Demanda/apoiador/liderança/organização (UX — servidor já rejeita).
- Gates (
pnpm push); e2e no CI.
Já resolvido no simplify/critique (não reabrir)
- Criação de atividade avulsa/giro fora do escopo: server-side no C141
(
getWritableMunicipalityIdsno create individual e no batch do giro). - Ficha de contatos write-scoped (
assertPersonContactWritable). - Ações de liderança write-scoped (
assertMunicipalitiesWithinScope). allocationDecisioncreate capado na carteira.
Explicitamente fora (deste lote)
- Apresentação por perfil (botões/controles/atalhos) — C142.
- Enforcement server-side — C141 (já entregue).
- Options de leitura (listas/detalhes) — read-scoped permanece.