Depot Kitchen — Visión General
¿Qué es?
La Kitchen app (Tablero de Cocina) es una aplicación web separada del POS, diseñada específicamente para las pantallas de cocina. Está desplegada en https://kitchen.depot.center.
Su propósito es mostrar en tiempo real las órdenes que los cajeros registran en el POS, para que el personal de cocina las vea, las avance por su flujo de preparación y notifique cuando están listas.
---
Separación del POS
La Kitchen app es independiente del POS:
- Es un Next.js 15 diferente, desplegado en su propia URL
- Tiene su propio login y sesión
- Puede estar abierta en una tablet o monitor de cocina sin interferir con las terminales del POS
- Permite configuración granular distinta a la del POS (ej. qué artículos mostrar, cómo avanzar los estados)
---
Acceso y autenticación
La Kitchen app usa Clerk igual que el POS. El empleado entra con sus credenciales de Clerk.
Roles permitidos en la Kitchen app:
owneradminmanagerkitchen(rol específico para personal de cocina)
Los roles cashier, delivery y waiter no tienen acceso a la Kitchen app.
Al entrar, si la empresa tiene más de una sucursal, se muestra un selector de sucursal antes de ver el tablero.
---
Navegación
La barra lateral izquierda (colapsable) tiene cuatro ítems:
| Ítem | URL | Descripción |
|---|---|---|
| Órdenes | / (raíz) | Tablero principal con órdenes en tiempo real |
| Métricas | /metrics | Estadísticas de rendimiento de cocina |
| Configuración | /settings | Ajustes de la Kitchen app |
| Actividad | /activity | Log de cambios de estado |
---
Tiempo real con Ably
La Kitchen app recibe eventos en tiempo real del mismo canal Ably que el POS:
order.created→ aparece una nueva orden en el tableroorder.updated→ se actualiza el estado de una ordenorder.item.updated→ se actualiza el estado de un ítem individual
El indicador de conexión (punto verde/amarillo/rojo) está visible en el encabezado del tablero. Si Ably no está disponible, la app hace polling automático al servidor según el intervalo configurado (pollIntervalSeconds, default 30s).
---
Datos compartidos con el POS
La Kitchen app lee y escribe en la misma base de datos que el POS (PostgreSQL Neon). No hay sincronización especial — los cambios de estado en la cocina se reflejan inmediatamente en el POS y viceversa.