Todos los casos
~/cases/[clasificado]/segundo-turno
confidencial · NDALanding pages blindadasCampaña presidencialoct 2026Completado

P-09

Segundo Turno

Página estática sin compilación, con cuatro capas contra bots antes de enviar registros al CRM.

cliente████Red no oficial de apoyo voluntario durante una segunda vuelta presidencial

Landing de una red de voluntariado durante una segunda vuelta presidencial, visitada principalmente desde teléfonos mediante enlaces de WhatsApp. Reúne transmisión en vivo, grupos, guía PDF, guiones de vídeo y registro. Antes de guardar el contacto y la prueba de consentimiento LGPD en Mautic, el formulario pasa por honeypot, verificación de tiempo, límites en Workers KV y Cloudflare Turnstile. Se publicó el día del primer commit.

5 días
Período activo
0
Dependencias npm
10/h por IP
límite de tarifa
5
cabeceras de seguridad
  • cloudflare
  • anti-bot
  • crm
  • rate-limiting
  • lgpd
  • vanilla-js
  • seo
  • ci
architecture.es.svgampliar ↓

01Sinopsis

Segundo Turno es la puerta principal de una red voluntaria de comunicadores, activistas y periodistas que se reunieron en las tres semanas entre la primera vuelta y la segunda vuelta de una elección presidencial. La página dice claramente que no es oficial: no es un canal de partido o campaña.

Casi todo el tráfico llega a través de enlaces compartidos en WhatsApp y redes sociales, en un teléfono, a menudo en una conexión deficiente. En una sola pantalla, un visitante puede ver la grabación de la reunión inicial, elegir un grupo WhatsApp que aún tenga espacio, descargar la guía de investigación como PDF, tomar un script de video ready-to-shoot y, si quiere hacer más, dejar su nombre, correo electrónico, número de móvil, estado y ciudad.

El sitio es estático, sin paso de compilación, implementado en páginas Cloudflare. La única pieza dinámica es una función de borde que recibe el registro, filtra los bots a través de cuatro capas y escribe el contacto en una instancia Mautic autohospedado, junto con la prueba de consentimiento que requiere la ley de protección de datos de Brasil (LGPD).

02El problema

  • Días, no semanas. La página tenía que estar en vivo el mismo día de la reunión de inicio, y la segunda vuelta fue de tres semanas. No había tiempo para un producto, solo para una página que funcionaba en cualquier teléfono.
  • Una audiencia hostil por defecto. Una página política con una forma abierta atrae bots y envíos masivos de basura, que contaminan la lista y queman la reputación del remitente del correo electrónico.
  • Consentimiento que puedes probar. Una lista de contactos utilizada para la divulgación tiene que responder "¿cuándo, de dónde y con qué redacción estuvo de acuerdo esta persona?". Y no podía mezclarse con la base de datos de ninguna campaña oficial, ya que la página se presenta como independiente.
  • Contenido que cambia por hora. Los grupos WhatsApp se llenan, la transmisión en vivo se convierte en una grabación, los materiales se reemplazan. Quien edita la página no puede depender de una canalización de compilación.

03La solución

  • Livestream hasta arriba. Un reproductor de YouTube incrustado en el héroe. Un script cambia el estado de la reunión en función de la hora de Brasilia: cuenta atrás, "en vivo ahora", "reunión celebrada". El HTML estático ya se envía en el estado actual, que es lo que los motores de búsqueda y los rastreadores de IA leen sin ejecutar JS.
  • Grupos y materiales como listas abiertas (<details open>) dentro de las tarjetas, sin ruta extra. Marcar un grupo como completo significa editar una línea de HTML.
  • /roteiros: Scripts de vídeo cortos 5 con público objetivo, formato y un botón de "Copiar script" que reúne el título y los párrafos listos para pegar en un teleprompter (Clipboard API con un execCommand fallback).
  • "¿Quieres ayudar?" registro con estados y ciudades dependientes, pobladas a partir de una tabla local de municipios 5,571 en los estados 27 (datos oficiales del IBGE). Máscara de teléfono, validación que enfoca el primer campo no válido, y mensajes anunciados a lectores de pantalla.
  • Per-link atribución de fuente. ?de=insta or utm_source se convierte en un de-insta etiqueta en el contacto, para que el equipo pueda saber qué canal maneja registros.
  • Un verdadero 404. Sin un 404.html, Pages sirve la página de inicio con un 200 para cualquier URL. La página de error usa rutas absolutas porque se sirve a cualquier profundidad (/a/b/c).
  • Descubribilidad. sitemap.xml, JSON-LD (WebSite, WebPage, an ItemList de escrituras) cuya dateModified atado a un visible <time> en el pie de página y notificación instantánea de search-engine a través de IndexNow.
  • Cuatro capas anti-bot en el borde: las presentaciones honeypot y too-fast obtienen un 200 falso, la limitación de velocidad devuelve 429 desde la 11a solicitud en una hora, y Turnstile se verifica del lado del servidor.
  • Prueba de consentimiento LGPD almacenada en el propio contacto: marca de tiempo UTC, IP, página, fuente de enlace y la redacción exacta de la casilla de verificación.
  • Las credenciales CRM viven solo en secretos de borde; sin ellas, la función falla al cerrarse con un 503 en lugar de aceptar datos.
  • Tres dominios colapsaron en uno canónico a través de 301, y la vista previa pública se estableció en noindex, en un middleware de línea 29.
  • Sin compilación, sin package.json: escrito a mano HTML, CSS y JS, implementados por GitHub Acciones en cada empuje.
  • Municipios 5,571 en menús desplegables dependientes, sin llamada externa API.

04Arquitectura

arquitectura real · pasa el cursor por los nodos
Leer el diagrama como lista (13 componentes, 14 conexiones)

Componentes

  • Canales: WhatsApp y redes sociales<br>enlaces con ?de=origin, Bots y envíos<br>automatizados
  • Páginas Cloudflare: middleware.js<br>301 al dominio canónico<br>cabeceras de seguridad<br>noindex en la vista previa, Estático, sin compilación<br>índice /roteiros 404<br>styles.css · app.js · cidades.js, Función de páginas<br>POST /api/cadastro, Workers KV<br>RATE_KV · 10 envíos/h/IP, Registros en tiempo real<br>[BLOQUEIO:motivo] [CADASTRO:ok]

Conexiones

  • WhatsApp y redes sociales<br>enlaces con ?de=origin → Visitante<br>(teléfono)
  • Visitante<br>(teléfono) → middleware.js<br>301 al dominio canónico<br>cabeceras de seguridad<br>noindex en la vista previa
  • Bots y envíos<br>automatizados → middleware.js<br>301 al dominio canónico<br>cabeceras de seguridad<br>noindex en la vista previa
  • middleware.js<br>301 al dominio canónico<br>cabeceras de seguridad<br>noindex en la vista previa → Estático, sin compilación<br>índice /roteiros 404<br>styles.css · app.js · cidades.js
  • middleware.js<br>301 al dominio canónico<br>cabeceras de seguridad<br>noindex en la vista previa → Función de páginas<br>POST /api/cadastro
  • Visitante<br>(teléfono) → Cloudflare Turnstile<br>widget invisible + siteverify (token)
  • Función de páginas<br>POST /api/cadastro → Función de páginas<br>POST /api/cadastro (honeypot · tiempo · validación)
  • Función de páginas<br>POST /api/cadastro → Workers KV<br>RATE_KV · 10 envíos/h/IP
  • Función de páginas<br>POST /api/cadastro → Cloudflare Turnstile<br>widget invisible + siteverify (siteverify)
  • Función de páginas<br>POST /api/cadastro → Mautic autoalojado<br>REST API Autonomía básica<br>contacto · etiquetas · nota de consentimiento (upsert por correo)
  • Función de páginas<br>POST /api/cadastro → Registros en tiempo real<br>[BLOQUEIO:motivo] [CADASTRO:ok]
  • Estático, sin compilación<br>índice /roteiros 404<br>styles.css · app.js · cidades.js → YouTube<br>transmisión en vivo integrada (iframe)
  • GitHub Acciones<br>wrangler páginas despliegue → Edge
  • Estático, sin compilación<br>índice /roteiros 404<br>styles.css · app.js · cidades.js → IndexNow<br>mapa del sitio JSON-LD

Las etiquetas de los diagramas están en portugués, como en el código base.

Cada solicitud primero golpea el middleware, que normaliza el host y establece los encabezados. Todo lo demás es un archivo estático servido desde el borde. El navegador nunca habla con Mautic: solo la función conoce su URL y sus credenciales.

05Por dentro

Backend y datos

El backend es una sola función de páginas, functions/api/cadastro.js (líneas 159), que solo acepta POST (Cualquier otro método tiene un 405). El orden de los controles es deliberado:

  1. Configuración. Sin credenciales Mautic vuelve 503, y el formulario dice que no podía enviar, en lugar de aceptar datos que nunca se almacenarían.
  2. Honeypot y tiempo. Un lleno oculto website campo, o una presentación menor que 2 s después de la forma montada, obtiene 200 {ok:true} y se cae. El bot ve el éxito y no recibe ninguna señal para adaptarse.
  3. Límite de tarifa Por IP (CF-Connecting-IP) en Workers KV: presentaciones de 10 por hora. Más allá de eso, 429.
  4. Turnstile. El token del widget invisible se comprueba contra el siteverify API junto con la IP del cliente; un token no válido obtiene un 403.
  5. Validación Del lado del servidor, independientemente del navegador: longitud máxima por campo (nombre 120, correo electrónico 200, ciudad 120, fuente 40), correo electrónico regex, teléfono reducido a dígitos y requerido para tener 10 o 11, un código de estado 2 letras, y consentimiento requerido como el booleano true. La fuente del enlace está restringida a [a-z0-9-].

Una vez que los cheques pasan, el nombre se divide en firstname/lastname, el teléfono se convierte en E.164 (+55…), y el contacto se crea o actualiza en Mautic a través de POST /api/contacts/new, que deduplica el correo electrónico, con overwriteWithBlank: false por lo que una nueva presentación nunca borra los datos anteriores. Entonces, sin poder fallar la respuesta:

  • a nota en la línea de tiempo del contacto mantener la prueba de consentimiento: marca de tiempo UTC, IP, estado y ciudad, página de referencia, fuente de enlace y la redacción exacta de la casilla de verificación. Cada reenvío agrega una nueva nota, ya que cada uno es un evento de consentimiento;
  • adición opcional a un segmento (MAUTIC_SEGMENT_ID).

Etiquetas predeterminadas: segundo-turno (configurable), aceite-lgpd (consentimiento LGPD) y de-<source>. Un fallo en la nota o segmento solo va al registro; el registro principal ya está guardado.

Frontend

Escrito a mano HTML, CSS y JavaScript, sin marco, sin bundler y sin package.json: 629 líneas de HTML a través de páginas 3, 1,087 líneas de CSS y 319 líneas de navegador JS (app.js y roteiros.js), más la tabla municipal generada.

  • Móvil primero. Diseño apilado, una barra pegajosa que solo aparece una vez que el jugador se desplaza fuera de la vista (IntersectionObserver), y cuatro tarjetas que se convierten en una cuadrícula 22 en el escritorio para que las listas de grupo no se expriman.
  • Funciona sin JS. Todo es legible y se puede hacer clic con JavaScript apagado. Solo el envío del formulario y el botón copiar dependen de él, y el botón se oculta si JS no carga.
  • Accesibilidad. aria-live regiones para el estado de la reunión y el estado del formulario (los lectores de pantalla escuchan el cambio de estado, nunca un tictac del reloj); Esc cierra una lista abierta y devuelve el foco a su encabezado; el foco se mueve a la confirmación después de enviar; prefers-reduced-motion es honrado por el desplazamiento y la animación.
  • Peso bajo control. Las fuentes de la marca se convirtieron en Latin-subset woff2 archivos (archivos 3, sobre 120 KB total) con preload; el título solo se anima una vez que llega su fuente, con el respaldo de un 1.2 para que nunca se deje oculto. La pincelada decorativa es un PNG alineado como un URI de datos en una máscara CSS, porque una máscara cargada desde un archivo externo no funciona bajo file://.
  • Reventar la caché sin una construcción. CSS y JS utilizan un hand-bumped ?v= compartidas en las tres páginas.
Infraestructura y despliegue
  • Páginas Cloudflare sirve la raíz del repositorio como el sitio (pages_build_output_dir = ".") y functions/ como el API, sin paso de compilación.
  • Implementación continua a través de acciones GitHub. El proyecto Pages fue creado por carga directa, un tipo que Cloudflare no permite convertir a la integración nativa de Git. La solución es un flujo de trabajo que se ejecuta wrangler pages deploy en cada empujón para main, pasando el hash de confirmación y el mensaje, con concurrency así que despliegues nunca solapan y contents: read permisos.
  • Tres dominios, uno canónico. El middleware 301-redirige cualquier host personalizado al dominio canónico, preservando la ruta y la consulta. Los *.pages.dev host se queda como una vista previa, con X-Robots-Tag: noindex No compite en la búsqueda.
  • Los secretos solo viven en páginas. Las credenciales de Mautic y el secreto Turnstile son secretos de proyecto cifrados; el repo solo envía un .dev.vars.example con valores de marcador de posición.
  • Pruebas locales con wrangler pages dev, un espacio de nombres KV simulado, y un git-ignored .dev.vars.

06Seguridad

6 ataques considerados, 6 defensas en producción.

ataquedefensa
Bots y registros falsos

Scripts que saturan formularios, inflan cifras o rastrean el sitio buscando brechas.

  • Un bot envíos masivos el formulario con datos falsos

    Un honeypot invisible y los envíos bajo 2 s obtienen un 200 falso y se eliminan, lo que no da al bot ninguna señal para adaptarse.

  • Un script dispara cientos de envíos desde una IP

    Un contador por IP en Workers KV: a partir de la 11a solicitud dentro de la hora, 429

Atajo por la API

Saltarse la interfaz y hablar directo con la base o la API, con la clave pública en mano.

  • Omita el JavaScript y envíe una carga arbitraria directamente al API

    La validación se vuelve a realizar en el servidor: límites de longitud por campo, correo electrónico regex, teléfono digits-only, estado 2-letra, consentimiento booleano y una lista de caracteres permitidos en la fuente

Inyección y contenido hostil

XSS, iframe, fórmulas en CSV, subidas disfrazadas y manipulación del prompt de la IA.

  • Enmarcar la página o abusar de MIME olfateando

    El middleware establece X-Frame-Options SAMEORIGIN, nosniff, Referrer-Policy y Permissions-Policy en cada respuesta

Fuga y rastreo de datos

Enumerar quién está en la base, raspar datos personales, vincular preguntas a personas, extraer secretos.

  • Extraiga las credenciales de CRM del navegador

    El navegador solo habla con la función edge; la URL y las credenciales de Mautic existen solo como secretos de Pages, y la función falla sin ellos.

Adulteración y rastro

Alterar conteos, borrar la base, editar el historial o negar lo que fue autorizado.

  • Disputa que la persona haya consentido alguna vez

    Cada envío escribe una nota en el contacto con la marca de tiempo UTC, IP, página, fuente y la redacción exacta de la casilla de verificación, además de una etiqueta aceite-lgpd

Una página política con una forma abierta es un objetivo. Las defensas se encuentran en el borde, antes de que cualquier dato alcance el CRM.

Cuatro capas contra la automatización

Capa Lo que hace Respuesta
website honeypot off-screen campo, tabindex=-1, aria-hidden, autocomplete=off falso 200, caído
Tiempo de llenado form_elapsed_ms < 2,000 ms falso 200, caído
Límite de tarifa Por IP Workers Contador KV, 10/h, 1 h TTL 429
Cloudflare Turnstile widget invisible; token verificado a través siteverify con remoteip 403

Las dos primeras capas se encuentran a propósito: un bot que obtiene una respuesta de éxito no tiene ninguna razón para cambiar de táctica. Verificado localmente con wrangler pages dev: la presentación honeypot y too-fast devuelven ambas {"ok":true} con un 200, y a partir de la undécima solicitud de la misma IP dentro de la ventana, la función responde 429.

Validación e higiene de datos. El navegador valida la experiencia del usuario; el servidor valida de nuevo, con un límite de longitud en cada campo, normalización (correo electrónico en minúsculas, teléfono digits-only, estado en mayúsculas) y una lista de caracteres permitidos en la fuente de enlace, que se convierte en una etiqueta CRM.

Secretos y superficie de ataque. El navegador nunca ve la URL o las credenciales de Mautic. La autenticación es HTTP Basic con un usuario dedicado limitado a API y permisos de contacto. Sin credenciales configuradas, la función falla (503) en lugar de aceptar datos. Los errores de Mautic se convierten en genéricos 502, y el cuerpo aguas arriba solo alcanza el tronco, truncado.

LGPD (Ley de protección de datos de Brasil).

  • casilla de verificación opt-in explícita, forzada en el servidor (aceite === trueNo sólo la verdad).
  • Prueba del consentimiento almacenado con el contacto: marca de tiempo UTC, IP, página, fuente de enlace y el texto exacto que la persona verificó. Ese texto se duplica como una constante en la función, con un comentario de código para cambiar ambos juntos.
  • An aceite-lgpd Segmentar a las personas que han dado su consentimiento.
  • Una base de datos separada y dedicada: la página se declara no oficial y, como regla de proyecto, nunca escribe en ninguna base de datos oficial de campaña.

El endurecimiento HTTP. En cada respuesta, los archivos estáticos incluyen: X-Content-Type-Options: nosniff, X-Frame-Options: SAMEORIGIN, Referrer-Policy: strict-origin-when-cross-origin, a Permissions-Policy que desactiva la cámara, el micrófono y la geolocalización, y X-XSS-Protection. Las respuestas API llevan Cache-Control: no-store.

Observabilidad. Cada bloque emite un [BLOQUEIO:bot|rate-limit|turnstile|validacao] línea con IP y User-Agent; cada registro aceptado emite [CADASTRO:ok]. Un ataque en curso es visible en Pages Real-time Logs sin herramientas adicionales.

07Desafíos técnicos

El invisible Turnstile congelando el formulario

La primera integración hizo que el widget de varios lugares (script ya cargado, un retraso DOMContentLoaded, load) y, en un envío sin un token, sondeó cada 200 ms hasta 10 s. En un teléfono lento, el script Turnstile llegó tarde y el botón se quedó atascado en "Verifying...". La corrección reemplazó las encuestas con eventos: el script Turnstile se carga con render=explicit y un onload callback que representa el widget exactamente una vez; una presentación que llega antes de que el token se estacione como una función pendiente y se dispare por el propio Turnstile callback; la error-callback re-enables el botón con un mensaje claro; y después de cualquier fallo, el widget se restablece para emitir un token nuevo.

Un dominio canónico, sin contenido duplicado

Tres dominios apuntan al mismo proyecto, y el *.pages.dev La vista previa es pública. Solo, los motores de búsqueda verían cuatro copias de la página. El middleware maneja ambas líneas en 29: a 301 desde cualquier host personalizado hasta el canónico, preservando la ruta y la consulta, y noindex en la vista previa, que sigue siendo útil para comprobar las implementaciones.

Una página dinámica que debe leerse correctamente sin JS

El estado de la reunión cambia por hora, pero los rastreadores y los sistemas de IA leen HTML en bruto. La respuesta fue invertirlo: el HTML estático siempre se envía en el estado actual y JS solo lo actualiza cuando es necesario. Junto a esto llegó el JSON-LD que describe solo lo que es visible, y una sola fecha última actualización repetida en el pie de página. <time>, el dateModified y el mapa del sitio lastmod.

registro geográfica sin API externo

El estado y la ciudad son desplegables dependientes, sin llamada de terceros en cada cambio de estado: todos los municipios 5,571 viven en un archivo JS servido por la propia página, y el servidor recibe valores seleccionados de una lista cerrada en lugar de texto libre.

08Resultados

  • En vivo el mismo día que el primer commit (Oct 5, 2026), con la transmisión en vivo, grupos, materiales y un CRM integrado registro.
  • Del primer al último commit: 5 días y 30 commits por autores 2, cubriendo registro, seguridad, SEO y una segunda página.
  • Registro protegido por capas 4 anti-automation, todas ellas registradas.
  • No hay bibliotecas JavaScript, no package.json y sin paso de compilación: los únicos scripts de terceros son Turnstile y el reproductor de YouTube.
30
compromisos
cómo lo medimos

git log --oneline wc -l

5 días
Período activo
cómo lo medimos

git log: primera confirmación 2026-10-05, última 2026-10-09

2
autores
cómo lo medimos

git log --format%an sort -u

3
páginas
cómo lo medimos

index.html, roteiros.html, 404.html

1
puntos finales
cómo lo medimos

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

10/h por IP
límite de tarifa
cómo lo medimos

RATE_LIMIT y RATE_WINDOW en functions/api/cadastro.js; 429 en la undécima presentación, verificado con wrangler páginas dev

5
cabeceras de seguridad
cómo lo medimos

HEADERS_SEGURANCA en functions/_middleware.js

5,571
Municipios
cómo lo medimos

recuento de entradas CIDADES_BR en cidades.js (27 estados)

5
scripts de vídeo
cómo lo medimos

identificadores únicos de roteiro-N en roteiros.html

0
Dependencias npm
cómo lo medimos

no hay package.json en el repositorio

1,087
Líneas CSS
cómo lo medimos

Líneas no vacío de styles.css

629
Líneas HTML
cómo lo medimos

Líneas no vacío de index.html, roteiros.html y 404.html

507
Líneas JS
cómo lo medimos

Líneas no vacío de app.js, roteiros.js y functions/, sin la tabla cidades.js generada

09Línea de tiempo

  1. 05 oct 2026

    Página en vivo con transmisión en vivo, grupos y un registro enviado a Mautic a través de una Función de Páginas

  2. 05 oct 2026

    Prueba de consentimiento LGPD en el contacto, etiquetas de origen por enlace y un dominio canónico a través de 301

  3. 05 oct 2026

    Implementación continua a través de GitHub Actions, trabajando en torno al proyecto carga directa Pages

  4. 06 oct 2026

    Página de scripts de vídeo y una 404 real

  5. 06 oct 2026

    SEO/GEO auditoría, mapa del sitio, JSON-LD, noindex en la vista previa e IndexNow

  6. 09 oct 2026

    Estado y ciudad con municipios 5,571, Turnstile y limitación de la tasa KV

10Stack

Frontend
  • HTML5
  • CSS3 sem framework
  • JavaScript sem dependências
  • IntersectionObserver
  • Clipboard API
  • woff2 em subset
Backend
  • Cloudflare Pages Functions
  • Middleware de borda
Datos
  • 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)
Seguridad
  • 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
página de destino + función de borde
stack
html css vanilla js
runtime
funciones de páginas cloudflare
crm
mautic (autohospedado)
antibot
honeypot tiempo límite de velocidad kv Turnstile
deploy
acciones github wrangler
build
ninguno
status
Completado
$ 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

© 2026 NODE. Todos los derechos reservados.