HandyCafe Docs
owner it-admin

Cafetería

Cafetería es el módulo integrado de servicio de alimentos y bebidas en HandyCafe. Te permite crear un plano digital de tus mesas, publicar un menú de autoservicio con tu marca en la web en handy.cafe/{your-slug}, y seguir cada pedido entrante en tiempo real desde el panel del servidor.

Los clientes escanean el código QR en su mesa, ingresan un código de seguridad de 6 dígitos, navegan por el menú en su propio idioma y realizan un pedido. El pedido aparece en tu pantalla de Pedidos de Cafetería en segundos. Tu personal reconoce cada etapa de preparación, y cuando el servicio está completo, la acción "Cerrar Cuenta" liquida la factura en un solo paso.

Para Quién Es

Cafetería está diseñado para cibercafés, centros de juegos y arenas de esports que también sirven alimentos y bebidas en los asientos de los clientes. Reemplaza los resguardos de pedidos en papel y las solicitudes verbales al mostrador. Funciona junto con el sistema estándar de sesiones y precios de HandyCafe; los pedidos de cafetería se rastrean por separado pero en la misma licencia del café.

Capacidades Principales

Capacidad Resumen
Plano de mesas Editor visual para varios pisos. Arrastra mesas a su posición, cambia a vista 3D, marca mesas fuera de servicio.
Mesas Configura el número de asientos por mesa, forma, tamaño (1 a 10) y código de visualización. Genera códigos QR y gíralos según sea necesario.
Menú Categorías con iconos MDI, productos con fotos, descripciones en markdown, listas de ingredientes y grupos de variantes (por ejemplo, Tamaño, Ingredientes adicionales).
Pedidos Panel en vivo con sondeo cada 3 segundos, insignia de conteo pendiente, notificaciones de escritorio y audio, estado por pedido y por artículo.
Liquidación Acción de cierre de cuenta con un clic que liquida todos los pedidos abiertos en una mesa con un método de pago elegido.
Menú del cliente Menú web con marca en 24 idiomas en handy.cafe/{slug}, con tema claro y oscuro y predeterminado de idioma según el dispositivo.
Pago en línea Integración opcional con Stripe Checkout para pago al realizar el pedido, con opción de pago en efectivo en la mesa.
Impresora Impresora de recibos TCP opcional con corte automático e impresión automática en nuevos pedidos.

Dónde Se Encuentra Cafetería en la Interfaz del Servidor

Cafetería tiene dos puntos de entrada:

  1. Sección de Cafetería en la barra lateral. Este es el espacio de trabajo operativo para el uso diario. Contiene cinco pestañas: Mesas, Plano de Mesas, Menú, Pedidos y Horario. La pestaña de Pedidos muestra una insignia pendiente siempre que hay nuevos pedidos esperando.
  2. Configuración > Cafetería. Esta es el área de configuración. Contiene el perfil del negocio (slug, nombre para mostrar, logo, imagen de encabezado, dirección, moneda, zona horaria), configuraciones de impresora, gestión de pisos y activación de funciones opcionales.

Aprovisionamiento de un Café

Cuando habilitas Cafetería por primera vez, el servidor utiliza automáticamente tu licencia de HandyCafe como el token de autorización. No necesitas pegar nada manualmente. El asistente de aprovisionamiento luego solicita cuatro piezas de información:

  1. Slug. Esto se convierte en la URL pública en handy.cafe/{slug}. Los caracteres permitidos son letras minúsculas, números y guiones. El slug tiene de 3 a 62 caracteres. El sistema verifica la disponibilidad en tiempo real y rechaza slugs reservados como "admin", "api" o "dashboard".
  2. Nombre para mostrar. El nombre legible por humanos que se muestra en la parte superior del menú del cliente.
  3. País y moneda. La moneda predeterminada para los precios del menú. Los precios se almacenan en unidades menores (por ejemplo, centavos) y se muestran con el símbolo de moneda configurado.
  4. Zona horaria. Se utiliza para cálculos dinámicos de tiempo de preparación, marcas de tiempo en pedidos y registros de liquidación.

Después de completar el aprovisionamiento, el café se crea en la base de datos en la nube y se abre el espacio de trabajo de Cafetería. Luego puedes agregar pisos, mesas y elementos del menú.

Perfil del Negocio

El perfil del negocio es editable en cualquier momento en Configuración > Cafetería. Campos clave:

Campo Propósito
Slug Segmento de URL pública. Cambiar el slug rompe los códigos QR existentes hasta que se regeneren.
Nombre para Mostrar Se muestra en la parte superior del menú del cliente.
Logo Imagen cuadrada. Se recomienda WebP hasta 2 MB.
Imagen de Encabezado Imagen de banner ancha en la parte superior del menú del cliente. Se recomienda WebP hasta 2 MB.
Dirección y Teléfono Opcional. Se muestra en el pie de página del menú.
Moneda Se aplica a cada precio de producto en el menú.
País Se utiliza para impuestos y valores predeterminados regionales.
Zona Horaria Se aplica a las marcas de tiempo de pedidos y liquidaciones.
Mostrar Tiempo de Preparación en el Menú Alternar. Cuando está activado, cada producto muestra una etiqueta de tiempo estimado de preparación.

Configuración de la Impresora

La sección de impresora acepta la siguiente configuración:

  • Tipo. Desactivado o TCP. La impresión directa por USB no está soportada en esta versión.
  • IP y Puerto. La dirección de red de tu impresora de recibos. La mayoría de las impresoras ESC POS TCP escuchan en el puerto 9100.
  • Corte Automático. Agrega el comando de corte de papel después de cada recibo impreso.
  • Impresión Automática en Nuevo Pedido. Cuando está activado, cada pedido entrante desencadena automáticamente la impresión de un recibo.
  • Notificación de Sonido. Reproduce una alerta de audio además de la notificación de escritorio cuando llega un nuevo pedido.
  • Prueba de Impresión. Envía un recibo de muestra a la impresora configurada para verificar la conexión.

Resumen de la Arquitectura

Cafetería utiliza un modelo de datos centrado en la nube. Cada mesa, categoría, producto, pedido y registro de liquidación se almacena en la base de datos en la nube de handy.cafe. Tu servidor local de HandyCafe refleja este estado y sondea el endpoint de Pedidos cada 3 segundos para nueva actividad. Las páginas orientadas al cliente son servidas directamente por la nube de handy.cafe; no requieren que tu servidor sea accesible desde internet.

Debido a que los datos residen en la nube:

  • Los códigos QR continúan funcionando incluso cuando el servidor está desconectado, pero el personal no puede ver los pedidos en el panel hasta que regrese la conectividad.
  • Los cambios en el menú se envían a handy.cafe en segundos después de guardarlos.
  • Los pedidos realizados por los clientes llegan al panel de Pedidos después del siguiente sondeo de 3 segundos.

Próximos Pasos