Todos os cases
~/cases/[classificado]/segundo-turno
confidencial · NDALanding pages blindadasCampanha presidencialout 2026Concluído

P-09

Segundo Turno

Uma página estática, sem build, com o cadastro blindado na borda: quatro camadas contra robôs antes de qualquer dado chegar ao CRM.

cliente████Rede voluntária e não oficial de apoio no 2º turno de uma eleição presidencial

Landing page de uma rede voluntária de mobilização para o segundo turno de uma eleição presidencial, acessada quase sempre pelo celular a partir de links no WhatsApp. Reúne live, grupos, guia em PDF, roteiros de vídeo e um cadastro que passa por honeypot, checagem de tempo, rate limit em Workers KV e Cloudflare Turnstile antes de gravar o contato num Mautic auto-hospedado com a prova do consentimento LGPD. No ar no dia do primeiro commit.

5 dias
período ativo
0
dependências npm
10/h por IP
rate limit
5
headers de segurança
  • cloudflare
  • anti-bot
  • crm
  • rate-limiting
  • lgpd
  • vanilla-js
  • seo
  • ci
architecture.pt.svgampliar ↓

01Visão geral

Segundo Turno é a página de entrada de uma rede voluntária de comunicadores, ativistas e jornalistas que se organizou nas três semanas entre o primeiro e o segundo turno de uma eleição presidencial. A página se declara não oficial: não é canal de partido nem de campanha.

Quase todo o acesso chega por link compartilhado no WhatsApp e nas redes, num celular, muitas vezes com conexão ruim. Em uma tela, a pessoa assiste à gravação da reunião de lançamento, escolhe um grupo do WhatsApp com vaga, baixa o guia de pesquisa em PDF, pega um roteiro de vídeo pronto para gravar e, se quiser ajudar mais, deixa nome, e-mail, celular, estado e cidade.

O site é estático, sem etapa de build, publicado no Cloudflare Pages. A única parte dinâmica é uma função de borda que recebe o cadastro, filtra bots em quatro camadas e grava o contato num Mautic auto-hospedado com a prova do consentimento exigida pela LGPD.

02O problema

  • Prazo de dias, não de semanas. A página precisava estar no ar no mesmo dia da reunião de lançamento, e o segundo turno acontecia três semanas depois. Não havia tempo para um produto; havia tempo para uma página que funcionasse em qualquer celular.
  • Público hostil por definição. Página política com formulário aberto atrai robôs e envio em massa de dados falsos, que sujam a base e queimam a reputação de envio de e-mail.
  • Consentimento com prova. Uma base de contatos para comunicação precisa responder "quando, de onde e com qual texto essa pessoa aceitou?". E a base não podia ser misturada com a de nenhuma campanha oficial, já que a página se declara independente.
  • Conteúdo que muda de hora em hora. Grupos de WhatsApp lotam, a live vira gravação, materiais são substituídos. Quem edita não pode depender de pipeline de build.

03A solução

  • Live no topo. Player do YouTube embutido no hero. Um script troca o estado da reunião pela hora de Brasília: contagem regressiva, "ao vivo agora", "reunião realizada". O HTML estático já vem no estado atual, que é o que buscadores e IAs leem sem executar JS.
  • Grupos e materiais em listas abertas (<details open>) dentro dos cards, sem rota separada. Marcar um grupo como lotado é editar uma linha do HTML.
  • /roteiros: 5 roteiros de vídeo curtos com público-alvo, formato e botão "Copiar roteiro" que monta título e parágrafos prontos para colar num teleprompter (Clipboard API com fallback para execCommand).
  • Cadastro "Quer ajudar?" com UF e cidade em selects dependentes, populados por uma tabela local de 5.571 municípios em 27 UFs (IBGE). Máscara de celular, validação com foco no primeiro campo inválido e mensagens anunciadas a leitores de tela.
  • Atribuição de origem por link. ?de=insta ou utm_source vira a tag de-insta no contato, para saber qual canal rende cadastro.
  • 404 de verdade. Sem um 404.html, o Pages devolve a home com status 200 para qualquer URL. A página de erro usa caminhos absolutos porque é servida em qualquer profundidade (/a/b/c).
  • Descoberta. sitemap.xml, JSON-LD (WebSite, WebPage, ItemList dos roteiros) com dateModified amarrado a um <time> visível no rodapé, e aviso imediato a buscadores via IndexNow.
  • Quatro camadas anti-robô na borda: honeypot e envio rápido recebem um 200 falso, o rate limit devolve 429 a partir do 11º envio na hora e o Turnstile é validado no servidor.
  • Prova de consentimento LGPD gravada no próprio contato: data UTC, IP, página, origem do link e o texto exato do checkbox.
  • Credenciais do CRM só nos segredos da borda; sem elas, a função falha fechada com 503 em vez de aceitar dados.
  • Três domínios num canônico por 301 e o preview público com noindex, num middleware de 29 linhas.
  • Zero build, zero package.json: HTML, CSS e JS à mão, publicados por GitHub Actions a cada push.
  • 5.571 municípios em selects dependentes, sem chamada a API externa.

04Arquitetura

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

Componentes

  • Canais: WhatsApp e redes<br>links com ?de=origem, Bots e envios<br>automatizados
  • Cloudflare Pages: _middleware.js<br>301 p/ domínio canônico<br>headers de segurança<br>noindex no preview, Estático, sem build<br>index · /roteiros · 404<br>styles.css · app.js · cidades.js, Pages Function<br>POST /api/cadastro, Workers KV<br>RATE_KV · 10 envios/h/IP, Real-time Logs<br>[BLOQUEIO:motivo] · [CADASTRO:ok]

Conexões

  • WhatsApp e redes<br>links com ?de=origem → Visitante<br>(celular)
  • Visitante<br>(celular) → _middleware.js<br>301 p/ domínio canônico<br>headers de segurança<br>noindex no preview
  • Bots e envios<br>automatizados → _middleware.js<br>301 p/ domínio canônico<br>headers de segurança<br>noindex no preview
  • _middleware.js<br>301 p/ domínio canônico<br>headers de segurança<br>noindex no preview → Estático, sem build<br>index · /roteiros · 404<br>styles.css · app.js · cidades.js
  • _middleware.js<br>301 p/ domínio canônico<br>headers de segurança<br>noindex no preview → Pages Function<br>POST /api/cadastro
  • Visitante<br>(celular) → Cloudflare Turnstile<br>widget invisível + siteverify (token)
  • Pages Function<br>POST /api/cadastro → Pages Function<br>POST /api/cadastro (honeypot · tempo · validação)
  • Pages Function<br>POST /api/cadastro → Workers KV<br>RATE_KV · 10 envios/h/IP
  • Pages Function<br>POST /api/cadastro → Cloudflare Turnstile<br>widget invisível + siteverify (siteverify)
  • Pages Function<br>POST /api/cadastro → Mautic auto-hospedado<br>API REST · Basic Auth<br>contato · tags · nota de aceite (upsert por e-mail)
  • Pages Function<br>POST /api/cadastro → Real-time Logs<br>[BLOQUEIO:motivo] · [CADASTRO:ok]
  • Estático, sem build<br>index · /roteiros · 404<br>styles.css · app.js · cidades.js → YouTube<br>live embutida (iframe)
  • GitHub Actions<br>wrangler pages deploy → Edge
  • Estático, sem build<br>index · /roteiros · 404<br>styles.css · app.js · cidades.js → IndexNow<br>sitemap · JSON-LD

Toda requisição passa primeiro pelo middleware, que normaliza o domínio e aplica os headers. O resto é arquivo estático servido da borda. O navegador nunca fala com o Mautic: só a função conhece a URL e as credenciais.

05Por dentro

Backend e dados

O backend é uma única Pages Function, functions/api/cadastro.js (159 linhas), que aceita apenas POST (qualquer outro método recebe 405). A ordem das checagens é deliberada:

  1. Configuração. Sem as credenciais do Mautic, responde 503 e o formulário mostra "não deu pra enviar", em vez de aceitar dados que não seriam gravados.
  2. Honeypot e tempo. Campo invisível website preenchido, ou envio em menos de 2 s desde que o formulário montou: responde 200 {ok:true} e descarta. O robô recebe sucesso e não tem sinal para ajustar o ataque.
  3. Rate limit por IP (CF-Connecting-IP) em Workers KV: 10 envios por hora. Acima disso, 429.
  4. Turnstile. O token do widget invisível é validado na API siteverify com o IP do cliente; token inválido recebe 403.
  5. Validação de servidor, independente da do navegador: tamanhos máximos por campo (nome 120, e-mail 200, cidade 120, origem 40), e-mail por regex, celular reduzido a dígitos com 10 ou 11 posições, UF com 2 letras, aceite obrigatório como booleano true. A origem do link é sanitizada para [a-z0-9-].

Passadas as checagens, o nome é separado em firstname/lastname, o celular vira E.164 (+55…) e o contato é criado ou atualizado no Mautic por POST /api/contacts/new, que deduplica pelo e-mail, com overwriteWithBlank: false para não apagar dados de um cadastro anterior. Em seguida, sem poder derrubar a resposta:

  • uma nota na linha do tempo do contato com a prova do aceite: data UTC, IP, UF e cidade, página de origem (Referer), origem do link e o texto exato do checkbox. Cada reenvio gera uma nota nova, porque cada um é um evento de consentimento;
  • a inclusão opcional num segmento (MAUTIC_SEGMENT_ID).

Tags padrão: segundo-turno (configurável), aceite-lgpd e de-<origem>. Falha na nota ou no segmento vai só para o log; o cadastro principal já foi feito.

Frontend

HTML, CSS e JavaScript escritos à mão, sem framework, sem bundler e sem package.json: 629 linhas de HTML em 3 páginas, 1.087 de CSS e 319 de JS no navegador (app.js e roteiros.js), mais a tabela de municípios gerada.

  • Feita para o celular primeiro. Layout empilhado, barra fixa que aparece só quando o player sai da tela (IntersectionObserver), quatro cards que viram uma grade 2×2 no desktop para as listas de grupos não espremerem.
  • Funciona sem JS. Tudo é legível e clicável com o JavaScript desligado. Só o envio do cadastro e o botão de copiar dependem dele, e o botão nem aparece se o JS não carregar.
  • Acessibilidade. Regiões aria-live para o estado da reunião e para o status do formulário (o leitor de tela ouve a mudança de estado, nunca o relógio de segundos); Esc fecha a lista aberta e devolve o foco ao cabeçalho; foco movido para a confirmação após o envio; prefers-reduced-motion respeitado na rolagem e nas animações.
  • Peso controlado. Fontes da identidade convertidas em subsets Latin woff2 (3 arquivos, cerca de 120 KB no total) com preload; o título só anima depois que a fonte chega, com fallback de 1,2 s para nunca ficar escondido. A pincelada decorativa é um PNG embutido como data URI numa máscara CSS, porque máscara por arquivo externo não carrega em file://.
  • Cache sem build. CSS e JS usam ?v= incrementado à mão, compartilhado pelas três páginas.
Infraestrutura e deploy
  • Cloudflare Pages servindo a raiz do repositório como site (pages_build_output_dir = ".") e functions/ como API, sem nenhum passo de compilação.
  • Deploy contínuo por GitHub Actions. O projeto Pages foi criado por upload direto, tipo que a Cloudflare não deixa converter para integração nativa com Git. A saída foi um workflow que roda wrangler pages deploy a cada push na main, com o hash e a mensagem do commit, concurrency para não sobrepor deploys e permissão contents: read.
  • Três domínios, um canônico. O middleware redireciona com 301 qualquer host personalizado para o domínio canônico, preservando caminho e query. O *.pages.dev fica como preview, com X-Robots-Tag: noindex para não concorrer nos buscadores.
  • Segredos só no Pages. Credenciais do Mautic e secret do Turnstile ficam como segredos criptografados do projeto; o repositório traz só um .dev.vars.example com valores de exemplo.
  • Teste local com wrangler pages dev, KV simulado e .dev.vars ignorado pelo git.

06Segurança

6 ataques considerados, 6 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.

  • Robô preenche o formulário em massa com dados falsos

    Honeypot invisível e envio em menos de 2 s recebem um 200 falso e são descartados, sem dar sinal para o robô se ajustar

  • Script dispara centenas de envios do mesmo IP

    Contador por IP em Workers KV: a partir do 11º envio na hora, 429

Atalho pela API

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

  • Pular o JavaScript e mandar payload arbitrário direto para a API

    Validação refeita no servidor: limite de tamanho por campo, regex de e-mail, celular só dígitos, UF de 2 letras, aceite booleano e allowlist de caracteres na origem

Injeção e conteúdo hostil

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

  • Embutir a página num iframe ou explorar MIME sniffing

    Middleware aplica X-Frame-Options SAMEORIGIN, nosniff, Referrer-Policy e Permissions-Policy em todas as respostas

Vazamento e rastreio de dados

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

  • Extrair do navegador a credencial do CRM

    O navegador só fala com a função de borda; URL e credenciais do Mautic existem apenas como segredos do Pages, e a função falha fechada sem elas

Adulteração e rastro

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

  • Contestar que a pessoa autorizou o uso dos dados

    Cada envio grava no contato uma nota com data UTC, IP, página, origem e o texto exato do checkbox, além da tag aceite-lgpd

Uma página política com formulário aberto é alvo. As defesas ficam na borda, antes de qualquer dado chegar ao CRM.

Anti-automação em quatro camadas

Camada O que faz Resposta
Honeypot website campo fora da tela, tabindex=-1, aria-hidden, autocomplete=off 200 falso, descarta
Tempo de preenchimento form_elapsed_ms < 2.000 ms 200 falso, descarta
Rate limit por IP contador em Workers KV, 10/h, TTL de 1 h 429
Cloudflare Turnstile widget invisível; token validado em siteverify com remoteip 403

As duas primeiras camadas mentem de propósito: um robô que recebe sucesso não tem por que mudar de estratégia. Verificado localmente com wrangler pages dev: honeypot e envio rápido devolvem {"ok":true} com 200; a partir do 11º envio do mesmo IP na janela, 429.

Validação e higiene de dados. O navegador valida para dar boa experiência; o servidor valida de novo, com limite de tamanho em todo campo, normalização (e-mail em minúsculas, celular só dígitos, UF em maiúsculas) e allowlist de caracteres na origem do link, que vira tag no CRM.

Segredos e superfície. O navegador nunca vê a URL nem a credencial do Mautic. A autenticação é HTTP Basic com um usuário dedicado, com permissão só de API e de contatos. Sem credenciais configuradas, a função falha fechada (503) em vez de aceitar dados. Erros do Mautic viram 502 genérico, e o corpo da resposta upstream vai só para o log, truncado.

LGPD.

  • Aceite explícito por checkbox, obrigatório no servidor (aceite === true, não "truthy").
  • Prova do consentimento gravada junto do contato: data UTC, IP, página, origem do link e o texto exato que a pessoa marcou. O texto do checkbox está duplicado numa constante da função, com aviso no código para mudar os dois juntos.
  • Tag aceite-lgpd para segmentar quem consentiu.
  • Base própria e separada: a página se declara não oficial e, por regra do projeto, não grava em nenhuma base de campanha oficial.

Hardening HTTP. Em todas as respostas, inclusive no estático: X-Content-Type-Options: nosniff, X-Frame-Options: SAMEORIGIN, Referrer-Policy: strict-origin-when-cross-origin, Permissions-Policy desligando câmera, microfone e geolocalização, e X-XSS-Protection. Cache-Control: no-store nas respostas da API.

Observabilidade. Cada bloqueio gera uma linha [BLOQUEIO:bot|rate-limit|turnstile|validacao] com IP e User-Agent; cada cadastro aceito, [CADASTRO:ok]. Dá para ver um ataque em andamento no Real-time Logs do Pages sem nenhuma ferramenta extra.

07Desafios técnicos

Turnstile invisível travando o formulário

A primeira integração chamava o render do widget em momentos diferentes (script carregado antes, DOMContentLoaded com atraso, load) e, no envio sem token, fazia polling a cada 200 ms por até 10 s. Em celular lento, o script do Turnstile chegava depois e o botão ficava em "Verificando…". A correção trocou o polling por eventos: o script do Turnstile é carregado com render=explicit e um callback onload que renderiza o widget uma única vez; o envio que chega antes do token fica guardado numa função pendente e é disparado pelo callback do próprio Turnstile; o error-callback libera o botão com uma mensagem clara; e depois de qualquer falha o widget é resetado para gerar um token novo.

Domínio canônico sem duplicar conteúdo

Três domínios apontam para o mesmo projeto, e o preview *.pages.dev é público. Sem cuidado, buscadores veriam quatro cópias da página. O middleware resolve as duas coisas numa função de 29 linhas: 301 de qualquer host personalizado para o canônico, mantendo caminho e query, e noindex no preview, que continua útil para conferir deploys.

Página dinâmica que precisa ser lida sem JS

O estado da reunião muda pela hora, mas crawlers e IAs leem o HTML cru. A solução foi inverter: o HTML estático fica sempre no estado atual e o JS só o atualiza quando necessário. Junto vieram JSON-LD descrevendo apenas o que está visível e uma data de atualização única, repetida no <time> do rodapé, no dateModified e no lastmod do sitemap.

Cadastro geográfico sem API externa

UF e cidade em selects dependentes, sem chamar serviço de terceiros a cada troca de estado: os 5.571 municípios ficam num único arquivo JS carregado pela própria página, e o servidor recebe valores que vieram de uma lista fechada, em vez de texto livre.

08Resultados

  • No ar no mesmo dia do primeiro commit (05/10/2026), com live, grupos, material e cadastro integrado ao CRM.
  • Do primeiro ao último commit, 5 dias e 30 commits de 2 autores, cobrindo cadastro, segurança, SEO e uma segunda página.
  • Cadastro protegido por 4 camadas anti-automação, todas registradas em log.
  • Nenhuma biblioteca JavaScript, nenhum package.json e nenhuma etapa de build: os únicos scripts de terceiros são o Turnstile e o player do YouTube.
30
commits
como medimos

git log --oneline | wc -l

5 dias
período ativo
como medimos

git log: primeiro commit 2026-10-05, último 2026-10-09

2
autores
como medimos

git log --format=%an | sort -u

3
páginas
como medimos

index.html, roteiros.html, 404.html

1
endpoints
como medimos

functions/api/cadastro.js (POST /api/cadastro) + functions/_middleware.js

10/h por IP
rate limit
como medimos

RATE_LIMIT e RATE_WINDOW em functions/api/cadastro.js; 429 no 11º envio verificado com wrangler pages dev

5
headers de segurança
como medimos

HEADERS_SEGURANCA em functions/_middleware.js

5.571
municípios
como medimos

contagem das entradas de CIDADES_BR em cidades.js (27 UFs)

5
roteiros de vídeo
como medimos

ids roteiro-N únicos em roteiros.html

0
dependências npm
como medimos

não há package.json no repositório

1.087
linhas CSS
como medimos

linhas não vazias de styles.css

629
linhas HTML
como medimos

linhas não vazias de index.html, roteiros.html e 404.html

507
linhas JS
como medimos

linhas não vazias de app.js, roteiros.js e functions/, sem a tabela gerada cidades.js

09Linha do tempo

  1. 05 out 2026

    Página no ar com live, grupos e cadastro enviado ao Mautic por uma Pages Function

  2. 05 out 2026

    Prova de consentimento LGPD no contato, tag de origem por link e domínio canônico com 301

  3. 05 out 2026

    Deploy contínuo via GitHub Actions, contornando o projeto Pages de upload direto

  4. 06 out 2026

    Página de roteiros de vídeo e 404 de verdade

  5. 06 out 2026

    Auditoria de SEO/GEO, sitemap, JSON-LD, noindex no preview e IndexNow

  6. 09 out 2026

    UF e cidade com 5.571 municípios, Turnstile e rate limit em KV

10Stack

Frontend
  • HTML5
  • CSS3 sem framework
  • JavaScript sem dependências
  • IntersectionObserver
  • Clipboard API
  • woff2 em subset
Backend
  • Cloudflare Pages Functions
  • Middleware de borda
Dados
  • Mautic auto-hospedado (API REST)
  • Workers KV
  • Tabela de municípios do IBGE
Infra
  • Cloudflare Pages
  • Wrangler 4
  • GitHub Actions
  • DNS Cloudflare (3 domínios)
Segurança
  • Cloudflare Turnstile
  • Rate limit por IP em KV
  • Honeypot
  • Checagem de tempo de preenchimento
  • Headers de segurança
  • Validação no servidor
  • Prova de consentimento LGPD

11Ficha técnica

node@segundo-turno: ~/cases/segundo-turno
node@segundo-turno ─────────────
type
landing page + edge function
stack
html · css · vanilla js
runtime
cloudflare pages functions
crm
mautic (self-hosted)
antibot
honeypot · timing · kv rate limit · turnstile
deploy
github actions → wrangler
build
nenhum
status
concluído
$ npx wrangler pages dev .
Using secrets defined in .dev.vars
env.RATE_KV (local) KV Namespace
[wrangler:info] Ready on http://localhost:8788
$ curl -s localhost:8788/api/cadastro
{"ok":false,"erro":"use POST"} # 405
$ curl -s -X POST localhost:8788/api/cadastro -d '{"website":"http://spam","form_elapsed_ms":9000}'
{"ok":true} # 200 falso: honeypot preenchido, descartado
[BLOQUEIO:bot] motivo=honeypot/timing
$ curl -s -X POST localhost:8788/api/cadastro -d '{"email":"nao-e-email", ...}'
{"ok":false,"erro":"e-mail inválido"} # 400
$ for i in $(seq 12); do curl -s -o /dev/null -w '%{http_code} ' -X POST localhost:8788/api/cadastro -d '{}'; done
400 400 400 400 400 400 400 400 400 400 429 429
[BLOQUEIO:rate-limit] contagem=10
$ curl -sI localhost:8788/ | grep -iE 'x-|policy'
Permissions-Policy: camera=(), microphone=(), geolocation=()
X-Frame-Options: SAMEORIGIN
referrer-policy: strict-origin-when-cross-origin
x-content-type-options: nosniff
NODE

TECNOLOGIA E INTELIGÊNCIA POLÍTICA

© 2026 NODE. Todos os direitos reservados.