14 Creando el Módulo de Clientes y Pedidos para Nuestro Sistema SaaS Multi-Tenant con Laravel

Duración: 17 min
Módulo: Operaciones, Clientes, Control de Ventas e Inventario Lección 1 de 2

¡Contenido Exclusivo!

Adquiere este curso para tener acceso inmediato a esta y a **todas las lecciones Premium**.

Inscribirse Ahora por $10.00 Acceso instantáneo de por vida y código fuente incluido.

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

TipoComando / RutaDescripción
💻 Artisanphp artisan make:migration create_clientes_table --path=database/migrations/tenantCrea la migración de clientes aislada para la base de datos de los tenants.
💻 Artisanphp artisan make:model Tenant/ClienteGenera el modelo Eloquent de Cliente dentro de la estructura de inquilinos.
💻 Artisanphp artisan make:controller Tenant/ClienteControllerGenera el controlador con la lógica CRUD para administrar clientes por tenant.
💻 Artisanphp artisan make:migration create_pedidos_table --path=database/migrations/tenantGenera la migración de la cabecera de pedidos del tenant.
💻 Artisanphp artisan make:migration create_pedido_detalles_table --path=database/migrations/tenantGenera la migración de los ítems o detalles de cada pedido.
💻 Artisanphp artisan tenants:migrateEjecuta las migraciones pendientes en todas las bases de datos de los inquilinos.
🌐 Ruta HTTPGET /pedidosMuestra el listado general de pedidos de la tienda (PedidoController@index).
🌐 Ruta HTTPGET /pedidos/{id}Visualiza la información detallada e ítems de un pedido (PedidoController@show).
🌐 Ruta HTTPRESOURCE /clientesRegistra el conjunto completo de rutas CRUD para la gestión de clientes.

🔒 Buenas Prácticas y Seguridad

  1. 📸 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.
  2. 🔑 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.
  3. 🔒 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.
  4. 🔢 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.