mirror of
https://github.com/fsolla/teqo.git
synced 2026-11-19 17:13:07 +00:00
* 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>
62 lines
2.9 KiB
Markdown
62 lines
2.9 KiB
Markdown
# 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.
|