Todos os cases
~/cases/crm-eleitoral-alencar-santana
Plataformas & CRMsCâmara e Assembleiamar 2026 → ago 2026Concluído

P-11

CRM Eleitoral Alencar Santana

Cadastro público, rede de indicações e CRM sobre um banco que não confia na chave pública.

clientePré-campanha do deputado federal Alencar Santana

Site de cadastro de apoiadores, portal para ativistas e painel interno com CRM, gamificação e rastreamento de links, todos sobre o mesmo Postgres. Cada apoiador ganha um link de indicação; ativistas acompanham quem trouxeram e sobem de nível; a equipe unifica contatos de várias fontes e mede cada canal. A base de dados pessoais fica fechada para a chave anônima: o cadastro entra por uma RPC que sanitiza, limita tentativas e devolve só o código de indicação.

20/20
Tabelas com RLS
16
Funções com gate de admin
56
Policies
9
Edge Functions
  • supabase
  • postgres
  • rls
  • edge
  • react
  • crm
  • rate-limiting
  • lgpd
architecture.pt.svgampliar ↓

01Visão geral

O CRM Eleitoral Alencar Santana é o conjunto de sistemas que a pré-campanha de Alencar Santana a deputado federal usou para transformar visitas ao site em uma base organizada de apoiadores. São duas aplicações sobre o mesmo backend: o site público, onde qualquer pessoa se cadastra em três etapas, e uma plataforma interna com duas áreas, uma para a equipe da campanha e outra para os ativistas que trazem novos apoiadores.

Cada apoiador recebe um link pessoal de indicação. Quem se torna ativista ganha um portal com o próprio link, QR code, a lista de quem indicou, um ranking e níveis de progresso. A equipe acompanha tudo num painel: cadastros em tempo real, indicações, abaixo-assinados, um CRM que unifica contatos vindos de várias fontes, links rastreáveis por canal e um placar de gamificação.

O sistema operou de março a agosto de 2026, evoluindo continuamente em produção, e foi construído partindo do princípio de que o formulário público e a chave pública do banco estão nas mãos de qualquer pessoa.

02O problema

  • Cadastro aberto, dados sensíveis. O formulário pede nome, e-mail, WhatsApp, endereço, data de nascimento e vínculo partidário. Tudo isso é dado pessoal sob a LGPD e não pode vazar pela mesma API que recebe o cadastro.
  • Crescimento por indicação. A campanha queria medir quem traz quem, premiar os mais ativos e permitir que um apoiador comum virasse ativista sem perder o histórico de indicações.
  • Bases espalhadas. Contatos chegavam de planilhas, de reuniões presenciais, de abaixo-assinados, do site e, no fim, de um formulário externo da campanha oficial. A equipe precisava de uma visão única, sem duplicatas.
  • Saber o que funciona. Cada post, grupo e QR code precisava de um link próprio para comparar canais por clique e por cadastro.

03A solução

Site público

  • Cadastro em três etapas (dados pessoais, endereço com preenchimento por CEP, formas de participação) com consentimento LGPD obrigatório e adesão opcional a um manifesto.
  • Link de indicação (?ref=) que mostra o primeiro nome de quem indicou, e parâmetro de origem (?origem=) que acompanha o visitante até o envio.
  • Tela de agradecimento com o link pessoal de indicação, e-mail de boas-vindas e disparo para uma automação de mensagens.

Portal do ativista

  • Cadastro com senha forte, login, recuperação de senha por e-mail.
  • Painel com o link pessoal, QR code e compartilhamento direto, lista de indicados, ranking e perfil.

Painel da equipe

  • Dashboard com contadores e atualização em tempo real.
  • Apoiadores (grade ou lista), indicações, ranking de ativistas e de apoiadores que indicam.
  • CRM: contatos com status em funil (novo → contatado → engajado → apoiador → voluntário → descartado), tags coloridas, notas, favoritos, filtros por origem, cidade e zona, cruzamento automático com quem se cadastrou no site e exportação CSV.
  • Abaixo-assinados e páginas temáticas de coleta de assinaturas, cada um com KPIs, filtros e exportação.
  • Página de reuniões presenciais: link com origem fixa e QR code para cadastro no próprio evento.
  • Rastreador UTM: criação de links por canal com encurtador próprio, registro de cliques (dispositivo, navegador, sistema, referência) e conversão em cadastros.
  • Gamificação: 9 níveis por número de indicações, tops do dia, da semana e do mês, sequência de dias ativos, melhores por cidade e por estado, ranking geral e exportação.
  • Recebimento de leads de um formulário externo por endpoint autenticado com API key.
  • A chave anônima não lê a tabela de apoiadores: o cadastro entra por uma RPC SECURITY DEFINER que devolve só o código de indicação.
  • 16 funções do painel começam com has_role(auth.uid(), 'admin') e recusam qualquer outro chamador.
  • Sanitização no banco: limites, regex e allowlist em cada campo, com erros genéricos para quem tenta forçar.
  • Indicações em dois níveis (APO- e MIL-) com migração automática quando um apoiador vira ativista.
  • CRM que deduplica por e-mail normalizado e últimos 11 dígitos do telefone, com cruzamento numa materialized view.
  • Realtime com RLS: cada ativista só escuta o próprio canal.
  • 1.191 commits em 5 meses de operação, somando site e plataforma.

04Arquitetura

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

Componentes

  • Público: Site público<br>cadastro em 3 etapas<br>?ref= · ?origem=, Formulário externo<br>integração por API key
  • Áreas logadas: Portal do ativista<br>link, QR code, ranking, Painel admin<br>CRM, gamificação, UTM
  • Postgres: RPCs SECURITY DEFINER<br>submit_apoiador · dashboards<br>gate has_role('admin'), 20 tabelas com RLS<br>56 policies, materialized view<br>CRM × apoiadores
  • Supabase: Auth<br>e-mail + senha<br>papéis admin / ativista, PostgREST + Realtime<br>RLS também em realtime.messages, Edge Functions · Deno<br>9 funções<br>signup, reset, approve, intake,<br>redirect UTM, boas-vindas, webhook, PG

Conexões

  • Site público<br>cadastro em 3 etapas<br>?ref= · ?origem= → PostgREST + Realtime<br>RLS também em realtime.messages (RPC anônima)
  • Site público<br>cadastro em 3 etapas<br>?ref= · ?origem= → Edge Functions · Deno<br>9 funções<br>signup, reset, approve, intake,<br>redirect UTM, boas-vindas, webhook (pós-cadastro)
  • Formulário externo<br>integração por API key → Edge Functions · Deno<br>9 funções<br>signup, reset, approve, intake,<br>redirect UTM, boas-vindas, webhook (x-api-key)
  • Portal do ativista<br>link, QR code, ranking → Cloudflare Turnstile
  • Painel admin<br>CRM, gamificação, UTM → Cloudflare Turnstile
  • Portal do ativista<br>link, QR code, ranking → Auth<br>e-mail + senha<br>papéis admin / ativista (JWT)
  • Painel admin<br>CRM, gamificação, UTM → Auth<br>e-mail + senha<br>papéis admin / ativista (JWT)
  • Portal do ativista<br>link, QR code, ranking → PostgREST + Realtime<br>RLS também em realtime.messages (JWT)
  • Painel admin<br>CRM, gamificação, UTM → PostgREST + Realtime<br>RLS também em realtime.messages (JWT)
  • Portal do ativista<br>link, QR code, ranking → Edge Functions · Deno<br>9 funções<br>signup, reset, approve, intake,<br>redirect UTM, boas-vindas, webhook
  • Painel admin<br>CRM, gamificação, UTM → Edge Functions · Deno<br>9 funções<br>signup, reset, approve, intake,<br>redirect UTM, boas-vindas, webhook
  • PostgREST + Realtime<br>RLS também em realtime.messages → RPCs SECURITY DEFINER<br>submit_apoiador · dashboards<br>gate has_role('admin')
  • RPCs SECURITY DEFINER<br>submit_apoiador · dashboards<br>gate has_role('admin') → 20 tabelas com RLS<br>56 policies
  • 20 tabelas com RLS<br>56 policies → materialized view<br>CRM × apoiadores
  • Edge Functions · Deno<br>9 funções<br>signup, reset, approve, intake,<br>redirect UTM, boas-vindas, webhook → 20 tabelas com RLS<br>56 policies (service role)
  • Edge Functions · Deno<br>9 funções<br>signup, reset, approve, intake,<br>redirect UTM, boas-vindas, webhook → Resend<br>e-mail transacional
  • Edge Functions · Deno<br>9 funções<br>signup, reset, approve, intake,<br>redirect UTM, boas-vindas, webhook → n8n<br>automação

São dois front-ends React independentes (site e plataforma interna) apontando para o mesmo projeto Supabase. Não há servidor de aplicação próprio: a regra de negócio sensível mora no Postgres, em funções SECURITY DEFINER e policies de RLS, e o que precisa de segredo (service role, chave do provedor de e-mail, API key de integração, segredo do webhook) roda em Edge Functions.

05Por dentro

Backend e dados
  • Postgres com 20 tabelas no schema public, todas com RLS, mais RLS em realtime.messages. As migrations estão divididas entre os dois repositórios porque ambos evoluíram o mesmo banco: 70 arquivos ao todo.
  • 36 funções SQL e PL/pgSQL. As de leitura para o painel devolvem jsonb já agregado (KPIs, séries diárias, rankings, tops por período), em vez de mandar linhas para o navegador.
  • submit_apoiador, a porta de entrada do site, passou por 10 versões: sanitização de cada campo, allowlist das formas de participação, rate limit, anti-enumeração, remapeamento de código de indicação e registro de origem.
  • Indicações em dois níveis. Apoiadores recebem um código APO- e ativistas um código MIL-, gerados por trigger. Quando um apoiador vira ativista, um trigger move os indicados do código antigo para o novo, e novos cadastros feitos com o código antigo já são regravados no envio.
  • CRM unificado. Um trigger copia cada novo apoiador para a tabela de contatos, deduplicando por e-mail normalizado e pelos últimos 11 dígitos do telefone. Uma materialized view cruza contatos e apoiadores, atualizada com REFRESH ... CONCURRENTLY por uma função restrita a admin.
  • Normalização de nomes com uma função de title case para português que mantém preposições em minúsculas ("Maria da Silva"), usada no backfill que separou nome e sobrenome.
  • Edge Functions (9, em Deno): cadastro e recuperação de senha de ativista, criação e aprovação de ativista pelo admin, intake de leads externos, redirecionamento de links curtos com registro de clique, verificação de Turnstile, e-mail de boas-vindas e webhook para automação.
  • Integrações: Resend para e-mail transacional, n8n por webhook autenticado, ViaCEP no site para endereço e Cloudflare Turnstile nos logins.
Frontend
  • React 18 + TypeScript + Vite, Tailwind CSS e componentes shadcn/ui sobre Radix.
  • TanStack Query para dados, React Hook Form + Zod nos formulários, Recharts nos dashboards, Framer Motion nas transições do cadastro e qrcode.react para os QR codes.
  • Supabase Realtime atualiza dashboard, CRM e petições sem recarregar.
  • Paginação em blocos de 1.000 linhas para contornar o limite padrão do PostgREST nas listas e exportações completas, e contagens com count: exact.
  • Todas as datas são calculadas no fuso de Brasília, independentemente do fuso do navegador, para que "hoje", "semana" e "mês" batam com os números do banco.
  • Chave de idempotência por formulário, guardada em sessionStorage, para que um duplo clique ou um F5 não gerem cadastro duplicado.
Infraestrutura e deploy
  • Backend inteiramente gerenciado no Supabase: Postgres, Auth, Realtime, Storage e Edge Functions.
  • Edge Functions públicas declaradas com verify_jwt = false no config.toml e autenticadas por outros meios (API key, validação de cadastro recente); as de administração mantêm a verificação de JWT padrão.
  • Respostas das funções com X-Robots-Tag: noindex, nofollow.

06Segurança

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

ataquedefesa
Robôs e cadastro falso

Scripts que enchem formulários, inflam números ou varrem o site atrás de brechas.

  • Inundar o cadastro por script

    Limite no banco de 3 tentativas por e-mail e 10 por IP a cada 10 minutos, numa tabela inacessível pela API.

Atalho pela API

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

  • Ler a base de apoiadores com a chave pública do site

    REVOKE de SELECT para anon e cadastro só por RPC SECURITY DEFINER que retorna um escalar: o código de indicação.

Escalada de privilégio

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

  • Chamar as funções de dashboard sem ser admin

    16 funções checam has_role(auth.uid(), 'admin') e lançam 'forbidden'; EXECUTE revogado de anon.

  • Escutar canais Realtime de outros usuários

    RLS em realtime.messages: ativista só assina o tópico ativista-<próprio uid>; tabelas com PII fora da publicação.

Origem e requisições forjadas

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

  • Usar a função de boas-vindas como relay de e-mail

    A função só aceita o código de indicação, confere e-mail e cadastro criado há menos de 10 minutos e lê o destinatário do banco.

  • Gravar leads pelo endpoint de integração sem credencial

    API key comparada em tempo constante antes de qualquer validação, mais 30 requisições por IP a cada 10 minutos.

Injeção e conteúdo hostil

XSS, iframe, fórmula em CSV, upload disfarçado e manipulação do prompt da IA.

  • Mandar payload malformado ou valores fora do formulário

    Sanitização na RPC: remoção de caracteres de controle, limites de tamanho, regex por campo e allowlist de 6 opções.

Vazamento e rastreio de dados

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

  • Descobrir quais e-mails têm conta

    Mensagem única no login e respostas genéricas de sucesso no cadastro e na recuperação de senha.

Autenticação e papéis

  • Supabase Auth com e-mail e senha. Os papéis (admin, ativista) ficam em user_roles, que só um admin pode alterar. Um trigger concede o papel ativista quando o registro de ativista é criado.
  • has_role() é SECURITY DEFINER com search_path fixo, o que evita recursão de RLS e mantém a checagem em um único lugar.
  • Senha de ativista exige 8+ caracteres com maiúscula, minúscula, número e símbolo, validada no cliente (Zod) e de novo na Edge Function.
  • Ativista com status diferente de ativo é deslogado ao entrar.

Autorização no banco

  • Todas as 20 tabelas têm RLS. Tabelas de PII só são lidas por admin; o ativista só enxerga os cadastros cujo referred_by é o próprio código, resolvido por uma função que lê auth.uid().
  • 16 funções de leitura do painel começam com has_role(auth.uid(), 'admin') e lançam forbidden caso contrário, e têm EXECUTE revogado de anon.
  • Funções internas (geração de código, triggers, extração de IP, sincronização) têm EXECUTE revogado de PUBLIC, anon e authenticated.
  • Tabelas de controle (tentativas de login, tentativas de cadastro, rate limit, idempotência) têm grants revogados e uma policy AS RESTRICTIVE ... USING (false): só funções SECURITY DEFINER e a service role tocam nelas.
  • O log de eventos de segurança é legível por admin e bloqueado para escrita direta por policies restritivas de INSERT, UPDATE e DELETE.

A base de apoiadores fechada para a chave pública

  • anon não tem SELECT na tabela de apoiadores, e o INSERT direto foi substituído por uma RPC SECURITY DEFINER que retorna só um escalar, o código de indicação. Não há RETURNING nem leitura de outras colunas pelo caminho público.
  • O contador público de apoiadores é uma função que devolve apenas count(*).
  • A função que mostra "indicado por" devolve só o primeiro nome e valida o formato do código.

Validação e sanitização no servidor

  • submit_apoiador remove caracteres de controle, colapsa espaços, limita tamanhos (nome 2–120, e-mail 254, endereço 200), valida e-mail por regex, telefone por 10–13 dígitos, CEP por 8 dígitos, UF por ^[A-Z]{2}$, data de nascimento como data real, código de indicação por ^[A-Za-z0-9_-]{1,32}$ e formas de participação contra uma allowlist de 6 valores, com no máximo 10 itens.
  • Erros saem como códigos genéricos (DADOS_INVALIDOS, RATE_LIMITED) sem detalhar o motivo.
  • O endpoint de intake externo devolve erros por campo, mas só depois de autenticar a API key.

Rate limiting e anti-abuso

  • Cadastro no site: até 3 tentativas por e-mail e 10 por IP a cada 10 minutos, contadas no próprio banco, com limpeza oportunista dos registros.
  • Cadastro e recuperação de senha de ativista: 3 por e-mail e 3 por IP a cada 10 minutos, em tabela compartilhada pelas Edge Functions.
  • Intake externo: 30 requisições por IP a cada 10 minutos.
  • Honeypot nos formulários de login, cadastro e recuperação: se o campo invisível vier preenchido, a função responde sucesso e descarta.
  • Cloudflare Turnstile nos logins de admin e de ativista, com o token validado por uma Edge Function que guarda o segredo.

Anti-enumeração

  • Login com mensagem única ("E-mail ou senha incorretos").
  • Cadastro de ativista com e-mail já existente devolve uma resposta genérica de sucesso; recuperação de senha responde igual exista a conta ou não.
  • No site, um e-mail já cadastrado não gera erro: a RPC devolve sucesso silencioso.

Integrações e e-mail

  • O intake externo compara a API key em tempo constante e só grava via service role; a tabela não tem nenhuma policy de escrita pública.
  • As funções de boas-vindas e de webhook não aceitam destinatário nem dados do cliente: recebem só o código de indicação, conferem que o cadastro existe e foi criado há menos de 10 minutos e leem os dados do banco. Isso impede o uso como relay de e-mail ou de webhook.
  • O HTML do e-mail de boas-vindas escapa os campos interpolados.

Realtime

  • As tabelas com PII foram removidas da publicação do Realtime.
  • realtime.messages tem RLS: admin escuta qualquer canal, ativista só o tópico ativista-<seu uid>.

LGPD

  • Consentimento LGPD obrigatório no cadastro do site.
  • E-mail guardado como hash SHA-256 no log de eventos de segurança; cliques de links curtos guardam um hash de IP e user agent, não o IP.
  • Registros de tentativas expiram (1 hora para cadastro, 24 horas para login) por limpeza oportunista.

07Desafios técnicos

Fechar a base sem quebrar o formulário público

O primeiro desenho tinha uma policy de SELECT público para alimentar o contador, o que na prática expunha a tabela inteira para a chave anônima. A correção veio em camadas: remoção da policy, REVOKE ALL seguido de GRANT INSERT apenas nas colunas do formulário, função de contagem dedicada e, por fim, a troca do INSERT direto por uma RPC SECURITY DEFINER que devolve só o código de indicação. O site continuou funcionando durante toda a transição.

Uma pessoa, dois códigos de indicação

Apoiadores e ativistas têm prefixos diferentes, e um apoiador que já tinha indicado gente podia virar ativista depois. Para não perder o histórico, um trigger na criação do ativista move os indicados do APO- para o MIL-, a RPC de cadastro já grava o código novo quando alguém usa o antigo, e uma migration fez o backfill do que existia.

Um CRM a partir de fontes que não conversam

Contatos importados de várias origens tinham nomes em caixa alta, telefones com e sem DDI e e-mails com espaços. A solução normaliza no banco: title case com preposições em português, comparação de e-mail por lower(btrim()), telefone pelos últimos 11 dígitos, um trigger que só insere quando não há correspondência e uma materialized view com índice único para o cruzamento, atualizável sem bloquear leituras.

Números que batem

O PostgREST corta respostas em 1.000 linhas e o navegador pode estar em outro fuso. Os dashboards passaram a ser calculados em RPCs agregadas no fuso de Brasília, as listas e exportações a buscar em blocos de 1.000, e as contagens a usar count: exact.

08Resultados

  • Em produção de março a agosto de 2026, com 1.191 commits somando os dois repositórios.
  • 70 migrations, 20 tabelas com RLS, 56 policies e 36 funções no banco; 9 Edge Functions.
  • 15 telas no painel da equipe e um portal do ativista com 4 abas (divulgação, painel de indicados, ranking, perfil).
1.191
Commits
como medimos

git log --oneline | wc -l nos dois repositórios (644 plataforma + 547 site)

70
Migrations
como medimos

arquivos em supabase/migrations dos dois repositórios (61 + 9); 9 deles vazios

20/20
Tabelas com RLS
como medimos

CREATE TABLE e ENABLE ROW LEVEL SECURITY distintos no schema public, somando as migrations dos dois repositórios

56
Policies
como medimos

nomes distintos de CREATE POLICY nas migrations dos dois repositórios

36
Funções no banco
como medimos

nomes distintos de CREATE [OR REPLACE] FUNCTION public.* nas migrations

16
Funções com gate de admin
como medimos

funções cujo corpo checa has_role(auth.uid(), 'admin') e lança 'forbidden'

9
Edge Functions
como medimos

diretórios em supabase/functions (7 plataforma + 2 site)

15
Telas do painel
como medimos

rotas filhas de /admin em src/App.tsx, sem contar o redirecionamento

09Linha do tempo

  1. mar 2026

    Site de cadastro e base da plataforma: formulário em etapas, painel em tempo real e portal do ativista.

  2. abr 2026

    Sistema de indicações com códigos por pessoa e e-mail de boas-vindas.

  3. abr 2026

    Revisão de segurança: RLS endurecida, RPC de cadastro com sanitização, rate limit e anti-enumeração.

  4. abr 2026

    CRM com funil, tags, notas e cruzamento com apoiadores; endurecimento de login e recuperação de senha.

  5. mai 2026

    Cadastro de ativista sem aprovação manual, sincronização automática com o CRM e webhook de automação.

  6. jun 2026

    Rastreador UTM com encurtador e painel de gamificação com níveis e rankings.

  7. ago 2026

    Turnstile nos logins e endpoint autenticado para receber leads de um formulário externo.

10Stack

Frontend
  • React 18
  • TypeScript
  • Vite
  • Tailwind CSS
  • shadcn/ui
  • TanStack Query
  • React Hook Form
  • Zod
  • Recharts
  • Framer Motion
Backend
  • Supabase Edge Functions (Deno)
  • PostgREST
  • PL/pgSQL SECURITY DEFINER
  • Supabase Auth
  • Resend
  • n8n (webhook)
Dados
  • PostgreSQL
  • Row Level Security
  • Materialized view
  • Supabase Realtime
  • Supabase Storage
Infra
  • Supabase
  • ViaCEP
Segurança
  • Cloudflare Turnstile
  • RLS em 20/20 tabelas
  • Policies RESTRICTIVE
  • Rate limit em Postgres
  • Honeypot
  • Idempotência
  • Anti-enumeração
  • API key em tempo constante

11Ficha técnica

node@crm-eleitoral-alencar-santana: ~/cases/crm-eleitoral-alencar-santana
node@crm-eleitoral-alencar-santana ─────────────
type
cadastro · indicações · CRM
stack
React 18 · TS · Vite
db
Postgres · 20 tabelas · RLS 20/20
auth
Supabase Auth · papéis admin/ativista
backend
9 Edge Functions · 36 funções SQL
modules
site · portal ativista · CRM · UTM · gamificação
status
concluído
$ find . -path '*/supabase/migrations/*.sql' | wc -l
70 # plataforma 61 + site 9, mesmo banco
$ curl -s "$SUPABASE_URL/rest/v1/bora_alencar?select=email" -H "apikey: $ANON_KEY"
{"code":"42501","message":"permission denied for table bora_alencar"}
$ curl -s "$SUPABASE_URL/rest/v1/rpc/submit_apoiador" -H "apikey: $ANON_KEY" -H 'content-type: application/json' -d '{"_nome":"A","_email":"x"}'
{"code":"P0001","message":"DADOS_INVALIDOS"}
$ ls supabase/functions
approve-ativista campanha-oficial-intake create-ativista
reset-password-ativista signup-ativista utm-redirect verify-turnstile
$ curl -s -X POST "$SUPABASE_URL/functions/v1/campanha-oficial-intake" -d '{}'
{"error":"Unauthorized"} # 401, API key comparada em tempo constante
NODE

TECNOLOGIA E INTELIGÊNCIA POLÍTICA

© 2026 NODE. Todos os direitos reservados.