05 CRUD Como Registrar Tiendas, Subdominios y Base de Datos Por Separado Laravel Multi-Tenant Saas

Duración: 24 min
Módulo: Onboarding, Autenticación y Administración de Tenants Lección 1 de 3

Descripción

🎓 Lección 05: Registro de Tiendas, Subdominios y Base de Datos Independiente en Laravel Multi-Tenant

El propósito de esta lección es implementar la arquitectura Multi-Tenant SaaS mediante un CRUD completo en el panel central que gestione el registro de tiendas (Tenants), asignando a cada cliente su propio subdominio único y automatizando la aprovisionación de una base de datos aislada por inquilino.

🚀 Pasos Clave con Timestamps

  • 📂 Creación de la Migración y Modelo Tenant: Diseñar la tabla tenants con los campos fundamentales (id, domain, tenancy_db_name, etc.) y configurar el modelo Eloquent correspondiente.⏱️ 01:10
  • 🎨 Maquetación del Formulario de Registro: Construir la vista Blade del formulario dentro de la plantilla Sneat para capturar el nombre de la tienda, correo del propietario y el subdominio deseado.⏱️ 03:25
  • 🔍 Validación de Datos y Subdominios Únicos: Implementar Form Requests para validar que el subdominio no contenga caracteres especiales, espacios ni esté registrado por otro usuario en la plataforma.⏱️ 05:40
  • ⚙️ Controlador TenantController y Creación de Tenant: Programar la acción store() en el controlador central para instanciar el nuevo inquilino utilizando la API del paquete de Tenancy.⏱️ 08:15
  • 🗄️ Automatización de Base de Datos e Inserción de Dominio: Disparar los eventos del ciclo de vida de Tenancy para crear la base de datos física en MySQL y vincular el registro de dominio al cliente.⏱️ 10:50
  • 📊 Listado y Estado de Tiendas en el Dashboard: Diseñar la tabla de administración en el panel central mostrando la lista de clientes registrados, su subdominio y el estado de la base de datos.⏱️ 12:30

🛠️ Comandos y Rutas Principales

TipoComando / RutaDescripción
Comando Artisanphp artisan make:model Tenant -mCrea el modelo Tenant junto con su respectiva migración para la base de datos central.
Comando Artisanphp artisan make:controller TenantControllerGenera el controlador de gestión de tiendas para el panel central.
Comando Artisanphp artisan tenancy:migrateEjecuta las migraciones específicas dentro de cada base de datos de los inquilinos.
Vista Bladeresources/views/admin/tenants/create.blade.phpFormulario de registro para nuevas tiendas y asignación de subdominios.
Ruta HTTPGET /tenantsDespliega el listado completo de tiendas (Tenants) registradas.
Ruta HTTPPOST /tenantsProcesa el formulario, crea la base de datos y registra el subdominio del tenant.

🔒 Buenas Prácticas y Seguridad

  1. Aislamiento Estricto de Datos (Database-per-Tenant): Asignar una base de datos física independiente para cada cliente evita filtraciones accidentales de información entre inquilinos y simplifica las copias de seguridad individuales.
  2. Sanitización Rígida de Subdominios: Valida que los subdominios contengan exclusivamente caracteres alfanuméricos en minúsculas ([a-z0-9-]) y restringe palabras clave reservadas del sistema (como admin, api, dashboard, www).
  3. Transacciones de Base de Datos y Manejo de Eventos: Envuelve la creación del Tenant y el registro del dominio en transacciones SQL para asegurar la atrocidad; si la creación física de la base de datos falla, se deben revertir los cambios en la base de datos central.
  4. Permisos y Control de Acceso Centralizado: Restringe las rutas de creación de tiendas exclusivamente a los administradores del sistema principal (Super Admin) mediante middleware de autenticación y roles.