El CMS Headless, Multi-Idioma y Multi-Tenant que Sirve a Agencias Enteras desde una Única Plataforma
Construí desde cero un CMS headless multi-tenant en Laravel 12 y Filament 4, con modelado de contenido dinámico en PostgreSQL/JSONB, aislamiento total entre tenants, 603 tests y respuestas de API por debajo de 20ms vía Octane. Fue diseñado para servir más de 50 sitios desde un único panel, desde mi propio rafhael.pro hasta el menú digital de una panadería.
- Cliente
- SaaS
- Rol
- Arquitectura, Desarrollo, Infraestructura y Operación
- Período
- Producción Continua desde 2025
Rush CMS es mi SaaS: un CMS headless multi-tenant construido en Laravel 12 y Filament 4 para quien gestiona muchos sitios al mismo tiempo: agencias y operaciones con decenas de dominios bajo el mismo techo. En lugar de mantener 50 instalaciones separadas de WordPress, una única instancia de Laravel sirve a todos los clientes con aislamiento de datos, cada uno con su contenido, sus usuarios, sus permisos y su API.
A diferencia del resto de mi portafolio, este no es un proyecto de cliente. Es un producto que yo diseñé, construí y mantengo solo, de punta a punta: del modelo de datos a la infraestructura, del panel administrativo a la capa de API, del aislamiento de tenant al pipeline de 603 tests. Es la pieza donde mis decisiones de ingeniería aparecen sin intermediario, porque cada una fue mía.
Y ya está en producción. El propio sitio que estás leyendo, rafhael.pro, corre en Rush CMS. Una panadería con menú digital completo también. Casos de uso radicalmente distintos servidos por la misma base, que es exactamente el punto de un CMS multi-tenant eficiente. El producto vive en rushcms.com.
El problema que Rush resuelve
Quien mantiene muchos sitios pequeños y medianos conoce el dolor: cada sitio se vuelve una instancia separada de WordPress (o similar), con su propia actualización, su propio backup, su propia superficie de ataque, su propia cuenta de hosting. Diez sitios se vuelven diez sistemas que mantener. Cincuenta se vuelven una pesadilla operativa.
La alternativa obvia, "un WordPress multisite", resuelve parte del problema y crea otros: acoplamiento entre sitios, plugins que rompen a todos de una vez, y un modelo de contenido atado a "posts y páginas" que no le sirve a quien necesita estructuras de datos propias. Otro motivo: detesto tener que meterme con WordPress; cuando de verdad lo necesito, tengo que usar Sage para sufrir mentalmente menos.
Yo quería otra cosa: una plataforma donde agregar un nuevo sitio fuera agregar un tenant, no levantar un servidor. Donde el modelo de contenido lo definiera quien lo usa, no lo impusiera la herramienta. Y donde el rendimiento de entrega no dependiera de un cache improvisado encima de un sistema lento por naturaleza.
"Ah, ¿y Strapi? Existen diversas soluciones en el mercado", sí existe, y ninguna me atendió de la forma que yo necesitaba - y quería. i18n first, multi-tenant aislado de fábrica, collections con databases, etc.
Las decisiones de arquitectura
Este es el corazón de este case, porque Rush CMS es, ante todo, un conjunto de decisiones técnicas conscientes. Cada una tiene un porqué.
Multi-tenancy con aislamiento real vía global scopes
Los tenants están 100% aislados, y no existe un super-admin que vea los datos de todos los clientes, esa fue una decisión deliberada de seguridad y privacidad. El aislamiento lo hace un global scope en Eloquent: toda query de un modelo tenant se filtra automáticamente por site_id a partir del tenant resuelto por Filament. El resultado es cero fuga de datos entre sitios, con la regla de aislamiento explícita en el código y cubierta por tests, no escondida detrás de magia del framework.
En un producto multi-tenant, un bug que filtra datos de un cliente a otro no es un bug común, es un incidente de seguridad. Por eso el aislamiento se testea, no se confía.
Modelado de contenido dinámico en PostgreSQL con JSONB
Esta es la decisión más importante del proyecto. En lugar de crear una tabla y una migration para cada nuevo tipo de contenido, Rush almacena el schema de las Collections y los datos de las Entries en JSONB en PostgreSQL, con índices GIN para búsqueda. En la práctica: un usuario puede crear una nueva Collection, con sus propios campos, sin que corra una sola migration en la base de datos.
Esto es lo que permite el sistema de Collections al estilo Notion/Statamic: listas y bases de datos que el usuario arma por sí mismo, pudiendo incluso encadenarlas como dependencias jerárquicas. Marcas de autos que se desdoblan en modelos. Estados que se desdoblan en ciudades, en cascada reactiva. O algo simple como una lista de "tipos de tecnología" aplicada a una collection para volverse un campo de selección a la hora de crear una entry.
El modelo de datos deja de ser definido por mí, en el código, y pasa a ser definido por quien lo usa, en runtime.
Generación de clases PHP en runtime para Custom Blocks
Este es un truco técnico: los Custom Blocks del editor de contenido los define el usuario en la base de datos, con {nombre, ícono, campos}, y necesitan convertirse en clases PHP reales para que el editor (Filament RichEditor/TipTap) los reconozca. El primer enfoque fue class_alias(), pero tiene una limitación: dentro del método, static::class sigue devolviendo la clase base, así que el bloque no sabe quién es. La solución fue generar subclases reales en runtime vía eval(), donde cada bloque conoce su propio slug.
Usar eval() es el tipo de decisión que exige justificar el trade-off de seguridad: el template del código está hardcodeado, la única parte dinámica es el slug (validado por la base de datos y sanitizado vía Str::studly()), y ningún input de usuario llega al eval(). Es una solución correcta para un problema real, con el riesgo mapeado y contenido.
Rendimiento de entrega
Octane + RoadRunner con respuestas por debajo de 20ms
Un CMS headless vive o muere por la latencia de la API, es ella la que alimenta los frontends. Corro Rush sobre Laravel Octane con RoadRunner, manteniendo la aplicación viva en memoria entre requests en lugar de levantar y tumbar el framework en cada llamada. El resultado son respuestas de API de ~20ms en endpoints simples y ~50ms en los complejos, lo bastante rápidas para servir sitios SSR y estáticos vía SSG con webhooks de rebuild, con cache de API en Redis por encima.
Operar Octane impone disciplina: el estado compartido entre requests es una trampa, el código fue escrito con eso en mente, sin propiedades estáticas acumulando datos de request, inyección de dependencias en lugar de singletons con estado, y workers que se reciclan cada 10.000 jobs para contener fugas de memoria.
i18n desde el día 0
Rush es 100% i18n-first: fue pensado para multi-idioma desde la base. Es posible crear entries y otros contenidos en múltiples idiomas de forma nativa, y la propia plataforma está disponible en portugués e inglés. La internacionalización en este CMS es parte de la estructura. Quedó así porque mi sitio tiene la necesidad real de tener más de un idioma, y en mi filosofía para este proyecto, si Rush CMS no atiende 100% a mi propio sitio, no va a atender a nadie más.
Nota: el repo de este sitio es público, puedes acceder en https://github.com/rush-cms-showcase/rafhael, esa org tiene todos los sitios de clientes que permitieron el repositorio público.
Lo que Rush hace
Por debajo de esas decisiones, Rush es un CMS completo, no un prototipo:
- Collections personalizables con 13+ tipos de campo y un sistema de listas/bases reutilizables y encadenables como dependencias
- Custom Blocks generados en runtime, con editor de contenido estilo TipTap y bloques listos como YouTube y galería con lightbox
- Block builder de homepage para armar la página de inicio en la plataforma
- Form builder con captura automática de UTMs/referrer y envío de e-mails a la empresa y al remitente
- Menu builder jerárquico con tags, categorías y webhooks
- Sistema de miembros para sitios con contenido exclusivo por área logueada
- Gestión de usuarios y roles con 100+ permission nodes, en el patrón
acción:recursode Filament - Integración con Google Analytics vía OAuth2
- Importador de WordPress que convierte HTML en bloques, con preview y dry-run
- Integración MCP para controlar el CMS vía LLM (ChatGPT, Claude) por lenguaje natural, con tokens aislados por tenant
- Conversión automática de imágenes a WebP en todos los campos de imagen, con 50-70% de ahorro de espacio
- Plataforma bilingüe (pt-br/en) completa
La ingeniería detrás
Lo que vuelve a Rush sostenible a largo plazo no es la lista de features, es el rigor por debajo de ellas:
- 603 tests automatizados con Pest
- PHPStan/Larastan Level 5 para análisis estático y detección de errores antes del runtime
- Laravel Pint
- CI/CD vía GitHub Actions corriendo tests, análisis estático, code style, auditoría de seguridad y build del frontend en cada push
- Eliminación sistemática de N+1 usando eager loading y cache en Redis
- Documentación como código, al estilo ADR: Cada decisión de peso está registrada
La infraestructura
Rush corre en servidores Hetzner gestionados vía Coolify, con PostgreSQL 16, Redis 7, Nginx y Supervisor para los queue workers. Es una elección de self-hosting que mantiene un costo bajo y predecible, toda la operación queda en la casa de unas pocas decenas de reales al mes, manteniendo el control total sobre la VPS.
Errores de Sentry, backup automatizado a S3 con lifecycle policy y monitoreo cierran esta cuenta, el mismo principio que guía el código guía la infra: la solución más simple y directa que entrega el resultado, sin complejidad innecesaria.
En resumen, ¿qué demuestra este proyecto?
Rush CMS es una prueba de concepto ambulante, muestra tres cosas que un case de cliente rara vez logra mostrar con la misma claridad:
- Profundidad arquitectónica. - Las decisiones difíciles, como aislamiento de tenant por global scope, modelado dinámico en JSONB, generación de clases en runtime, rendimiento vía Octane, la migración medida a PostgreSQL, fueron todas tomadas y defendidas por mí, y están en producción sosteniendo datos reales de clientes reales.
- Mantenimiento de largo plazo. - Después del MVP es cuando la cosa se pone fea: mantener un producto multi-tenant vivo, testeado y rápido a lo largo de meses, con CI/CD y documentación de decisiones, es una demostración de mantener un proyecto en producción.
- Pragmatismo bajo restricción. - Un único desarrollador con infraestructura barata, stack ajustado, y aun así un CMS diseñado para 50+ sitios aislados, sirviendo por debajo de 20ms. Muestra que no hace falta tener recursos infinitos, sino tomar la decisión correcta en cada bifurcación.