Preguntas Frecuentes
Configuración e Instalación
¿Qué tipos de negocios soporta HandyCafe?
HandyCafe está diseñado para cibercafés, centros de juegos, arenas de esports, cafés internet y PC bangs. Cualquier negocio que ofrezca acceso cronometrado a PCs o consolas de juegos puede usar HandyCafe para gestionar sesiones, facturación y membresías.
¿Cuáles son los requisitos del sistema para HandyCafe Server?
El servidor requiere Windows 10 o posterior (64 bits), al menos 4 GB de RAM, 500 MB de espacio en disco y una conexión de red local. Los PCs cliente necesitan Windows 10 o posterior con 2 GB de RAM. Todos los PCs deben estar en la misma LAN. Consulte Requisitos del Sistema para más detalles.
¿Cómo instalo HandyCafe Server?
Descargue el instalador desde el sitio web oficial, ejecútelo y siga las indicaciones. En el primer inicio, el Asistente de Configuración Inicial crea su cuenta de administrador. Consulte Instalación del Servidor para instrucciones detalladas.
¿Cómo conecto un PC cliente al servidor?
Instale HandyCafe Client en el PC. Utiliza mDNS para descubrir el servidor automáticamente en la red local. Si la detección automática falla, ingrese manualmente la dirección IP del servidor en la configuración del cliente. Consulte Instalación del Cliente.
¿Por qué mi cliente no se conecta al servidor?
Causas comunes: el servidor no está en ejecución, los PCs están en subredes diferentes, el firewall está bloqueando puertos (TCP 5001, 5002, 5003 y UDP 5004) o la clave de conexión no coincide. Consulte Solución de Problemas para soluciones detalladas.
¿Qué puertos utiliza HandyCafe?
TCP 5001 (comandos), TCP 5002 (transferencias de archivos), TCP 5003 (gestión remota), UDP 5004 (transmisión de pantalla). Estos son configurables en Configuración de Red.
¿Cómo activo mi licencia?
Ingrese su clave de licencia en el panel de licencias. El servidor la valida con el servidor de licencias. Se requiere una conexión a internet activa para la activación inicial. Consulte Licencias.
¿Qué sucede cuando mi servidor está desconectado por más de 72 horas?
HandyCafe tiene un período de gracia de 72 horas sin conexión. Durante este tiempo, todas las funciones funcionan normalmente. Después de 72 horas sin conectividad con el servidor de licencias, el servidor entra en un estado bloqueado hasta que se restaure el acceso a internet.
Sesiones y Precios
¿Cómo inicio una sesión en un PC?
En el Panel de Administración, seleccione un PC inactivo (cian) y haga clic en Iniciar en la tarjeta. Elija modo pospago o prepago, asigne opcionalmente un miembro, establezca duración/monto si es prepago, seleccione un método de pago y confirme. Consulte Sesiones.
¿Cuál es la diferencia entre sesiones prepagadas y pospagadas?
En modo pospago, el cliente paga al final según el tiempo de uso real. En modo prepago, el cliente paga por adelantado por una duración o monto fijo. Prepago admite dos submodos: Bloquear al Comprar (costo congelado al inicio) y Horario en Vivo (el costo se ajusta con cambios de franja horaria). Consulte Sesiones.
¿Cómo funciona el horario de precios?
El horario de precios es una cuadrícula de 7 días por 24 horas donde cada bloque de tiempo se asigna a una franja de precios codificada por colores. Cada franja tiene un multiplicador (por ejemplo, 1.0x estándar, 1.5x pico, 0.5x fuera de pico). El costo de la sesión se calcula como: tarifa base por hora multiplicada por el multiplicador de la franja multiplicada por la duración. Consulte Precios de Sesión.
¿Cómo establezco precios diferentes para fines de semana vs días de semana?
En Configuración > Horario de Precios, cree franjas de precios con diferentes multiplicadores (por ejemplo, "Día de Semana" a 1.0x, "Fin de Semana" a 1.3x). Pinte las columnas de fin de semana con el color de la franja de Fin de Semana y las columnas de días de semana con el color de la franja de Día de Semana. Consulte Configuración del Horario de Precios.
¿Cómo pauso y reanudo una sesión?
Haga clic en Pausar en la tarjeta del PC en línea. La facturación se detiene mientras está pausada. Para reanudar, haga clic en Reanudar en la tarjeta del PC pausado. Un nuevo segmento de precios comienza al reanudar. Consulte Sesiones.
¿Cómo agrego tiempo extra a una sesión activa?
Haga clic en Agregar Tiempo en la tarjeta del PC en línea. Ingrese el número de minutos a agregar (positivo para extender, negativo para reducir). Se crea un registro de transacción para el ajuste.
¿Qué sucede cuando una sesión abarca múltiples franjas de precios?
La sesión se divide automáticamente en segmentos en los límites de las franjas. Cada segmento utiliza el multiplicador activo durante ese período. El costo total es la suma de todos los costos de los segmentos. Consulte Precios de Sesión.
¿Qué es la tarifa de inicio?
La tarifa de inicio es un cargo mínimo aplicado a cada sesión. Incluso si una sesión es muy corta, al cliente se le cobra al menos esta cantidad. Configúrelo en Configuración de Precios.
Miembros y Fidelización
¿Cómo creo un nuevo miembro?
Navegue a la página de Miembros y haga clic en Agregar Miembro. Ingrese el nombre de usuario, nombre para mostrar, correo electrónico opcional, teléfono y otros detalles. Asigne un nivel si corresponde. Consulte Miembros.
¿Cómo funciona el sistema de monedero?
Cada miembro tiene un saldo de monedero. Cuando recarga el monedero, se crea un crédito de monedero con una cantidad específica y tipo de crédito (pagado, bono, manual, etc.). Durante las sesiones, el monedero se consume automáticamente. Los créditos pueden tener fechas de expiración y restricciones de dispositivo. Consulte Monedero de Miembro.
¿Qué es un crédito de monedero?
Un crédito de monedero es una entrada discreta de saldo de monedero creada por una sola recarga. Cada crédito rastrea su propia cantidad, tipo de crédito (pagado, bono, manual), estado (activo, expirado, consumido) y restricción de dispositivo elegible. Los créditos se consumen en orden (el más antiguo primero). Consulte Monedero de Miembro.
¿Cómo funcionan los niveles de fidelización y puntos?
Los miembros ganan puntos a través de actividades (gastos, visitas, recargas, pedidos). Cada nivel tiene un umbral de puntos. Cuando un miembro acumula suficientes puntos, avanza al siguiente nivel. Los niveles más altos pueden tener mejores tasas de descuento. Consulte Niveles de Fidelización.
¿Cómo recargo el monedero de un miembro?
Seleccione el miembro en la página de Miembros, haga clic en la opción de pago/recarga, ingrese la cantidad, seleccione el tipo de crédito y método de pago, y confirme. Se crea un nuevo crédito de monedero. Consulte Monedero de Miembro.
¿Puede un miembro usar su saldo de monedero tanto para PCs como para consolas?
Depende de la restricción de dispositivo del crédito. Los créditos pueden estar restringidos a "solo PCs", "solo consolas" o "ambos". Al comprar un paquete, la restricción de dispositivo se define por la configuración del paquete. Consulte Paquetes.
¿Qué sucede cuando un crédito de monedero expira?
Cuando un crédito alcanza su fecha de expiración, su estado cambia a "expirado" y el saldo restante ya no está disponible para su uso. La cantidad expirada se registra en el historial de transacciones del miembro.
¿Cómo veo el historial de transacciones de un miembro?
Seleccione el miembro en la página de Miembros. El panel de detalles del miembro muestra el libro de transacciones con todas las recargas de monedero, gastos, reembolsos y ajustes con marcas de tiempo y cantidades.
Productos, Pedidos e Inventario
¿Cómo agrego un producto al catálogo?
Navegue a Productos y haga clic en Agregar Producto. Ingrese el nombre, categoría, unidad, código de barras, precio de venta, precio de costo y tasa de IVA. Active o desactive según sea necesario. Consulte Productos.
¿Cómo creo un pedido para un cliente?
Navegue a Pedidos, haga clic en Nuevo Pedido, asigne opcionalmente a un PC o agregue una nota, agregue artículos del catálogo de productos con cantidades, luego cierre el pedido con un método de pago. Consulte Pedidos.
¿Cómo cancelo o reembolso un pedido?
Abra el pedido desde la página de Pedidos y haga clic en Cancelar. El pedido se anula y no se registra ningún pago. Para reembolsos en pedidos cerrados, use el flujo de trabajo de reembolso apropiado.
¿Cómo funciona el seguimiento de inventario?
Cada producto tiene un nivel de inventario. El registro de inventario rastrea los cambios con razones: venta (auto-decrementado al cerrar el pedido), compra (de entradas de inventario), ajuste, desperdicio y devolución. Consulte Productos e Inventario.
Campañas y Paquetes
¿Cómo creo una campaña?
Navegue a Campañas y haga clic en Agregar Campaña. Ingrese el nombre, descripción, actívela y configure una fecha de expiración si es aplicable. Luego agregue paquetes a la campaña. Consulte Campañas.
¿Cuál es la diferencia entre paquetes basados en minutos y en dinero?
Los paquetes basados en minutos dan al miembro tiempo (minutos) que puede usar para sesiones. Los paquetes basados en dinero agregan fondos al monedero del miembro. Ambos pueden incluir cantidades de bono. Consulte Paquetes.
¿Cómo funciona el sistema de bonos en los paquetes?
Un paquete puede incluir un bono además del derecho base. Por ejemplo, un paquete podría ofrecer "60 minutos + 15 minutos de bono" o "$10 + $2 de bono". El bono crea una entrada de crédito separada etiquetada con el tipo de crédito "Bono".
¿Cómo funcionan las restricciones de dispositivo en los paquetes?
Cada paquete define una restricción de dispositivo: cliente (PCs), consola (consolas), ambos, solo PCs o solo consolas. Cuando se compra el paquete, los créditos de monedero/tiempo creados heredan esta restricción y solo pueden usarse en tipos de dispositivos coincidentes.
Gestión de Cajeros
¿Cómo creo una cuenta de cajero?
Navegue a Gestión > Cajeros. Haga clic en Agregar Cajero, ingrese un nombre de usuario y contraseña, y asigne un rol. El cajero puede iniciar sesión con estas credenciales. Consulte Roles de Cajero.
¿Cómo configuro permisos para un rol de cajero?
Navegue a Gestión > Roles de Cajero. Cree un nuevo rol o edite uno existente. Marque o desmarque las banderas de permiso individuales en cada una de las 6 categorías (Autenticación, Miembros, Consolas, Registros, Informes, Métodos de Pago). Consulte Roles de Cajero.
¿Cuáles son las 6 categorías de permisos?
Autenticación (1 bandera), Miembros (6 banderas: ver, agregar, eliminar, actualizar, mostrar correo electrónico, mostrar teléfono), Consolas (4 banderas: ver, agregar, eliminar, actualizar), Registros (4 banderas: ver, historial completo, solo hoy, eliminar), Informes (3 banderas: ver, historial completo, solo hoy), Métodos de Pago (4 banderas: gestionar, agregar, eliminar, actualizar). Total: 22 banderas de permiso individuales.
¿Cómo funciona la protección contra fuerza bruta en el inicio de sesión de cajeros?
Después de 5 intentos fallidos de inicio de sesión en 10 minutos, la cuenta se bloquea por 15 minutos. Todos los intentos fallidos se registran en el rastro de auditoría con una alerta de seguridad.
¿Cómo veo los informes de turno de cajeros?
Abra la página de Informe de Caja. Filtre por nombre de cajero para ver las transacciones procesadas por un cajero específico durante su turno. El resumen del turno muestra totales y desglose por método de pago.
Configuración y Configuración
¿Cómo cambio el idioma?
Navegue a Configuración > General y seleccione su idioma del menú desplegable. HandyCafe soporta 24 idiomas. La interfaz se actualiza inmediatamente. Consulte Configuración General.
¿Cómo configuro el inicio de sesión con Google OAuth?
Navegue a Configuración > OAuth. Habilite OAuth globalmente, luego habilite Google. Ingrese su ID de Cliente de Google y Secreto de Cliente (desde la Consola de Google Cloud). Opcionalmente, importe el archivo de credenciales JSON. Pruebe iniciando un inicio de sesión OAuth desde un PC cliente. Consulte Configuración de OAuth.
¿Cómo configuro la cuadrícula del horario de precios?
Navegue a Configuración > Horario de Precios. Habilite el horario, cree franjas codificadas por colores con multiplicadores, luego haga clic/arrastre en la cuadrícula de 7x24 horas para pintar bloques de tiempo con la franja deseada. Consulte Configuración del Horario de Precios.
¿Cómo personalizo la pantalla de espera del cliente?
Navegue a Configuración > Clientes > pestaña Pantalla de Espera. Habilite la presentación de diapositivas, agregue imágenes o videos, configure duraciones y transiciones. Opcionalmente, habilite superposiciones de reloj y nombre del café. Consulte Pantalla de Espera del Cliente.
¿Cómo cambio el tema de apariencia del cliente?
Navegue a Configuración > Clientes > pestaña Apariencia. Seleccione un tema (Neon Arena, Crimson Pulse, Emerald Depth), elija un diseño preestablecido y configure fondo, densidad de tarjetas y efectos. Consulte Apariencia del Cliente.
¿Cómo configuro las notificaciones de sonido?
Navegue a Configuración > Sonidos. Habilite el interruptor maestro de sonidos, luego seleccione un sonido para cada evento (Llamar a Cajero, Nuevo Pedido, Fin de Sesión, Solicitud de Inicio de Sesión) de las 15 opciones integradas. Consulte Configuración de Sonidos.
¿Qué es la clave de conexión y por qué es importante?
La clave de conexión es un secreto compartido utilizado para la autenticación criptográfica entre el servidor y los clientes. Previene que dispositivos no autorizados se conecten a su servidor. Todos los clientes deben usar la misma clave que el servidor. Configúrela en Configuración de Red.
Gestión Remota
¿Cómo tomo una captura de pantalla remota de un PC cliente?
Seleccione el cliente en el Panel de Administración y haga clic en Captura de Pantalla en la tarjeta. El visor de capturas muestra la imagen capturada. Puede actualizar para una nueva captura o descargar la imagen. Consulte Capturas de Pantalla.
¿Cómo uso el escritorio remoto para controlar un PC cliente?
Seleccione la tarjeta del cliente y haga clic en Escritorio Remoto. Se abre una ventana con transmisión de video en vivo H.264. Puede controlar el mouse y el teclado de forma remota y la sincronización del portapapeles funciona entre el servidor y el cliente. Consulte Escritorio Remoto.
¿Cómo funciona el sistema de sincronización de archivos?
Configure directorios para sincronizar en Configuración > Explorador de Sincronización. Cuando se activa, el servidor crea un manifiesto de archivos. Los clientes comparan el manifiesto con los archivos locales y descargan solo los archivos cambiados o nuevos utilizando transferencia basada en fragmentos. Consulte Sincronización de Archivos.
¿Cómo veo qué aplicaciones están ejecutándose en un PC cliente?
Seleccione el cliente en el Panel de Administración y haga clic en Aplicaciones en Ejecución en la tarjeta. Un panel muestra todos los procesos en ejecución actualmente con nombres y detalles. También puede ver Aplicaciones de Inicio, Aplicaciones Instaladas y Aplicaciones en Ventana desde los mismos botones de acción.
¿Cómo envío un mensaje a un PC cliente?
Seleccione la tarjeta del cliente y haga clic en Enviar Mensaje. Escriba su mensaje y confirme. El mensaje aparece en la pantalla del cliente.
¿Cómo apago o reinicio un PC cliente de forma remota?
Seleccione la tarjeta del cliente y haga clic en Apagar o Reiniciar. También puede seleccionar múltiples clientes para operaciones en masa. Wake on LAN está disponible para encender PCs desconectados que lo soporten.
Informes y Análisis
¿Cómo veo el informe de caja?
Navegue a Informe de Caja desde la barra lateral. El informe muestra tarjetas de resumen, historial de transacciones, ganancias por dispositivo y gráficos. Use filtros de fecha para acotar el rango de tiempo. Consulte Informe de Caja.
¿Cómo exporto datos de informes?
En el Informe de Caja, use la función de exportar/copiar para copiar datos de transacciones a su portapapeles en formato CSV. Luego puede pegarlos en Excel o cualquier aplicación de hoja de cálculo.
¿Qué análisis están disponibles en la página de Estadísticas?
Nueve pestañas de análisis: Tendencias de ingresos, Análisis de ventas, Seguimiento de gastos, Estadísticas de sesiones, Utilización de consolas, Uso de aplicaciones, Tasas de uso de computadoras, Actividad de miembros y Rendimiento de cajeros. Consulte Estadísticas.
¿Cómo verifico las tasas de utilización de computadoras?
Navegue a Estadísticas > pestaña Uso de Computadoras. Esto muestra porcentajes de utilización por PC, tiempo de actividad e ingresos por máquina. También identifica sus PCs más ocupados. Consulte Estadísticas de Sesiones y Computadoras.
Solución de Problemas
El cliente muestra "offline" pero el PC está encendido. ¿Qué hago?
Verifique que: 1) HandyCafe Client esté ejecutándose en el PC, 2) Ambos PCs estén en la misma red/subred, 3) El firewall permita los puertos TCP 5001-5003, 4) La clave de conexión coincida entre servidor y cliente. Consulte Solución de Problemas.
El precio de la sesión parece incorrecto. ¿Cómo lo verifico?
Verifique la configuración de precios (Configuración > Precios) para la tarifa base por hora e IVA. Verifique el horario de precios (Configuración > Horario de Precios) para multiplicadores activos en el momento de la sesión. Revise los segmentos de precios de la sesión en los detalles de la transacción para ver cómo se calculó cada segmento.
El inicio de sesión OAuth está atascado en "pendiente". ¿Cómo lo resuelvo?
Asegúrese de que el administrador haya aprobado la solicitud en la página de Solicitudes. Si la solicitud está atascada, verifique: 1) Las credenciales del proveedor OAuth son correctas en Configuración > OAuth, 2) El servidor tiene acceso a internet para llegar a la API del proveedor, 3) El código del dispositivo no ha expirado (típicamente expiran en 15-30 minutos).
El escritorio remoto está lento. ¿Cómo mejoro el rendimiento?
Reduzca la tasa de bits en la configuración de transmisión (pruebe 1000-2000 kbps para LAN). Verifique el ancho de banda de la red entre servidor y cliente. Asegúrese de que el puerto UDP 5004 no esté bloqueado. Use Ethernet cableado en lugar de WiFi para obtener mejores resultados.
Mi licencia muestra "over_limit". ¿Qué significa eso?
Hay más PCs cliente conectados de lo que permite su licencia. Desconecte clientes no utilizados o actualice su licencia. El servidor no iniciará nuevas sesiones hasta que el número de clientes conectados esté en o por debajo del límite.
Un cajero está bloqueado después de demasiados intentos fallidos de inicio de sesión. ¿Cómo lo desbloqueo?
Espere 15 minutos para que el bloqueo automático expire. Si es urgente, un administrador puede gestionar la cuenta del cajero a través de la interfaz de gestión.
Cafetería
¿Cómo hacen los clientes pedidos desde su mesa?
Escanean el código QR en la mesa con su teléfono, ingresan el código de seguridad de 6 dígitos que les da el personal, navegan por el menú en su propio idioma, agregan artículos al carrito y envían con pago en efectivo o en línea (Stripe). Los pedidos aparecen en su panel de Pedidos de Cafetería en 3 segundos. Consulte Menú del Cliente.
¿Cómo habilito el módulo de Cafetería?
Abra Configuración > Cafetería y active Habilitar Cafetería. El servidor utiliza su licencia de HandyCafe como autorización automáticamente. Un asistente de aprovisionamiento solicita su slug, nombre para mostrar, país, moneda y zona horaria. Consulte Descripción General de Cafetería y Cómo Configurar Cafetería.
¿Qué idiomas soporta el menú del cliente?
El menú del cliente en handy.cafe/{slug} soporta 24 idiomas. La primera visita elige la mejor coincidencia del encabezado Accept-Language del navegador. Los clientes pueden cambiar de idioma en cualquier momento con el selector en la parte superior.
¿Funciona Cafetería sin internet?
No. Cafetería es primero en la nube. El aprovisionamiento, la sincronización del menú y la consulta de pedidos requieren acceso a internet saliente. Las páginas orientadas al cliente son servidas por la nube y no dependen de que su servidor local sea accesible desde internet.
Clientes Legado
¿HandyCafe soporta mis clientes antiguos V3 o V4?
Sí. Habilite el soporte en tiempo de ejecución en Configuración > Clientes Legado y el servidor inicia oyentes en los puertos originales de legado (UDP 710/711, TCP 712, transferencia de archivos 717). Sus clientes existentes se conectan sin ningún cambio de su parte. Aparecen en el Panel de Administración con un conjunto de acciones reducido (Iniciar Sesión, Cerrar Sesión, Agregar Tiempo, Captura de Pantalla, Cerrar Sesión, Reiniciar, Apagar). Consulte Clientes Legado.
¿Pueden los clientes legado y modernos funcionar en el mismo servidor al mismo tiempo?
Sí. Las dos pilas de protocolos usan diferentes puertos y no colisionan. Puede mezclar clientes antiguos y nuevos en la misma LAN y gestionarlos desde el mismo Panel de Administración.
¿Puedo traer mis datos de una instalación anterior de HandyCafe?
Sí, en Windows. Abra Configuración > Clientes Legado, desplácese a Migración de Base de Datos y haga clic en Iniciar Migración. Se importan miembros, precios, productos, pedidos, transacciones y registros. Los archivos originales no se modifican ni eliminan. Si el resultado no es lo que esperaba, haga clic en Deshacer Migración para revertir. Consulte Cómo Migrar desde una Instalación Legado.
¿Cuál es la diferencia entre las variantes de protocolo STE y Standard?
Los marcos STE (Smart/Turbo Edition) incluyen un prefijo de información de licencia de 70 bytes; el tamaño del marco es de 1337 bytes. Los marcos Standard omiten el prefijo; el tamaño del marco es de 1267 bytes. Elija la variante que coincida con cómo se construyó su servidor legado. Elegir la variante incorrecta causa marcos perdidos o mal leídos.