14 Creando el Módulo de Clientes y Pedidos para Nuestro Sistema SaaS Multi-Tenant con Laravel
Duración: 17 minDescripción
🎓 Lección 14: Arquitectura y Modelado del Módulo de Clientes, Pedidos y Detalle en Laravel SaaS Multi-Tenant
Objetivo General: Diseñar e implementar las migraciones, modelos Eloquent con sus respectivas relaciones y controladores para la gestión de clientes, pedidos y detalles de pedidos dentro de cada base de datos aislada de los inquilinos (tenants).
🚀 Pasos Clave con Timestamps
- 👤 Migración y Estructura de la Tabla clientes: Creación de la migración en la carpeta database/migrations/tenant para definir los campos de los clientes (nombre, teléfono único, correo, dirección, ciudad y estado).⏱️ 02:01
- 🏗️ Generación de Modelo y Controlador para Clientes: Creación del modelo Cliente y su respectivo controlador ClienteController dentro del espacio de nombres Tenant para aislar la lógica por inquilino.⏱️ 03:28
- 📦 Migración, Modelo y Controlador para la Tabla pedidos: Construcción de la tabla de encabezados de pedidos con su llave foránea cliente_id, código único, tipo de entrega, método de pago, totales y estados.⏱️ 04:34
- 📑 Migración y Estrategia de Snapshot para pedido_detalles: Implementación del detalle de pedidos relacionando pedido_id y capturando nombre, código y precio unitario del producto en el momento exacto de la compra.⏱️ 06:59
- 🔗 Definición de Relaciones Eloquent (HasMany, BelongsTo): Configuración de las asociaciones en los modelos: Cliente tiene muchos Pedidos, Pedido pertenece a un Cliente y tiene muchos PedidoDetalles.⏱️ 10:16
- ⚡ Ejecución de Migraciones Multi-Tenant: Aplicación del comando de migración de Stancl/Tenancy para replicar automáticamente las tres nuevas tablas en las bases de datos de todos los inquilinos activos.⏱️ 12:03
- 🔀 Configuración de Rutas y Menú de Navegación Administrador: Registro de las rutas en routes/tenant.php (index, show, update-status, destroy, print) e integración de los enlaces en la plantilla Blade del panel de control.⏱️ 14:20
🛠️ Comandos y Rutas Principales
| Tipo | Comando / Ruta | Descripción |
|---|---|---|
| 💻 Artisan | php artisan make:migration create_clientes_table --path=database/migrations/tenant | Crea la migración de clientes aislada para la base de datos de los tenants. |
| 💻 Artisan | php artisan make:model Tenant/Cliente | Genera el modelo Eloquent de Cliente dentro de la estructura de inquilinos. |
| 💻 Artisan | php artisan make:controller Tenant/ClienteController | Genera el controlador con la lógica CRUD para administrar clientes por tenant. |
| 💻 Artisan | php artisan make:migration create_pedidos_table --path=database/migrations/tenant | Genera la migración de la cabecera de pedidos del tenant. |
| 💻 Artisan | php artisan make:migration create_pedido_detalles_table --path=database/migrations/tenant | Genera la migración de los ítems o detalles de cada pedido. |
| 💻 Artisan | php artisan tenants:migrate | Ejecuta las migraciones pendientes en todas las bases de datos de los inquilinos. |
| 🌐 Ruta HTTP | GET /pedidos | Muestra el listado general de pedidos de la tienda (PedidoController@index). |
| 🌐 Ruta HTTP | GET /pedidos/{id} | Visualiza la información detallada e ítems de un pedido (PedidoController@show). |
| 🌐 Ruta HTTP | RESOURCE /clientes | Registra el conjunto completo de rutas CRUD para la gestión de clientes. |
🔒 Buenas Prácticas y Seguridad
- 📸 Técnica de Snapshot de Datos Históricos: Al registrar una venta, guarda siempre el nombre, código y precio del producto directamente en la tabla pedido_detalles. Si el administrador actualiza el precio o elimina el producto del catálogo en el futuro, los reportes financieros históricos y las facturas se mantendrán intactos.
- 🔑 Indexación y Llaves Foráneas Aisladas: Define llaves foráneas (cliente_id, pedido_id) en el nivel de base de datos de cada inquilino para garantizar la integridad referencial y acelerar las consultas complejas de reportes.
- 🔒 Aislamiento de Rutas por Inquilino: Coloca todas las rutas administrativas de clientes y pedidos dentro del archivo routes/tenant.php y protégelas con el grupo de middlewares ['auth', 'tenant'] para evitar acceso no autorizado entre tiendas.
- 🔢 Generación de Códigos Únicos de Pedido: Implementa una secuencia o código alfanumérico amigable por cada tenant (ej. ORD-0001) almacenado de forma independiente en lugar de exponer la ID autoincremental de la base de datos.