teqo/docs/plans/onda-0.md
Francisco Ignácio Fontoura Solla adc0f31f5b Sync all project docs with the deployed remodel and hardening; compile roadmap
- Compile docs/roadmap.md into a next-steps document (277→206 lines): R0–R5/M1–M5
  tables and the delivered map/list item paragraphs compressed into 'Já entregue';
  janelas, grafo and cortes list only open IDs; C10/C11/C8 fill-ins keep their
  original triggers; C5 moved under 'A validar'.
- Record the production deploy of the destructive remodel chain (2026-07-23 Vercel
  builds) across roadmap, AGENTS.md, the project notebook and plans — supersedes
  every 'deploy pendente'; smoke pós-deploy + onboarding remain the open blockers.
- Fix AGENTS.md internal contradictions: Município locked-decisions bullet (435,
  Camaçari whole, candidate role), campaignUser role enum, deploy-checklist item 7
  as historical, access/* structure note, election-aggregates artifact +
  election-tse revalidate runbook.
- Sync open plans to real identifiers (plaza*/nucleus* → municipality*): the
  intelligence program (master + E8–E15/B13/C12 with artifact/caching context and
  satisfied deps), B8 rescoped to Salvador ZE 1–19 only, WhatsApp D3–D5, D2, A6
  (now the insight layer over stateDeputy), RS+, onda-0 smoke step.
- Close items verified done in code: C8 F4 (DRY de forms) complete, filtros-auto
  shared pending shell, petition generateStaticParams select/depth; ledger the
  surviving user-visible 'Praça' copy in src as new P2 debt.
- Banner delivered praça-era plans (production note + rename pointer); mark
  remodelagem-pracas.md superseded and remodelagem-municipios.md delivered.
- TECH-DEBT smell statuses, TESTING RBAC row, README quality gates, campanha
  UI rules updated to current component names.
2026-07-24 02:04:45 -03:00

5.8 KiB
Raw Blame History

Onda 0 — go-live MVP (Consent + privacidade)

Status: implementado (engenharia) Atualizado em: 2026-07-19 Item do roadmap: docs/roadmap.md (Onda 0 — Caminho crítico para /campanha em produção) Responsável: —

Contexto

O MVP de Núcleos e o cadastro nominal de apoiadores (C2) estão em main e falham fechado sem as chaves estáveis de Consent e sem o Aviso de Privacidade publicado. A assessoria jurídica eleitoral ainda não entregou os textos finais; para desbloquear engenharia, QA e smoke operacional, a Onda 0 provisiona textos provisórios automaticamente em local e produção via migrations, com hold explícito de PII real até revisão jurídica.

Objetivos

  • Provisionar automaticamente (local + prod via pnpm migrate / build Vercel) as quatro chaves de Consent e o Global privacy-policy publicado.
  • Expor /privacidade no site público e corrigir links mortos (Footer, ficha de apoiador).
  • Manter fail-closed do runtime; não cadastrar lideranças/apoiadores reais antes da assessoria eleitoral substituir os textos.
  • Oferecer pnpm db:seed:consent como espelho idempotente para re-aplicar textos após edição no repo.

Decisões travadas

  • Assessoria provisória no MVP (2026-07-19). A implementação redige textos utilizáveis em pt-BR com banner de status provisório. Não substituem parecer jurídico nem RIPD formal.
  • Provisionamento automático. Migration de schema (privacy-policy global) + migration de dados (seed_onda0_consent_and_privacy) aplicadas no deploy; sem passo manual de colar no admin.
  • Hold de PII real. Não importar CSV real, não convidar lideranças reais, não cadastrar apoiadores reais até substituição dos textos pela assessoria eleitoral.
  • Fonte canônica dos textos: src/lib/onda0ConsentTexts.ts + src/utilities/onda0Provision.ts.
  • i18n e naming seguem o AGENTS.md: identificadores em inglês (privacy-policy, provisionOnda0ConsentAndPrivacy); strings visíveis em pt-BR.
Chave Uso
lideranca-autopreenchimento Convites / autopreenchimento de liderança
apoiador-cadastro Cadastro nominal de apoiador
apoiador-intencao-voto Intenção de voto (dado sensível — art. 11 LGPD)
campanha-notificacoes-push Opt-in push (D2; chave provisionada, UI push pendente)

Provisionamento

Automático (local + produção)

  1. 20260719_054706_add_privacy_policy_global — schema do Global.
  2. 20260719_054707_seed_onda0_consent_and_privacy — upsert Consent ×4 + privacy-policy (published: true).

Aplicado por pnpm migrate localmente e por payload migrate no pnpm build da Vercel.

CLI espelho (re-seed)

pnpm db:seed:consent
# Neon (somente re-seed consciente pós-revisão jurídica):
ALLOW_REMOTE_DB=true pnpm db:seed:consent

Refusa host não-local sem ALLOW_REMOTE_DB=true (mesma família de guard que db:seed:tse).

Substituição pelos textos finais

  1. Assessoria eleitoral aprova textos definitivos.
  2. Atualizar src/lib/onda0ConsentTexts.ts.
  3. Nova migration de dados ou ALLOW_REMOTE_DB=true pnpm db:seed:consent em produção.
  4. Aceites com contentHash antigo exigem novo checkbox (comportamento existente).
  5. Só então liberar coleta de titulares reais (lideranças, apoiadores, import CSV).

Smoke (dados fictícios apenas)

Local (PR):

  1. pnpm migrate (ou db:seed:consent se iterando textos).
  2. Login /campanha → abrir um município e registrar dado fictício de teste.
  3. Convite com Consent visível (contato fictício).
  4. Apoiador de teste (+ intenção de voto opcional).
  5. GET /privacidade com banner provisório.

Produção (pós-deploy):

  1. Confirmar env: NEXT_PUBLIC_SITE_URL HTTPS, PAYLOAD_SECRET, DATABASE_URL, BLOB_*, REVALIDATE_SECRET.
  2. Migrations aplicadas no build.
  3. Bustar cache de /privacidade (migration SQL não dispara afterChange no runtime deployado):
curl -X POST "https://<prod-domain>/api/revalidate?tag=global_privacy-policy" \
  -H "x-revalidate-secret: $REVALIDATE_SECRET"
  1. Smoke com dados fictícios; não importar CSV real nem convidar titulares reais.

Onboarding staff (sem PII de campo)

  • Criar campaignUser geral/coordenador via /admin.
  • Estruturar municípios de teste, agenda, baseline TSE.
  • Treinamento de campo com titulares reais após revisão jurídica.

RIPD

Ver onda-0-ripd-nota-mvp.md — nota interna; não substitui RIPD formal da assessoria.

Não escopo

  • D2 push / VAPID.
  • Known Gap #2 (Consent por ID nos fluxos públicos).
  • Collection Pages.
  • RBAC em users.
  • Seed de lideranças/apoiadores reais.

Referências

Revisões

  • 2026-07-19: Plano criado na implementação Onda 0 — textos provisórios MVP, provisionamento automático local+prod, hold de PII real.
  • 2026-07-19: Débitos do /simplify registrados em escala-dry-pos-onda0.md (O0+).