09 CRUD Productos con Galería de Múltiples Imágenes en Base de Datos Separada Laravel Multi-Tenant
Duración: 26 minDescripció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
| Tipo | Comando / Ruta | Descripción |
|---|---|---|
| Comando Artisan | php artisan make:model Product -m --path=database/migrations/tenant | Crea el modelo y la migración del producto en el directorio del tenant. |
| Comando Artisan | php artisan make:model ProductImage -m --path=database/migrations/tenant | Crea el modelo y la migración para las imágenes de la galería del producto. |
| Comando Artisan | php artisan tenancy:migrate | Ejecuta las migraciones de productos y galerías en las bases de datos de todos los clientes. |
| Vista Blade | resources/views/tenant/products/create.blade.php | Formulario con selector de categorías e input file múltiple para imágenes. |
| Ruta HTTP Tenant | GET /products | Muestra el listado de productos de la tienda con paginación y miniaturas. |
| Ruta HTTP Tenant | POST /products | Almacena el producto y procesa la carga del paquete de imágenes adjuntas. |
🔒 Buenas Prácticas y Seguridad
- 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.
- 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.
- 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.
- 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).