08 CRUD Completo de Categorías, Paginación con Base de Datos Separada | Laravel Multi-Tenant SaaS
Duración: 17 minDescripción
🎓 Lección 08: CRUD Completo del Módulo de Categorías, Paginación Aislada y Migraciones Tenant en Laravel SaaS
El propósito de esta lección es desarrollar el flujo completo de gestión (CRUD) para las categorías de productos dentro de cada tienda en la arquitectura Multi-Tenant, garantizando la persistencia aislada de datos, paginación independiente y navegación integrada dentro del panel administrativo Sneat.
🚀 Pasos Clave con Timestamps
- 🗄️ Creación del Modelo y Migración del Tenant: Generar el modelo Category y situar su migración en el directorio aislado database/migrations/tenant para asegurar la creación de la tabla en la base de datos de cada tienda.⏱️ 01:15
- ⚙️ Ejecución de Migraciones Tenant: Ejecutar las migraciones en el entorno Multi-Tenant para propagar la estructura de la tabla de categorías a todas las bases de datos registradas.⏱️ 03:40
- 🛣️ Definición de Rutas en routes/tenant.php: Registrar las rutas del recurso de categorías (index, create, store, edit, update, destroy) dentro del grupo de rutas del tenant activo.⏱️ 06:20
- 🎨 Maquetación del Listado y Paginación: Diseñar la vista de consulta de categorías adaptada con componentes UI de Sneat, integrando la paginación nativa de Laravel configurada para Bootstrap/Sneat.⏱️ 09:50
- 📝 Formulario de Registro y Edición: Construir las vistas Blade para la creación y edición de categorías con validación de datos en tiempo de ejecución y manejo de mensajes de alerta.⏱️ 14:10
- 🗑️ Eliminación Segura y Confirmación Modal: Implementar el borrado de categorías mediante peticiones DELETE con confirmación previa del usuario.⏱️ 18:35
🛠️ Comandos y Rutas Principales
| Tipo | Comando / Ruta | Descripción |
|---|---|---|
| Comando Artisan | php artisan make:model Category -m --path=database/migrations/tenant | Genera el modelo y la migración dentro de la carpeta aislada del tenant. |
| Comando Artisan | php artisan tenancy:migrate | Ejecuta la migración de la tabla de categorías en todas las bases de datos de inquilinos. |
| Comando Artisan | php artisan make:controller CategoryController | Crea el controlador encargado de la lógica CRUD de categorías. |
| Vista Blade | resources/views/tenant/categories/index.blade.php | Listado paginado de categorías registradas en la tienda activa. |
| Ruta HTTP Tenant | GET /categories | Muestra el panel principal de administración de categorías. |
| Ruta HTTP Tenant | POST /categories | Guarda una nueva categoría en la base de datos del subdominio actual. |
🔒 Buenas Prácticas y Seguridad
- Ubicación Correcta de Migraciones: Coloca siempre las migraciones de los módulos del negocio dentro del directorio database/migrations/tenant para evitar que se creen tablas del comercio dentro de la base de datos central.
- Validación de Formularios con Form Requests: Utiliza Form Requests dedicados (CategoryRequest) para validar campos como el nombre y la descripción, aplicando la regla unique condicionada al contexto del tenant.
- Paginación Amigable con el UI: Aplica paginate(10) en la consulta Eloquent y personaliza la plantilla de paginación en Laravel (Paginator::useBootstrapFive()) para mantener la cohesión estética del panel Sneat.
- Protección CSRF y Verificación de Verbos HTTP: Asegúrate de enviar el token @csrf y especificar @method('DELETE') o @method('PUT') en las acciones de actualización y borrado para prevenir vulnerabilidades en peticiones web.