P-07
Alicerce
Registros, voluntariado y CRM de movilización en una misma base, con permisos definidos en Postgres.
cliente████Precampaña estatal para una elección mayoritaria
Plataforma digital de una precampaña estatal: páginas públicas de apoyo, portal de activistas con enlaces de recomendación y clasificación, y un panel de administración con CRM. Cada persona se unifica en un perfil por teléfono. El sistema registra recorridos por página y cambios de campos, calcula la puntuación de contactos a partir de eventos y mide el embudo por página y UTM. La lógica reside en funciones y triggers de Postgres, con RLS en todas las tablas, registro público mediante una Edge Function con CAPTCHA, límites en el inicio de sesión y protección contra borrados masivos. Estuvo en producción unos diez meses.
- supabase
- postgres
- rls
- edge
- react
- pwa
- crm
- anti-bot
- rate-limiting
- lgpd
01Sinopsis
Alicerce es la plataforma digital de un precampaña en todo el estado para un importante cargo electo. Reúne tres cosas que generalmente viven en herramientas separadas: las páginas públicas donde las personas declaran apoyo, un portal donde los voluntarios rastrean sus referencias y descargan materiales, y un panel de administración que funciona como CRM de la campaña.
Los visitantes completan un breve formulario y se convierten en partidarios. Aquellos que quieran hacer más se inscriben como activistas y obtienen un inicio de sesión, un enlace de referencia personal, materiales de divulgación y un lugar en la tabla de clasificación. El equipo de coordinación utiliza el panel para ver de dónde proviene cada registro, fusionar a la misma persona en muchas páginas, calificar el compromiso de cada contacto y enviar correos electrónicos segmentados.
El sistema funcionó en producción durante unos diez meses (de diciembre de 2025 a septiembre de 2026), con varias oleadas de páginas temáticas, eventos y encuentros en línea. En el tramo final, la página de inicio comenzó a redireccionar al sitio web oficial de la campaña y Alicerce se quedó como el back office: registros del nuevo sitio siguió fluyendo en el mismo CRM a través de un API autenticado.
02El problema
- Una persona, diez lugares. Cada página temática, evento o ayuntamiento tenía su propia forma y su propia mesa. Sin una clave compartida, nadie podía decir cuántas personas reales tenía la campaña, o cómo era el viaje de cada uno.
- No todo el apoyo es igual. Alguien que se inscribió una vez no es lo mismo que alguien que asistió a tres eventos y trajo a diez personas. El equipo necesitaba priorizar contactos sin hojas de cálculo hand-built.
- Reconocimiento. Saber si un registro provenía de un enlace de un activista, un código QR impreso, un correo electrónico o una red social UTM, y dónde cada página estaba perdiendo personas en el camino.
- Forma pública, lista valiosa. Una lista de contactos de campaña atrae bots, registros falso e intenta leer o eliminar en bloque. También son datos personales bajo la ley de protección de datos de Brasil (LGPD).
- ritmo de campaña. Nuevas páginas cada semana, reglas cambiantes, un equipo pequeño y gran parte de la base de código generada con un creador de aplicaciones AI-assisted, con cientos de migraciones acumuladas.
03La solución
- Captura pública: Un formulario ligero con un combobox municipal (lista oficial IBGE), un CAPTCHA Turnstile, una pantalla de éxito que ofrece tres pasos siguientes (compartir, convertirse en activista, unirse al canal de mensajería) y páginas de destino temáticas con sus propios formularios.
- Área activista (PWA instalable): enlace de referencia con código QR, plantillas de mensajes preparadas, una galería de materiales, la posición de la tabla de clasificación del activista y los 10 primeros.
- Gamificación en el panel: distribución de niveles, clasificaciones por estado y ciudad, los mejores activistas del día y una tabla de clasificación racha diaria.
- Onboarding activista: los registros directos se aprueban in situ, con una cuenta aprovisionada y un correo electrónico de activación enviado; las solicitudes procedentes de la página de éxito del seguidor aterrizan en una cola de aprobación.
- CRM con perfil único: cada persona se convierte en un perfil codificado por el número de teléfono normalizado, con un viaje de registros por página y un historial de cada cambio de campo (nombre, correo electrónico, estado, ciudad, vecindario, código postal).
- Puntuación de contactos: una puntuación sumada de un catálogo configurable de acciones, con bandas de "temperatura", puntos automáticos para cada registro de página y para cada referencia recibida, y la importación de CSV restringida a acciones externas (correo electrónico, mensajería, redes sociales). Las causas marcadas como sensibles entran en un flujo de atención y nunca se califican.
- Seguimiento de adquisición: un constructor de cinco dimensiones UTM, un origen por registro y un embudo por página y por UTM (visita inicio envío), incluida la atribución de tráfico externo.
- Panel de administración: 20 pantallas, incluyendo KPIs con un mapa coroplético de Brasil y desglose por ciudad para el estado de enfoque, partidario y gestión activista, una tabla de clasificación de referencia con análisis de Pareto, campañas de correo electrónico programadas con métricas, eventos, peticiones, cumpleaños e informes PDF.
- Modo de privacidad: un conmutador de encabezado (administrador y activista) que difumina los nombres y números en la pantalla, por lo que el panel se puede presentar en una reunión o compartido en pantalla sin exponer datos.
- Perfil único por número de teléfono: una función de ingestión en la base de datos alimentada por disparadores y rellenos idempotentes, con un recorrido por página y un historial field-level.
- Event-sourced Lead Score, deduplicado por un índice único parcial, con causas sensibles mantenidas fuera de la puntuación.
- Público registro solo a través de una función de borde con Turnstile y una lista blanca de columnas; INSERT anónimo revocado en la tabla.
- Inicie sesión a través de una función perimetral limitada a errores 5 por IP y 8 por correo electrónico durante minutos 2, con IP almacenadas solo como hashes.
- Auditoría de instantáneas de cada eliminación y un desencadenador que bloquea cualquier DELETE de más de 5 partidarios por declaración.
- Migraciones 221, tablas 67 y directivas 177 RLS; funciones de borde 38; rutas cargadas perezosamente 49.
04Arquitectura
Leer el diagrama como lista (15 componentes, 14 conexiones)
Componentes
- Clientes: Páginas de destino públicas<br>formulario ligero + páginas temáticas, Área de activistas<br>(PWA), Panel de administración<br>CRM + informes
- Funciones de borde (Deno) 38: inicio de sesión<br>límite de solicitudes por IP + correo, submit-form<br>CAPTCHA + lista de permitidos, activación<br>enlace firmado con HMAC, webhooks de entrada<br>secreto · Svix
- Postgres · RLS: simpatizantes<br>auditoría + bloqueo de DELETE, perfil unificado<br>crm_ingest, Puntuación de plomo, embudo<br>LPs UTMs page_events
- Supabase: Auth<br>correo + contraseña, PostgREST + RPCs<br>is_admin / has_role, PG
Conexiones
- Clientes → SPA estática<br>Vite + Servicio Worker<br>Cloudflare Turnstile
- SPA estática<br>Vite + Servicio Worker<br>Cloudflare Turnstile → inicio de sesión<br>límite de solicitudes por IP + correo
- SPA estática<br>Vite + Servicio Worker<br>Cloudflare Turnstile → submit-form<br>CAPTCHA + lista de permitidos
- SPA estática<br>Vite + Servicio Worker<br>Cloudflare Turnstile → PostgREST + RPCs<br>is_admin / has_role (JWT del usuario)
- inicio de sesión<br>límite de solicitudes por IP + correo → Auth<br>correo + contraseña
- activación<br>enlace firmado con HMAC → Auth<br>correo + contraseña
- submit-form<br>CAPTCHA + lista de permitidos → simpatizantes<br>auditoría + bloqueo de DELETE (Rol de servicio)
- PostgREST + RPCs<br>is_admin / has_role → embudo<br>LPs UTMs page_events
- PostgREST + RPCs<br>is_admin / has_role → perfil unificado<br>crm_ingest
- simpatizantes<br>auditoría + bloqueo de DELETE → perfil unificado<br>crm_ingest (disparador)
- perfil unificado<br>crm_ingest → Puntuación de plomo (disparador)
- Resend n8n GA4<br>formularios externos → webhooks de entrada<br>secreto · Svix (webhook autenticado)
- webhooks de entrada<br>secreto · Svix → simpatizantes<br>auditoría + bloqueo de DELETE
- PG → Resend n8n GA4<br>formularios externos (pg_net / correo electrónico / GA4)
El frontend es un SPA React que sirve como archivos estáticos, sin servidor propio. Cualquier cosa que necesite privilegios pasa por una de las funciones de borde de Deno 38 o por Postgres SECURITY DEFINER funciones llamadas RPCs. La base de datos es la fuente de la verdad: la fusión del perfil y la puntuación ocurren en los disparadores, no en el cliente, por lo que cada punto de entrada (los propios formularios del sitio, el webhook del chatbot, el API del sitio externo, las importaciones) produce el mismo resultado.
05Por dentro
- Migraciones versionadas de 221, Tablas 67 en el esquema público (por los tipos generados), 177
CREATE POLICYdeclaraciones y Disparadores distintos 33. - Roles en su propia mesa:
user_rolescon elapp_roleEnum y aSECURITY DEFINERhas_role()función; los roles nunca se almacenan en el perfil de usuario. - Una sola vía de ingestión (
crm_ingest), llamado por disparadores ensupportersy en la tabla event-forms, y mediante funciones de relleno idempotente para datos históricos (incluidos lotes de conjuntos de claves para la tabla más grande). Normaliza el teléfono, encuentra o crea el perfil, registra cada campo cambiado en el historial y registra el evento del viaje bajoUNIQUE (profile_id, form_slug), por lo que hay un registro por persona por página incluso si se reprocesa el mismo registro. - Event-sourced Lead Puntuación: La puntuación es la suma de
crm_score_events. Eventos automáticos llevansource='auto'y asource_ref; un índice único parcial sobre(action_slug, source_ref)evita anotar el mismo registro o referencia dos veces, mientras que los eventos importado desde CSV dedupe por persona, acción y día (en la hora de So Paulo). - Canal de página:
page_eventsacepta eventos anónimos de clientes y unBEFORE INSERTtrigger resuelve la página y el UTM; lee son solo para administradores y expuesto a través del agregado RPCs (get_funnel_overview,get_funnel_detail,get_utm_funnel). - Del lado del servidor paginado RPCs para las listas grandes (perfiles, seguidores, CRM consolidado), con filtrado y clasificación en Postgres, además de un ayudante de frontend que las páginas con
.range()cuando se necesita la mesa completa más allá del límite de filas de PostgREST. - Integraciones a través de funciones de borde: correo electrónico transaccional y de campaña a través de Resend (con un webhook de eventos y sincronización de métricas), automatizaciones n8n, un chatbot de mensajería, Google Analytics 4 (histórico y en tiempo real), un proxy código postal e ingestión de eventos y formularios externos.
- Empleos:
pg_cronpara la limpieza diaria email-log ypg_netpara reenviar event-page registros a un punto final externo de forma asíncrona, sin bloquear o fallar elINSERTSi el objetivo está abajo.
- React 18 + TypeScript + Vite (SWC), CSS Tailwind con tokens semánticos HSL y componentes shadcn/ui en la parte superior de Radix.
- Rutas de 49 con
react-router-domy 40 páginas cargadas perezosamente (lazy+Suspense), manteniendo el peso del panel de administración fuera de la página pública. - Consulta de TanStack para el estado del servidor,
react-hook-form+zodpara las formas, los diagramas yreact-simple-mapspara gráficos y mapas, jsPDF + html2canvas para informes. - PWA vía
vite-plugin-pwa: instalable, auto-updating, con HTML servido network-first por lo que una nueva versión entra en vigor sin una actualización dura. - Accesibilidad y LGPD en la IU: un widget de accesibilidad, un banner de consentimiento y una política de privacidad publicada.
- Dos capas de enmascaramiento de datos: funciones de enmascaramiento puras (nombre, correo electrónico, teléfono) y modo de privacidad, aplicadas a través de un
<body>Atributo y reglas CSS.
- Frontend publicado como archivos estáticos a través de la implementación continua desde la rama principal, con una ruta alternativa (
_redirects) los enlaces tan profundos funcionan. - Totalmente administrado en Supabase: Postgres, Auth, almacenamiento y funciones de borde.
- Cloudflare Turnstile como CAPTCHA en registro e inicio de sesión.
- Las redirecciones de dominio manejadas dentro del SPA, preservando las cadenas de consulta UTM, cuando el tráfico público se trasladó al sitio web oficial.
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.
Bot mass-signing directamente a través del REST API, saltando el CAPTCHA
INSERT anónimo revocado en la tabla de partidarios; la única ruta pública es una función de borde que verifica Turnstile del lado del servidor
Fuerza bruta, creación indebida de cuentas, restablecimiento de contraseña y robo de cuenta.
Contraseña fuerza bruta en el administrador o activista login
Inicie sesión a través de una función Edge con Turnstile, con errores de 5 por IP y 8 por correo electrónico en 2 minutos; 429 con Retry-After; IP almacenada solo como un hash
Quien ya tiene algún acceso intentando ganar más: volverse admin, leer lo que no debe, conservar un acceso revocado.
Un usuario habitual que lee el CRM o llama al panel RPCs
RLS con solo para administradores lee, escribe solo a través de las funciones SECURITY DEFINER, RPCs protegido por is_admin() sin EXECUTE para anon; roles en una tabla separada
CSRF, webhooks falsos, tokens reutilizados, enlaces firmados y redirección abierta.
Forjar eventos en el webhook del proveedor de correo electrónico
Firma Svix verificada antes de analizar el cuerpo; otros webhooks requieren un secreto per-integration
Abusar del enlace de clic de correo electrónico como una redirección abierta para phishing
Redirigir solo a hosts permitidos
Crear un enlace de activación de cuenta para otro usuario
uid firmado con HMAC-SHA256 y la firma recalculada del lado del servidor antes de conceder el acceso
Alterar conteos, borrar la base, editar el historial o negar lo que fue autorizado.
Enviar columnas adicionales en registro para falsificar referencias o banderas
La fila se construye a partir de una lista blanca de columnas dentro de la función Edge.
Limpiar la lista de seguidores con una cuenta comprometida
Un disparador a nivel de sentencia bloquea las filas DELETE por encima de 5; un disparador ANTES de DELETE almacena una instantánea completa y el actor en una tabla que ningún cliente puede escribir
Autenticación
- Los inicios de sesión de los administradores y activistas nunca llegan directamente a Auth: pasan por el
loginEdge Function, que comprueba Turnstile y limita los errores por IP (5) y por correo electrónico (8) dentro de una ventana de minutos 2429conRetry-After. El IP se almacena solo como un hash SHA-256 enlogin_attempts. - Política de contraseña (al menos caracteres 8, una letra mayúscula y un dígito) con una lista de verificación en vivo en la interfaz de usuario.
- Activación de la cuenta a través de un enlace cuyo
uidestá firmado con HMAC-SHA256; la función de activación recomputa la firma antes de conceder acceso.
Autorización y RLS
- RLS habilitado en todas las tablas del esquema público, con
GRANTs toauthenticatedyservice_roleen la misma migración que crea la tabla. - Las tablas CRM son legibles solo por los administradores y Escribible sólo a través de
SECURITY DEFINERfunciones; funciones internas (normalización, mapeo de origen, disparadores) tienenEXECUTErevocado deanonyauthenticated. - El panel RPCs está protegido por
is_admin(auth.uid())y tienenEXECUTErevocado deanon. - Los activistas ven datos completos solo para los partidarios a los que se refieren; la tabla de clasificación pública lee una vista que solo expone el nombre, el código de referencia y el recuento de referencias.
Superficie anónima
- Anónimo directo
INSERTen la mesa de los partidarios fue revocada. La única ruta pública registro es lasubmit-formEdge Function, que verifica Turnstile, valida el mínimo del lado del servidor y construye la fila a partir de un columna lista blanca, por lo que los campos como códigos de referencia o banderas no se pueden establecer a través de la API. - Las funciones de búsqueda pública (existencia de correo electrónico, código de referencia) devuelven lo mínimo y nunca exponen nombres o roles.
Integraciones
- El webhook Resend se verifica con su firma Svix antes El cuerpo es analizado.
- La automatización, el chatbot y los webhooks external-ingestion requieren cada uno su propio encabezado secreto.
- El seguimiento de clics por correo electrónico solo redirige a los hosts permitidos, cerrando la redirección abierta.
Proteger la lista
- A
BEFORE DELETEtrigger almacena una instantánea completa de cada partidario eliminado, con quién lo eliminó, su función, la dirección del cliente y el nombre de la aplicación, en una tabla que solo los administradores pueden leer y ningún cliente puede escribir. - Un disparador a nivel de sentencia Bloquear cualquier
DELETEde más de 5 partidarios a la vez a menos que la sesión establezca explícitamente una bandera administrativa. - La eliminación de la cuenta Autoservicio se ha deshabilitado desde el incidente descrito a continuación, en espera de una revisión de ese flujo.
LGPD
- Banner de consentimiento, política de privacidad publicada, IP hash, enmascaramiento en pantalla de datos confidenciales y un aviso de monitoreo en las pantallas de inicio de sesión.
07Desafíos técnicos
La fusión de la misma persona de muchas fuentes
El número de teléfono era la única clave presente en casi todas las formas, pero llegó en muchos formatos. Descubrimos que el ayudante heredado de "solo dígitos" también despojó al personaje de su identidad. 0, lo que habría hecho que diferentes números chocaran. La solución fue un nuevo normalizador construido en regexp_replace que deja caer el 55 código de país, una única ruta de ingestión de en la base de datos compartida por los disparadores y rellenos de en tiempo real, y la regla de que el perfil mantiene su página de origen más antigua mientras que cada registro posterior se convierte en un evento de viaje más una entrada de field-history.
Un índice que rompió la forma pública
El relleno necesario para hacer coincidir a los partidarios con los perfiles por teléfono, por lo que un índice funcional en crm_digits(whatsapp) fue añadido. En la misma migración, como buena práctica, EXECUTE Esta función fue revocada de anon. En la producción, la forma pública comenzó a fallar con permission denied for function: Postgres evalúa una expresión de índice con los privilegios de quien ejecuta la INSERTNo el propietario de la función. La revisión concedida EXECUTE de vuelta para esa función pura, documentó por qué en la migración y la convirtió en una regla en la guía del proyecto.
Una eliminación masiva y la recuperación
En abril 2026 la lista de partidarios sufrió una eliminación masiva. La respuesta llegó en capas: primero una tabla de auditoría con instantáneas completas escritas por un disparador, luego restaurando las filas de esas instantáneas (jsonb_populate_record con ON CONFLICT DO NOTHING), un desencadenador a nivel de sentencia que bloquea las filas 5 superiores y desactiva la eliminación de la cuenta self-service hasta una revisión adicional.
Cierre de la puerta trasera registro
Un CAPTCHA front-end no protege nada si la tabla acepta anónimo INSERTs a través del REST API. Registro se movió a una función de borde que verifica Turnstile y filtra columnas, y una vez que el frontend estaba en esa ruta, el anon INSERT La subvención fue revocada. Turnstile fue diseñado para fallar abierto solo mientras su secreto aún no estaba configurado, y cerrado a partir de entonces.
08Resultados
- Unos diez meses en producción, desde diciembre 2025 hasta septiembre 2026.
- Commits 1,847, migraciones 221, tablas 67, funciones de borde 38 y rutas 49.
- La capa CRM se envió como una serie de solicitudes de extracción 28 durante cinco días: perfil único, puntaje de plomo manual y automático, embudo UTM, mapa geográfico y el endurecimiento del público registro.
- Cuando el tráfico público se trasladó al sitio web oficial, Alicerce siguió recibiendo el registros del nuevo sitio a través de un API autenticado, sin pérdida de historial ni puntajes.
- 1,847
- compromisos
- 10 meses
- Tiempo en producción
- 221
- Migraciones
- 67
- cuadros
- 177
- Políticas de RLS
- 38
- funciones de borde
- 49
- rutas
- ~65k
- Líneas de código
cómo lo medimos
git rev-list --cuenta la cabeza
cómo lo medimos
git log: primer compromiso de producto en 2025-12-15, último en 2026-09-28
cómo lo medimos
es supabase/migrations wc -l
cómo lo medimos
claves de public.Tables en src/integrations/supabase/types.ts (tipos generados)
cómo lo medimos
recuento de 'POLTICA DE CREACIN' en supabase/migrations/*.sql (declaraciones, incluida la recreaciones)
cómo lo medimos
es supabase/functions wc -l
cómo lo medimos
cuenta de Route en src/App.tsx
cómo lo medimos
Líneas no vacío en archivos rastreados: TSX 34,434, TS 10,350 (6,987 de ellos en funciones perimetrales), SQL 13,300; tipos generados excluidos (cloc no disponible)
09Línea de tiempo
- dic 2025
Primera versión: landing page pública y embudo gamificado registro
- ene 2026
Área de activistas, tabla de clasificación de referencias y marketing por correo electrónico; 635 se compromete ese mes
- feb 2026
PWA instalable y políticas RLS ajustadas
- mar 2026
El inicio de sesión se movió detrás de una función de borde con límite de solicitudes
- abr 2026
Auditoría de eliminación, restauración de listas y protección contra la masa DELETE
- jul 2026
Movilización CRM en 28 PRs: perfil único, puntuación de clientes potenciales, embudo UTM, mapa y Turnstile en registro e inicio de sesión
- ago 2026
El tráfico público se traslada al sitio oficial; el CRM comienza a recibir su registros a través de API
- sep 2026
ltima confirmación: final redirecciona al sitio oficial
10Stack
- React 18
- TypeScript 5
- Vite 5 (SWC)
- Tailwind CSS 3
- shadcn/ui (Radix)
- TanStack Query 5
- React Router 6
- react-hook-form + zod
- Recharts
- react-simple-maps
- vite-plugin-pwa
- Supabase Edge Functions (Deno)
- Supabase Auth
- PL/pgSQL SECURITY DEFINER
- PostgREST
- Resend
- n8n
- Google Analytics 4 Data API
- PostgreSQL (Supabase)
- Row Level Security
- pg_cron
- pg_net
- Supabase Storage
- Hospedagem estática com deploy contínuo via GitHub
- Supabase gerenciado
- Cloudflare Turnstile
- Rate limiting de login no banco
- HMAC-SHA256
- Verificação de assinatura Svix
- Auditoria por trigger
- Allowlist de redirecionamento
11Ficha técnica
- type
- movilización CRM + PWA
- stack
- React 18 · Vite · TypeScript
- db
- Postgres 67 tablas RLS
- auth
- Supabase Auth con límite de solicitudes inicio de sesión
- edge
- Funciones de borde 38 (Deno)
- anti-bot
- Cloudflare Turnstile
- modules
- páginas de destino activista CRM puntuación principal embudo
- status
- 10 meses en producción
Registros, activistas y CRM en una base: un perfil por persona y puntuación controlada por Postgres.
Plataforma de la campaña contra la jornada 6x1: registros nacionales, red de voluntariado y siete capas contra bots.
Registros públicos, red de recomendaciones y CRM en una base que limita el acceso con la clave pública.
¿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.