P-12
CRM Eleitoral Dimas Gadelha
Investigación de campo, atención al público y relaciones con la ciudadanía en un sistema con permisos en la base de datos.
clienteOficina del representante estatal Dimas Gadelha
Plataforma para la oficina de Dimas Gadelha que reúne un sitio público, formularios de campo, un área de voluntariado y un panel de gestión. Postgres puntúa y clasifica automáticamente las encuestas, permite seguirlas por territorio y equipo y genera información para un informe ejecutivo en PDF. Funciona en Cloudflare Workers con Supabase, RLS en las 18 tablas y un rol de acceso mínimo que genera el informe sin consultar formularios individuales.
- cloudflare
- supabase
- postgres
- rls
- lgpd
- react
01Sinopsis
CRM Eleitoral Dimas Gadelha es la plataforma digital de la oficina del representante estatal Dimas Gadelha. Un sistema cubre el sitio web público, los equipos de campo de formularios usan en la calle, un área para voluntarios y un panel de gestión para el equipo de coordinación. Todos los que llegan a la oficina, ya sea a través del sitio, en un servicio presencial del vecindario o en una entrevista de encuesta de campo, se convierten en un registro organizado con una fuente, un territorio y una historia.
La investigación de campo es el núcleo. Los entrevistadores llenan un formulario estandarizado en sus teléfonos; la base de datos puntúa cada formulario por sí sola y lo coloca en niveles configurables; los coordinadores siguen todo por vecindario, municipio y equipo, y emiten un informe ejecutivo en PDF con un solo clic.
02El problema
- Contactos dispersos. El sitio web registros, las listas de servicios callejeros y una base de contactos institucionales más antigua vivían en diferentes lugares sin deduplicación.
- Investigación de campo en papel u hojas de cálculo. Sin preguntas estándar, sin clasificación, sin forma de cruzar respuestas con el territorio o con el equipo que dirigió la entrevista.
- Datos personales sensibles. Opinión política, religión y números de teléfono: LGPD (GDPR de Brasil) debe tomarse en serio, con prueba de consentimiento y acceso a least-privilege.
- Audiencias con niveles de confianza muy diferentes. Formularios abiertos a cualquier persona, voluntarios autenticados, coordinadores con acceso completo y personas que solo necesitan un informe agregado.
03La solución
- Sitio público y seguidor registro en pasos, con un enlace de referencia por voluntario.
- Servicio Atención presencial: un formulario de calle que reconoce el número de teléfono tal como se escribe, muestra si esta es la primera o la enésima visita, y acepta una visita con fecha anterior para los formularios en papel ingresados más adelante. Un perfil por teléfono normalizado, una fila por visita.
- Formulario de encuesta de campo: un cuestionario estandarizado con un bloque de equipo (coordinador y entrevistador), ciudad de la lista oficial del municipio, autocompletado del vecindario y un consentimiento LGPD versionado.
- Puntuación automática: Pesos per-answer, niveles de clasificación y perfil del entrevistador, todos configurables por coordinadores, con cada cambio versionado y auditado.
- Panel de coordinación: KPIs y gráficos, una tabla de registros con búsqueda y filtros por nivel, vecindario y equipo (multi-select), exportación de CSV que honra los filtros activos, mapa de calor agrupado, coroplético por municipio y vecindario cruzado con clasificación, cumpleaños, aprobación de voluntarios y gestión de roles.
- Informe ejecutivo PDF, generado en el navegador, disponible desde el panel y desde una ruta dedicada para un rol de acceso mínimo.
- Área de Voluntarios: tablero personal, clasificación, niveles por número de referencias y materiales de divulgación.
- RLS en todas las tablas 18; roles en su propia tabla, verificados por has_role con EXECUTE revocado de anon.
- Un rol de 'relatorio' sin política de lectura: el PDF proviene de un column-scoped SECURITY DEFINER RPC con el teléfono enmascarado.
- La puntuación de la encuesta se calcula mediante un activador, con una configuración versionada y una pista de auditoría before/after.
- El consentimiento de LGPD se aplica en tres capas (Zod, servidor y una base de datos CHECK), con la versión de texto de consentimiento grabada.
- El cliente service_role se limita a archivos .server.ts o importaciones dinámicas dentro del controlador.
- Las agregaciones de paneles y mapas territoriales se realizan en Postgres, no en el navegador.
04Arquitectura
Leer el diagrama como lista (18 componentes, 21 conexiones)
Componentes
- Clientes: Público<br>página de destino · registro, Equipos de campo<br>formularios de captación<br>atención presencial con dispositivos móviles, Voluntariado<br>área autenticada · clasificación, Coordinación<br>panel de administración, rol relatorio<br>solo genera el PDF
- Cloudflare Workers: Inicio de TanStack SSR<br>React 19, createServerFn<br>Zod en cada entrada, requireSupabaseAuth<br>JWT mediante getClaims
- Postgres: 18 tablas<br>RLS en todas, 39 funciones SECURITY DEFINER<br>has_role · agregaciones, Puntuación con versiones<br>trigger + auditoría
- Supabase: Auth<br>correo/contraseña + OAuth, PostgREST<br>clave publicable, 7 Edge Functions<br>aprobación · correo · cuenta, PG
Conexiones
- Público<br>página de destino · registro → Inicio de TanStack SSR<br>React 19
- Equipos de campo<br>formularios de captación<br>atención presencial con dispositivos móviles → Inicio de TanStack SSR<br>React 19
- Voluntariado<br>área autenticada · clasificación → Inicio de TanStack SSR<br>React 19
- Coordinación<br>panel de administración → Inicio de TanStack SSR<br>React 19
- rol relatorio<br>solo genera el PDF → Inicio de TanStack SSR<br>React 19
- Inicio de TanStack SSR<br>React 19 → createServerFn<br>Zod en cada entrada
- createServerFn<br>Zod en cada entrada → 18 tablas<br>RLS en todas (formularios públicos<br>service_role solo en el servidor)
- createServerFn<br>Zod en cada entrada → requireSupabaseAuth<br>JWT mediante getClaims
- requireSupabaseAuth<br>JWT mediante getClaims → PostgREST<br>clave publicable (token del usuario)
- Voluntariado<br>área autenticada · clasificación → Auth<br>correo/contraseña + OAuth
- Coordinación<br>panel de administración → Auth<br>correo/contraseña + OAuth
- rol relatorio<br>solo genera el PDF → Auth<br>correo/contraseña + OAuth
- PostgREST<br>clave publicable → 18 tablas<br>RLS en todas
- PostgREST<br>clave publicable → 39 funciones SECURITY DEFINER<br>has_role · agregaciones
- 39 funciones SECURITY DEFINER<br>has_role · agregaciones → Puntuación con versiones<br>trigger + auditoría
- 7 Edge Functions<br>aprobación · correo · cuenta → Auth<br>correo/contraseña + OAuth
- 7 Edge Functions<br>aprobación · correo · cuenta → Resend<br>correo transaccional
- Coordinación<br>panel de administración → IBGE<br>límites y municipios
- createServerFn<br>Zod en cada entrada → Nominatim / OSM<br>geocodificación en caché
- rol relatorio<br>solo genera el PDF → jsPDF<br>informe en el navegador
- Coordinación<br>panel de administración → jsPDF<br>informe en el navegador
Una sola aplicación TanStack Start se ejecuta en Cloudflare Workers, con funciones SSR y servidor mecanografiado (createServerFn) el cliente llama como RPC. Toda la nueva lógica de backend vive allí; las funciones de borde Supabase se mantuvieron solo para la aprobación de voluntarios heredados, el restablecimiento de contraseñas y los flujos de correo electrónico. Postgres es la fuente de la verdad para los permisos: los roles viven en una tabla separada y son verificados por un has_role función dentro de las políticas y RPCs.
05Por dentro
- Migraciones 62 versionadas de SQL, Tablas 18 in
public, 3 vistas y 46 SQL/PL/pgSQL funciones (39 de ellosSECURITY DEFINERcon un ancladosearch_path). .functions.ts/.server.tsconvenio: la.functions.tsel archivo exporta la función del servidor y es seguro importar desde el cliente; la implementaciónservice_roleEl cliente vive en.server.tso se importa dinámicamente dentro del manejador, por lo que nunca llega al paquete del navegador. Hay funciones de servidor 13.- Servicio Atención presencial: la
gi_register_visitRPC aumenta el perfil (único por teléfono normalizado) e inserta la visita en una transacción, devolviendo si el perfil es nuevo y el recuento de visitas. Cuando el perfil es nuevo y el teléfono aún no está en la base principal, el servidor también crea el seguidor. - Puntuación de la encuesta: El modelo vive en tablas (
pontuacao_pergunta,pontuacao_opcao,pontuacao_faixa). AnAFTER INSERTdisparador encendidoleads_abordagemcalcula la puntuación; guardar la configuración crea una nueva versión y una fila de auditoría con el estado before/after y quién la cambió;pontuacao_recalcularreelaborar la base. Losleads_abordagem_scoredview sirve formularios con puntuación, nivel y una bandera pendiente. - Agregación Del lado del servidor: El panel de control, el mapa territorial, los análisis y los cumpleaños son RPCs que devuelven JSON agregado en lugar de enviar filas al navegador.
- Tapa de la fila 1,000 de PostgREST: a
fetchAllRangePáginas de ayuda con.range()sobre un pedido determinista, con un límite de seguridad de 200k filas, utilizado por exportaciones y selecciones a granel. - Normalización en la base de datos: normalizar la municipalidad y el estado en los partidarios y contactos; los teléfonos se comparan solo por dígitos.
- Inicio TanStack + React 19, enrutamiento basado en archivos (archivos de ruta 28: páginas públicas 13, inicio de sesión de administrador, un diseño protegido y pantallas de panel 12).
- Consulta de TanStack con
ensureQueryDataen cargadores yuseSuspenseQueryen componentes; nouseEffect + fetchpara las cargas iniciales. - CSS de viento de cola 4 con tokens de tema CSS, shadcn/ui + Radix (componentes base 47), React Gancho Forma + Zod compartir esquemas entre cliente y servidor.
- Mapas: Folleto con agrupamiento de marcadores y mapa de calor; un coropleto construido sobre la malla municipal oficial de IBGE.
- Informe PDF con jsPDF y jspdf-autotable, generados completamente en el navegador desde un column-scoped RPC: tabla diaria, distribución de niveles, equipos y presencial vs. participación remota, siempre en tiempo de Brasilia.
- Alrededor de 30k líneas de TypeScript/TSX (se excluyen los archivos generados).
- Cloudflare Workers con
nodejs_compat, configurado a través dewrangler.jsoncy el plugin Cloudflare Vite. - Despliegues a través de Lovable, conectado a la rama principal: cambiar, validar con una construcción de producción, empujar.
- Supabase para Postgres, Auth, almacenamiento (cubo para materiales de extensión) y funciones de Deno Edge.
- Resend para correo electrónico transaccional (aprobación voluntaria, restablecimiento de contraseña).
- Variables de servidor (
SUPABASE_SERVICE_ROLE_KEY,RESEND_API_KEY) existen solo como secretos de entorno; el cliente solo obtiene la URL y la clave publicable.
06Seguridad
7 ataques considerados, 7 defensas en producción.
Saltarse la interfaz y hablar directo con la base o la API, con la clave pública en mano.
Lea los datos de los ciudadanos llamando al API directamente con la clave pública
RLS en todas las tablas 18; el seguidor y las lecturas de contacto son solo para administradores, o un voluntario que ve su propio registro y referencias
Llamar a funciones internas y agregaciones a través de RPC
EXECUTE revocado de PUBLIC y anon en funciones internas; las agregaciones abortan con FORBIDDEN sin el rol de administrador
Quien ya tiene algún acceso intentando ganar más: volverse admin, leer lo que no debe, conservar un acceso revocado.
Concédete el rol de administrador
Los roles viven en user_roles, se insertan solo por los administradores existentes a través de has_role, una función con EXECUTE revocada de anon
Utilice la cuenta de informe para extraer formularios de encuesta individuales
El rol no tiene directiva SELECT; solo un SECURITY DEFINER RPC con un segmento de columna, sin nombre y el teléfono enmascarado
Enumerar quién está en la base, raspar datos personales, vincular preguntas a personas, extraer secretos.
Extraer la clave service_role del paquete del navegador
Cliente privilegiado solo en .server.ts o importaciones dinámicas en el controlador; las funciones de administración validan el JWT y el rol antes de usarlo
Alterar conteos, borrar la base, editar el historial o negar lo que fue autorizado.
Almacenar un formulario de encuesta sin consentimiento falsificando la solicitud
Zod solo acepta true, el servidor repite la regla y una base de datos CHECK rechaza la fila; se almacenan el tiempo de consentimiento y la versión de texto
Cambiar los pesos de clasificación sin dejar rastro
Cada guardado crea una nueva versión y una fila de auditoría con antes, después y autor; cada resultado almacena la versión que lo produjo
Autorización en la base de datos, no en la interfaz de usuario. Todas las tablas 18 tienen RLS habilitado. Roles (admin, ativista, relatorio) vivir en user_roles, nunca en el perfil, y son revisados por has_role(uid, role), a SECURITY DEFINER cuya ejecución fue revocada de anon y PUBLIC. El diseño del panel bloquea la sesión y el rol, pero eso es solo UX: cualquiera que llame al API directamente con la clave pública golpea las políticas.
Políticas mínimas. El partidario lee solo para administradores, o un voluntario que ve su propio registro y sus referencias. La base de contacto institucional es solo para administradores. Solo los administradores escriben roles, y una política impide que un administrador elimine su propio rol de administrador. Una política de lectura permisiva temprana (USING (true)) se encontró y se soltó en una migración, con la pantalla de confirmación cambiada a un RPC que devuelve solo los campos que necesita.
Las funciones se cierran por defecto. Las funciones de activación y las funciones internas tenían EXECUTE revocado de PUBLIC, anon y authenticated (incluyendo un bloque que se revoca en masa). La agregación RPCs comienza con IF NOT has_role(auth.uid(), 'admin') THEN RAISE EXCEPTION 'FORBIDDEN'.
Un rol de acceso mínimo para el informe. Una cuenta que tiene sólo el relatorio El rol inicia sesión y aterriza en una página con un solo botón. No tiene una política de lectura sobre leads_abordagemLos datos provienen de leads_abordagem_relatorio_rows(), a SECURITY DEFINER RPC que solo acepta admin or relatorio y devuelve un segmento sin nombre, teléfono o campos free-text. El teléfono se convierte en un marcador de presencia (******), porque el informe solo cuenta cuántos formularios tienen un contacto.
Función de servicio mantenida del lado del servidor. Los service_role El cliente solo es importado en .server.ts archivos o dinámicamente dentro de un controlador. Las funciones del servidor de administración pasan por el requireSupabaseAuth middleware, que valida el JWT con getClaims, y luego una verificación explícita de roles antes de tocar el cliente privilegiado. Una brecha de este tipo en el mapa de administración se ha corregido en mayo 2026.
LGPD. El formulario de encuesta requiere consentimiento en tres capas: el esquema Zod solo acepta true, la función de servidor repite la regla, y una base de datos CHECK rechaza un formulario current-version sin consentimiento. Consent almacena la marca de tiempo y la versión del texto de consentimiento, por lo que volver a redactarlo no invalida los consentimientos ya recopilados; los formularios más antiguos nunca se marcan retroactivamente como consentidos. Los voluntarios pueden eliminar su propia cuenta a través de una función de servidor dedicado.
Validación de entrada. Cada función de servidor valida con Zod (longitudes máximas, enums cerrados, arrays limitados). Las fechas de campo en el futuro o más antiguas que 90 días son rechazadas del lado del servidor, en el tiempo de Brasilia. El inicio de sesión del administrador tiene un honeypot, límites de longitud y, como fricción adicional en la parte superior de la limitación de velocidad nativa de Supabase Auth, un bloqueo del lado del cliente de minutos 15 después de que el 5 falle con retroceso exponencial.
Higiene. Panel, formulario de campo y rutas de informe son noindex. Sin clave de servidor en el paquete; Google OAuth pasa por un corredor administrado en lugar de exponer la configuración del proveedor al cliente.
07Desafíos técnicos
Conceder un informe sin otorgar los datos
Alguien tenía que emitir el informe, pero no debe ver los formularios individuales. En lugar de políticas de lectura parcial, que se filtran a través de cualquier consulta well-built, la respuesta fue un rol sin SELECT política en absoluto más un SECURITY DEFINER RPC devuelve exactamente las columnas que utiliza el informe, reflejando la lista de columnas definida en el código PDF. El teléfono se enmascara en un marcador de presencia antes de que salga de la base de datos.
Puntuación configurable sin perder trazabilidad
Los coordinadores querían ajustar los pesos y los niveles durante el período de la campaña. El modelo se trasladó a las tablas, el cálculo a un desencadenador, y cada configuración guardada ahora crea una versión y una fila de auditoría before/after. Cada resultado almacena la versión de configuración que lo produjo, y una recalculación reprocesa toda la base cuando cambian las reglas.
Reemplazar el formulario oficial con los datos ya recopilados
La versión 2 del formulario cambió las preguntas y agregó el consentimiento de LGPD. La migración añadida form_versao con un CHECK aplicado NOT VALID y validado después, hizo el consentimiento obligatorio solo para la versión 2, y el servidor escribe la versión explícitamente para que un cliente que ejecuta un paquete antiguo nunca se registre como el nuevo formulario. Panel, puntuación y RPCs manejar ambas versiones.
Un perfil por teléfono en visitas repetidas
La misma persona se presenta en varios servicios presencial, a veces ingresados días después. gi_register_visit normaliza el teléfono, actualiza el perfil, inserta la visita con una fecha de retroceso opcional y devuelve el número de visita, manteniendo la primera y la última visita consistentes. El formulario busca el teléfono cuando se escribe para advertir al equipo antes de enviarlo.
08Resultados
- 736 confirma entre abril y agosto 2026; migraciones 62; tablas 18 con directivas RLS; 52 creadas.
- La investigación de campo pasó del papel a un formulario estandarizado con clasificación automática y un informe ejecutivo one-click.
- 736
- compromisos
- 62
- Migraciones SQL
- 18/18
- mesas con RLS
- 52
- Políticas creadas
- 39 of 46
- Funciones SECURITY DEFINER
- 13
- funciones del servidor
- 7
- funciones de borde
- ~29.9k
- Líneas TS/TSX
- 5,080
- Líneas SQL
cómo lo medimos
git rev-list --cuenta la cabeza
cómo lo medimos
es supabase/migrations wc -l
cómo lo medimos
grep for CREAR MESA y HACER SEGURIDAD DE NIVEL DE FILA en las migraciones
cómo lo medimos
grep -ic 'crear política' en las migraciones (5 después POLTICA DE DROP)
cómo lo medimos
script sobre las migraciones: distintos nombres CREATE FUNCTION con SECURITY DEFINER en el encabezado
cómo lo medimos
grep -c 'createServerFn(' en src/lib/*.functions.ts y src/utils/*.functions.ts
cómo lo medimos
ls supabase/functions (excluyendo compartido)
cómo lo medimos
wc -l en git ls-files .ts .tsx, excluyendo los routeTree.gen.ts y types.ts generados
cómo lo medimos
cat supabase/migrations/*.sql wc -l
09Línea de tiempo
- 27 abr 2026
App scaffold, mesa de apoyo y endurecimiento RLS, dejando caer una política de lectura permisiva
- abr 2026
Apr 2930: área de voluntarios con referencias y clasificación; base de contacto institucional con acceso a solo para administradores
- may 2026
Mayo 1215: forma de calle, análisis y un mapa agrupado con una caché de geocodificación
- jun 2026
Jun 28: Servicio presencial con un perfil por teléfono, historial de visitas y fechas anteriores
- 07 jul 2026
Formulario de encuesta de campo, puntuación automática versionada y un mapa territorial coropleto
- jul 2026
Jul 2130: informe ejecutivo en PDF y función de acceso mínimo para emitirlo
- 15 ago 2026
Versión oficial del formulario con el consentimiento de LGPD aplicado en la base de datos
10Stack
- React 19
- TanStack Start
- TanStack Router
- TanStack Query
- TypeScript
- Tailwind CSS 4
- shadcn/ui
- Radix
- React Hook Form
- Recharts
- Leaflet
- jsPDF
- TanStack Start server functions
- Cloudflare Workers
- Supabase Auth
- Supabase Edge Functions (Deno)
- PL/pgSQL
- Resend
- PostgreSQL
- Row Level Security
- Triggers e views
- pg_trgm
- Supabase Storage
- Cloudflare Workers
- Vite 7
- Lovable
- Supabase CLI
- Bun
- RLS em todas as tabelas
- Papéis com has_role SECURITY DEFINER
- Zod em toda entrada
- Consentimento LGPD com CHECK
- Honeypot
- service_role só no servidor
11Ficha técnica
- type
- plataforma de oficina legislativa civic tech
- stack
- TanStack Inicio React 19 TS
- db
- Postgres 18 tablas RLS 18/18
- auth
- Supabase Auth Funciones de 3 vía has_role
- deploy
- Cloudflare Workers
- modules
- campo Servicio presencial voluntarios tablero informe
- status
- en producción
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.
Relaciones por WhatsApp con envío humano, historial inmutable y reglas de negocio en Postgres.
¿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.