- 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.
17 KiB
Cadastro nominal de apoiadores em massa
Status: engenharia pronta, mesclada e em produção (deploy 2026-07-23); dados reais de apoiadores em hold até o lote jurídico (Onda 0 — chaves apoiador-cadastro / apoiador-intencao-voto)
Atualizado em: 2026-07-18
Item do roadmap: docs/roadmap.md (seção "Campanha → Próximos ciclos")
Responsável: —
Referência visual (UX Pilot)
Três designs cobrem este plano:
| Tela | Arquivos |
|---|---|
Lista de apoiadores (/campanha/apoiadores) |
Apoiadores-Lista.png · Apoiadores-Lista.html |
| Ficha do apoiador | Apoiador-Ficha.png · Apoiador-Ficha.html |
| Import CSV (desktop, wizard 3 passos) | Importar-CSV-Apoiadores.png · Importar-CSV-Apoiadores.html |
Como usar:
- Lista — adotar: KPIs no topo (total / "Certo + Tende" / "Indecisos"), busca por nome/telefone/município, filtros "Intenção de voto" e "Território", linhas com nome + município + núcleo vinculado (ou "sem núcleo vinculado" — reflete a decisão de núcleo opcional) + badge de intenção + telefone; CTAs "Importar CSV" e "+ Novo". (Telefone é obrigatório no v1 — ver decisões fechadas; o estado "Sem telefone cadastrado" do design não se aplica.)
- Ficha — adotar: bloco destacado "Consentimento LGPD" com checkbox nominal, link para a Política de Privacidade e registro "Consentimento registrado em … · Coletor: …" (
consentedAt+createdBy); segmented control de intenção de voto desabilitado até o consentimento ("Disponível somente após confirmação do consentimento LGPD" — consentimento destacado, chaveapoiador-intencao-voto); seção "Kit de compartilhamento" mínimo (mensagem template +wa.me+ copiar texto; sem collectionshareKit); ação "Remover meus dados" (descadastramento art. 18). - Import — adotar: wizard em 3 passos (Upload → Conferir prévia → Confirmação) com chips de contagem ("412 prontos" / "37 duplicados (pelo telefone)" / "3 erros"), tabela de prévia com status por linha (
ok,duplicado pelo telefone,telefone inválido,município não reconhecido), toggle "Todos | Só erros", "Baixar relatório de erros" e resumo final. Import só porgeral. O sidebar desktop do design mostra a navegação-alvo — usar como referência do shell, mas só adicionar entradas de domínios que existirem (sem "Agenda"/C3). - Ajustar cores: paleta antiga (navy/vermelho escuro) no HTML/PNG; implementar com tokens do tema
campaign. Avatares com foto viram iniciais; "solla.ba" no kit é placeholder — a URL real vem deNEXT_PUBLIC_SITE_URL.
Contexto
Hoje a campanha só cadastra pessoas via leadership — a junção única Contact↔núcleo que carrega status de apoio, vínculo com campaignUser (acesso ao app) e consentimento. Não existe base nominal de apoiadores "comuns": eleitores que declaram apoio mas não são lideranças engajadas com acesso à plataforma. O roadmap pede explicitamente o cadastro nominal em massa via Contact + junção, sem nunca criar uma collection "pessoa/apoiador" paralela (decisão travada no AGENTS.md, espelhada por Signature/Subscription).
Decisão de produto (2026-07-17): modelo híbrido — apoiador é join Contact↔campanha com núcleo opcional. A base é transversal (pode existir sem núcleo) e, quando vinculada a um núcleo, agrega por território. leadership permanece como o subconjunto que tem acesso ao app. A pre-intenção de votos (intenção de voto) entra neste plano: é dado sensível (opinião política) e exige consentimento destacado, mas é o ganho de produto central — transforma a estimativa manual de hoje em base nominal real, alimentando os insights de conversão e gap vs. 2022.
Marco legal (LGPD + TSE)
Pesquisa web (2026-07-17). Fontes: TSE (Res. 23.610/2019 alterada pela 23.732/2024), ConJur, Migalhas, OAB Campinas, ANPD.
- Opinião política e filiação partidária são dados sensíveis (art. 11 da LGPD). Não cabe legítimo interesse do controlador; exigem consentimento específico, expresso e destacado. A intenção de voto capturada neste plano é dado sensível.
- Princípio da finalidade (art. 6º LGPD): dado coletado para "cadastro de apoio" ou "lista de presença em evento" não migra livremente para "propaganda eleitoral". Cada finalidade nova precisa ser consentida. O
source(proveniência) e oConsentpor finalidade documentam isso. - Disparo em massa é vedado no WhatsApp/Telegram (Res. 23.610, art., 33). Permitido só compartilhamento individual/orgânico entre pessoas físicas (art. 33, §2º). A Meta veda o uso do WhatsApp Business API por campanhas políticas.
- Vedada a cessão, doação e venda de cadastros eletrônicos a candidatas/candidatos/partidos. A base nominal construída aqui é da campanha do Solla e não é compartilhada.
- Obrigações do controlador: Aviso de Privacidade, Política de Segurança, Canal de Comunicação (confirmação de tratamento, eliminação, descadastramento — art. 18 LGPD), Encarregado de Dados (DPO; dispensado em municípios < 200 mil eleitores), Registro das Operações de Tratamento (art. 33-C da Res. 23.610).
- RIPD: a Justiça Eleitoral pode exigir Relatório de Impacto à Proteção de Dados quando o tratamento for em larga escala (≥10% do eleitorado apto da circunscrição) e envolver dado sensível ou perfilamento. Avaliação caso a caso pela assessoria jurídica.
- Mensagens devem trazer identificação completa do remetente e mecanismo de descadastramento/eliminação.
Objetivos
- Nova collection
supporter(joinContact↔campanha, núcleo opcional), no admin groupCampanha. - Import em massa (CSV) com dedup por telefone, transacional, whitelist de colunas e preview de erros por linha.
- Captura de intenção de voto (dado sensível) com
Consentpor chave estávelapoiador-intencao-voto, falha fechado se ausente. - Consentimento de apoio declarado por chave
apoiador-cadastro. - Mobilização orgânica: kit mínimo de compartilhamento (links
wa.mepré-preenchidos + texto template) — sem disparo em massa pela campanha e sem collectionshareKitno v1. - Canal de descadastramento/eliminação (direito LGPD art. 18).
- Access control por papel herdando o padrão existente (
getAccessibleNucleusIds).
Decisões travadas
- Pessoa =
Contact+ junção. Nova collectionsupporterrelacionacontact(required) +nucleus(opcional) + campos de apoio. Nunca criar "apoiador/pessoa" paralela. (AGENTS.md.) - Híbrido com núcleo opcional. Apoiador pode existir sem núcleo (base transversal); quando vinculado a um núcleo, agrega por território.
nucleusérelationshipopcional aelectoralNucleus. leadershipsegue separada. Liderança é o apoiador engajado com acesso ao app;leadershippermanece responsável pelocampaignUsere pelosupportStatusinterno. Um hook emsupporterimpede o mesmocontactser apoiador e liderança do mesmo núcleo simultaneamente.- Telefone obrigatório no v1 (2026-07-18).
Contact.phonecontinua required/único; linha de import sem telefone válido é erro. O estado "sem telefone" do design não se aplica. - Intenção de voto é dado sensível. Captura exige
Consent.key = 'apoiador-intencao-voto'(consentimento destacado, separado do consentimento de cadastro). Falha fechado se a chave não existir — resolver genérico emcampaignConsent.ts(getConsentByKey/requireConsentByKey). - Import em massa só por
geral/admin, via server action autenticada no/campanha(não no/admin, que ainda não tem RBAC — AGENTS Known Gap #1). Dedup por telefone viaacquireContactPhoneLocks/assertContactPhoneAvailableemcontactPhoneInvariant.ts(não criarsupporterDedup.ts). Tudo transacional comreq: { transactionID }. - Kit de compartilhamento mínimo no v1 (2026-07-18). Template fixo +
wa.me+ copiar texto no detalhe do apoiador; sem collectionshareKit. - Descadastramento. Server action
removeSupporterDatadeleta osupportere anonimiza/limpa PII doContactapenas se nenhum outro join (leadership/signature/subscription/ outrosupporter) o referencia. - Access control.
geralvê/gerencia todos;coordenadorvê apoiadores dos seus núcleos (nucleus in getAccessibleNucleusIds); apoiador sem núcleo é só degeral;liderancanão gerencia apoiadores. Delete admin-only. - Enum de intenção.
certo | tende_a_certo | indeciso | outro(bate com o design). CamposupportLevelfica fora do v1. - i18n e naming. Identificadores em inglês (
supporter,voteIntention,removeSupporterData), strings visíveis em pt-BR. Admin groupCampanha.
Questões fechadas (2026-07-18)
- Coexistência
supporter↔leadershipno mesmo núcleo. Adotado: um contato não pode ser apoiador e liderança do mesmo núcleo (hook valida). - Import no
/campanhavs/admin. Adotado: import no/campanha(server action, sógeral). - Intenção de voto: enum. Adotado:
certo | tende_a_certo | indeciso | outro. - Kit de compartilhamento. Adotado no v1: versão mínima (template +
wa.me+ copiar); collectionshareKitfora de escopo. - Telefone. Adotado: obrigatório; linha sem telefone válido = erro no import.
- Anonimização vs eliminação. Adotado (assumido — validar com jurídico): deleta
supporter; limpa PII doContactsó se nenhum outro join o referencia. - Atestado do operador no import CSV. Adotado (assumido — validar com jurídico): checkbox do operador registrado em
consentNote/consentedAt, exige as duas chaves de Consent configuradas. - RIPD / reuso pós-eleição. Continuam com jurídico; fora do escopo de engenharia deste item.
Abordagem proposta
flowchart LR
Import["Import CSV / cadastro manual<br/>(server action, geral)"]
Dedup["contactPhoneInvariant<br/>advisory lock"]
Contact["upsert Contact<br/>(transacional)"]
Consent["resolve Consent por chave<br/>campaignConsent.ts"]
Supporter["create supporter<br/>contact + nucleus opcional<br/>+ voteIntention + consent"]
Kit["kit mínimo<br/>wa.me + texto"]
Share["apoiador repassa<br/>individualmente"]
Unsub["removeSupporterData<br/>deleta / anonimiza"]
Import --> Dedup
Dedup --> Contact
Contact --> Consent
Consent --> Supporter
Supporter --> Kit
Kit --> Share
Supporter --> Unsub
Componentes:
src/collections/Supporter.ts(nova, groupCampanha):contact(relationship→contact, required, index)nucleus(relationship→electoralNucleus, opcional, index)voteIntention(select:certo | tende_a_certo | indeciso | outro, index) — dado sensível, field access restrito ageral/coordenador(reusacanReadLeadershipInternal)- Pares de consentimento:
consent/consentContentHash/consentedAt(cadastro) evoteIntentionConsent/voteIntentionConsentContentHash/voteIntentionConsentedAt(intenção) source(select:import_csv | manual | convite | evento) — v1 grava só os dois primeirosconsentNote,notes(staff-only),createdBy(readOnly)- Unicidade:
UNIQUE NULLS NOT DISTINCT (contact_id, nucleus_id)na migration (Postgres ≥15) - access:
canReadSupporter,canManageSupporter,canCreateSupporter(emcampaignAccess.ts) - hook
beforeChange: setacreatedBy; rejeitacontactque já éleadershipdo mesmonucleus
Consentkeys (admin cadastra; app falha fechado se ausente):apoiador-cadastro— apoio declaradoapoiador-intencao-voto— intenção de voto (consentimento destacado)
src/utilities/campaignConsent.ts— generalizar comgetConsentByKey/requireConsentByKey; wrappers de liderança e constantesSUPPORTER_REGISTRATION_CONSENT_KEY/SUPPORTER_VOTE_INTENTION_CONSENT_KEYsrc/lib/schemas/supporter.ts— zod schemas (create, intenção, import, filtros)src/app/(campaign)/campanha/actions/supporter.ts—createSupporter,setSupporterVoteIntention,previewSupporterImport/confirmSupporterImport,removeSupporterData- UI
/campanha/apoiadores— lista + ficha + wizard de import; nav "Apoiadores" só para geral/coordenador - Migrations:
pnpm migrate:create add_supporter. Tipos:pnpm generate:types
O que isso viabiliza
- Base nominal por território para direcionar campo e eventos.
- Intenção de voto nominal alimentando insights (conversão, gap vs. 2022) com dado real.
- Mobilização orgânica: apoiadores compartilham conteúdo da campanha em seus círculos (caminho legal, sem disparo em massa).
- Agregados no overview da lista de núcleos (follow-up de B1) passam a incluir contagem nominal de apoiadores.
Dependências
- Nenhuma bloqueante de engenharia. Reusa
Contact,Consent(por chave viacampaignConsent.ts),campaignAccess(getAccessibleNucleusIds),normalizeBrazilianPhone,contactPhoneInvariant, e o padrão transacional multi-collection. - Baseline TSE 2022 habilita o cruzamento nominal vs. voto 2022 (fora deste item).
Não escopo
- Disparo em massa / WhatsApp Business API — vedado.
- Collection
shareKitcompleta — kit mínimo no v1 basta. - RIPD — assessoria jurídica.
- PWA/push para apoiadores — plano
notifications.md. - Agregado de apoiadores no overview de núcleos — follow-up de B1.
- Uso da base no dia D — C5.
- Campo
supportLevel— fora do v1. - Mesclar
leadershipemsupporter—leadershipsegue responsável pelo acesso ao app. - Escala/DRY pós-v1 (shells compartilhados com núcleos, import bulk drizzle, preview token, KPI agregado, StrictCombobox/AlertDialog) — item C6, plano escala-dry-pos-c2.md.
Bloqueador obrigatório de produção
Antes de importar dados reais ou capturar intenção de voto: a assessoria jurídica eleitoral documenta a base do art. 11 da LGPD para intenção de voto (dado sensível) e dos arts. 7/8 para o cadastro de apoio, aprova os textos versionados específicos, e um admin cadastra Consent.key = 'apoiador-cadastro' e Consent.key = 'apoiador-intencao-voto'. O app falha fechado se qualquer uma das chaves estiver ausente — mesmo padrão do bloqueador de liderança.
Lote jurídico único (decisão de processo 2026-07-17): esses dois textos devem ser revisados na mesma rodada jurídica que o texto de lideranca-autopreenchimento (bloqueador do MVP de Núcleos) e o de campanha-notificacoes-push (notifications.md) — quatro textos, uma rodada. A mesma rodada deve cobrir o Aviso de Privacidade.
Nota de faseamento: a engenharia deste plano não fica bloqueada pelo jurídico — o app falha fechado por design.
Revisões
- 2026-07-18: auditoria pré-implementação C2. Corrigidas refs defasadas (
campaignConsent.tsem vez decampaignInvite.ts/supporterConsent.ts;contactPhoneInvariant.tsem vez desupporterDedup.ts). Decisões fechadas: telefone obrigatório; kit mínimo no v1; enum de intenção; coexistência com leadership; import sógeral;supportLevelfora do v1;removeSupporterDatacom anonimização condicionada a outros joins. - 2026-07-18 (pós-simplify): follow-ups de escala/DRY adiados do v1 registrados como C6 (escala-dry-pos-c2.md).
Referências
docs/roadmap.mdAGENTS.md— Pessoa =Contact+ junção;Consentpor chave; transações multi-collection; access control- Res. TSE 23.610/2019 (alterada pela 23.732/2024); LGPD art. 11 (dados sensíveis) e art. 18 (direitos do titular)
src/collections/Leadership.ts— padrão de junçãoContact↔núcleo + consentsrc/collections/Signature.tsesrc/collections/Subscription.ts— padrão de join comContactsrc/collections/Consent.ts—keyestávelsrc/collections/Contact.ts— normalização de telefonesrc/utilities/campaignAccess.ts—getAccessibleNucleusIdssrc/utilities/campaignConsent.ts— resolve Consent por chave + falha fechadasrc/utilities/contactPhoneInvariant.ts— advisory lock de telefonesrc/app/(campaign)/campanha/actions/leadership.ts— upsert de Contact + transação


