teqo-backup/docs/plans/escopo-formularios-escrita-perfil.md
Francisco Solla c723d6accf
merge(OPS75): convergência Forgejo→GitHub — GitHub como fonte única
* deploy: limpeza pós-deploy do build cache e tags locais antigas (INF3/F2)

O deploy compila no homeserver e acumulava build cache + tags locais
antigas no disco raiz (incidente 19/08: 45G de cache). Após o smoke:
docker builder prune -f + remoção das tags locais teqo-1313 exceto o
SHA em uso (best-effort, registry preserva o rollback).

* feat(S9): captura de novidades da campanha na home pública (form + CTA do hero)

Seção 'Receba as novidades da campanha' acima do rodapé: nome + WhatsApp
obrigatórios, e-mail/estado/cidade/comentário opcionais, toggle pré-selecionado
'Quero fazer parte do time' gravado como subscription.campaignLevel
(time|esporadico). CTA secundário do hero vira o atalho (#novidades, scroll
suave). Contact + Subscription em withPayloadTransaction com consentimento
novo fail-closed por chave estável 'campanha-novidades' — nada é gravado sem o
texto aprovado no admin. Migration 20260819_192605 (state de contact nullable
+ coluna campaign_level). Impl plan, changelog, int + e2e.

* plans(C141,C143,C142): permissões granulares por assessor + responsáveis de demanda + UI por perfil

* plans(C141,C143,C142): permissões granulares por assessor + responsáveis de demanda + UI por perfil

* feat(S8): seção 'Nossa história' na home — vídeo da trajetória embutido do YouTube (Closes #91)

* docs(S8): resolução do conflito com S9 (história → newsletter) + nota do guard e2e dev-only

* feat(S10): pixel do Meta na página pública de campanha (campo admin em SiteSettings + PageView na home + Lead no sucesso da captura)

Campo tracking.facebookPixelId no global SiteSettings (mesma validação/normalização do precedente Petition, regra centralizada em facebookPixel.ts); home (grupo (home)) injeta o base code + PageView quando o ID está configurado (fail-closed) e o CampaignNewsletterForm dispara exatamente um Lead no sucesso do S9. Migration 20260819_213947_add_site_settings_facebook_pixel_id. Closes #94

* refactor(S10): simplify pass — Lead wiring unit-tested e raças de estado compartilhado do e2e resolvidas

e2e: stub hermético de connect.facebook.net no guard compartilhado (specs paralelos renderizam a home com o pixel); advisory lock no Postgres serializando o login do usuário de teste (Payload perde sessão em login concorrente read-modify-write — classe documentada no webauthn); seedTestUser vira create-if-missing (sem janela de usuário ausente nem reset de senha); Lead do form protegido do catch de erro (tracking nunca falha uma captura commitada); descrição do campo compartilhada; unidade nova campaignNewsletterLead cobre exatamente um Lead no sucesso.

* feat(C141): perfis de permissão por assessor — Visão × Edição configuráveis, enforcement fail-closed (Closes #105)

* chore(C141): regenera changelog agregado após rebase com S10

* plans(C144): options write-scoped para formulários de escrita pós-C141

---------

Co-authored-by: Francisco Solla <admin@solla.dev>
2026-08-21 01:41:18 -03:00

2.9 KiB
Raw 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.