RestaurantOS Kiwi
Manual Maestro
⚡ Blueprint Operativo & Especificación Técnica 1.0

Control Total de tu Cadena:
De la Harina al Cobro en Caja

Guía interactiva completa de RestaurantOS: secuencia canónica de configuración, relaciones entre insumos y recetas, modelo matemático de costos, operaciones de inventario por lotes y el rol de la IA en Back Office y POS.

🌿 Offline-First (PostgreSQL + SQLite) 📊 Ledger Inmutable de Inventarios 💰 Cero Flotantes (Centavos Exactos) 🤖 IA con Human-in-the-Loop ⚡ KDS Multi-estación

1. Orden de Configuración Inicial (De Cero a la Primera Venta)

El sistema exige respetar el árbol estricto de dependencias. Sigue este mapa interactivo para configurar tu restaurante sin errores de catálogo.

1. Estructura Organizacional

Configura el Grupo corporativo, las Razones Sociales fiscales, las Unidades de Negocio (restaurante, panadería, etc.) y las Sucursales físicas con su único Almacén operativo vinculado.

  • Cada sucursal pertenece a exactamente una sola razón social fiscal.
  • Cada sucursal tiene un único almacén formal donde se costean sus inventarios.
  • El alta de sucursal crea automáticamente su almacén principal en una sola transacción.
Entidades del Dominio
Organization
  └── LegalEntity (RFC)
        └── BusinessUnit (restaurant)
              └── Branch (Sucursal Centro)
                    └── Warehouse (Almacén Principal)

2. Relaciones y Fórmulas Matemáticas de Costeo

Experimenta en tiempo real cómo viaja el dinero desde el costal del proveedor hasta el margen de contribución de cada platillo vendido en caja.

📦 1. Presentación de Compra a Costo Base

Convierte el empaque comercial del proveedor a costo exacto por kilogramo y gramo.

Contenido Neto Útil:25.00 kg
Costo Unitario Base:$18.00 / kg
Costo por Gramo:$0.0180 / g

🍳 2. Subreceta / Producción por Lotes

Calcula el costo unitario de un insumo elaborado (ej. 50 Panes Brioche artesanal).

Insumo Elaborado Resultante:Pan Brioche Artesanal
Costo por Pieza Terminada:$3.90 / pza
Impacto en Venta POS:Descarga 1 bollo al vender

🍔 3. Receta de Venta y Margen de Utilidad (Hamburguesa Gourmet)

Monitorea el Food Cost % y el margen bruto ajustando el precio de venta y la porción de carne.

Componentes fijos de la receta:
• Pan Brioche: 1 pza ($3.90)
• Queso Cheddar 40g ($7.20) | Tocino 30g ($8.25)
• Salsa BBQ 30ml ($2.40) | Vegetales y Empaque ($6.30)
39.7%
Food Cost
Costo Total Insumos:$59.16
Margen Bruto:$89.84 (60.3%)
Estado Semáforo:🟢 Margen Saludable

3. Traspasos, Mermas y Conteos Físicos Ciegos

Descubre cómo el libro de movimientos inmutable garantiza que ninguna venta ni traspaso en tránsito desvirtúe las existencias.

🚚 Traspasos entre Sucursales

El inventario viaja con su costo promedio congelado sin tratarse como una compra.

ORIGEN (Centro)
TRANSFER_OUT
10.0 kg @ $140/kg
EN TRÁNSITO
Saldo Inmutable
$1,400.00 MXN
DESTINO (Norte)
TRANSFER_IN
9.5 kg recibidos
Manejo de Diferencia: 0.5 kg se documentan con motivo de daño. El destino absorbe los 9.5 kg a $140/kg directamente en su Costo Promedio Ponderado.

🔍 Conteo Físico Ciego vs. Ledger Dinámico

Ajusta diferencias reales sin pisar ventas legítimas ocurridas durante la auditoría.

1. Fotografía Teórica (08:00 AM):20.0 kg
2. Captura Ciega (Supervisor cuenta):18.0 kg físicos
3. Venta en POS (08:30 AM):-1.0 kg (Ledger: 19.0 kg)
Ajuste Inteligente Aplicado: -1.0 kg (COUNT_ADJUSTMENT)
Fórmula: Conteo Físico (18 kg) - Ledger Vigente (19 kg) = -1 kg. ¡Cero ventas perdidas!

4. IA en Back Office y Punto de Venta (Playground)

Prueba el comportamiento del copiloto administrativo y la captura de pedidos por voz sin riesgo de alucinación ni exposición de datos personales.

Selecciona una consulta de diagnóstico:
Respuesta del Motor Canónico DRAFT (Sin Cambios)
Para responder con precisión contable, por favor especifica qué autoridad deseas diagnosticar:

1. Precio de Compra de Proveedor: Insumos sin presentación activa con precio.
2. Costo Promedio Ponderado: Insumos sin recepción confirmada en la sucursal actual.

(El sistema no mezcla catálogos ni inventa costos cero).
🔒 PII Protegido: Excluidos saldos de caja, ventas de empleados y clientes.

5. Matriz Canónica de Permisos por Rol

La autoridad se gobierna exclusivamente mediante permisos granulares en backend, jamás por nombres cosméticos de roles.

Permisos de Dominio vs. Roles Operativos
Permiso Granular Admin Corporativo Supervisor Sucursal Cajero Encargado Inventarios Auditor
admin.manage
branch.admin.access
catalog.branch.manage
pos.operate / orders.create
cash.shift.open/close
payments.confirm
purchases.manage
production.manage
inventory.transfer.send
inventory.transfer.receive
inventory.waste
inventory.count
audit.read