15 Gestión de Clientes Pedidos y Ventas con Control de Stock, Ticket en SaaS Multi-Tenant Laravel
Duración: 15 minDescripción
🎓 Lección 15: Gestión de Clientes, Pedidos, Control de Stock y Generación de Tickets en Laravel SaaS Multi-Tenant
Objetivo General: Implementar el flujo completo de checkout público y administración interna para pedidos en cada tienda inquilina (tenant), incluyendo la actualización automatizada de inventario con reversión de stock, gestión del ciclo de vida de clientes y emisión de tickets térmicos imprimibles.
🚀 Pasos Clave con Timestamps
- 📂 Estructura de Vistas y Rutas para Clientes y Pedidos: Revisión de las vistas Blade para la gestión de pedidos (index, show, imprimir) y clientes (index, show, edit), asociadas a sus respectivos controladores dentro del espacio de nombres Tenant.⏱️ 00:44
- 🛑 Validación del Límite de Inventario en Tiempo Real: Demostración del comportamiento del selector de cantidad en el catálogo e-commerce, el cual impide al comprador superar las existencias disponibles de un producto.⏱️ 04:14
- 📝 Registro del Checkout Público y Método firstOrCreate: Procesamiento del pedido público con storePublic, registrando o actualizando el cliente mediante su número de teléfono único y descontando las unidades compradas del stock.⏱️ 05:02
- 🔔 Panel de Administración y Notificaciones de Pedidos: Recepción de nuevos pedidos en el panel de control del tenant con contadores dinámicos en tiempo real para estados pendientes.⏱️ 07:14
- 🔄 Transición de Estados de Pedido (Pendiente ➔ En Proceso ➔ Completado): Actualización interactiva del flujo de trabajo del pedido e integración de notificaciones al cliente vía WhatsApp.⏱️ 08:34
- 🧾 Generación de Ticket Comprobante Térmico: Renderizado de la vista optimizada para impresión en formato pos-ticket de 80mm/58mm con detalles del cliente y los productos adquiridos.⏱️ 09:53
- ↺ Reversión Automática e Integridad de Stock al Cancelar/Eliminar: Mecanismo en las acciones update y destroy que reabastece las unidades descontadas al catálogo cuando un pedido es anulado o eliminado.⏱️ 12:42
🛠️ Comandos y Rutas Principales
| Tipo | Comando / Ruta | Descripción |
|---|---|---|
| 💻 Artisan | php artisan make:controller Tenant/PedidoController | Genera el controlador principal para la gestión de ventas, stock y tickets. |
| 💻 Artisan | php artisan make:controller Tenant/ClienteController | Genera el controlador para el expediente y ciclo de vida de los clientes. |
| 🌐 Ruta HTTP | POST /pedido/publico | Procesa el checkout del cliente, crea/actualiza el perfil y descuenta stock (PedidoController@storePublic). |
| 🌐 Ruta HTTP | GET /pedidos/{id}/imprimir | Genera la vista optimizada para impresión de ticket de caja (PedidoController@imprimir). |
| 🌐 Ruta HTTP | PUT /pedidos/{id}/estado | Actualiza el estado funcional del pedido (PedidoController@updateStatus). |
🔒 Buenas Prácticas y Seguridad
- ⚛️ Transacciones de Base de Datos Atomic (DB::transaction): Encapsula el registro del pedido, la inserción de los detalles y el descuento de stock dentro de una transacción (DB::beginTransaction()). Si falla el descuento de inventario, la venta completa se revierte sin dejar estados inconsistentes.
- 🔄 Reversión Garantizada de Stock (Stock Rollback): Al cancelar o eliminar un pedido previamente registrado, asegúrate de devolver las cantidades exactas al stock del producto mediante operaciones incrementales atómicas ($producto->increment('stock', $cantidad)).
- 📱 Identificación de Cliente por firstOrCreate con Teléfono Sanitizado: Utiliza el número de teléfono limpio como clave natural para consolidar el historial de compra y métricas de consumo de cada usuario sin forzar registros con contraseña.
- 📄 Estilos CSS Optimizados para Impresión Térmica (@media print): Diseña la vista del ticket con reglas @page { size: auto; margin: 0mm; } para asegurar una salida gráfica impecable en impresoras térmicas de 58mm u 80mm sin cabeceras web no deseadas.