Todos os cases
~/cases/pimenta-no-senado
Plataformas & CRMsMajoritárias estaduaisdez 2025 → set 2026Concluído

P-13

Pimenta no Senado

Captação, ativistas e CRM numa só base: cada pessoa vira um perfil único, e o banco decide quem pontua.

clienteCampanha majoritária estadual

Plataforma de uma campanha majoritária estadual com três frentes: landing pages de captação, painel de ativistas com link de indicação e ranking, e um CRM administrativo com perfil único por telefone, Lead Score automático, funil por UTM e mapa geográfico. Construída sobre Supabase com 38 Edge Functions e 221 migrations, com RLS em todas as tabelas, Turnstile e rate limit no login, cadastro público só por função de servidor e travas contra exclusão em massa.

221
Migrations
38
Edge Functions
67
Tabelas
~53 mil
Linhas TS/TSX
  • supabase
  • postgres
  • rls
  • edge
  • react
  • crm
  • anti-bot
  • rate-limiting
  • lgpd
  • pwa
architecture.pt.svgampliar ↓

01Visão geral

Pimenta no Senado é a plataforma digital de uma campanha majoritária estadual. Ela junta três coisas que normalmente vivem em ferramentas separadas: as páginas públicas onde as pessoas se cadastram como apoiadoras, um painel para militantes (os "ativistas") acompanharem quem trouxeram e se compararem com os demais, e um CRM interno para a coordenação ver toda a base, segmentar, mandar e-mail e medir de onde vem cada cadastro.

Na prática, um cidadão entra por uma landing page ou por um link de indicação, preenche um formulário curto e passa a existir como um perfil único, identificado pelo telefone, mesmo que tenha se cadastrado em cinco páginas diferentes ao longo de meses. Cada ação dele soma pontos num Lead Score, que a coordenação usa para saber quem está frio, morno ou pronto para ser chamado para algo maior.

O sistema ficou em produção de dezembro de 2025 a setembro de 2026, passou por mais de 1.800 commits e 221 migrations de banco e lidou com dados pessoais de eleitores sob a LGPD, num ambiente em que o público inclui adversários.

02O problema

  • Cadastros espalhados. A mesma pessoa aparecia em supporters, em tabelas de cada landing page temática, em formulários de eventos e numa base histórica importada. Não havia como responder "quantas pessoas reais temos" nem "qual a jornada desta pessoa".
  • Atribuição. A coordenação precisava saber qual página, qual UTM e qual ativista trouxe cada cadastro, e separar indicação de apoiador de recrutamento de novo ativista.
  • Engajamento mensurável. Era preciso transformar ações (cadastro, indicação, presença, interações externas por e-mail e WhatsApp) em uma pontuação configurável, sem depender de planilhas.
  • Exposição. Formulários públicos atraem bots; o painel de ativistas expõe uma área autenticada a milhares de pessoas que não são da equipe; e o banco guarda nome, telefone e e-mail de eleitores.

03A solução

Captação pública

  • Landing com formulário multi-step e um formulário leve (/apoiar) com pós-cadastro de três caminhos (compartilhar, virar ativista, entrar no canal oficial).
  • Landing pages temáticas registradas em landing_pages, cada uma com pontuação própria de cadastro e causa associada.
  • Campo de município como combobox sobre a base do IBGE (bottom sheet no celular).
  • PWA instalável, widget de acessibilidade, banner de consentimento e política de privacidade.

Área do Ativista (/ativista)

  • Link de indicação exclusivo com QR code, templates de mensagem e materiais para baixar.
  • Ranking geral, regional e por cidade, níveis, conquistas e sequência diária.
  • Visibilidade restrita: o ativista só lê, via RLS, o próprio registro e os apoiadores que ele mesmo indicou.

CRM administrativo (/admin)

  • Perfil único por telefone, com jornada (um evento por página de cadastro), histórico campo a campo, score e faixa, filtros por tag, origem, UF e faixa, e exportação CSV.
  • Lead Score com catálogo de ações, faixas e causas configuráveis; pontuação automática no cadastro e na indicação; importação CSV restrita a ações externas.
  • Tracker: origens, criador de UTM em cinco dimensões e funil de conversão e abandono por página e por UTM.
  • Dashboard com KPIs, mapa coroplético do país com drill-down no estado prioritário e filtro por origem; falha de um card não derruba a página.
  • Fila de aprovação de ativistas, convite individual e em lote, reenvio de link de senha.
  • E-mail marketing com templates, agendamento e métricas sincronizadas do provedor.
  • Ranking de indicações com curva de Pareto, gestão de eventos, petições e carrossel de notícias, relatórios em PDF.
  • Modo Privacidade: um botão no cabeçalho mascara nomes, telefones e números na tela, para apresentar o painel em reunião ou gravar a tela.
  • Perfil único por telefone sobre várias tabelas de cadastro, com uma só função de ingestão usada por triggers em tempo real e por backfill idempotente em lotes de 20 mil.
  • Lead Score idempotente: dois índices únicos parciais separam a deduplicação de eventos automáticos (por fonte) da de importações CSV (por dia).
  • Cadastro público só pela Edge Function: INSERT anônimo revogado, Turnstile validado no servidor e whitelist de colunas.
  • Login com Turnstile e rate limit duplo (5 falhas por IP, 8 por e-mail em 2 min), IP guardado só como hash.
  • Após um incidente de exclusão em massa, restauração pelo audit log e trigger por statement que recusa DELETE de mais de 5 linhas.
  • Envio a sistemas externos movido do navegador para trigger com pg_net e chave no Vault.

04Arquitetura

arquitetura real · passe o cursor nos nós
Ler o diagrama como lista (23 componentes, 23 conexões)

Componentes

  • Clientes: Apoiador<br>(landing, LPs, PWA), Ativista<br>(/ativista · ranking, link, QR), Coordenação<br>(/admin · CRM)
  • SPA React 18 + Vite: Turnstile<br>cadastro e login, tracking.ts<br>UTM + funil, Modo Privacidade<br>máscara no cliente
  • 38 Edge Functions (Deno): submit-form<br>Turnstile + whitelist, login<br>Turnstile + rate limit, provision / ativação<br>link HMAC uid+sig, funções admin<br>JWT + is_admin(), webhooks<br>segredo / Svix
  • Postgres: RLS em public.*<br>user_roles + has_role(), CRM de Mobilização<br>crm_ingest · perfil por telefone, Lead Score<br>eventos idempotentes, Guardrails<br>audit log + trava de DELETE em massa, pg_net + Vault<br>envio server-side, pg_cron<br>limpeza de logs
  • Supabase: EF, Auth<br>e-mail e senha, PostgREST<br>RPCs SECURITY DEFINER, PG

Conexões

  • Apoiador<br>(landing, LPs, PWA) → Turnstile<br>cadastro e login
  • Turnstile<br>cadastro e login → submit-form<br>Turnstile + whitelist
  • Ativista<br>(/ativista · ranking, link, QR) → login<br>Turnstile + rate limit
  • Coordenação<br>(/admin · CRM) → login<br>Turnstile + rate limit
  • login<br>Turnstile + rate limit → Auth<br>e-mail e senha
  • Ativista<br>(/ativista · ranking, link, QR) → PostgREST<br>RPCs SECURITY DEFINER
  • Coordenação<br>(/admin · CRM) → PostgREST<br>RPCs SECURITY DEFINER
  • Coordenação<br>(/admin · CRM) → funções admin<br>JWT + is_admin()
  • tracking.ts<br>UTM + funil → PostgREST<br>RPCs SECURITY DEFINER
  • submit-form<br>Turnstile + whitelist → PG
  • PostgREST<br>RPCs SECURITY DEFINER → RLS em public.*<br>user_roles + has_role()
  • RLS em public.*<br>user_roles + has_role() → CRM de Mobilização<br>crm_ingest · perfil por telefone
  • CRM de Mobilização<br>crm_ingest · perfil por telefone → Lead Score<br>eventos idempotentes
  • provision / ativação<br>link HMAC uid+sig → Auth<br>e-mail e senha
  • provision / ativação<br>link HMAC uid+sig → Resend<br>e-mail transacional e campanhas
  • funções admin<br>JWT + is_admin() → Resend<br>e-mail transacional e campanhas
  • funções admin<br>JWT + is_admin() → GA4<br>Data API
  • webhooks<br>segredo / Svix → PG
  • N8N / WhatsApp<br>webhooks → webhooks<br>segredo / Svix
  • Resend<br>e-mail transacional e campanhas → webhooks<br>segredo / Svix
  • pg_net + Vault<br>envio server-side → N8N / WhatsApp<br>webhooks
  • submit-form<br>Turnstile + whitelist → Cloudflare<br>Turnstile siteverify
  • login<br>Turnstile + rate limit → Cloudflare<br>Turnstile siteverify

A SPA conversa com o Supabase por dois caminhos: leitura autenticada via PostgREST (RLS e RPCs SECURITY DEFINER com checagem de papel) e operações sensíveis via Edge Functions, que usam a service role do lado do servidor. Escritas do CRM nunca vêm do cliente: triggers em supporters e forms_eventos chamam crm_ingest() dentro do banco.

05Por dentro

Backend e dados
  • 67 tabelas no schema público (segundo os tipos gerados), 221 migrations entre dez/2025 e set/2026, cerca de 177 funções SQL e 38 Edge Functions em Deno (8 mil linhas).
  • Papéis em tabela separada (user_roles, enum app_role) com has_role(), is_admin() e is_ativista() em SECURITY DEFINER, nunca em profiles.
  • Perfil único. crm_profiles tem telefone_normalizado UNIQUE; crm_events tem UNIQUE (profile_id, form_slug), um cadastro por pessoa por página; crm_field_history guarda cada mudança de campo. A origem do perfil é sempre o cadastro mais antigo.
  • Ingestão única. crm_ingest() é o único ponto de escrita do CRM, chamado por triggers em tempo real e por crm_backfill_core() / crm_backfill_crm_geral_batch() em lotes de 20 mil, ambos idempotentes, para migrar a base histórica.
  • Lead Score. O score é a soma de crm_score_events. Eventos automáticos carregam source='auto' e source_ref, com índice único parcial (action_slug, source_ref); importações CSV deduplicam por (profile_id, action_slug, occurred_on). Assim o mesmo cadastro nunca pontua duas vezes, mas um ativista pode receber várias indicações no mesmo dia. Causas sensíveis são marcadas como fluxo de cuidado e não pontuam.
  • Funil e UTM. landing_pages, utm_links e page_events alimentam RPCs de funil (get_funnel_overview, get_funnel_detail) e de geografia (get_crm_geo_overview, com normalização de município por unaccent).
  • Integrações server-side. Envio de cadastros a endpoints externos por trigger com pg_net (assíncrono, não bloqueia o INSERT), com a chave lida do Supabase Vault, não do código. pg_cron limpa logs de e-mail diariamente.
  • Importação de pontuação pela edge import-score-csv, em três fases (crm_start/apply/finish_score_import) com registro do lote.
Frontend
  • React 18, Vite 5 (SWC), TypeScript, Tailwind CSS 3 com tokens HSL semânticos e shadcn/ui sobre Radix.
  • 40 rotas carregadas com lazy() e Suspense; TanStack Query v5 para estado de servidor.
  • Formulários com react-hook-form + zod; telefone sempre no formato (DD) 9XXXX-XXXX via src/lib/phone.ts; validação de parâmetros de URL em urlParamValidation.ts.
  • supabaseFetchAll e paginação em lotes de 1.000 para contornar o db-max-rows do PostgREST em listas grandes.
  • Recharts e react-simple-maps para gráficos e mapas; jsPDF + html2canvas para relatórios.
  • PWA com vite-plugin-pwa: HTML servido pela rede (network-first na navegação) para que uma versão nova valha sem hard refresh, e materiais pesados fora do precache.
Infraestrutura e deploy
  • Front publicado por deploy contínuo a partir do branch principal, com fallback de SPA em public/_redirects.
  • Backend gerenciado no Supabase: Postgres, Auth, Storage, Edge Functions, pg_cron, pg_net e Vault.
  • Quando o site oficial da campanha entrou no ar, a home do domínio antigo passou a redirecionar para ele por um script no topo do <head>, preservando /admin, /ativista, as rotas de ativação, as LPs e qualquer URL com ?ref= ou ?utm_, para não quebrar links de indicação nem a atribuição no CRM.
  • Não há CI nem testes automatizados no repositório.

06Segurança

7 ataques considerados, 7 defesas em produção.

ataquedefesa
Atalho pela API

Pular a interface e falar direto com o banco ou a API, com a chave pública na mão.

  • Chamar RPCs administrativas ou helpers de permissão com a chave pública

    EXECUTE revogado de anon e public; funções admin checam is_admin() por dentro

Contas e login

Força bruta, criação de contas indevidas, redefinição de senha e tomada de conta.

  • Força bruta ou credential stuffing no login de admin e ativista

    Turnstile no login e rate limit de 5 falhas por IP e 8 por e-mail a cada 2 minutos, com 429 e Retry-After

Escalada de privilégio

Quem tem algum acesso tentando ganhar mais: virar admin, ler o que não deve, manter acesso revogado.

  • Ativista logado tentar ler a base inteira de apoiadores

    RLS: o ativista só lê o próprio registro e os indicados por ele; tabelas do CRM só para admin

Origem e requisições forjadas

CSRF, webhooks falsos, tokens reaproveitados, links assinados e redirecionamento aberto.

  • Forjar eventos do provedor de e-mail

    Assinatura Svix verificada sobre o corpo cru antes de qualquer processamento

  • Forjar um link de ativação para assumir uma conta

    Link assinado com HMAC-SHA256 sobre o uid e verificado no servidor

Vazamento e rastreio de dados

Enumerar quem está na base, raspar dados pessoais, ligar perguntas a pessoas, extrair segredos.

  • Assinar canais Realtime para receber dados de tabelas administrativas

    RLS em realtime.messages limitada a admins

Adulteração e rastro

Mexer em contagens, apagar a base, editar o histórico ou negar o que foi autorizado.

  • Apagar a base de apoiadores em uma única operação

    Trigger por statement recusa DELETE de mais de 5 linhas; audit log com snapshot de cada linha apagada

Autenticação

  • Login de admin e ativista passa pela edge login, que exige Cloudflare Turnstile validado no servidor e aplica rate limit duplo: 5 falhas por IP e 8 por e-mail numa janela de 2 minutos, com resposta 429 e Retry-After. O IP é armazenado só como hash SHA-256.
  • Política de senha: mínimo de 8 caracteres, uma maiúscula e um número (passwordValidation.ts).
  • Ativação de conta por link assinado com HMAC-SHA256 (uid + sig, base64url), verificado no servidor antes de permitir definir senha.
  • Aviso discreto de monitoramento nas telas de login.

Autorização e RLS

  • RLS habilitada em todas as tabelas públicas, com GRANT explícito na mesma migration.
  • O ativista lê supporters apenas pelo próprio registro e pelos indicados por ele (referred_by_supporter_id = get_ativista_supporter_id(auth.uid())); só admin atualiza ou apaga.
  • Tabelas do CRM: leitura só para admin, escrita só via funções SECURITY DEFINER.
  • EXECUTE revogado de anon (e de public) em RPCs administrativas e em helpers de RLS como is_admin, has_role e geradores de código de indicação. Funções internas do CRM não são chamáveis pela API.
  • Realtime fechado: RLS em realtime.messages restrita a admins, porque, sem isso, qualquer usuário autenticado poderia assinar canais de tabelas administrativas mesmo com a RLS das tabelas bloqueando o SELECT.
  • Edge Functions administrativas validam o JWT e chamam is_admin() antes de agir.

Formulários e anti-abuso

  • INSERT anônimo em supporters revogado: o único caminho público de cadastro é a edge submit-form, que valida o Turnstile e grava apenas colunas de uma whitelist, impedindo injeção de colunas pelo PostgREST.
  • Endpoints de consulta pública (check-supporter-email, get-referral-code) devolvem só o mínimo, sem nome nem papel, para reduzir enumeração.
  • Webhooks: assinatura Svix verificada sobre o corpo cru antes do parse (provedor de e-mail); segredo compartilhado em cabeçalho nas integrações de automação.

Proteção dos dados

  • supporters_audit_log guarda um snapshot JSON de cada apoiador apagado, com quem apagou, papel e origem, legível só por admin.
  • Trava de DELETE em massa: trigger por statement recusa qualquer DELETE em supporters que afete mais de 5 linhas, salvo um bypass explícito de sessão.
  • Exclusão de conta pelo próprio usuário desativada até revisão do fluxo, depois de um incidente.
  • Segredos de integração fora do código: variáveis de ambiente nas Edge Functions e Supabase Vault para chamadas feitas pelo banco.

LGPD

  • Banner de consentimento e política de privacidade públicos; IP com hash no controle de login; Modo Privacidade para exibir o painel sem expor dados pessoais; ativistas veem dados completos só dos próprios indicados.

07Desafios técnicos

Unificar a base sem perder a história

Havia cadastros em várias tabelas, com telefones em formatos diferentes. A função legada de limpeza de dígitos tinha um bug: o translate removia também o dígito 0, gerando chaves erradas. A solução foi uma camada nova por cima das tabelas existentes, sem substituí-las: crm_digits() com regexp_replace, crm_normalize_phone() (remove o 55, exige no mínimo 10 dígitos), UNIQUE no telefone normalizado e uma única função de ingestão usada tanto pelos triggers quanto pelo backfill em lotes. A primeira versão revogou EXECUTE de crm_digits e quebrou o cadastro público em produção (42501), porque um índice funcional em supporters avalia a função com o privilégio de quem insere; o hotfix devolveu o EXECUTE a essa função pura, e a regra ficou documentada.

Pontuação idempotente com duas fontes

Eventos importados por CSV e eventos automáticos têm regras de duplicidade diferentes. Dois índices únicos parciais (um por dia para importação, um por fonte para eventos automáticos) deixam o banco decidir, e reprocessar cadastros ou reimportar o mesmo arquivo não infla o score.

Incidente de exclusão em massa

Em abril de 2026, apoiadores foram apagados em massa. Como o audit log já existia havia quatro dias, uma migration reinseriu os registros a partir do snapshot mais recente de cada ID (jsonb_populate_record, ON CONFLICT DO NOTHING) e, na mesma migration, criou a trava por statement com tabela de transição. A função de autoexclusão foi desligada e, três dias depois, outra migration revogou EXECUTE de anon em RPCs administrativas e negou leitura da fila de aprovação a não-admins.

Cadastros que se perdiam no navegador

O envio de cadastros de eventos a um endpoint externo era um fetch do front, sujeito a cache de PWA, bloqueadores e conexão ruim. Ele foi movido para um trigger com pg_net, que é assíncrono, não derruba o INSERT e lê a chave do Vault; o PWA passou a buscar o HTML pela rede para que correções chegassem sem hard refresh.

08Resultados

  • Em produção de dezembro de 2025 a setembro de 2026, com 1.847 commits e 221 migrations.
  • 38 Edge Functions, 67 tabelas, cerca de 177 funções SQL, 40 rotas com lazy loading.
  • CRM de Mobilização entregue em uma série de 28 pull requests entre 2 e 6 de julho de 2026: perfil único, Lead Score automático, funil por UTM, mapa geográfico, Turnstile e o bloqueio de INSERT anônimo.
1.847
Commits
como medimos

git rev-list --count HEAD

221
Migrations
como medimos

ls supabase/migrations | wc -l

38
Edge Functions
como medimos

ls supabase/functions | wc -l

67
Tabelas
como medimos

seção Tables de src/integrations/supabase/types.ts

~177
Funções SQL
como medimos

nomes distintos em CREATE [OR REPLACE] FUNCTION nas migrations

40
Rotas com lazy()
como medimos

grep -c 'lazy(' src/App.tsx

~53 mil
Linhas TS/TSX
como medimos

wc -l dos arquivos .ts e .tsx versionados (inclui Edge Functions e tipos gerados)

~14 mil
Linhas SQL
como medimos

wc -l de supabase/migrations/*.sql

dez/2025 – set/2026
Período
como medimos

git log (primeiro commit de código em 2025-12-15, último em 2026-09-28)

09Linha do tempo

  1. dez 2025

    Início: landing de captação e funil de cadastro gamificado

  2. jan 2026

    Mês de maior volume (635 commits): área do ativista, CRM e e-mail marketing

  3. abr 2026

    Audit log, restauração após exclusão em massa, trava de DELETE e fechamento de Realtime e RPCs

  4. jul 2026

    CRM de Mobilização: perfil único, Lead Score automático, funil por UTM e mapa (28 PRs em 5 dias)

  5. jul 2026

    Turnstile em cadastro e login e revogação do INSERT anônimo

  6. ago 2026

    Integração com o site oficial e redirecionamento preservando indicações e UTMs

  7. set 2026

    Últimas landing pages de eventos e encerramento do desenvolvimento

10Stack

Frontend
  • React 18
  • Vite 5 (SWC)
  • TypeScript 5
  • Tailwind CSS 3
  • shadcn/ui
  • Radix UI
  • TanStack Query 5
  • React Router 6
  • react-hook-form
  • zod
  • Recharts
  • react-simple-maps
  • jsPDF
Backend
  • Supabase Edge Functions (Deno)
  • PostgREST
  • PL/pgSQL SECURITY DEFINER
  • Supabase Auth
  • Resend
  • N8N
Dados
  • PostgreSQL
  • Row Level Security
  • pg_cron
  • pg_net
  • Supabase Vault
  • Supabase Storage
  • unaccent
Infra
  • Deploy contínuo via GitHub
  • PWA (vite-plugin-pwa)
  • GA4 Data API
Segurança
  • Cloudflare Turnstile
  • Rate limit por IP e por e-mail
  • Hash de IP (SHA-256)
  • Links de ativação HMAC-SHA256
  • Webhooks Svix
  • Audit log + trava de DELETE em massa
  • RLS em realtime.messages

11Ficha técnica

node@pimenta-no-senado: ~/cases/pimenta-no-senado
node@pimenta-no-senado ─────────────
type
CRM de mobilização
stack
React 18 · Vite · TS
db
Postgres · 67 tabelas · RLS
auth
Supabase Auth · Turnstile · rate limit
edge
38 Edge Functions (Deno)
deploy
deploy contínuo + PWA
modules
captação · ativistas · CRM · lead score
status
concluído
$ ls supabase/migrations | wc -l && ls supabase/functions | wc -l
221
38
$ psql -c "select crm_normalize_phone('+55 (11) 90000-0000')"
crm_normalize_phone
---------------------
11900000000
(1 row)
$ curl -s -X POST $FN/submit-form -d '{"data":{"nome_completo":"Teste","whatsapp":"11900000000"}}'
{"success":false,"error":"CAPTCHA","message":"Falha na verificação de segurança. Recarregue a página e tente novamente."}
$ grep -ri 'enable row level security' supabase/migrations | wc -l
72
$ psql -c "delete from supporters where created_at < now() - interval '1 day'"
ERROR: Mass delete em public.supporters bloqueado: tentativa de apagar 6 linhas em uma unica statement (limite: 5).
$ npm run build
vite v5.4.19 building for production...
✓ built
NODE

TECNOLOGIA E INTELIGÊNCIA POLÍTICA

© 2026 NODE. Todos os direitos reservados.