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.
- cloudflare
- anti-bot
- crm
- rate-limiting
- lgpd
- vanilla-js
- seo
- ci
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 unexecCommandfallback).- "¿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=instaorutm_sourcese convierte en unde-instaetiqueta 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, anItemListde escrituras) cuyadateModifiedatado 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
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
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:
- 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. - Honeypot y tiempo. Un lleno oculto
websitecampo, o una presentación menor que 2 s después de la forma montada, obtiene200 {ok:true}y se cae. El bot ve el éxito y no recibe ninguna señal para adaptarse. - Límite de tarifa Por IP (
CF-Connecting-IP) en Workers KV: presentaciones de 10 por hora. Más allá de eso,429. - Turnstile. El token del widget invisible se comprueba contra el
siteverifyAPI junto con la IP del cliente; un token no válido obtiene un403. - 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.
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-liveregiones 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);Esccierra una lista abierta y devuelve el foco a su encabezado; el foco se mueve a la confirmación después de enviar;prefers-reduced-motiones honrado por el desplazamiento y la animación. - Peso bajo control. Las fuentes de la marca se convirtieron en Latin-subset
woff2archivos (archivos 3, sobre 120 KB total) conpreload; 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 bajofile://. - Reventar la caché sin una construcción. CSS y JS utilizan un hand-bumped
?v=compartidas en las tres páginas.
- Páginas Cloudflare sirve la raíz del repositorio como el sitio (
pages_build_output_dir = ".") yfunctions/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 deployen cada empujón paramain, pasando el hash de confirmación y el mensaje, conconcurrencyasí que despliegues nunca solapan ycontents: readpermisos. - Tres dominios, uno canónico. El middleware
301-redirige cualquier host personalizado al dominio canónico, preservando la ruta y la consulta. Los*.pages.devhost se queda como una vista previa, conX-Robots-Tag: noindexNo 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.examplecon 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.
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
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
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
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.
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-lgpdSegmentar 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.jsony sin paso de compilación: los únicos scripts de terceros son Turnstile y el reproductor de YouTube.
- 30
- compromisos
- 5 días
- Período activo
- 2
- autores
- 3
- páginas
- 1
- puntos finales
- 10/h por IP
- límite de tarifa
- 5
- cabeceras de seguridad
- 5,571
- Municipios
- 5
- scripts de vídeo
- 0
- Dependencias npm
- 1,087
- Líneas CSS
- 629
- Líneas HTML
- 507
- Líneas JS
cómo lo medimos
git log --oneline wc -l
cómo lo medimos
git log: primera confirmación 2026-10-05, última 2026-10-09
cómo lo medimos
git log --format%an sort -u
cómo lo medimos
index.html, roteiros.html, 404.html
cómo lo medimos
functions/api/cadastro.js (POST /api/cadastro) + functions/_middleware.js
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
cómo lo medimos
HEADERS_SEGURANCA en functions/_middleware.js
cómo lo medimos
recuento de entradas CIDADES_BR en cidades.js (27 estados)
cómo lo medimos
identificadores únicos de roteiro-N en roteiros.html
cómo lo medimos
no hay package.json en el repositorio
cómo lo medimos
Líneas no vacío de styles.css
cómo lo medimos
Líneas no vacío de index.html, roteiros.html y 404.html
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
- 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
- 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
- 05 oct 2026
Implementación continua a través de GitHub Actions, trabajando en torno al proyecto carga directa Pages
- 06 oct 2026
Página de scripts de vídeo y una 404 real
- 06 oct 2026
SEO/GEO auditoría, mapa del sitio, JSON-LD, noindex en la vista previa e IndexNow
- 09 oct 2026
Estado y ciudad con municipios 5,571, Turnstile y limitación de la tasa KV
10Stack
- HTML5
- CSS3 sem framework
- JavaScript sem dependências
- IntersectionObserver
- Clipboard API
- woff2 em subset
- Cloudflare Pages Functions
- Middleware de borda
- Mautic auto-hospedado (API REST)
- Workers KV
- Tabela de municípios do IBGE
- Cloudflare Pages
- Wrangler 4
- GitHub Actions
- DNS Cloudflare (3 domínios)
- 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
- 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
Un canal público de denuncias con un panel de triaje donde la autorización vive en la base de datos: RLS por rol, contactos solo mediante una función auditada, revocación inmediata de sesiones y un robot que guarda las pruebas antes de que expiren.
Plataforma de la campaña contra la jornada 6x1: registros nacionales, red de voluntariado y siete capas contra bots.
Registros nacionales de creadores, contador público resistente a la manipulación y administración protegida contra fuerza bruta.
¿Quieres un sistema así para tu operación?
Node diseña, construye y protege plataformas a la medida para campañas, mandatos y movimientos.

TECNOLOGÍA E INTELIGENCIA POLÍTICA
© 2026 NODE. Todos los derechos reservados.