P-18
Techpoint CRM
CRM y sitio web de un servicio técnico de computadoras: clientes, órdenes de servicio, etiquetas de precio y vitrina, en el borde y con RLS como última palabra.
clienteTienda de informática y servicio técnico en Brasilia, Distrito Federal de Brasil
Desarrollador full stack (único autor de los 48 commits del CRM y los 25 del sitio)
Área administrativa de una tienda de informática y servicio técnico, construida con React Router v7 (SSR) sobre Cloudflare Workers y Supabase Postgres 17. Importa la planilla de clientes con una normalización probada y sin duplicados, gestiona órdenes de servicio con etiqueta de taller y comprobante de recepción impresos, genera etiquetas de precio en milímetros reales con texto que se ajusta al espacio, recibe los leads del sitio web y alimenta la vitrina pública. El acceso es con un código de un solo uso enviado por correo, protegido por Turnstile y sin registro público; los datos siempre pasan por la sesión del usuario con RLS en todas las tablas; el JWT se verifica en el borde con un JWKS incrustado en el build, de modo que cada clic cuesta un solo viaje a la base de datos. El sitio estático en Astro registra la solicitud en el CRM antes de abrir WhatsApp.
- cloudflare
- react
- supabase
- postgres
- rls
- astro
- anti-bot
- lgpd
01Sinopsis
Techpoint es una tienda independiente de informática y servicio técnico en Brasilia, Brasil: repara laptops y computadoras de escritorio, vende hardware nuevo y reacondicionado y compra equipos usados. El día a día vivía en WhatsApp y en una planilla exportada del sistema anterior, con poco más de mil registros de clientes, teléfonos en una docena de formatos y ni un solo cumpleaños cargado.
El proyecto entregó dos piezas que se comunican entre sí. El CRM es el área administrativa de la tienda: clientes con perfil, historial y carné; órdenes de servicio con etiqueta de taller y comprobante de recepción; inventario con vitrina pública; etiquetas de precio impresas en milímetros reales; leads que llegan del sitio; cumpleaños; y un panel con un mapa del Distrito Federal que muestra dónde está realmente la base de clientes. El sitio web es una landing estática en Astro con páginas de servicio, datos estructurados y un formulario que registra la solicitud en el CRM antes de pasar al visitante a WhatsApp.
Todo corre en Cloudflare Workers, con Supabase (Postgres 17) para datos y autenticación. El CRM se construyó y publicó entre el 16 y el 18 de septiembre de 2026 en 48 commits de un único autor; el sitio salió en la misma ventana en 25 commits.
02El problema
- Datos sin forma. La planilla de clientes tenía teléfonos en diez formatos, nombres EN MAYÚSCULAS, duplicados por teléfono y por nombre, y campos clave vacíos. Cualquier CRM listo para usar habría exigido una limpieza manual antes de importar.
- Flujo de taller en papel. Presupuesto escrito, aprobación, reparación, retiro: cada paso se acordaba por chat, sin número de orden, sin historial y sin un comprobante estándar.
- Tienda pequeña, latencia grande. Un equipo de dos o tres personas no tiene paciencia para pantallas lentas. La primera versión corría con la base de datos en Estados Unidos, y cada clic encadenaba varios viajes a la base.
- Sin contraseñas que olvidar ni registro del que abusar. La tienda no quería administrar contraseñas, pero tampoco podía exponer a internet un formulario de registro abierto.
- Sitio y CRM separados. Los formularios del sitio abrían WhatsApp y no quedaba nada registrado; la vitrina era un archivo JSON editado a mano.
03La solución
Clientes. La importación de la planilla corre en el navegador, con normalización probada (teléfonos a dígitos con código de país, nombres a Title Case conservando el original, códigos postales, fechas en hora de Brasilia, correos mal escritos marcados con una etiqueta) y una RPC idempotente: volver a subir el mismo archivo no duplica nada. Vista de tabla o de cuadrícula de tarjetas, edición en la celda, búsqueda sin tildes por nombre, teléfono, correo, ciudad y código del carné, filtros por barrio, región administrativa y cuadra, acciones masivas de etiquetas y una cola de duplicados cuya fusión traslada historial, órdenes de servicio y leads.
Órdenes de servicio. Ocho estados (recibido → diagnóstico → presupuesto → aprobación → reparación → listo → entregado, más cancelado), número secuencial, presupuesto detallado y fecha estimada de entrega. Cada cambio de estado se convierte en un evento del historial mediante un trigger. Impresos: una etiqueta de taller (74×105 o 50×80 mm, con un código QR que abre la orden) y un comprobante de recepción A5 en dos copias con el aviso de la ley del consumidor. Mensajes de WhatsApp listos para cada etapa, editables en Configuración.
Productos, vitrina y etiquetas de precio. Inventario con categoría, condición, especificaciones y cuotas. Los productos marcados como "mostrar en la vitrina" se sirven por GET /api/vitrine para el sitio. Las etiquetas de precio se generan en milímetros (A7, A6, A5, una etiqueta de 50×30 o un tamaño personalizado), en tres temas, con un código QR que abre el WhatsApp de la tienda con el producto ya escrito en el mensaje; el texto se ajusta al espacio disponible midiendo con canvas después de que cargan las fuentes, y la hoja de impresión distribuye varias etiquetas en A4/A3/Carta con marcas de corte.
Leads del sitio. POST /api/leads recibe los formularios de presupuesto y de venta de equipos usados, verificados con Turnstile, y alimenta la pantalla de leads con un contador en el menú. Desde ahí un vendedor responde por WhatsApp, crea el cliente o vincula el lead a uno existente por teléfono.
Panel. KPIs de la base, una serie mensual de personas y empresas, los cumpleaños del día, un resumen de las órdenes de servicio y dos mapas: el Distrito Federal en MapLibre (un pin por barrio o por región administrativa, área proporcional, un clic abre la lista filtrada) y un esquema de las cuadras alrededor de la tienda.
Equipo y accesos. El login principal es un código de un solo uso de 8 dígitos enviado por correo, con la marca de la tienda. No hay registro público: el admin crea las cuentas en Configuración y la persona recibe un correo de bienvenida. Los roles son admin y vendedor (ventas).
Sitio web. Astro estático, diez páginas de servicio generadas a partir de JSON, unas preguntas frecuentes reflejadas 1:1 en JSON-LD, un sitemap cuyo lastmod sale de git, un llms.txt generado con los mismos datos, un robots.txt con Content Signals (búsqueda y asistentes de IA permitidos, entrenamiento de modelos no permitido) y un verificador que corre al final del build y falla si se rompen el schema, los datos NAP o el sitemap.
- Un viaje a la base de datos por clic: JWT verificado en el isolate con un JWKS del build, bootstrap de sesión en una sola RPC con caché de 60 s y loaders que arrancan sin esperar el perfil.
- RLS en las 13 tablas con helpers en un schema fuera de la API; el rol anónimo solo puede insertar un lead nuevo y leer la vitrina a través de una view security_invoker con grants por columna.
- Login sin contraseña con la marca de la tienda: el hook Send Email de Supabase llega firmado (Standard Webhooks) al Worker, que arma el correo y lo envía por Resend.
- Etiquetas de precio en milímetros reales con texto ajustado midiendo con canvas, tres temas y una hoja de impresión con marcas de corte.
- Mapa del Distrito Federal sin geocodificar direcciones: barrios y regiones en una tabla estática, MapLibre cargado solo en el navegador y SVG como respaldo.
- Sitio estático que registra el lead en el CRM antes de abrir WhatsApp, con Turnstile verificado en el servidor y un verificador de SEO/GEO que hace fallar el build.
04Arquitectura
Leer el diagrama como lista (19 componentes, 20 conexiones)
Componentes
- Equipo de la tienda: Admin<br>equipo · importación · tienda, Vendedor<br>clientes · órdenes · etiquetas
- Sitio público · Cloudflare Workers (assets): Astro estático<br>11 páginas de servicio · JSON-LD · llms.txt, Widget de Turnstile<br>en cada formulario
- CRM · Cloudflare Worker (smart placement): React Router v7 SSR<br>36 rutas · loaders y actions, Verificación local del JWT<br>JWKS incrustado en el build · caché de 6 h, bootstrap_sessao()<br>perfil + configuración + contadores · 1 viaje a la base, POST /api/leads<br>CORS allowlist · honeypot · Turnstile en el servidor, GET /api/vitrine<br>caché de 5 min en el borde, POST /api/auth/email<br>Standard Webhooks HMAC · ventana de 5 min, admin.server.ts<br>service role solo para crear/eliminar accesos
- Supabase · Postgres 17 (São Paulo): Auth<br>OTP por correo · Turnstile · sin registro público, RLS en 13 tablas<br>40 policies · helpers en un schema privado, RPCs y views<br>security invoker · EXECUTE solo para authenticated, Desencadenantes<br>perfil al crear usuario · historial de la orden · catálogo
Conexiones
- Admin<br>equipo · importación · tienda → React Router v7 SSR<br>36 rutas · loaders y actions
- Vendedor<br>clientes · órdenes · etiquetas → React Router v7 SSR<br>36 rutas · loaders y actions
- Visitante del sitio<br>presupuesto · venta de usados → Astro estático<br>11 páginas de servicio · JSON-LD · llms.txt
- Astro estático<br>11 páginas de servicio · JSON-LD · llms.txt → POST /api/leads<br>CORS allowlist · honeypot · Turnstile en el servidor (sendBeacon / fetch keepalive)
- Astro estático<br>11 páginas de servicio · JSON-LD · llms.txt → GET /api/vitrine<br>caché de 5 min en el borde (fetch en el build/cliente)
- Widget de Turnstile<br>en cada formulario → POST /api/leads<br>CORS allowlist · honeypot · Turnstile en el servidor (token)
- React Router v7 SSR<br>36 rutas · loaders y actions → Verificación local del JWT<br>JWKS incrustado en el build · caché de 6 h
- Verificación local del JWT<br>JWKS incrustado en el build · caché de 6 h → bootstrap_sessao()<br>perfil + configuración + contadores · 1 viaje a la base
- bootstrap_sessao()<br>perfil + configuración + contadores · 1 viaje a la base → RPCs y views<br>security invoker · EXECUTE solo para authenticated
- React Router v7 SSR<br>36 rutas · loaders y actions → RLS en 13 tablas<br>40 policies · helpers en un schema privado (sesión del usuario + RLS)
- POST /api/leads<br>CORS allowlist · honeypot · Turnstile en el servidor → RLS en 13 tablas<br>40 policies · helpers en un schema privado (clave publicable · solo INSERT)
- POST /api/leads<br>CORS allowlist · honeypot · Turnstile en el servidor → Cloudflare Turnstile<br>siteverify
- GET /api/vitrine<br>caché de 5 min en el borde → RLS en 13 tablas<br>40 policies · helpers en un schema privado (view security_invoker)
- Auth<br>OTP por correo · Turnstile · sin registro público → POST /api/auth/email<br>Standard Webhooks HMAC · ventana de 5 min (hook Send Email)
- POST /api/auth/email<br>Standard Webhooks HMAC · ventana de 5 min → Resend<br>correos con la marca
- React Router v7 SSR<br>36 rutas · loaders y actions → Auth<br>OTP por correo · Turnstile · sin registro público (signInWithOtp / verifyOtp)
- admin.server.ts<br>service role solo para crear/eliminar accesos → Auth<br>OTP por correo · Turnstile · sin registro público (auth.admin.createUser)
- Auth<br>OTP por correo · Turnstile · sin registro público → Desencadenantes<br>perfil al crear usuario · historial de la orden · catálogo
- RLS en 13 tablas<br>40 policies · helpers en un schema privado → Desencadenantes<br>perfil al crear usuario · historial de la orden · catálogo
- React Router v7 SSR<br>36 rutas · loaders y actions → OpenFreeMap<br>teselas del mapa · sin clave (solo en el navegador)
El Worker es el único punto de entrada: renderiza las pantallas en el servidor (React Router v7 en framework mode), ejecuta las actions y expone cuatro resource routes en JSON. Los datos del CRM nunca se tocan con privilegios elevados: cada solicitud usa la propia sesión del usuario, y Row Level Security decide qué puede ver. El service role vive en un solo módulo y se usa únicamente para crear y eliminar cuentas.
05Por dentro
- Postgres 17 en Supabase, 20 migrations versionadas, 13 tablas, 2 views, 26 funciones SQL/PL/pgSQL y 12 triggers. Extensiones
pg_trgm,unaccentycitext. - Búsqueda sin tildes mediante una columna generada
tsvector(sem_acento, un wrapper IMMUTABLE sobreunaccent) y un índice de trigramas sobre el nombre normalizado. Las columnas generadas también guardan el código del carné (un prefijo del UUID) y la cuadra extraída de la dirección con una regex. - Un viaje a la base por pantalla.
bootstrap_sessao()devuelve perfil, configuración y contadores del menú en un solo JSON;painel_resumo,painel_osypainel_clientesagregan el panel en tres RPCs disparadas en paralelo;filtros_clientes()devuelve ciudades, barrios, etiquetas y los chips de datos pendientes de una vez. - Lógica de negocio en la base donde tiene que ser atómica:
importar_clientes(lote idempotente conon conflict do nothingsobre una clave natural),mesclar_clientes(traslada historial, órdenes y leads, y luego desactiva el duplicado),clientes_alterar_tagmasivo,catalogo_aprender(un trigger que alimenta el diccionario de marcas/modelos a partir de órdenes y productos),os_registrar_evento(cada cambio de estado se vuelve una interacción en el historial). - Correo sin SMTP: el hook Send Email de Supabase llega firmado al Worker, el Worker arma el HTML con la marca (
layoutEmail, un módulo puro y probado) y lo envía por Resend. Los enlaces apuntan al propio/auth/callbackdel CRM con untoken_hash, así que funcionan aunque se abran en otro dispositivo. - Sin Edge Functions, sin colas, sin cron: todo lo que necesitaba un servidor cupo en loaders, actions y funciones SQL.
- React Router v7 (framework mode, SSR) + React 19 + TypeScript, Tailwind CSS v4 con los tokens de la marca (ámbar sobre casi negro, Barlow / Barlow Condensed / B612 Mono), Radix UI para diálogos y menús,
cmdkpara la paleta Ctrl K y Zod compartido entre cliente y servidor. - Caché por capas sin biblioteca:
clientLoadercon un helpercacheado(10–60 s por URL en el navegador, invalidado por cualquier envío de formulario), un layout que solo revalida después de una mutación o cada 2 minutos, yprefetch="intent"en los enlaces del menú. - Cero errores de hidratación por diseño: fechas siempre formateadas en hora de Brasilia, tiempo relativo solo después del montaje (
<Relativo />) y la preferencia de tabla/cuadrícula leída delocalStoragedentro de unuseEffect. - La impresión como ciudadana de primera clase: etiquetas, rótulos y comprobantes son HTML dimensionado en milímetros con un
@pagesin márgenes; el editor mide el contenido y avisa cuando no cabe, compactando en tres niveles antes de recortar. - Un mapa que no geocodifica a nadie: MapLibre GL se importa dinámicamente dentro de
useEffect(un chunk de ~1 MB solo para quien abre el panel), con un estilo propio en los colores de la marca sobre teselas vectoriales de OpenFreeMap y los polígonos de las 34 regiones administrativas proyectados de antemano por un script a partir de Overpass. Un SVG estático toma el relevo si WebGL falla. - Vista previa visual sin sesión:
npm run previamonta los componentes reales en Playwright y les toma capturas, para revisar el carné y la Configuración sin base de datos.
- Cloudflare Workers con
@cloudflare/vite-plugin: el desarrollo local corre en elworkerdreal.placement: smartacerca el Worker a la base de datos. El dominio propio está declarado enwrangler.json;npm run deploysiempre recompila antes de publicar, porque elwrangler.jsonque vale es el que se genera en el build. Observabilidad y source maps activados. - Base de datos en São Paulo: el proyecto original de Supabase (us-east-1) se reemplazó el primer día por la latencia.
- Un build que descarga las claves públicas del Auth (
scripts/baixar-jwks.mjs,prebuild) y las incrusta en el bundle: un isolate en frío verifica JWTs sin tocar la red. - Sitio web publicado como un Worker solo de assets (
wrangler.jsoncsinmain), desplegado automáticamente por Workers Builds en cada push; headers de seguridad y de caché enpublic/_headers. - Verificación mínima antes de publicar:
npm run typecheck(wrangler types+react-router typegen+tsc -b),npm test,npm run build,npx wrangler deploy --dry-run.
06Seguridad
8 ataques considerados, 8 defensas en producción.
Scripts que saturan formularios, inflan cifras o rastrean el sitio buscando brechas.
Un bot que inunda el endpoint público con leads falsos
Allowlist de Origin, un honeypot que responde ok sin grabar, Zod con límites por campo, token de Turnstile verificado en siteverify con la IP del cliente y una policy de INSERT que solo acepta el estado nuevo, sin vínculos.
Saltarse la interfaz y hablar directo con la base o la API, con la clave pública en mano.
Leer clientes, órdenes o leads directo desde PostgREST con la clave publicable
RLS en las 13 tablas; anon perdió todo privilegio sobre productos, leads y catálogo, y los default privileges revocan EXECUTE de toda función nueva. Sin un JWT válido, ninguna fila.
Fuerza bruta, creación indebida de cuentas, restablecimiento de contraseña y robo de cuenta.
Registrarse por cuenta propia y entrar al CRM
/cadastro solo redirige; signInWithOtp se ejecuta con shouldCreateUser: false; el trigger de perfil deja inactiva cualquier cuenta que no haya nacido de un admin o de una invitación registrada.
Fuerza bruta sobre el código de un solo uso o la contraseña de respaldo
Turnstile obligatorio en cada formulario, validado por el propio Supabase; código de 8 dígitos de un solo uso; un envío por correo cada 60 s con cuenta regresiva en pantalla.
Quien ya tiene algún acceso intentando ganar más: volverse admin, leer lo que no debe, conservar un acceso revocado.
Un vendedor que intenta importar la planilla, eliminar un cliente o crear accesos
Rol leído de la tabla de perfiles por sou_admin() en un schema fuera de la API; exigirAdmin en la ruta y la misma verificación dentro de la RPC importar_clientes; policies de DELETE solo para admin; service role solo en admin.server.ts.
CSRF, webhooks falsos, tokens reutilizados, enlaces firmados y redirección abierta.
Falsificar el hook de correo para enviar mensajes en nombre de la tienda
Firma Standard Webhooks (HMAC-SHA256 sobre id.timestamp.body) verificada en tiempo constante, ventana de 5 minutos, secretos rotables separados por |. Sin firma válida, 401.
Open redirect a través de ?proximo= después del login
destinoSeguro solo acepta una ruta que empieza con /; caminhoInternoDoApp rechaza cualquier destino fuera de /app.
Enumerar quién está en la base, raspar datos personales, vincular preguntas a personas, extraer secretos.
Filtrar SKU, notas internas o costo a través de la vitrina pública
View vitrine_publica con security_invoker, grant de SELECT por columna para anon y una policy que solo expone filas en stock marcadas para la vitrina.
Autenticación. El login principal es un código de un solo uso de 8 dígitos enviado por correo (signInWithOtp con shouldCreateUser: false, luego verifyOtp); la contraseña existe solo como respaldo. Cada formulario de login y de recuperación lleva su propio widget de Turnstile, y el token lo valida el propio Supabase (Attack Protection), así que una llamada de autenticación sin captcha se rechaza en el origen. Supabase limita los reenvíos a uno por correo cada 60 s y la pantalla muestra una cuenta regresiva en lugar de dejar que el usuario choque con el límite.
Sin registro público. /cadastro solo redirige. Las cuentas nacen en Configuración → Equipo mediante auth.admin.createUser con metadatos; el trigger criar_perfil_para_novo_usuario crea el perfil y deja la cuenta inactiva salvo que venga de un admin o de una invitación registrada. Eso es defensa en profundidad: aunque se reactivara el registro en el panel, la cuenta no tendría acceso.
Sesión y JWT. Las cookies son httpOnly, secure, sameSite=lax, escritas por @supabase/ssr. El JWT se verifica localmente en el Worker contra las claves públicas (JWKS) incrustadas en el build y guardadas en caché por 6 h; un kid desconocido fuerza una nueva descarga. exigirSessaoRapida autentica los loaders de lectura sin esperar a la base mientras RLS sigue siendo la barrera de los datos; exigirSessao/exigirAdmin protegen las actions y las pantallas de admin. Los destinos de redirección (?proximo=, ?de=) solo se aceptan cuando son rutas relativas internas.
Autorización en la base de datos. RLS activada en las 13 tablas, 40 policies. Los helpers sou_admin(), estou_ativo() y meu_papel() viven en un schema privado, fuera de la API de PostgREST, como SECURITY DEFINER con search_path = ''. Los default privileges del schema public revocan EXECUTE de anon y public para toda función nueva; cada RPC concede authenticated de forma explícita. Las funciones que leen auth.users (equipe_acessos, minha_senha_definida, sistema_resumo) llevan la verificación dentro del cuerpo (auth.uid() o privado.sou_admin()), no solo en el grant. La importación exige admin tanto en la ruta como dentro de la RPC.
Lo que el rol anónimo puede hacer, y nada más. anon perdió todo privilegio sobre produtos, leads, marcas, modelos y cliente_pares_ignorados y recuperó exactamente dos: INSERT en leads, con una policy que exige status = 'novo', sin cliente_id ni atendido_por, un origen de una lista cerrada y límites de longitud; y SELECT por columna sobre produtos solo para filas en stock marcadas para la vitrina, a través de una view security_invoker (la primera versión de la view se ejecutaba como su dueño y se corrigió en la migration 12). SKU, notas internas y costo nunca salen.
Endpoint público de leads. Allowlist de Origin a partir de una variable de entorno, un honeypot que responde éxito sin grabar, un schema Zod con longitud máxima por campo, el token de Turnstile verificado contra siteverify con la IP del cliente y un insert sin .select(). El sitio envía como form-urlencoded para seguir siendo una solicitud simple (sin preflight) y recurre a sendBeacon si la red falla.
Hook de correo. /api/auth/email solo acepta payloads firmados en el formato Standard Webhooks: HMAC-SHA256 sobre id.timestamp.body, comparación en tiempo constante, una ventana de 5 minutos y varios secretos separados por | para rotar sin interrupciones. Firma inválida → 401; sin secreto configurado → 500 explícito.
Secretos. Service role, clave de Resend, secreto del hook y secreto de Turnstile son secretos del Worker (wrangler secret put), nunca en el tipo Env generado, nunca impresos. El service role se instancia solo en admin.server.ts, sin persistencia de sesión, para crear y eliminar cuentas. El build falla si un componente de cliente referencia un módulo *.server.ts.
Datos personales (LGPD). La planilla original con los registros de clientes quedó fuera de git desde el inicio y el historial se reescribió para garantizarlo (commit del segundo día). El mapa del panel no geocodifica direcciones: las coordenadas pertenecen a barrios en una tabla estática, y solo el área visible va al servidor de teselas. La exportación CSV y las acciones masivas respetan los mismos filtros y la misma RLS que la lista. El robots.txt del sitio indica que el contenido puede indexarse y citarse, pero no usarse para entrenar modelos.
Validación. Zod en cada action (cliente, producto, orden, interacción, lead, login), teléfonos normalizados a dígitos con código de país antes de grabar, cumpleaños guardados como YYYY-MM-DD sin zona horaria, nombres de lugares canonizados al guardar.
07Desafíos técnicos
Hacer que un Worker en el borde hable con un Postgres a miles de kilómetros sin que la pantalla lo note
La primera versión corría con la base de datos en Estados Unidos y cada navegación encadenaba autenticación, perfil, configuración y la consulta de la pantalla. La solución llegó por capas: trasladar el proyecto a São Paulo; incrustar el JWKS en el build y verificar el JWT dentro del isolate; juntar perfil, configuración y contadores en una sola RPC (bootstrap_sessao) con caché de 60 s por token, invalidada ante cualquier solicitud que no sea GET; dejar que los loaders de lectura arranquen sin esperar el bootstrap (exigirSessaoRapida); Promise.all en cada consulta paralela; y una caché de 10–60 s en el navegador. La regla pasó a ser "un viaje a la base de datos por clic", y un /api/diag solo para admin mide desde el Worker el costo real de cada llamada.
Login sin contraseña con la marca de la tienda que sigue funcionando bajo automatización
Supabase envía los correos por SMTP con su propia plantilla; aquí el hook Send Email llega firmado al Worker, la plantilla la arma un módulo puro y probado y el mensaje sale por Resend. Los enlaces usan token_hash en lugar de PKCE, así que un código abierto en el celular funciona aunque el login haya empezado en una computadora de escritorio. Como Turnstile bloquea cualquier login por formulario en un navegador automatizado, las pruebas end-to-end inician sesión con un magic link generado con el service role, fuera del flujo del usuario.
Etiquetas de precio que siempre caben
Imprimir en milímetros es fácil; un título largo en una etiqueta A7 no lo es. En lugar de fijar el tamaño por cantidad de caracteres, cada campo tiene una base y un mínimo en unidades relativas al ancho, el editor mide el texto con canvas después de que document.fonts está listo, estima la altura en tres niveles de compactación y solo entonces avisa que no cabe (ofreciendo el siguiente tamaño). En el servidor, sin canvas, usa los tamaños base. La orientación horizontal tiene su propio diseño en dos columnas; las etiquetas cuyo lado corto mide ≤ 40 mm pasan a un diseño de tres campos.
Un mapa de clientes que no envía la dirección de nadie a ningún lado
Los códigos postales no sirven para el Distrito Federal: las APIs de consulta devuelven el centro de Brasilia para todos. La alternativa fue una tabla estática de 69 barrios con nombre canónico, región administrativa y coordenada, los polígonos de las 34 regiones descargados de Overpass y proyectados de antemano por un script (un archivo generado, nunca editado a mano), y la agrupación por región porque el mismo lugar llegaba escrito de nueve formas distintas. MapLibre se carga vía import() dentro de useEffect, solo en el navegador, con un estilo propio sobre teselas de OpenFreeMap; si WebGL falla, un SVG toma el relevo.
Importar una planilla desordenada sin perder nada
La normalización corre en el navegador por lotes, con 154 casos de prueba que cubren formatos de teléfono, nombres, códigos postales y fechas; la RPC inserta con on conflict do nothing sobre una clave natural (nombre original + teléfono + fecha de registro), así que volver a subir el archivo es seguro. Los duplicados por teléfono o nombre caen en una view, "son personas distintas" queda guardado, y mesclar_clientes traslada todo lo que apunta al registro secundario.
08Resultados
- CRM en producción en su propio dominio, con el sitio integrado: leads registrados antes de que se abra WhatsApp y una vitrina alimentada por el inventario.
- 13 tablas, 40 policies de RLS, 26 funciones SQL, 12 triggers, 20 migrations, 36 rutas, 4 endpoints de recursos, 0 Edge Functions.
- 154 pruebas unitarias en 13 archivos (Vitest, ejecutadas: todas aprobadas) y 4 guiones de Playwright (flujo completo, móvil, sesión, latencia en producción).
- ~21k líneas no vacías en el CRM (TSX 12,675; TS 4,950 sin contar los tipos generados; SQL 2,422; scripts 722; CSS 365) y ~2.7k en el sitio (Astro 1,161; CSS 783; TS 431; scripts 343).
- 48 commits en el CRM y 25 en el sitio entre el 16 y el 18 de septiembre de 2026, un único autor.
- 13
- mesas con RLS
- 40
- Políticas de RLS
- 26
- Funciones SQL
- 20
- Migraciones
- 36
- rutas
- 154
- pruebas unitarias
- 48 + 25
- compromisos
- ~21k
- Líneas de código
cómo lo medimos
create table / enable row level security en las migrations de supabase/migrations
cómo lo medimos
grep 'create policy' en las migrations
cómo lo medimos
sentencias create or replace function distintas en las migrations (schema public + privado)
cómo lo medimos
ls supabase/migrations
cómo lo medimos
entradas route()/index() en app/routes.ts
cómo lo medimos
npx vitest run ejecutado localmente: 13 archivos, 154 pruebas, todas aprobadas
cómo lo medimos
git rev-list --count HEAD en el CRM y en el sitio
cómo lo medimos
líneas no vacías de .ts/.tsx/.sql/.mjs/.css versionados en el CRM, sin contar los tipos generados ni geo-ras.ts
09Línea de tiempo
- sep 2026
Diagnóstico de la planilla y del proyecto Supabase; área administrativa completa (clientes, cumpleaños, productos, etiquetas de precio) en el primer commit
- sep 2026
Órdenes de servicio con etiqueta de taller y comprobante A5; leads del sitio y vitrina pública; login con código OTP y fin del registro público
- sep 2026
Rendimiento: un viaje a la base por clic, proyecto trasladado a São Paulo, correos con la marca vía hook de Supabase + Resend, Turnstile en el login y en los formularios del sitio
- sep 2026
Editor de etiquetas con texto que se ajusta, etiqueta de 50×30 y tema ámbar; catálogo de marcas/modelos que aprende solo; planilla de clientes eliminada del historial de git
- sep 2026
Panel con un mapa del Distrito Federal en MapLibre coloreado por región administrativa, gráficos y filtros por barrio, región y cuadra
- sep 2026
Cuadrícula de clientes con carné y edición en la celda; menú por secciones, paleta Ctrl K y Configuración rehecha; el sitio empieza a registrar los leads en el CRM
10Stack
- React 19
- React Router 7 (framework mode, SSR)
- TypeScript 5.9
- Vite 7
- Tailwind CSS 4
- Radix UI
- cmdk
- MapLibre GL 6
- Astro 7 (site)
- Cloudflare Workers
- @cloudflare/vite-plugin
- Loaders e actions do React Router
- @supabase/ssr
- Zod 4
- Resend (API HTTP)
- Supabase Postgres 17
- Row Level Security
- PostgREST
- Views security_invoker
- PL/pgSQL
- pg_trgm + unaccent + citext
- Colunas geradas e tsvector
- Workers com smart placement
- Custom domain
- Workers Builds (site)
- Workers Static Assets
- OpenFreeMap
- Vitest + Playwright
- OTP por e-mail (8 dígitos)
- Cloudflare Turnstile
- JWT verificado localmente (JWKS embutido)
- Cookies httpOnly/secure
- Standard Webhooks HMAC
- Schema privado para helpers de RLS
- Default privileges restritivos
- CORS allowlist + honeypot
11Ficha técnica
- type
- CRM + sitio web · servicio técnico de computadoras
- stack
- React Router v7 SSR · React 19 · Tailwind v4 · Astro 7
- db
- Supabase Postgres 17 · 13 tablas · RLS en todas
- auth
- OTP por correo · Turnstile · JWT verificado en el borde
- deploy
- Cloudflare Workers (smart placement) · Workers Builds
- modules
- clientes · órdenes de servicio · etiquetas de precio · vitrina · leads · panel
- tests
- 154 unitarias · 4 guiones de Playwright
- status
- en producción desde sep. de 2026
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.
Un asistente de IA que responde con fuentes y limita el gasto mediante cuatro capas de control.
¿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.