Una plataforma multi tenant para franquicia de servicios en LATAM aisla cada franquicia en su propio espacio dentro de la misma base de datos via RLS de Postgres con JWT custom claims, gestiona pagos con Stripe Connect Standard, audita cada acción con hash SHA-256 inmutable y permite rollout en olas sin downtime. En Catalizadora la construimos para una distribuidora internacional con 100 franquicias en exactamente 12 semanas sin piloto, inversión 26,000 USD fijo. Lo que antes tomaba 30 ingenieros y 18 meses lo entregamos en semanas.
Si lideras franquicia de servicios en LATAM (control de plagas, limpieza, jardinería, restaurantes, retail) con 10 a 500 franquiciatarios y necesitas plataforma unificada, este post te ordena la arquitectura.
Por qué multi tenant es la arquitectura correcta
Multi tenant es la arquitectura correcta para franquicia de servicios por cuatro razones operativas.
Primero, aísla datos por franquicia. Cada franquiciatario ve solo sus clientes, sus técnicos, sus facturas. Sin filtraciones cross franquicia. La RLS de Postgres con JWT custom claims resuelve esto a nivel de query, no de aplicación.
Segundo, mantiene una sola base de código. No tienes 100 deploys distintos, tienes uno solo. Cambios y mejoras llegan a todas las franquicias al mismo tiempo. El admin central ve todo cruzado.
Tercero, escala económicamente. Una base de datos compartida con RLS es más barata que 100 bases separadas. Costo operacional baja significativamente.
Cuarto, permite features cross franquicia. Cross-sell entre franquicias, benchmarking competitivo, agregación regional. Imposible con bases separadas.
Módulos obligatorios en plataforma multi tenant de franquicia
Un sistema serio incluye doce módulos en la primera entrega:
- Onboarding automatizado de franquicia con flujo paso a paso
- RBAC por rol y por franquicia (7 roles típicos)
- Catálogo de servicios configurable por franquicia
- Gestión de clientes por franquicia con historial completo
- Agenda de visitas con asignación de técnicos
- Cobranza con Stripe Connect Standard por franquicia
- Cross-sell intelligence con scoring de oportunidades entre franquicias
- Reportería avanzada con KPIs por franquicia y agregados
- Audit trail inmutable con hash SHA-256 verificable
- Token credits system pass-through sin margen
- WhatsApp Business multi bot (1 por franquicia)
- Onboarding y capacitación con material por franquicia
Módulos opcionales en fase 2: AI Sales Engine con lead scoring, Enhanced Pest Control o equivalente vertical, integración con sistemas legacy del headquarters, multi idioma con AI batch translation.
Stack recomendado para plataforma multi tenant LATAM
El stack que funciona para multi tenant con 100 franquicias:
- Frontend Next.js con SSR para reportería y CSR para dashboards operativos
- Backend FastAPI con workers para procesos pesados (sync, reportes, IA)
- Base de datos Postgres en Supabase Pro con RLS por oficina vía JWT custom claims
- Stripe Connect Standard, cada franquicia titular de su cuenta
- Twilio o Meta WhatsApp Business API con bot fleet (1 por franquicia)
- Audit trail con SHA-256 hash chain trigger automático en cada INSERT
- Cloudflare Pages o Vercel para frontend, Hetzner para backend
- Sentry para errores, Mapbox para mapas, next-intl con AI batch translation
Si tu franquicia tiene 10 a 50 franquiciatarios, MAGIA Forge a 20,000 USD por 12 semanas. Si tiene 100+ franquiciatarios o requisitos complejos, MAGIA Forge extendido a 26,000-50,000 USD.
El caso real: 100 franquicias multi tenant en 12 semanas
Una distribuidora internacional con holding en Delaware contrató a Catalizadora en 2026 para lanzar plataforma multi tenant a 100 franquicias en 12 semanas sin piloto. La inversión fue 26,000 USD fijo.
- 249 issues en Linear, 886 story points, 12 sprints semanales
- 5 módulos completos: Cross-Sell, AI Sales, Token Credits, Reportería Avanzada, Enhanced Pest Control
- 28 KPIs en reportería final calculados en JS con narrativa AI sobre datos verificados
- 14 secciones HTML v3 de Enhanced Pest Control
- Audit trail inmutable con hash SHA-256 verificable
- 100 cuentas Stripe Connect Standard con pass-through sin margen
- 7 roles RBAC: tni_admin, tni_regional, franchise_owner, franchise_admin, franchise_manager, franchise_user, auditor
- Wave model: 3 olas de testing más go live el 26 de julio de 2026
La RLS por oficina con JWT custom claims aisló las 100 franquicias en una sola base de datos. Cero filtración cross franquicia. Cero downtime durante go live. Pruebas de carga con 1,000 usuarios concurrentes pasadas.
Arquitectura de RLS multi tenant en detalle
RLS (Row Level Security) de Postgres con JWT custom claims es la arquitectura más segura para multi tenant.
Cómo funciona:
- El usuario hace login y Supabase Auth genera JWT con custom claims (incluyendo oficina_id)
- Cada query a Postgres se ejecuta con el JWT del usuario adjunto
- Las políticas RLS leen oficina_id del JWT y filtran rows automáticamente
- El usuario solo puede ver y modificar rows de su oficina, sin importar la query que escriba
Beneficios:
- Aislamiento garantizado a nivel de base de datos, no de aplicación
- Imposible de evadir desde el frontend
- Auditable y verificable
- Performance óptimo con índices por oficina_id
- Una sola base de datos para 100 franquicias
Lo usamos para 100 franquicias sin incidentes. Es la arquitectura más recomendada por Postgres y Supabase oficial.
Wave model: cómo es rollout sin piloto
Wave model significa 3 olas de testing más go live, sin pausa de piloto.
- Ola 1: grupo piloto de 5 franquicias amigables que prueban en staging por 2 semanas
- Ola 2: seguidores cercanos, 20 franquicias en staging por 1 semana
- Ola 3: todas las 100 franquicias en staging por 3 días pre go live
- Go live: el día anunciado, todas pasan a producción al mismo tiempo
Wave model evita el cliff de un go live de golpe, pero también evita el costo de un piloto eterno que retrasa el lanzamiento. Lo construimos así en 2026.
Tres errores caros en plataforma multi tenant
Tres errores que vemos repetidos en multi tenant.
- RLS desactivado o con políticas read_all. Cuando llega el primer usuario adversario o un bug, hay filtración masiva.
- Bases de datos separadas por tenant. Operacionalmente imposible mantener 100 bases. Costo se va al cielo.
- Sin audit trail inmutable. Cuando llega un reclamo legal de un franquiciatario, no puedes demostrar qué pasó.
En MAGIA Forge esos tres errores están bloqueados de fábrica: RLS estricta desde sprint 1, base unificada con RLS por tenant, audit trail con SHA-256 desde el día 1.
Próximos pasos
Si lideras franquicia de servicios en LATAM y necesitas plataforma multi tenant para escalar, agenda una llamada de 30 minutos donde mapeamos tu modelo de franquicia, tus sistemas actuales y tus requisitos, y te entregamos blueprint con módulos, arquitectura y timeline.
- MAGIA Core si tienes franquicia chica con 5-15 franquiciatarios y quieres centralizar sin multi tenant complejo
- MAGIA Forge si tienes franquicia con 20-500 franquiciatarios y necesitas multi tenant, audit trail, Stripe Connect y rollout en olas
Llamada con el equipo que construye, no con un SDR.