Pedidos

La pestaña de Pedidos es el panel en vivo para cada pedido de cafetería realizado por tus clientes. Consulta la nube cada 3 segundos y muestra nueva actividad con una notificación de escritorio, una alerta de audio y una insignia de conteo pendiente en el encabezado de la pestaña.

Diseño

La página de Pedidos tiene dos áreas:

Consulta en Vivo

El panel de Pedidos consulta /v1/cafeteria/admin/orders/poll cada 3 segundos. Cada nuevo pedido desencadena:

1. Una notificación de escritorio con el código de la mesa y el conteo de artículos.
2. Una alerta de audio en los altavoces del servidor si las notificaciones de sonido están habilitadas en Configuración > Cafetería.
3. Un incremento de la insignia de conteo pendiente en la pestaña de Pedidos.
4. Una impresión automática del recibo si la impresora está configurada con Impresión Automática en Nuevo Pedido.

La insignia permanece visible hasta que cada pedido con estado realizado o confirmado avanza a un estado posterior o se descarta. La insignia es visible globalmente en la sección de Cafetería de la barra lateral; no necesitas mantener la pestaña de Pedidos abierta para verla.

Ciclo de Vida del Pedido

Cada pedido pasa por una secuencia definida de estados.

La barra de acción en cada tarjeta de pedido muestra el siguiente estado disponible. Avanzar es un clic. La interfaz de usuario utiliza un patrón de actualización optimista: el nuevo estado se muestra inmediatamente. Si el servidor rechaza el cambio, el estado revierte y aparece una notificación de error.

Estado por Artículo

Algunos pedidos tienen múltiples artículos que se terminan en diferentes momentos. Por ejemplo, una hamburguesa está lista antes que una pizza. El estado por artículo te permite rastrear cada línea de forma independiente.

Cada artículo tiene su propio menú desplegable con cinco opciones: realizado, en preparación, listo, servido, cancelado. Cada artículo también lleva tres marcas de tiempo:

• created_at se establece cuando llega el pedido.
• ready_at se establece la primera vez que el artículo entra en listo.
• served_at se establece cuando el artículo entra en servido.

El menú del cliente muestra una insignia junto a cada línea para que el cliente pueda ver qué artículos están listos o en camino.

Cancelación de un Pedido

1. Abre la tarjeta del pedido.
2. Haz clic en Cancelar.
3. Confirma en el diálogo que aparece.
4. El pedido pasa a cancelado. Permanece en el historial pero desaparece de la vista en vivo por defecto.

La cancelación es una acción de pedido completo. Para cancelar una sola línea, cambia el estado por artículo de esa línea a cancelado.

Liquidación (Liquidar Cuenta)

La liquidación cierra todos los pedidos abiertos en una mesa en un solo paso. Usa esto cuando el cliente se va y quiere pagar toda la cuenta.

1. Abre la mesa desde la página de Mesas o el menú de acciones del Plano de Piso.
2. Haz clic en Liquidar Cuenta.
3. El modal lista cada pedido en la mesa que aún no está servido.
4. Elige un método de pago. Las opciones son: Efectivo, Tarjeta, En línea, Otro.
5. Confirma.

El servidor realiza las siguientes acciones de manera atómica:

• Cada pedido abierto en la mesa pasa a servido con payment_status=paid.
• Se crea un registro de cafeteria_settlements con el monto total, método de pago y hora de creación.
• Un registro de auditoría de pedidos de liquidación registra qué pedidos pertenecen a esta liquidación.
• El código de seguridad de la mesa expira, por lo que el QR se vuelve inválido.
• La mesa vuelve a inactiva.

Si elegiste En línea como método de pago, el registro de liquidación se marca como pagado en línea. No se activa ningún cargo de Stripe con esta acción. El pago en línea por parte del cliente se maneja al realizar el pedido; la acción de liquidación registra el flujo de efectivo para tus libros.

Temporizador de Apertura

Cada mesa lleva una marca de tiempo opened_at establecida cuando el cliente se sienta. Las páginas de Plano de Piso y Mesas muestran un temporizador en vivo desde ese momento. Esto ayuda al personal a detectar mesas que han estado activas durante mucho tiempo sin pedir, o mesas que podrían estar acercándose al final de una sesión.

El temporizador se reinicia a cero al Cerrar Mesa o Liquidar Cuenta.

Visualización Dinámica del Tiempo de Preparación

Cuando el tiempo de preparación dinámico está activo para un producto, la tarjeta de pedido muestra la estimación junto al nombre del artículo. El personal ve la estimación incluso cuando la opción Mostrar Tiempo de Preparación en el Menú está desactivada para los clientes.

La estimación se actualiza cada vez que se realiza un nuevo pedido y cada vez que se completa un pedido. El sistema aprende del ritmo real de tu cocina.

Comportamiento de Notificación de Nuevo Pedido

Las notificaciones se activan en toda la aplicación, no por pestaña. Esto significa que recibes alertas cuando estás navegando en otra parte del servidor de HandyCafe, por ejemplo en el Panel de Administración o Configuración. La alerta de audio se habilita o deshabilita desde Configuración > Cafetería > Notificación de Sonido.

Las notificaciones de escritorio requieren que el sistema operativo haya otorgado permiso de notificación a HandyCafe. Si no ves una notificación después de un nuevo pedido, verifica la configuración de notificaciones de tu sistema operativo.

Consejos

• Usa las Pestañas de Estado para dividir la carga de trabajo. Una pantalla filtrada a en preparación muestra la cola de la cocina. Otra pantalla en listo muestra lo que necesita entrega.
• Liquidar Cuenta es la forma más rápida de cerrar una mesa. Usa Cancelar en pedidos individuales solo para errores explícitos.
• Entrena al personal para avanzar el estado de manera consistente. El estimador de tiempo de preparación dinámico aprende de estas señales, por lo que omitir estados reduce su precisión.
• Audita periódicamente los pedidos cancelados y reembolsados desde el punto final de administración para detectar patrones de error del personal.