English version available: README.en.md
Keues TicketMachine es el kiosco físico de autoservicio del sistema de gestión de turnos Keues. Es la máquina que el cliente usa para elegir un servicio y sacar su número de turno, que se imprime al instante.
Sitio web oficial y documentación: https://www.keues.dev
⚠️ Importante: la máquina no funciona sola. Necesita un servidor para conectarse y emitir turnos (ver Requisitos).
Usar la máquina es muy sencillo:
- La pantalla muestra el menú de servicios del establecimiento.
- El cliente toca el servicio que necesita (si hay submenús, navega con el botón "Atrás").
- La máquina genera su número de turno y lo muestra en pantalla.
- El turno se imprime automáticamente en la impresora.
- A los 2 segundos la pantalla vuelve al menú principal, lista para el siguiente cliente.
- Un servidor Keues (Keues) desplegado y accesible desde la misma red que la máquina. El servidor es el que gestiona las colas, los turnos y los flujos de servicio; sin él la máquina no puede emitir tickets.
- Una pantalla (idealmente táctil) para el kiosco.
- Una impresora de tickets (térmica POS o cualquier impresora del sistema).
No necesitas compilar nada. Cada release de GitHub incluye un instalador .exe para Windows:
- Descarga el archivo
Keues-TicketMachine-Setup-X.Y.Z.exe. - Ejecútalo y sigue los pasos del instalador.
- La máquina queda instalada y lista para configurar.
Al abrir la aplicación por primera vez, se muestra la pantalla de ajustes de la máquina:
- Introduce la dirección del servidor Keues y pulsa Conectar.
- Selecciona la ubicación (establecimiento).
- Selecciona el flujo de servicios.
- Asigna un nombre a la máquina.
- Elige el tema visual (opcional).
Guarda los ajustes y la máquina cargará el menú de servicios y empezará a atender clientes.
Desde los ajustes puedes configurar la impresión:
- Seleccionar impresora: elige entre las impresoras disponibles.
- Tamaño del papel: 58 mm u 80 mm.
- Vista previa: revisa cómo quedará el ticket antes de imprimir.
Los botones, fondos y textos son configurables. Desde los ajustes puedes cambiar:
- Colores del encabezado y de los botones.
- Redondeo de los botones.
- Título que se muestra en pantalla.
- Imagen de fondo.
- Número de columnas del menú.
La máquina puede actualizarse sola. En Ajustes → Actualizaciones puedes comprobar si hay una versión nueva en GitHub, descargarla e instalarla con un clic; la app se reinicia con la versión actualizada.
ℹ️ La comprobación de actualizaciones solo está disponible en la app instalada.
¿La máquina funciona sin servidor? No. Necesita un servidor Keues desplegado y accesible desde la misma red que la máquina.
¿Qué impresora necesito? Una impresora térmica POS (58/80 mm) o cualquier impresora del sistema. Se selecciona desde los ajustes.
¿Puedo cambiar los colores y textos? Sí. Botones, fondos y textos son configurables desde los ajustes de la máquina.
¿Cómo se actualiza la máquina? Desde Ajustes → Actualizaciones se comprueba, descarga e instala la última versión con un clic.
Distribuido bajo la Licencia MIT.