SaaS multiarrendamiento con Laravel: arquitectura para escalar
El multiarrendamiento dejó de ser un tema de startups
Hasta hace poco, armar un producto con varios clientes sobre la misma base de código era una decisión reservada a startups que buscaban crecer rápido. Hoy aparece en proyectos mucho más concreto: una distribuidora que quiere darle a cada sucursal su propio panel, una agencia que quiere ofrecer el mismo sistema a veinte marcas, un fabricante que vende parametrizaciones distintas por región. En todos esos casos la pregunta no es si se puede hacer, sino cuándo conviene hacerlo bien.
Un error frecuente es tratar el multiarrendamiento como una capa de filtros que se agrega al final. Funciona durante los primeros meses, cuando hay tres clientes y todos conocen al que está del otro lado. Se rompe cuando aparece el cuarto, cuando alguien pide exportar sus datos, cuando un cliente reclama que vio información de otro o cuando el equipo intenta facturar por uso. En ese momento la arquitectura original pasa a ser el cuello de botella comercial.
La documentación oficial de Laravel (https://laravel.com/docs) reúne los componentes que hacen viable esta arquitectura sin inventar infraestructura propia: middleware, query scopes, policies, colas, eventos y almacenamiento por disco. La clave no es la herramienta, sino decidir dónde vive el límite de cada cliente antes de escribir la primera migración.
Qué significa multiarrendamiento (y qué no)
Un sistema multiarrendamiento, o multi-tenant, es una instancia de software que atiende a varios clientes con una única base de código, manteniendo sus datos y su configuración separados. Cada cliente es un arrendatario (tenant). Lo que cambia entre arrendatarios suele ser información, permisos, parametrizaciones y, a veces, aspectos de la interfaz.
Base de datos compartida o separada
No existe una respuesta universal. En una base compartida, todas las tablas incluyen un identificador de arrendatario y cada consulta lo respeta. Es la opción más eficiente y la más riesgosa si el filtro se olvida en un join. En una base por cliente, el aislamiento es físico y las migraciones se multiplican: con cincuenta clientes, cada cambio de esquema se ejecuta cincuenta veces.
El camino intermedio que más usamos en proyectos B2B es una base compartida con esquemas o tablas separadas para los datos sensibles, y una capa de acceso que impide consultar sin el contexto del arrendatario. Así se conserva la eficiencia operativa sin dejar el aislamiento librado a la memoria de quien escribe el query.
Identidad y resolución del arrendatario
El identificador del cliente debe resolverse temprano y una sola vez. Puede venir del subdominio, del token de sesión o de un encabezado de una API, pero conviene que el resto de la aplicación lo reciba como un objeto ya validado, no como un parámetro que cada controlador interpreta a su manera.
En Laravel, un middleware que resuelve el arrendatario y lo deja disponible en el contenedor es suficiente para empezar. A partir de ahí, los scopes globales y las policies hacen el trabajo pesado: ninguna consulta debería poder escapar del arrendatario activo, ni siquiera cuando la escribe alguien nuevo en el equipo.
Señales de que tu producto necesita esta arquitectura
Hay síntomas bastante claros. El primero es repetición: clonás el proyecto para cada cliente y después mantenés versiones paralelas. El segundo es configuración dispersa: los valores que cambian por cliente viven en archivos, variables de entorno o directamente en el código. El tercero es operación frágil: cada alta nueva implica intervención manual de alguien del equipo técnico.
También aparece cuando el negocio quiere vender por uso o por módulos y el sistema no sabe distinguir qué cliente consumió qué. En ese escenario, la facturación se arma a mano con planillas, y la discusión con el cliente se vuelve subjetiva. Un modelo multiarrendamiento bien llevado convierte esos consumos en datos, y los datos en facturas.
Antes de decidir, mirá desarrollo web a medida vs plantillas y, si el sistema actual ya tiene años, cuánta deuda técnica hay antes de prometer una migración.
Cinco decisiones que definen el resultado
1. El identificador de arrendatario va en el modelo de datos desde el día uno
Agregarlo después implica revisar cada tabla, cada índice y cada consulta. Ponerlo desde el principio cuesta poco y evita una migración traumática. Además, permite definir índices compuestos que hagan eficientes las consultas con filtro por cliente.
2. La resolución del arrendatario vive en un solo lugar
Si el tenant se detecta en el middleware, en el controlador y en el job, vas a tener tres verdades distintas. Un único punto de resolución simplifica las pruebas y hace auditable el acceso.
3. Las colas heredan el contexto
Este es el olvido más común. La petición HTTP corre con el arrendatario correcto, pero el job en segundo plano se ejecuta sin ese contexto y termina escribiendo en el lugar equivocado. Toda tarea asíncrona debe recibir el identificador del arrendatario como parte de su payload y restaurarlo al ejecutarse.
4. El almacenamiento de archivos también se separa
Facturas, logos y documentos adjuntos necesitan rutas o discos por cliente. No alcanza con que la base esté aislada si cualquier usuario con un enlace puede acceder a un archivo de otra cuenta.
5. La observabilidad se mide por arrendatario
Los logs, las métricas y los errores deben llevar el identificador del cliente. Cuando alguien reporta un problema, querés filtrar por su cuenta, no buscar una aguja en un pajar de miles de eventos mezclados.
Errores que vemos en auditorías
El más grave es confiar en que el frontend oculta lo que no debe verse. Si el IDs del cliente se puede cambiar en la URL y el backend no valida permisos, existe un problema de seguridad, no de interfaz. Las policies de Laravel existen justamente para resolver esto en el servidor.
También es habitual subestimar las migraciones. Con un esquema por cliente, una cambio simple se convierte en una operación que hay orquestar, reintentar y verificar. Si no hay automatización, el riesgo de dejar clientes en versiones distintas es real. En Laravel y parches de mantenimiento explicamos por qué la disciplina de actualización es parte del diseño, no un trámite posterior.
Cuándo no conviene
Un multiarrendamiento mal justificado agrega complejidad. Si vas a tener dos clientes, con necesidades muy distintas y sin expectativa de crecimiento, probablemente sea más barato mantener dos instancias. Si el cliente exige infraestructura dedicada por contrato o por regulación, el modelo compartido no aplica, aunque puedas simularlo.
Cómo lo encaramos en Codit Digital
Primero definimos el límite de arrendatario junto con el modelo de negocio: qué se factura, qué se personaliza y qué debe quedar prohibido ver. Después armamos una vertical delgada —un cliente real de punta a punta— para validar el aislamiento antes de escalar. Recién ahí automatizamos el alta de nuevos clientes, las migraciones y la observabilidad.
Ese enfoque reduce el riesgo y deja un sistema que puede seguir creciendo sin que cada nuevo cliente implique una reescritura. Si estás evaluando un producto multi-cliente o querés ordenar uno que ya existe, charlemos: en Codit Digital diseñamos arquitecturas Laravel pensadas para escalar y para mantenerse. También podés escribirnos desde nuestro contacto.