07 Módulo Ajustes de Tienda y Subida de Logo con Base de Datos Por Separado Laravel MultiTenant Saas

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

Descripció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

TipoComando / RutaDescripción
Comando Artisanphp artisan make:model Setting -m --path=database/migrations/tenantCrea el modelo Setting y su migración dentro del contexto aislado de los tenants.
Comando Artisanphp artisan tenancy:migrateImpacta la estructura de la tabla settings en todas las bases de datos de los inquilinos.
Comando Artisanphp artisan storage:linkCrea el enlace simbólico entre storage/app/public y public/storage para servir archivos multimedia.
Vista Bladeresources/views/tenant/settings/edit.blade.phpFormulario de edición de parámetros generales y carga del logotipo de la tienda.
Ruta HTTP TenantGET /settingsFormulario para consultar y editar las configuraciones del inquilino activo.
Ruta HTTP TenantPOST /settings/updateProcesa la actualización de datos comerciales y el almacenamiento del logo.

🔒 Buenas Prácticas y Seguridad

  1. 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.
  2. 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.
  3. 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.
  4. 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.