CHEFMANAGER IA 3.17.9 - INVENTARIO PREDICTIVO Y COMPRAS INTELIGENTES
====================================================================

Entrega acumulativa construida sobre ChefManager 3.17.8. Conserva POS offline,
Centro Omnicanal, Beeper Virtual, multiempresa, cadenas, franquicias, patios y
los módulos anteriores. La actualización es aditiva y no elimina información.

INTEGRACIÓN CON LO EXISTENTE
----------------------------
El módulo no crea un inventario paralelo. Utiliza directamente:
- inventario_stock y movimientos de inventario por sucursal;
- lotes, cantidades utilizables y fechas de vencimiento;
- recetas y consumos descontados por ventas;
- mermas para separar pérdida de demanda comercial;
- órdenes de compra en tránsito;
- ingredientes, mínimos, unidades y costos actuales;
- proveedores e historial real de precios de compra;
- sucursales, usuarios, permisos y auditoría existentes.

FUNCIONES IMPLEMENTADAS
-----------------------
1. Pronóstico configurable a 7, 14, 21 o 30 días por sucursal.
2. Consumo diario ponderado: 70% últimos 14 días y 30% base de 42 días.
3. Ajuste de demanda según el comportamiento histórico de cada día de semana.
4. Stock utilizable que excluye lotes vencidos e identifica lotes próximos a vencer.
5. Stock proyectado después de demanda y compras ordenadas aún no recibidas.
6. Días de cobertura, riesgo de quiebre, nivel crítico y alerta preventiva.
7. Cantidad sugerida con mínimo configurado y colchón operativo de tres días.
8. Riesgo de sobrecompra y vencimiento antes de recomendar reposición.
9. Detección de tendencia/estacionalidad cuando el consumo cambia 30% o más.
10. Comparación de precios históricos por proveedor.
11. Alerta de variación anormal cuando el último precio difiere 15% o más del promedio.
12. Proveedor recomendado, costo estimado y nivel de confianza por insumo.
13. Selección de varios insumos para crear una propuesta inteligente de compra.
14. Flujo pendiente -> aprobada/rechazada con usuario, fecha y observación.
15. Solo una aprobación humana crea una orden de compra, y la crea como borrador.
16. La recepción continúa usando el módulo existente de lotes, vencimientos y kardex.

REGLAS DE SEGURIDAD
-------------------
- ChefManager nunca envía una compra automáticamente al proveedor.
- Una recomendación no modifica inventario, costos ni cuentas por pagar.
- La orden aprobada queda en estado borrador para la revisión comercial final.
- Una propuesta revisada no puede aprobarse ni rechazarse nuevamente.
- Cada creación y revisión queda registrada en auditoría.
- Los cálculos de baja confianza se muestran como tales; no se inventan datos faltantes.
- Los históricos expresados en unidades incompatibles no se comparan como si fueran
  costos de la unidad canónica del ingrediente.

ARCHIVOS PRINCIPALES
--------------------
- database/sqlite-v40-predictive-inventory.sql
- app/Services/PredictiveInventoryService.php
- app/Support/Database.php
- api/index.php
- public/assets/app.js
- tools/smoke-predictive-inventory.sh

INSTALACIÓN Y PRUEBA
--------------------
1. Respaldar base de datos y archivos.
2. Instalar el paquete completo sobre staging.
3. Iniciar sesión; la migración v40 se ejecutará automáticamente.
4. Abrir Inventario > Inventario inteligente.
5. Elegir sucursal y horizonte; revisar niveles de confianza y alertas.
6. Seleccionar insumos, crear propuesta y confirmar que siga pendiente.
7. Aprobar con un responsable y verificar la OC borrador en Órdenes de compra.
8. Recibirla por el flujo normal con lote y vencimiento.

NOTA METODOLÓGICA
-----------------
El pronóstico es una ayuda explicable basada en datos operativos. Eventos, promociones,
feriados, cierres imprevistos y cambios de menú pueden alterar la demanda. Por esa razón
ChefManager muestra evidencia y confianza, y mantiene la decisión final en una persona.
