teqo/docs/plans/escopo-formularios-escrita-perfil.md

2.9 KiB
Raw Permalink Blame History

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 (parametro scope: 'read' | 'write' ou helper irmão) consumida pelos form actions/pages de escrita; manter o fragmento P3-D (advisorMunicipalityScopeWhere) e o getWritableMunicipalityIds do C141.
  • Mapear os call sites dos pickers (atividades/agenda, demandas, apoiadores, lideranças, organizações) e trocar só os de escrita.

Fases

  1. Variante write-scoped + call sites de atividade (onde o servidor aceita) — tester int: picker de atividade reflete o eixo.
  2. Demanda/apoiador/liderança/organização (UX — servidor já rejeita).
  3. 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 (getWritableMunicipalityIds no create individual e no batch do giro).
  • Ficha de contatos write-scoped (assertPersonContactWritable).
  • Ações de liderança write-scoped (assertMunicipalitiesWithinScope).
  • allocationDecision create 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.