CHEFMANAGER IA · V3.14.1
MOTOR INTERNO DE INGENIERÍA DE MENÚ + PRIVATE AI
=================================================

OBJETIVO

Convertir la matriz Estrella / Caballo de batalla / Rompecabezas / Perro en
una capacidad operativa común para cada restaurante y para el Gerente
Inteligente, usando exclusivamente datos internos verificables.

QUÉ SE IMPLEMENTÓ

1. Motor único MenuEngineeringEngine
   - Cruza margen bruto porcentual real con unidades vendidas.
   - Solo cuenta pedidos pagados y no cancelados.
   - Respeta el alcance de sucursal cuando el usuario está restringido.
   - Usa la mediana del catálogo del propio restaurante como corte.
   - Clasifica: Estrella, Caballo de batalla, Rompecabezas o Perro.
   - Genera explicación, prioridad y acción sugerida por producto.
   - Nunca cambia precios, costos, disponibilidad ni catálogo.

2. Ingeniería de menú del restaurante
   - La pantalla existente ahora consume el motor único.
   - Muestra la causa numérica de cada clasificación.
   - Añade acción sugerida y prioridades del motor interno.
   - Incluye acceso directo para consultar al Gerente IA.
   - Separa productos sin receta/precio/costeo válido y explica cómo corregirlos.

3. ChefManager Private AI
   - Nueva herramienta segura de lectura: get_menu_engineering.
   - El LLM, si está conectado, puede solicitar el resultado sin acceso SQL.
   - El fallback interno responde aun cuando AI Gateway/Ollama no esté disponible.
   - Reconoce preguntas sobre estrellas, caballos de batalla, rompecabezas,
     perros, rentabilidad, aumento de precio, visibilidad o retiro del menú.
   - La evidencia conserva umbrales, cifras, clasificación y recomendación.

4. AI Dashboard
   - El análisis interno incorpora señales de ingeniería de menú entre sus
     recomendaciones verificables.
   - Cada señal lleva a la pantalla donde el restaurante puede revisarla.

REGLAS DE NEGOCIO

- Estrella: margen alto + volumen alto. Proteger disponibilidad/calidad y
  mantener visible; evitar descuentos innecesarios.
- Caballo de batalla: margen bajo + volumen alto. Revisar costo, porción y
  precio; simular antes de cambiar.
- Rompecabezas: margen alto + volumen bajo. Mejorar visibilidad, foto,
  descripción y recomendación/promoción medible.
- Perro: margen bajo + volumen bajo. Revisar receta, presentación y demanda;
  rediseñar o retirar solo después de decisión humana.

SEGURIDAD Y PRIVACIDAD

- Aislamiento por restaurant_id intacto.
- Alcance por branch_id aplicado a consultas del Gerente Inteligente.
- Sin SQL libre para el LLM.
- Sin escritura automática ni decisiones irreversibles.
- Toda ejecución de herramienta Private AI sigue quedando auditada.

ARCHIVOS PRINCIPALES

- app/Services/MenuEngineeringEngine.php
- app/Services/PrivateAiService.php
- app/Services/AiInsights.php
- api/index.php
- public/assets/app.js
- app.php
- public/assets/bootstrap-loader.js
- service-worker.js
