P-17
Raio X Eleitoral
Del total nacional a la urna: un modelo territorial único para 2018, 2022 y 2026, un escrutinio en vivo recolectado del TSE y acceso por equipo mediante enlaces vinculados a un solo candidato.
clienteConsultora de inteligencia política que atiende a una campaña mayoritaria nacional y a oficinas parlamentarias
Desarrollador responsable de todo el sistema: base de datos y ETL, rutas de backend, frontend y el rediseño visual
Un panel privado sobre los datos electorales públicos de Brasil (TSE) para las elecciones generales de 2026. Un servidor Linux propio descarga los archivos por sección, concilia los locales de votación, decodifica los boletines de urna en ASN.1 y recolecta el escrutinio de la noche de la elección con ETags y pausa coordinada; un Postgres en Supabase guarda 700 mil territorios y 13 millones de filas de resultados en una tabla particionada por nivel, con RLS en todo y sin acceso para los roles públicos; un sitio Next.js 16 sirve la ficha del candidato, un explorador con mapa en canvas, la comparación entre elecciones, el escrutinio en vivo y la pestaña de abstención, detrás de un inicio de sesión con cookies HMAC, scrypt y bloqueo contra fuerza bruta. Seis informes bilingües salieron de la misma base en la semana posterior a la primera vuelta.
- ssr
- react
- postgres
- supabase
- etl
- rls
- lgpd
01Sinopsis
Raio X Eleitoral ("Rayos X Electoral") es un panel privado usado por una consultora de inteligencia política que atiende a una campaña mayoritaria nacional y a un grupo de oficinas legislativas. Responde la pregunta que toda campaña se hace en la noche de la elección y en las semanas siguientes: dónde le fue bien o mal a cada candidato y qué cambió desde la elección anterior, bajando hasta donde los datos públicos lo permiten (región, estado, ciudad, zona electoral, barrio, local de votación y sección electoral).
Todo lo que aparece en pantalla proviene de fuentes abiertas: los archivos de votación por sección del portal de datos abiertos del TSE, los JSON publicados en la noche de la elección, el boletín de cada urna (publicado en ASN.1) y las mallas territoriales del IBGE. El sistema no infiere perfiles de votantes ni atribuye intenciones a nadie. La regla escrita en el proyecto es "nada inventado, nada supuesto": cuando el TSE todavía no publicó una cifra, la pantalla lo dice en lugar de estimarla.
El producto se construyó en nueve días de commits, entre fines de septiembre y la semana posterior a la primera vuelta. Un servidor Linux dedicado se encarga de la recolección y las cargas; una base de datos Postgres en Supabase contiene el modelo territorial; un sitio Next.js, publicado en Vercel y en el mismo servidor, atiende al equipo detrás de un inicio de sesión, da a los equipos de campo acceso acotado mediante enlaces de seguimiento y ofrece un panel de administración con registros de auditoría.
02El problema
Los datos electorales brasileños son públicos, pero están lejos de estar listos para una campaña:
- Volumen y formato. El portal de datos abiertos entrega ZIP de CSV en Latin-1 separados por punto y coma, uno por estado, con cientos de miles de filas cada uno. La descarga completa del portal, hecha el segundo día, sumó 18 GB. Nada de eso se puede consultar sin un modelo de datos detrás.
- Territorio fragmentado. Las zonas electorales y los barrios no tienen límites oficiales, el registro de locales de votación no coincide entre el archivo de votos y el de totales, y los datos de la noche de la elección solo llegan hasta el municipio. Comparar 2022 con 2026 en el mismo corte exige conciliar todo eso.
- Tiempo. La primera vuelta fue el 4 de octubre de 2026. El sistema tenía que estar listo para recolectar el escrutinio en vivo ese día, con 2022 y 2018 ya cargados para comparar, y convertirse en informes para el equipo ese mismo fin de semana.
- Acceso controlado. El panel sirve a una campaña. Necesitaba inicio de sesión por persona, una forma de dar a los equipos de campo solo el escrutinio de un candidato sin crear cuentas y un registro de quién vio y exportó qué.
03La solución
- Ficha del candidato (presidente, gobernador, senador y un grupo de diputados seguidos) con un explorador territorial: mapa, tabla y barras, en la escala que elija el usuario, con un botón Volver que deshace cada paso.
- Comparación entre elecciones sobre el mismo territorio: el candidato frente a sí mismo en 2022 (primera o segunda vuelta) y frente al rival de la segunda vuelta, agrupado en cuatro acciones (recuperar, defender, impulsar, sostener).
- Comparar candidatos libremente entre 2026, 2022 y 2018, con una presentación lúdica al estilo de juego de pelea, sonidos generados en el navegador y rostros recortados de las fotos oficiales.
- Buscar locales de votación: todos los candidatos de un cargo en un territorio, del estado a la sección.
- Escrutinio en vivo: marcador, secciones contabilizadas, la curva de la noche y un mapa que se actualizan solos a partir del recolector; para diputados, los diez más votados de cada ciudad más los seguidos, con su posición real.
- Directo de las urnas: los boletines de urna publicados antes del conteo oficial, decodificados de ASN.1 con la especificación del TSE.
- Pestaña Abstención: abstención por grupo (edad, género, escolaridad, estado civil, voto obligatorio u opcional, discapacidad) del país hasta la zona, y el total hasta la urna, para 2014, 2018, 2022 y 2026.
- Informe final por candidato con exportación a PDF y CSV, más seis informes bilingües (PT/EN) publicados como páginas estáticas protegidas con contraseña para el equipo y los aliados.
- Administración: usuarios (crear, cambiar contraseña, desactivar), enlaces de seguimiento por equipo con vencimiento y conteo de aperturas, y registros de inicios de sesión, actividad, exportaciones, importaciones y acciones del administrador.
- Un solo modelo territorial, de 8 niveles, para todas las elecciones: 700,822 territorios y 13 millones de filas de resultados en una tabla particionada por nivel, con la clave empezando por el código del territorio y CLUSTER después de cada carga.
- Un recolector del escrutinio con ETag/304, pausa coordinada ante 403/429/503, dos fases por ronda (marcador en segundos, ciudades después), cada JSON guardado en gzip y un modo de ensayo que deshace las escrituras contra el simulador oficial.
- Boletines de urna leídos directamente del TSE: bu.dat en ASN.1 decodificado con la especificación oficial versionada en el repositorio.
- Enlaces de equipo sin inicio de sesión vinculados a un candidato: cookie firmada + allowlist de rutas y parámetros en el middleware + nueva verificación en la base de datos en cada actualización del marcador.
- RLS activado y revoke all para anon/authenticated en cada tabla, función y secuencia; el navegador nunca habla con Supabase.
- Cargas que se detienen ante una columna desconocida y una validación después de cada carga (secciones, locales y barrios suman la zona); números de contribuyente y de registro electoral verificados como ausentes de la base de datos.
- eleicoes_de reescrita para usar el índice: 47 s → 0.03 s.
04Arquitectura
Leer el diagrama como lista (26 componentes, 26 conexiones)
Componentes
- Fuentes públicas: TSE · datos abiertos<br>ZIP por sección (Latin-1, ';'), TSE · divulgación de resultados<br>JSON por país/estado/ciudad (ETag), TSE · boletín de urna<br>bu.dat en ASN.1, IBGE · mallas<br>TopoJSON
- Servidor Linux propio (recolección y cargas): baixar_* .py<br>descargas reanudables, carregar_* .py<br>psycopg 3 + DuckDB<br>validar_territorio.py, coletar_apuracao.py<br>timer systemd · 60 s · ETag/304<br>pausa ante 403/429/503, coletar_bu.py<br>asn1tools · spec bu.asn1, vigiar_abertos_2026.py<br>timer 5 min de día / 30 min de noche, gerar_malhas.py<br>IBGE → códigos del TSE
- Supabase Postgres · esquema tse: territorio (8 niveles)<br>br → regiao → uf → municipio<br>→ zona → local → secao · bairro, resultado<br>particionada por nivel (6)<br>+ territorio_total, Funciones SQL/plpgsql<br>explorar · locais_disputa<br>abstencao_filhos · trajetoria, usuario · link_acesso<br>log_evento · etl_execucao, RLS en cada tabla<br>revoke all anon/authenticated<br>sin números de contribuyente ni de registro electoral
- Next.js 16 · React 19 (SSR + ISR): proxy.ts<br>Cookie HMAC-SHA256 · timingSafeEqual<br>allowlist de enlaces de equipo, 20 rutas /api<br>allowlist de parámetros<br>gzip + caché en memoria, 18 páginas<br>ficha del candidato · explorador · escrutinio en vivo<br>comparar · abstención · registros, mapa en canvas<br>d3-geo + topojson-client
- Alojamiento: Vercel (gru1)<br>transaction pooler · DB_PREPARE=0, Servidor propio<br>systemd de usuario · solo por VPN
- Informes estáticos: Pipeline DuckDB → JSON/binario, Páginas PT/EN en Vercel<br>middleware con contraseña en env
Conexiones
- TSE · datos abiertos<br>ZIP por sección (Latin-1, ';') → baixar_* .py<br>descargas reanudables
- baixar_* .py<br>descargas reanudables → carregar_* .py<br>psycopg 3 + DuckDB<br>validar_territorio.py
- carregar_* .py<br>psycopg 3 + DuckDB<br>validar_territorio.py → resultado<br>particionada por nivel (6)<br>+ territorio_total
- TSE · datos abiertos<br>ZIP por sección (Latin-1, ';') → vigiar_abertos_2026.py<br>timer 5 min de día / 30 min de noche
- vigiar_abertos_2026.py<br>timer 5 min de día / 30 min de noche → carregar_* .py<br>psycopg 3 + DuckDB<br>validar_territorio.py
- TSE · divulgación de resultados<br>JSON por país/estado/ciudad (ETag) → coletar_apuracao.py<br>timer systemd · 60 s · ETag/304<br>pausa ante 403/429/503
- coletar_apuracao.py<br>timer systemd · 60 s · ETag/304<br>pausa ante 403/429/503 → resultado<br>particionada por nivel (6)<br>+ territorio_total
- TSE · boletín de urna<br>bu.dat en ASN.1 → coletar_bu.py<br>asn1tools · spec bu.asn1
- coletar_bu.py<br>asn1tools · spec bu.asn1 → resultado<br>particionada por nivel (6)<br>+ territorio_total
- IBGE · mallas<br>TopoJSON → gerar_malhas.py<br>IBGE → códigos del TSE
- gerar_malhas.py<br>IBGE → códigos del TSE → mapa en canvas<br>d3-geo + topojson-client
- carregar_* .py<br>psycopg 3 + DuckDB<br>validar_territorio.py → territorio (8 niveles)<br>br → regiao → uf → municipio<br>→ zona → local → secao · bairro
- territorio (8 niveles)<br>br → regiao → uf → municipio<br>→ zona → local → secao · bairro → resultado<br>particionada por nivel (6)<br>+ territorio_total
- resultado<br>particionada por nivel (6)<br>+ territorio_total → Funciones SQL/plpgsql<br>explorar · locais_disputa<br>abstencao_filhos · trajetoria
- Funciones SQL/plpgsql<br>explorar · locais_disputa<br>abstencao_filhos · trajetoria → 20 rutas /api<br>allowlist de parámetros<br>gzip + caché en memoria
- usuario · link_acesso<br>log_evento · etl_execucao → proxy.ts<br>Cookie HMAC-SHA256 · timingSafeEqual<br>allowlist de enlaces de equipo
- proxy.ts<br>Cookie HMAC-SHA256 · timingSafeEqual<br>allowlist de enlaces de equipo → 20 rutas /api<br>allowlist de parámetros<br>gzip + caché en memoria
- 20 rutas /api<br>allowlist de parámetros<br>gzip + caché en memoria → 18 páginas<br>ficha del candidato · explorador · escrutinio en vivo<br>comparar · abstención · registros
- 18 páginas<br>ficha del candidato · explorador · escrutinio en vivo<br>comparar · abstención · registros → mapa en canvas<br>d3-geo + topojson-client
- SITE → Vercel (gru1)<br>transaction pooler · DB_PREPARE=0
- SITE → Servidor propio<br>systemd de usuario · solo por VPN
- Equipo<br>inicio de sesión → proxy.ts<br>Cookie HMAC-SHA256 · timingSafeEqual<br>allowlist de enlaces de equipo
- Enlace de equipo<br>sin inicio de sesión → proxy.ts<br>Cookie HMAC-SHA256 · timingSafeEqual<br>allowlist de enlaces de equipo
- Admin → proxy.ts<br>Cookie HMAC-SHA256 · timingSafeEqual<br>allowlist de enlaces de equipo
- resultado<br>particionada por nivel (6)<br>+ territorio_total → Pipeline DuckDB → JSON/binario
- Pipeline DuckDB → JSON/binario → Páginas PT/EN en Vercel<br>middleware con contraseña en env
El sistema tiene tres capas físicas: un servidor Linux propio que habla con el TSE (desde la laptop de un desarrollador el TSE responde 403), Postgres en Supabase como base de publicación y el sitio Next.js, que lee la base de datos solo desde el lado del servidor.
(Las etiquetas del diagrama están en portugués, igual que el código: "fontes públicas" = fuentes públicas, "servidor próprio" = servidor propio, "coleta e cargas" = recolección y cargas, "relatórios" = informes.)
Las decisiones que resume el diagrama:
- Recolección separada de la publicación. El servidor propio descarga, valida y carga; Supabase solo publica. Las cargas grandes se ejecutan en transacciones separadas y, después de recargar secciones, el proceso ejecuta
CLUSTERsobre la clave del territorio yVACUUM ANALYZE, porque el orden físico es lo que mantiene rápido el explorador. - Un solo modelo territorial. Todas las elecciones (2018, 2020, 2022, 2024, 2026) van a la misma tabla
tse.resultado, particionada por nivel, con el código del territorio como primera columna de la clave. Comparar años se vuelve una consulta sobre una sola estructura. - Sin acceso del navegador a la base de datos. Ninguna clave de Supabase llega al cliente. Las páginas y las rutas de API usan la conexión del servidor; el navegador solo recibe JSON compacto.
05Por dentro
Modelo territorial. tse.territorio contiene cada lugar donde se cuentan votos, en ocho niveles (br, regiao, uf, municipio, zona, bairro, local, secao), con códigos por nivel pensados para búsqueda por prefijo (collate "C"): mun:zona, mun:BAIRRO, mun:zona:local, mun:zona:secao. Según la documentación del modelo (3 de oct.), hay 700,822 territorios. tse.resultado está particionada por lista según el nivel en seis particiones (agregados, municipio, zona, barrio, local de votación, sección), con 13 millones de filas reales en la misma fecha; tse.territorio_total contiene los denominadores (electores habilitados, participación, votos válidos, en blanco y nulos) por territorio, cargo, año y vuelta.
Funciones de lectura. El sitio no arma su propio SQL para el explorador: llama a funciones de la base de datos. tse.explorar devuelve los hijos de un territorio con votos, posición, principal rival y totales y, mediante los parámetros p_cmp_*, el mismo territorio en otro resultado para la pestaña Comparación. tse.locais_disputa lista todos los candidatos de un cargo en un territorio; tse.abstencao_filhos hace lo mismo para la abstención por grupo. Las funciones que reciben el nivel como parámetro se ejecutan con plan_cache_mode = force_custom_plan, porque el plan genérico no podaba particiones.
Migraciones. 26 archivos SQL aplicados en orden (2,097 líneas), con DDL, funciones y un comentario en cada columna. La migración 011 registra una decisión de alcance: la base de publicación conservó solo presidente, gobernador y senador más los diputados seguidos; bienes, financiamiento de campaña, encuestas y perfiles del electorado se eliminaron, con un respaldo hecho antes.
ETL en Python. 26 scripts activos en etl/ (psycopg 3 y DuckDB), ejecutados en el servidor propio:
baixar_*: descargas reanudables de los ZIP del portal.carregar_territorio.pyycarregar_secao_ano.py: cargan un año electoral completo a partir de los archivos por sección. La lista de columnas que lee cada carga es fija: si el TSE renombra una, la carga se detiene en lugar de adaptarse en silencio.validar_territorio.py: después de cada carga, verifica que secciones, locales de votación y barrios sumen la zona, que ningún territorio tenga votos de candidatos por encima de sus votos válidos y que a ninguno le falten totales.coletar_apuracao.py: el recolector de la noche de la elección (ver Desafíos técnicos).coletar_bu.py: boletines de urna, decodificados de ASN.1 conasn1toolsy la especificación oficial versionada enetl/spec/2026/bu.asn1, guardados entse.bu_secao.vigiar_abertos_2026.py: un monitor de los archivos de datos abiertos de 2026 que detecta nuevas publicaciones y dispara la carga por sí solo.
Programación. Seis unidades systemd de usuario versionadas en servidor/systemd/: un timer arranca el recolector diez minutos antes de que el TSE empiece a publicar, otro borra los datos de simulación antes del escrutinio real (el recolector se niega a escribir mientras haya una simulación marcada en la base de datos) y un tercero ejecuta el monitor cada 5 minutos de día y cada 30 de noche.
Trazabilidad. Cada carga registra inicio, fin, cantidad de filas, errores y un payload detalhe en tse.etl_execucao, incluida la lista de territorios que creó. La regla del proyecto es nunca borrar un territorio "vacío" por un criterio genérico, solo lo que la propia carga registró haber creado.
Next.js 16 con React 19 y TypeScript en el App Router: 18 páginas, 29 route handlers (20 en /api), 28 componentes y 26 módulos en lib/. Las dependencias de runtime son pocas: postgres (cliente de base de datos), d3-geo y topojson-client para el mapa, y server-only para mantener los módulos del servidor fuera de los bundles del cliente.
- Mapa en canvas. Las mallas del IBGE (TopoJSON, menor calidad) se convierten con
scripts/gerar_malhas.py, que cambia los códigos del IBGE por los del TSE y descarta lo que no tiene correspondencia. El sitio sirve 27 archivos por estado más regiones y estados (4.7 MB en total) y dibuja en canvas cond3-geo, leyendo los colores de los tokens CSS mediantegetComputedStylepara que el mismo mapa funcione en los temas claro y oscuro. - Respuestas compactas. La ruta
/api/territorioenvía los nombres de los campos una sola vez y un arreglo por fila, aplica gzip dentro del handler (el servidor de Next no comprime las rutas de API) y guarda el resultado en una caché en memoria con TTL de 6 horas para los años cerrados y de 60 segundos para 2026. - ISR en la ficha del candidato. Se regenera cada 10 minutos; las páginas que dependen del usuario (registros, enlaces, cuenta) son totalmente dinámicas.
- Escrutinio en vivo con polling que se cancela correctamente al cambiar de territorio y un marcador al estilo de transmisión televisiva.
- Rediseño visual (7 de oct.): una barra lateral que se abre al pasar el cursor y se fija con un clic, temas claro y oscuro mediante tokens, cuatro fuentes cargadas con
next/font(Newsreader para títulos, Source Sans 3 para texto y cifras tabulares, Martian Mono para los dígitos de la urna, Saira Condensed para el escenario del comparador), componentes compartidos (paneles sin sombra, un único encabezado de página) y movimiento guiado por los tokens--dur-*y--ease. - Exportación a PDF y CSV desde la propia pantalla, con el evento registrado mediante
sendBeacon.
| Pieza | Cómo |
|---|---|
| Servidor propio | Ubuntu, Python 3.14 en un venv, accesible solo por VPN (Tailscale). Ejecuta cargas, recolectores y timers systemd de usuario. También sirve una copia del sitio como servicio systemd en un puerto interno. |
| Base de datos | Supabase Postgres (plan Pro), esquema tse. Session pooler desde el servidor; transaction pooler desde Vercel con DB_PREPARE=0 y DB_MAX=10. |
| Sitio | Vercel, región gru1 (São Paulo), framework Next.js. vercel.json fija la región; poweredByHeader está desactivado. |
| Deploy al servidor | admin/deploy.sh: rsync, npm install, build con credenciales cargadas desde el entorno, reescritura de la unidad systemd y espera activa de HTTP 200. Si el build falla, el servicio no se reinicia. |
| Informes | Siete proyectos estáticos en Vercel, cada uno con un middleware.js de contraseña y un vercel.json que define noindex y no-store; desconectados de GitHub después del primer deploy. |
| Código | Repositorio privado en GitHub, una sola rama, commits pequeños en portugués. |
Lecciones aprendidas y registradas en el repositorio: procesos largos siempre bajo nohup con registro, porque las sesiones SSH se caen; nunca descomprimir un archivo grande en el /tmp del servidor (es RAM); como máximo 4 conexiones al TSE para los boletines, y nunca mientras el recolector del escrutinio está corriendo, porque el TSE responde 429.
06Seguridad
8 ataques considerados, 8 defensas en producción.
Saltarse la interfaz y hablar directo con la base o la API, con la clave pública en mano.
Leer las tablas directamente por la API pública de Supabase con la clave anon
RLS activado en todas las tablas del esquema y revoke all para anon y authenticated en tablas, funciones y secuencias; sin políticas, esos roles no leen nada. El sitio lee solo del lado del servidor, con la URL del pooler en una variable de entorno
Fuerza bruta, creación indebida de cuentas, restablecimiento de contraseña y robo de cuenta.
Seguir usando una sesión después de que se cambió la contraseña o se desactivó la cuenta
La versión del usuario forma parte de la cookie y aumenta en cada cambio de contraseña o desactivación; las páginas verifican en la base de datos que el usuario existe, está activo y tiene la misma versión
Fuerza bruta o enumeración de correos en el formulario de inicio de sesión
6 errores en 15 min bloquean por 15 min, por correo y por dirección; espera de 800 ms en cada error; correo inexistente y contraseña incorrecta muestran el mismo mensaje; contraseñas guardadas solo como scrypt (N=16384, sal de 16 bytes)
Quien ya tiene algún acceso intentando ganar más: volverse admin, leer lo que no debe, conservar un acceso revocado.
Usar un enlace de equipo para navegar todo el panel u otro candidato
Un código aleatorio de 18 bytes (144 bits) validado por regex antes de cualquier consulta a la base de datos; la cookie del enlace está firmada y vinculada a un candidato y un cargo; el middleware habilita solo la página de seguimiento, las fotos y las consultas de 2026 de ese candidato, parámetro por parámetro; todo lo demás recibe un 403; el marcador vuelve a verificar el enlace en la base de datos en cada actualización
CSRF, webhooks falsos, tokens reutilizados, enlaces firmados y redirección abierta.
Falsificar o alterar la cookie de sesión
Una cookie id.version.expiry.signature firmada con HMAC-SHA256 con un secreto de entorno y comparada con timingSafeEqual; httpOnly, sameSite=lax, secure en producción, 14 días
Enviar a la persona a otro sitio después del inicio de sesión (open redirect)
El parámetro de retorno solo se acepta si empieza con / y no con //; si no, la persona vuelve a la página de inicio
XSS, iframe, fórmulas en CSV, subidas disfrazadas y manipulación del prompt de la IA.
Inyectar SQL o parámetros inesperados en las rutas de API
Cada consulta pasa por los tagged templates de postgres.js (parametrizada); años, vueltas, cargos y niveles vienen de listas cerradas, y códigos e identificadores de expresiones regulares; cualquier otra cosa recibe un 400 antes de tocar la base de datos
Enumerar quién está en la base, raspar datos personales, vincular preguntas a personas, extraer secretos.
Filtrar números de contribuyente o de registro electoral a la base de publicación
Una regla del proyecto más un script de validación que verifica que ningún registro JSONB tenga esas claves, que ninguna columna del esquema tenga ese nombre y que anon no pueda ver el esquema
Perímetro. Todo el sitio exige inicio de sesión. proxy.ts (el middleware de Next) intercepta todo lo que no es un archivo estático y solo deja pasar una cookie de sesión válida o una cookie de enlace de equipo válida. Las rutas de API sin sesión responden 401 en JSON; las páginas redirigen a /entrar con el destino en volta=, que solo acepta rutas que empiezan con / y no con // (sin open redirect).
Sesiones. La cookie raiox_sessao lleva id.version.expiry.signature, firmada con HMAC-SHA256 con un secreto de entorno (SESSAO_SEGREDO) y comparada con timingSafeEqual. La verificación de la firma ocurre en el middleware sin tocar la base de datos; quién es el usuario, si sigue activo y si es administrador lo verifican las páginas contra la base de datos. La version forma parte de la cookie y aumenta cuando cambia la contraseña o se desactiva la cuenta, lo que invalida las sesiones abiertas. La cookie es httpOnly, sameSite=lax, secure en producción y válida por 14 días.
Contraseñas. Guardadas solo como hashes scrypt (N=16384, r=8, p=1, sal de 16 bytes, salida de 64 bytes), con la contraseña normalizada a NFKC antes del hash, mínimo de 8 caracteres. El script de línea de comandos que crea el primer administrador usa el mismo algoritmo.
Fuerza bruta en el inicio de sesión. Seis errores en 15 minutos bloquean por 15 minutos, contados por correo y por dirección; cada error espera 800 ms antes de responder; correo inexistente y contraseña incorrecta muestran el mismo mensaje (el motivo real va al registro). Los intentos bloqueados se registran como máximo una vez por minuto por clave, para que un bot no pueda inundar la tabla de registros.
Enlaces de seguimiento. El administrador crea un enlace por equipo (/l/<code>), con un código aleatorio de 18 bytes en base64url, una fecha de vencimiento y una etiqueta. Abrir el enlace graba una cookie separada (raiox_link), firmada de la misma forma y vinculada a un candidato y a un cargo. El middleware mantiene una allowlist explícita de lo que esa cookie habilita: la página /acompanhar, las fotos y solo las consultas que hace el escrutinio de ese candidato, con los parámetros verificados uno por uno (el sq tiene que ser el de ese candidato, el año tiene que ser 2026, el cargo tiene que coincidir). Cualquier otra ruta responde 403. El marcador vuelve a verificar el enlace en la base de datos en cada actualización, así que desactivarlo corta el acceso en segundos. Los códigos rechazados se registran como máximo 10 veces por hora por dirección.
Base de datos. Todas las tablas del esquema tse tienen RLS activado y revoke all para los roles anon y authenticated, al igual que las funciones y las secuencias; sin ninguna política, esos roles no leen nada a través de la API de Supabase. El sitio lee exclusivamente desde el servidor, con la URL del pooler en una variable de entorno, y usa los tagged templates del cliente postgres, que parametrizan cada consulta. En las rutas de API, los parámetros pasan por allowlists antes de llegar al SQL: años y cargos de listas cerradas, nivel de una lista cerrada, códigos e identificadores por expresión regular; cualquier otra cosa recibe un 400.
Datos personales (LGPD). Los números de contribuyente y de registro electoral nunca entran en Supabase: validar_candidaturas.py verifica que ningún registro JSONB contenga esas claves y que ninguna columna del esquema tenga ese nombre, y confirma que anon no puede ver el esquema. El registro de eventos guarda correo, IP y user agent para la auditoría del panel, nunca contraseñas. Las pruebas borran sus propios eventos al final.
Secretos. Las credenciales viven solo en variables de entorno (archivos .env fuera de git en el servidor; variables de Vercel, con las contraseñas marcadas como sensibles). El repositorio tiene una regla escrita de que ninguna contraseña va en un .md, en un mensaje de commit ni en el gestor de tareas.
Abuso de APIs internas. El endpoint que recibe eventos de actividad del navegador exige sesión, acepta solo rutas que empiezan con / y limita a 120 eventos por minuto por persona. Los informes estáticos están detrás de un middleware en el edge que compara la contraseña con la variable de entorno, graba una cookie httpOnly y Secure y devuelve 503 si falta la variable (fail closed).
Endurecimiento operativo. El recolector del escrutinio se niega a escribir en el entorno oficial mientras haya una simulación marcada en la base de datos. Las cargas se detienen ante una columna desconocida o un código nuevo del TSE. Escribir un registro nunca hace fallar la solicitud (los errores van solo a la consola). Los borrados en tablas grandes siempre usan la clave completa.
07Desafíos técnicos
Conciliar el territorio del TSE
El archivo de votos por sección y el de totales por sección a veces no coinciden sobre el local de votación de una sección (secciones agregadas, cambio de local entre vueltas, filas duplicadas). La regla adoptada: gana el local donde se registraron los votos, y los totales se emparejan fila por fila con casar_locais: primero los locales iguales en ambos archivos; si queda exactamente uno de cada lado, se emparejan; si no, el local cuya suma de votos es igual a los votos de los candidatos. Zonas y barrios no tienen contorno oficial, así que en el mapa son círculos en el centro de sus locales de votación, dentro del contorno de la ciudad; las coordenadas de los locales solo cuentan si caen dentro del rectángulo del IBGE del municipio. La validación después de cada carga es lo que permite bajar con seguridad hasta la sección.
Recolectar el escrutinio en vivo sin saturar al TSE ni quedar bloqueado
El recolector lee los archivos de estado del TSE y descarga solo lo que cambió, usando ETags (el TSE responde 304 cuando un archivo no cambió). Si el TSE rechaza (403, 429 o 503), todas las conexiones se pausan juntas y el ritmo baja, en lugar de reintentar archivo por archivo. Cada ronda tiene dos fases: país y estados primero (pocos archivos, el marcador se actualiza en segundos), ciudades después con un límite por ronda. Cada JSON nuevo se guarda en gzip para auditoría o reprocesamiento, y un modo --ensaio (ensayo) ejecuta todo contra el simulador oficial del TSE y deshace las escrituras. Aun así, en la noche de la elección el recolector declaró "completo" con ciudades faltantes; comparar la suma de las ciudades con el estado por cargo se volvió un paso obligatorio y documentado, junto con el procedimiento de nueva recolección.
Hacer rápido el explorador sobre decenas de millones de filas
La clave primaria de tse.resultado empieza por el código del territorio, las particiones son por nivel y las tablas se reordenan físicamente (CLUSTER) después de cada carga grande. Las funciones de lectura se ejecutan con un plan personalizado forzado porque el plan genérico no podaba particiones. En el sitio, las respuestas van en gzip y se guardan en caché en memoria con un TTL por año. Un caso concreto del historial: eleicoes_de, usada por la búsqueda de locales de votación, pasó de 47 segundos a 0.03 segundos al reescribirse para usar el índice.
Leer el boletín de urna
El TSE publica el bu.dat de cada urna en ASN.1 en cuanto lo recibe, antes del conteo oficial. La solución fue versionar la especificación oficial en el repositorio y decodificar con asn1tools en dos pasos (envoltorio genérico, luego el boletín), guardando los votos por cargo como JSONB. El límite de conexiones simultáneas al TSE (4) se aprendió por las malas, cuando 28 conexiones tumbaron una ronda del recolector del escrutinio.
08Resultados
Solo lo que el repositorio y su documentación comprueban:
| Medida | Valor | Fuente |
|---|---|---|
| Commits | 148 en 9 días (29 de sep. a 7 de oct. de 2026) | git log |
| Migraciones SQL | 26 archivos, 2,097 líneas | ls sql, wc -l |
| Territorios en el modelo | 700,822 | docs/MODELO.md (3 de oct.) |
Filas en tse.resultado |
13.0 millones reales | docs/MODELO.md (3 de oct.) |
| Urnas de 2026 por sección | 497,897 | CHANGELOG.md (Informe 4) |
| Tamaño de la base de datos | ~9.3 GB | docs/ESTADO-E-PLANO.md (7 de oct.) |
| Escrutinio de la primera vuelta | recolectado al 100% en la noche del 4 de oct. | CHANGELOG.md, docs/ESTADO-E-PLANO.md |
eleicoes_de |
47 s → 0.03 s | commit a479de9 |
| Informes publicados | 6 informes + 1 panel, PT/EN | relatorios/README.md |
- 148
- compromisos
- 9 días
- Período activo
- 26
- Migraciones SQL
- 2,097
- Líneas SQL
- 11
- funciones de base de datos activas
- 6
- particiones de resultados
- 0 (deny-all)
- Políticas de RLS
- 700,822
- territorios
- 13.0M
- filas de resultados
- 497,897
- urnas de 2026
- ~9.3 GB
- base de datos
- 18
- páginas
- 29 (20 en /api)
- route handlers
- 28
- Componentes React
- 26
- Scripts ETL en Python
- 6 (3 timers, 3 services)
- unidades systemd
- 27 estados + regiones + estados, 4.7 MB
- mallas del mapa
- 9,328
- Líneas de TypeScript/TSX
- 6,259
- Líneas de Python
- 6 + 1 panel
- informes publicados
cómo lo medimos
git log --oneline wc -l
cómo lo medimos
git log: primer commit 2026-09-29, último 2026-10-07
cómo lo medimos
ls sql/*.sql
cómo lo medimos
wc -l sql/*.sql
cómo lo medimos
create function en sql/ menos las eliminadas en sql/011_corte.sql
cómo lo medimos
sql/009_territorio.sql (partition by list (nivel))
cómo lo medimos
grep 'create policy' sql/ = 0; RLS activado + revoke all en todas las tablas (sql/001, 009, 012…)
cómo lo medimos
docs/MODELO.md, tabla tse.territorio (3 de oct.)
cómo lo medimos
docs/MODELO.md, filas reales de tse.resultado (3 de oct.)
cómo lo medimos
CHANGELOG.md, base del Informe 4
cómo lo medimos
docs/ESTADO-E-PLANO.md (7 de oct.)
cómo lo medimos
git ls-files admin/src/app/**/page.tsx
cómo lo medimos
git ls-files admin/src/app/**/route.ts
cómo lo medimos
git ls-files admin/src/components
cómo lo medimos
git ls-files etl/*.py (sin etl/legado)
cómo lo medimos
servidor/systemd/
cómo lo medimos
ls admin/public/geo; du -sh
cómo lo medimos
wc -l sobre git ls-files '*.ts' '*.tsx'
cómo lo medimos
wc -l sobre git ls-files '*.py'
cómo lo medimos
relatorios/README.md
09Línea de tiempo
- 29 sep 2026
Estructura del proyecto, descargador reanudable de los datos abiertos del TSE, DDL del esquema y carga de 20,062 candidaturas; primer sitio con búsqueda y ficha del candidato
- 30 sep 2026
Cambio de rumbo hacia el desempeño territorial, sin inferencia de perfil de votantes; modelo unificado del país a la sección, mallas del IBGE con códigos del TSE y recorte del alcance de la base de datos
- 01 oct 2026
Vista previa privada en Vercel, comparación de la segunda vuelta, comparar candidatos, buscar locales de votación y abstención por edad
- 02 oct 2026
Inicio de sesión por usuario, escrutinio en vivo y el recolector ensayado contra el simulador del TSE y programado con timers systemd
- 03 oct 2026
Enlaces de seguimiento por equipo, registros del administrador y la revisión para móviles
- 04 oct 2026
Día de la elección; escrutinio recolectado, boletines de urna decodificados de ASN.1, 2018 cargado y primer informe publicado
- oct 2026
5–6 de oct.: 2026 por sección en la base de datos, informe final en la ficha del candidato, monitor de datos abiertos, pestaña Abstención, eleicoes_de de 47 s a 0.03 s e informes 2 a 5
- 07 oct 2026
Rediseño visual (barra lateral, tipografía, componentes, páginas) integrado y publicado; informe 6
10Stack
- Next.js 16 (App Router, SSR, ISR)
- React 19
- TypeScript 5
- CSS com tokens (tema claro/escuro)
- next/font (Newsreader, Source Sans 3, Martian Mono, Saira Condensed)
- d3-geo + topojson-client em canvas
- Web Audio API
- Route handlers do Next.js (20 rotas /api)
- postgres.js (tagged templates)
- gzip no handler
- cache em memória com TTL
- server-only
- PostgreSQL (Supabase), schema tse
- 26 migrations SQL
- tabela particionada por nível (6 partições)
- funções plpgsql com force_custom_plan
- Python 3.14 (psycopg 3, DuckDB, asn1tools)
- CSV/JSON do TSE
- malhas TopoJSON do IBGE
- Parquet e binários compactos para os painéis
- Servidor Linux próprio (Ubuntu) via VPN
- systemd timers e serviços de usuário
- Vercel (gru1, transaction pooler)
- GitHub privado
- Chromium headless para capturas e PDFs
- Cookie HMAC-SHA256 com timingSafeEqual
- scrypt (N=16384)
- versão de sessão
- bloqueio por e-mail e IP
- allowlist de rotas para links de equipe
- RLS + revoke em todo o schema
- allowlist de parâmetros nas APIs
- logs de auditoria
- segredos só em ambiente
- checagem automática de ausência de CPF/título
11Ficha técnica
- type
- plataforma de datos + panel electoral en vivo
- stack
- Next.js 16 · React 19 · TypeScript · Python 3.14
- db
- Postgres (Supabase) · 6 particiones · RLS deny-all
- etl
- psycopg 3 · DuckDB · asn1tools · timers systemd
- auth
- Cookie HMAC-SHA256 · scrypt · enlaces de equipo
- deploy
- Vercel gru1 + servidor Linux propio
- modules
- ficha del candidato · explorador · escrutinio en vivo · comparar · abstención · registros
- status
- Completado
Registros nacionales de creadores, contador público resistente a la manipulación y administración protegida contra fuerza bruta.
Movilización de voluntariado con plazo electoral y una audiencia adversarial: las reglas residen en la base de datos.
Plataforma de la campaña contra la jornada 6x1: registros nacionales, red de voluntariado y siete capas contra bots.
¿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.