Todos los casos
~/cases/crm-eleitoral-dimas-gadelha
Sistemas internosCámara y Asambleaabr 2026 → ago 2026En producción

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.

18/18
mesas con RLS
39 of 46
Funciones SECURITY DEFINER
52
Políticas creadas
62
Migraciones SQL
  • cloudflare
  • supabase
  • postgres
  • rls
  • lgpd
  • react
architecture.es.svgampliar ↓

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

arquitectura real · pasa el cursor por los nodos
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

Backend y datos
  • Migraciones 62 versionadas de SQL, Tablas 18 in public, 3 vistas y 46 SQL/PL/pgSQL funciones (39 de ellos SECURITY DEFINER con un anclado search_path).
  • .functions.ts / .server.ts convenio: la .functions.ts el archivo exporta la función del servidor y es seguro importar desde el cliente; la implementación service_role El cliente vive en .server.ts o 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_visit RPC 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). An AFTER INSERT disparador encendido leads_abordagem calcula 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_recalcular reelaborar la base. Los leads_abordagem_scored view 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 fetchAllRange Pá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.
Frontend
  • 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 ensureQueryData en cargadores y useSuspenseQuery en componentes; no useEffect + fetch para 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).
Infraestructura y despliegue
  • Cloudflare Workers con nodejs_compat, configurado a través de wrangler.jsonc y 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.

ataquedefensa
Atajo por la API

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

Escalada de privilegios

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

Fuga y rastreo de datos

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

Adulteración y rastro

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
cómo lo medimos

git rev-list --cuenta la cabeza

62
Migraciones SQL
cómo lo medimos

es supabase/migrations wc -l

18/18
mesas con RLS
cómo lo medimos

grep for CREAR MESA y HACER SEGURIDAD DE NIVEL DE FILA en las migraciones

52
Políticas creadas
cómo lo medimos

grep -ic 'crear política' en las migraciones (5 después POLTICA DE DROP)

39 of 46
Funciones SECURITY DEFINER
cómo lo medimos

script sobre las migraciones: distintos nombres CREATE FUNCTION con SECURITY DEFINER en el encabezado

13
funciones del servidor
cómo lo medimos

grep -c 'createServerFn(' en src/lib/*.functions.ts y src/utils/*.functions.ts

7
funciones de borde
cómo lo medimos

ls supabase/functions (excluyendo compartido)

~29.9k
Líneas TS/TSX
cómo lo medimos

wc -l en git ls-files .ts .tsx, excluyendo los routeTree.gen.ts y types.ts generados

5,080
Líneas SQL
cómo lo medimos

cat supabase/migrations/*.sql wc -l

09Línea de tiempo

  1. 27 abr 2026

    App scaffold, mesa de apoyo y endurecimiento RLS, dejando caer una política de lectura permisiva

  2. abr 2026

    Apr 2930: área de voluntarios con referencias y clasificación; base de contacto institucional con acceso a solo para administradores

  3. may 2026

    Mayo 1215: forma de calle, análisis y un mapa agrupado con una caché de geocodificación

  4. jun 2026

    Jun 28: Servicio presencial con un perfil por teléfono, historial de visitas y fechas anteriores

  5. 07 jul 2026

    Formulario de encuesta de campo, puntuación automática versionada y un mapa territorial coropleto

  6. jul 2026

    Jul 2130: informe ejecutivo en PDF y función de acceso mínimo para emitirlo

  7. 15 ago 2026

    Versión oficial del formulario con el consentimiento de LGPD aplicado en la base de datos

10Stack

Frontend
  • React 19
  • TanStack Start
  • TanStack Router
  • TanStack Query
  • TypeScript
  • Tailwind CSS 4
  • shadcn/ui
  • Radix
  • React Hook Form
  • Recharts
  • Leaflet
  • jsPDF
Backend
  • TanStack Start server functions
  • Cloudflare Workers
  • Supabase Auth
  • Supabase Edge Functions (Deno)
  • PL/pgSQL
  • Resend
Datos
  • PostgreSQL
  • Row Level Security
  • Triggers e views
  • pg_trgm
  • Supabase Storage
Infra
  • Cloudflare Workers
  • Vite 7
  • Lovable
  • Supabase CLI
  • Bun
Seguridad
  • 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

node@crm-eleitoral-dimas-gadelha: ~/cases/crm-eleitoral-dimas-gadelha
node@crm-eleitoral-dimas-gadelha ─────────────
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
$ ls supabase/migrations | wc -l
62
$ grep -h 'ENABLE ROW LEVEL SECURITY' supabase/migrations/*.sql | sort -u | wc -l
18 # 18 tabelas, 18 com RLS
$ psql -c "select public.leads_abordagem_relatorio_rows();" # como usuário sem papel
ERROR: FORBIDDEN
$ psql -c "insert into leads_abordagem (form_versao, nome_abordado, lgpd_aceite) values (2, 'Teste', false);"
ERROR: new row for relation "leads_abordagem" violates check constraint "leads_abordagem_lgpd_v2_chk"
$ git log --oneline | wc -l
736

© 2026 NODE. Todos los derechos reservados.