09 CRUD Productos con Galería de Múltiples Imágenes en Base de Datos Separada Laravel Multi-Tenant

Duración: 26 min
Módulo: Gestión de Catálogo y Poblamiento de Datos (Tenant BD) Lección 2 de 4

Descripción

🎓 Lección 09: CRUD de Productos con Galería de Imágenes Múltiples y Relaciones en Laravel Multi-Tenant

El propósito de esta lección es desarrollar el módulo integral de gestión (CRUD) para productos dentro de cada tienda (Tenant), asociando categorías, stock, precios y la subida de múltiples fotografías procesadas y almacenadas de forma independiente en la base de datos y disco de cada cliente.

🚀 Pasos Clave with Timestamps

  • 🗄️ Modelo Product y Migración con Claves Foráneas: Diseñar la tabla products en database/migrations/tenant incorporando campos para código, nombre, precio, stock, descripción y la relación category_id vinculada a las categorías de la tienda.⏱️ 01:15
  • 🖼️ Tabla product_images para Galería Múltiple: Crear la migración y el modelo ProductImage para gestionar una relación de uno a muchos (hasMany), permitiendo asociar múltiples fotografías a un solo producto.⏱️ 04:30
  • ⚡ Ejecución de Migraciones Tenant: Correr el comando de migración aislado para actualizar las tablas en todas las bases de datos registradas para los distintos inquilinos.⏱️ 07:10
  • 🛣️ Rutas y Controlador ProductController: Configurar el recurso de rutas para el tenant y construir las acciones para el listado, creación, edición, actualización y eliminación de productos.⏱️ 09:40
  • 📤 Subida y Procesamiento de Imágenes Múltiples: Implementar la recepción del arreglo de archivos (images[]) en el controlador, almacenando cada archivo en el disco público aislado del tenant y guardando sus rutas en la base de datos.⏱️ 14:25
  • 🎨 Vista Sneat de Productos y Visor de Galería: Diseñar la interfaz con previsualización dinámica de imágenes mediante componentes de Sneat y modal de confirmación para borrado físico de fotos y registros.⏱️ 19:50

🛠️ Comandos y Rutas Principales

TipoComando / RutaDescripción
Comando Artisanphp artisan make:model Product -m --path=database/migrations/tenantCrea el modelo y la migración del producto en el directorio del tenant.
Comando Artisanphp artisan make:model ProductImage -m --path=database/migrations/tenantCrea el modelo y la migración para las imágenes de la galería del producto.
Comando Artisanphp artisan tenancy:migrateEjecuta las migraciones de productos y galerías en las bases de datos de todos los clientes.
Vista Bladeresources/views/tenant/products/create.blade.phpFormulario con selector de categorías e input file múltiple para imágenes.
Ruta HTTP TenantGET /productsMuestra el listado de productos de la tienda con paginación y miniaturas.
Ruta HTTP TenantPOST /productsAlmacena el producto y procesa la carga del paquete de imágenes adjuntas.

🔒 Buenas Prácticas y Seguridad

  1. Almacenamiento Aislado por Tenant: Estructura las carpetas de almacenamiento para que cada tienda guarde sus imágenes en su propio subdirectorio (p. ej., storage/tenants/{tenant_id}/products/), evitando conflictos de nombres o accesos no autorizados entre comercios.
  2. Validación de Archivos y Limpieza Física: Valida que los archivos cargados sean imágenes válidas (jpeg, png, webp) y asegúrate de eliminar físicamente las imágenes del servidor (Storage::delete(...)) al actualizar o borrar un producto.
  3. Transacciones SQL para la Creación de Productos: Utiliza DB::transaction() al guardar un producto junto con sus múltiples imágenes para garantizar que, si falla la carga de alguna foto, la transacción completa sea revertida sin dejar registros huérfanos.
  4. Relaciones Eloquent con Carga Anticipada (Eager Loading): Al listar los productos en la vista principal, utiliza Product::with(['category', 'images'])->paginate(...) para evitar la sobrecarga de consultas SQL (Problema N+1).