Inicio del día

ElGatoMenu arranca automáticamente cuando enciende la computadora. No necesitas ejecutar ningún comando.

Abre el dashboard en cualquier dispositivo de la red:

http://{tu-ip}:3000/dashboard

Si la página no carga, ejecuta ./elgatomenu start en la terminal. Consulta la guía de Administración si necesitas resolver problemas.


Lo que ve el cliente

1️⃣El cliente escanea el QR en la mesa. Accede a la carta con el nombre de tu restaurante, categorías, platos con fotos, descripciones y precios.
2️⃣El cliente arma su pedido. Toca + en cada plato, ajusta cantidades, y toca Ver pedido (botón verde en la parte inferior) para revisar.
3️⃣El cliente confirma el pedido. Elige mesa o para llevar, número de mesa (si es en sitio) y método de pago. El total mostrado incluye todos los impuestos y cargos.
4️⃣Pago digital (DeUna, Sipi, Transferencia). El cliente ve el monto exacto (copiado al portapapeles automáticamente), el QR o datos de cuenta y un temporizador de 15 minutos. Completa el pago en su app, toma un screenshot y lo sube a ElGatoMenu.
5️⃣Pago en efectivo o tarjeta. No necesita subir nada. El pedido aparece en tu dashboard de inmediato y el cliente se acerca a la caja a pagar.
6️⃣Seguimiento en vivo. El cliente ve el estado en tiempo real: Pendiente → Verificado → En cocina. La pantalla se actualiza automáticamente cuando verificas el pago.

El dashboard del dueño

Abre /dashboard. Esta es tu pantalla principal durante el servicio.

Encabezado

Ícono / elementoQué abre
Badge de política de pagoMuestra el modo actual — toca para cambiar en Configuración
👨‍🍳 CocinaPantalla de cocina (visible solo si está habilitada)
🍽️ CartaEditor de menú
👥Gestión de usuarios y equipo (solo admin)
⚙️Configuración (solo admin)

Barra de estadísticas

TarjetaQué muestra
Cobrado hoyTotal de órdenes verificadas en el día
Por verificarÓrdenes con comprobante pendiente de revisión
AlertasÓrdenes marcadas como posible fraude

Todo se actualiza en tiempo real.

Colas de órdenes

En modo pago anticipado: "Pendientes de verificación" (necesitan tu acción) y "En cocina" (verificadas).

En modo pago al final: "Órdenes activas" — la cocina ya empezó; cobras cuando el cliente termina.


Leer y gestionar las órdenes

Cómo leer una tarjeta de orden

┌─ #42 Mesa 3 · 12:34 ────────────────────────────── 🟢 DeUna ─┐ │ │ │ 2× Ceviche de camarón $16.00 │ │ 1× Jugo de naranja $2.50 │ │ │ │ Subtotal $18.50 · IVA $2.78 · Servicio $1.85 · Total $23.13 │ │ │ │ ✅ Comprobante recibido │ │ OCR: $23.13 ✓ · TX: TXN-8471-B │ │ │ │ [✕ Rechazar] [✓ Verificar] │ └──────────────────────────────────────────────────────────────────────┘
Color del borde izquierdoSignificado
GrisEsperando pago
ÁmbarComprobante recibido — necesita revisión
VerdeVerificada
RojoRechazada o alerta de fraude

La línea OCR (solo pagos digitales) muestra el monto leído del comprobante. ✓ = coincide con el total · ⚠️ = no coincide — revisa cuidadosamente.

Cuándo verificar

Verifica cuando estás seguro de que el pago fue recibido:

Haz clic en ✓ Verificar. La orden pasa a "En cocina" y la pantalla del cliente se actualiza.

Cuándo rechazar

Rechaza si el temporizador expiró sin pago, el comprobante es claramente incorrecto (restaurante equivocado, monto diferente, fecha errónea) o sospechas fraude.

Haz clic en ✕ Rechazar. La orden se elimina de la cola y el cliente puede ver que fue rechazada.

⚠️ ¿Verificaste por error? No se puede deshacer desde la interfaz. Puedes rechazarla manualmente y anotar la razón en la observación.

La pantalla de cocina

Si habilitaste la pantalla de cocina en Configuración, tu equipo puede abrirla en:

http://{tu-ip}:3000/dashboard/kitchen

Inician sesión con su propia cuenta (necesitan el rol Cocina). La pantalla tiene fondo oscuro — fácil de leer en una cocina ocupada.

Lo que ve la cocina

Cuando la cocina toca "Listo", la tarjeta desaparece de la pantalla de cocina, la orden pasa a "Completado" en el dashboard del dueño y la pantalla del cliente se actualiza. Las órdenes nuevas aparecen automáticamente — sin necesidad de refrescar.


Detección de fraude

ElGatoMenu revisa automáticamente cada comprobante subido en busca de dos tipos de fraude:

1. Mismo comprobante subido dos veces

El sistema calcula una huella digital de cada imagen. Si se sube el mismo archivo en una segunda orden, esa orden queda marcada como alerta.

2. Mismo ID de transacción usado dos veces

El sistema lee el ID de transacción del texto del comprobante. Si ese ID ya fue usado en una orden anterior, la nueva orden es marcada.

Qué ves

Un banner rojo en la parte superior del dashboard con un botón directo a la orden sospechosa. La tarjeta de esa orden también tiene borde rojo.

Cómo manejarlo

  1. Haz clic en "Ver orden" para ir directo a la tarjeta
  2. Revisa la imagen del comprobante
  3. Compara con la orden anterior que usó el mismo comprobante
  4. Si es fraude: haz clic en ✕ Rechazar
  5. Si es un error genuino (p. ej. el cliente re-envió accidentalmente): haz clic en ✓ Verificar — aparece un campo para escribir brevemente por qué apruebas a pesar de la alerta. Escríbelo y confirma. La razón queda guardada con tu nombre.

Tareas de cierre

1️⃣Revisa la barra de estadísticas — "Cobrado hoy" muestra el total de órdenes verificadas del día.
2️⃣Haz backup de la base de datos:
./elgatomenu backup
Guarda un archivo en la carpeta backups/. Hazlo cada día antes de cerrar.
3️⃣Oculta los platos agotados si no quieres que aparezcan al día siguiente, o déjalos hasta que se reabastezcan.

Situaciones comunes

SituaciónQué hacer
Un plato se agotóToca Activo en Carta → pasa a "Oculto"
El cliente pagó en efectivo pero el temporizador expiróRechaza la orden; toma un pedido nuevo si es necesario
El OCR leyó un monto incorrectoSi confirmaste el pago tú mismo, haz clic en Verificar — el OCR no es obligatorio
El cliente dice que pagó pero no aparece comprobantePídele que tome screenshot de la confirmación y lo suba de nuevo desde la página de pago
La pantalla de cocina muestra una orden antiguaNunca fue marcada como lista — toca ✓ Listo para limpiarla
El dashboard no se actualiza en tiempo realRecarga la página; verifica la conexión WiFi
La app no carga en el celular del clienteConfirma que está en el mismo WiFi que la computadora del servidor
Verificaste una orden por errorNo se puede deshacer en la interfaz — recházala manualmente y anota la razón