CHEFMANAGER IA 3.16.4 · MAESTRO FRANQUICIAS OPERATIVAS
======================================================

Esta distribución maestra incorpora todo lo entregado hasta 3.16.3 y activa
la capa corporativa de franquicias sin romper el aislamiento multiempresa.

IMPLEMENTADO
------------
- Tres niveles reales: casa matriz, franquiciado y operación local.
- El Super Administrador conserva la habilitación/bloqueo de cada franquicia.
- Vista corporativa consolidada para casa matriz y vista aislada para cada
  franquiciado. Un franquiciado no recibe indicadores de otras empresas.
- Regiones de franquicia y asignación regional de unidades.
- Recetario maestro versionado con especificación congelada en JSON.
- Despliegue de estándares a recetas locales y bloqueo de edición/eliminación.
- Los ingredientes y precios siguen siendo locales; el costo de la receta se
  recalcula con el costo real de cada franquiciado.
- Evaluación regional de promociones: precio promocional, costo de receta,
  food cost y alertas. Nunca autoriza ni publica campañas automáticamente.
- Política corporativa de mermas y ranking por costo de merma / venta bruta.
- Emisión idempotente de estados de regalías por período para franquiciados.
- Demo Andino Grill con matriz, dos unidades, dos regiones, costos diferentes,
  receta estándar, merma de ejemplo y estado de regalía.

ACLARACIONES DE ALCANCE
----------------------
- El porcentaje del ranking de merma compara costo estimado de merma contra
  venta bruta. No representa porcentaje físico por peso.
- ChefManager calcula y registra regalías. El débito bancario, Stripe Connect
  o split payment requiere configurar una pasarela y credenciales reales.
- La evaluación regional es una ayuda basada en datos; la decisión final sigue
  siendo humana y nunca se publica automáticamente.

RUTAS PRINCIPALES
-----------------
GET/PUT  /api/franchises/{id}/waste-policy
GET/POST /api/franchises/{id}/regions
GET/POST /api/franchises/{id}/standards
POST     /api/franchises/{id}/standards/{standard_id}/deploy
GET/POST /api/franchises/{id}/royalties
GET/POST /api/franchises/{id}/price-checks
GET      /api/franchise-dashboard?group_id={id}&from=AAAA-MM-DD&to=AAAA-MM-DD

INSTALACIÓN
-----------
Use este ZIP como paquete maestro completo. Realice respaldo de archivos y
base de datos antes de reemplazar una instalación. Las migraciones son
aditivas y se ejecutan al iniciar la aplicación.

VALIDACIÓN DISPONIBLE EN ESTE ENTORNO
------------------------------------
- Sintaxis JavaScript verificada con Node.
- Integridad del ZIP y manifiesto SHA-256 verificados.
- Migración SQLite nueva validada de forma aislada.
- PHP no está instalado en el entorno de construcción; por ello no se afirma
  haber ejecutado lint PHP ni pruebas HTTP del servidor.
