07 Módulo Ajustes de Tienda y Subida de Logo con Base de Datos Por Separado Laravel MultiTenant Saas
Duración: 21 minDescripción
🎓 Lección 07: Módulo de Configuración de Tienda y Carga de Logotipo con Base de Datos Independiente en Laravel Multi-Tenant
El propósito de esta lección es implementar el módulo de ajustes e identidad visual para cada tienda (Tenant) en la arquitectura SaaS, permitiendo gestionar de forma aislada datos generales como el nombre del negocio, logotipo, divisa, número telefónico y dirección dentro de su respectiva base de datos e hipervínculos de almacenamiento.
🚀 Pasos Clave con Timestamps
- 🗄️ Creación de la Migración y Modelo Setting para Tenant: Generar la tabla de configuraciones settings especificando los campos clave (nombre, logo, divisa, telefono, direccion) dentro del directorio de migraciones exclusivo del inquilino database/migrations/tenant.⏱️ 01:20
- ⚡ Ejecución de Migraciones y Seeder Inicial de Ajustes: Correr el comando de migración para tenants y poblar la tabla con datos por defecto mediante un Seeder para garantizar que cada tienda nueva nazca con un registro inicial de configuración.⏱️ 04:15
- 🛣️ Definición de Rutas y Controlador SettingController: Registrar las rutas HTTP protegidas dentro de routes/tenant.php y crear el controlador para gestionar la lectura (edit) y actualización (update) de la tienda activa.⏱️ 07:30
- 🎨 Maquetación de la Vista Blade de Ajustes: Diseñar la interfaz gráfica del formulario de configuración en Sneat integrando previsualización dinámica de imágenes y campos para los parámetros comerciales del negocio.⏱️ 11:05
- 🖼️ Carga y Almacenamiento de Logotipos: Procesar la subida del archivo de imagen en el controlador, guardándolo dentro de la carpeta pública del tenant mediante Storage::disk('public') y reemplazando la imagen anterior si existe.⏱️ 15:20
- 🔄 Sincronización Global en el Layout Central del Tenant: Inyectar los datos guardados (como el logo y nombre de la tienda) en la barra de navegación y encabezados del panel administrativo del tenant.⏱️ 18:45
🛠️ Comandos y Rutas Principales
| Tipo | Comando / Ruta | Descripción |
|---|---|---|
| Comando Artisan | php artisan make:model Setting -m --path=database/migrations/tenant | Crea el modelo Setting y su migración dentro del contexto aislado de los tenants. |
| Comando Artisan | php artisan tenancy:migrate | Impacta la estructura de la tabla settings en todas las bases de datos de los inquilinos. |
| Comando Artisan | php artisan storage:link | Crea el enlace simbólico entre storage/app/public y public/storage para servir archivos multimedia. |
| Vista Blade | resources/views/tenant/settings/edit.blade.php | Formulario de edición de parámetros generales y carga del logotipo de la tienda. |
| Ruta HTTP Tenant | GET /settings | Formulario para consultar y editar las configuraciones del inquilino activo. |
| Ruta HTTP Tenant | POST /settings/update | Procesa la actualización de datos comerciales y el almacenamiento del logo. |
🔒 Buenas Prácticas y Seguridad
- Aislamiento de Archivos Multimedia por Inquilino: Almacena las imágenes y documentos subidos en subcarpetas especificadas por el ID o subdominio del tenant (p. ej., storage/tenant_{id}/app/public) para evitar que dos tiendas sobrescriban archivos con el mismo nombre.
- Validación Estricta del Tipo de Archivo (MIME Type): Valida en el Form Request que el logotipo cargado sea una imagen válida (image/jpeg, image/png, image/webp) con un tamaño máximo permitido (p. ej., max:2048) para proteger el servidor de scripts maliciosos.
- Registro Unico de Configuración (Singleton Pattern): Utiliza una estructura donde la tabla settings contenga un solo registro de datos por inquilino o aplica el patrón de actualización updateOrCreate(['id' => 1], ...) para prevenir duplicados imprevistos.
- Eliminación Segura de Recursos Antiguos: Al actualizar el logotipo de la tienda, remueve el archivo previo del disco utilizando Storage::disk('public')->delete($old_logo) para mantener limpio el espacio en servidor.