Glosario

Una referencia alfabética de términos de dominio utilizados en toda la documentación de HandyCafe.

Panel de administración El panel principal de monitoreo en HandyCafe Server. Muestra todos los clientes conectados, sus estados y las sesiones activas. También proporciona botones de acción en cada tarjeta de cliente para el control de sesiones y operaciones de gestión remota.

Tasa de comisión Un porcentaje utilizado para expresar las tarifas de procesamiento de pagos. Por ejemplo, 1% o 5%. Se usa en la configuración de métodos de pago para definir el costo de aceptar un método de pago particular.

Protocolo binario Un formato de codificación compacto utilizado para la comunicación TCP entre el servidor de HandyCafe y los clientes. Elegido por su velocidad y tamaño de mensaje reducido en comparación con formatos basados en texto.

Cliente Un PC de uso público que ejecuta el software HandyCafe Client. Los clientes se conectan al servidor a través de la red local, reciben comandos de sesión y reportan datos de estado y uso. Cada cliente se identifica por su dirección MAC y nombre de equipo.

Clave de conexión Un secreto compartido configurado tanto en el servidor como en cada cliente durante la configuración. Se utiliza para generar tokens de autenticación criptográfica para la comunicación TCP, asegurando que solo dispositivos autorizados puedan intercambiar comandos con el servidor.

Consola Un dispositivo de juego como PlayStation o Xbox gestionado por HandyCafe. Las consolas admiten sesiones, precios y uso por miembros al igual que los PCs cliente, pero no ejecutan el software HandyCafe Client. Se identifican por dirección MAC.

Cibercafé / Cybercafe Un negocio que proporciona acceso público a computadoras y conectividad a internet, generalmente cobrando por hora. También conocido como café internet. HandyCafe gestiona todos los aspectos de las operaciones de cibercafés incluyendo sesiones, facturación y membresías.

Restricción de dispositivo Un ajuste que especifica a qué tipos de dispositivos aplica un crédito de monedero, crédito de tiempo o regla de precios. Los valores posibles son: cliente (PCs), consola (consolas de juego), solo PCs, solo consolas o ambos (cualquier dispositivo).

Arena de esports Un local dedicado a juegos competitivos y eventos de esports, que generalmente cuenta con PCs de alto rendimiento, áreas de competición y asientos para espectadores. HandyCafe admite arenas de esports con gestión de sesiones, seguimiento de miembros y facturación de consolas.

Derecho El valor que un miembro recibe al comprar un paquete. Puede ser un crédito de tiempo (minutos prepagados de uso de sesión), un saldo de monedero o una combinación de ambos. Los derechos se registran como entradas de crédito en el monedero o saldo de tiempo del miembro.

Tipo de cambio Tipo de cambio de divisas utilizado para convertir la moneda base a una moneda de visualización local. Esto permite que los cafés en regiones con diferentes monedas establezcan precios en su moneda local mientras mantienen una base contable interna consistente.

Centro de gaming Un local comercial donde los clientes pagan por usar PCs o consolas de juego, que generalmente ofrece hardware de alto rendimiento y un entorno social de juego. HandyCafe está construido para gestionar las operaciones de centros de gaming desde la facturación de sesiones hasta los programas de membresía.

Autenticación criptográfica Un mecanismo de verificación de mensajes utilizado para garantizar la integridad y autenticidad de los mensajes TCP entre el servidor y los clientes. Ambas partes usan la Clave de conexión para calcular y validar códigos de autenticación.

Café internet Un negocio que proporciona a los clientes acceso temporal a computadoras y servicios de internet. Los cafés internet son el caso de uso principal de HandyCafe, que maneja gestión de sesiones, precios, programas de membresía y operaciones de punto de venta.

Inactivo El estado del cliente cuando el PC está conectado al servidor pero no hay sesión activa. En estado inactivo, el cliente muestra la pantalla de bloqueo (página de espera) y espera el inicio de sesión, el inicio de sesión de un miembro o una acción administrativa.

Crédito de monedero / Crédito de tiempo Una entrada discreta de saldo de monedero o minutos prepagados creada por una recarga o compra de paquete. Cada entrada de crédito registra su origen (recarga en efectivo, derecho de paquete, bonificación de campaña), valor restante y restricción de dispositivo aplicable. Los créditos se consumen en orden durante la liquidación de la sesión.

Dirección MAC Un identificador de hardware asignado a una interfaz de red. HandyCafe usa direcciones MAC para identificar de forma única a los clientes y consolas, asegurando que los dispositivos sean reconocidos incluso si sus direcciones IP cambian.

mDNS (DNS Multicast) Un protocolo para la detección automática de servicios en redes locales. Los clientes de HandyCafe anuncian su presencia vía mDNS, permitiendo que el servidor los detecte sin configuración manual de IP.

Miembro Un cliente registrado con un perfil en el sistema HandyCafe. Los miembros tienen un monedero, nivel de fidelidad e historial de transacciones. Pueden iniciar sesión en PCs cliente para sesiones personalizadas. Los miembros también pueden tener cuentas vinculadas por OAuth.

Unidades menores La denominación más pequeña de una moneda, utilizada internamente para todos los cálculos financieros para evitar errores de redondeo en punto flotante. Por ejemplo, USD usa centavos (1 dólar = 100 unidades menores), mientras que JPY usa yenes directamente (1 yen = 1 unidad menor).

Multiplicador Un factor aplicado a la tarifa por hora base dentro de una franja del horario de precios. Un multiplicador de 1.0 significa que aplica la tarifa estándar. Un multiplicador de 1.5 significa que la tarifa es 50% más alta (por ejemplo, horas pico), mientras que 0.5 significa mitad de precio (por ejemplo, descuentos fuera de pico).

PC Bang Un cibercafé estilo coreano y centro de gaming donde los clientes pagan por acceso por hora a PCs. Los PC bangs son conocidos por su hardware de juego de alto nivel y su cultura de juego competitivo. HandyCafe admite operaciones de PC bang con horarios de precios flexibles y gestión de sesiones.

En línea El estado del cliente durante una sesión activa. Cuando está en línea, el cliente muestra la interfaz de escritorio (página en línea), permitiendo al cliente usar aplicaciones, navegar e interactuar con el menú del cliente.

Pospago Un modo de facturación de sesión donde el cliente usa el PC libremente y paga al final según la duración de uso real. El costo final se calcula al cierre de la sesión usando los segmentos del horario de precios que aplican.

Prepago Un modo de facturación de sesión donde el cliente paga por adelantado por una duración fija. La sesión termina automáticamente cuando el tiempo comprado expira, a menos que se extienda.

Segmento de precios Una porción de una sesión durante la cual aplica un solo multiplicador de precios. Los límites de los segmentos se crean por eventos como inicio de sesión, pausa, reanudación o una transición de franja horaria en el horario.

Franja de precios Una zona codificada por color en la cuadrícula semanal del horario de precios. Cada franja define un rango de tiempo y un multiplicador que modifica la tarifa por hora base. Las franjas pueden cubrir horas específicas en días específicos, permitiendo diferentes precios para periodos pico vs. fuera de pico.

Rol Un conjunto nombrado de permisos asignado a una cuenta de cajero. Los roles definen qué acciones puede realizar un cajero (por ejemplo, iniciar sesiones, gestionar miembros, ver reportes). Varios cajeros pueden compartir el mismo rol y los permisos se aplican en toda la interfaz.

Límite de segmento Un evento que activa la creación de un nuevo segmento de precios dentro de una sesión. Los límites incluyen: inicio de sesión, fin de sesión, pausa de sesión, reanudación de sesión y cambio de franja de precios (cuando el reloj cruza de una franja de precios a otra).

Sesión Un periodo de tiempo de uso de PC o consola por un cliente. Las sesiones registran hora de inicio, hora de fin, pausas, segmentos de precios y el monto total cobrado. Pueden ser prepago o pospago.

Liquidación El cálculo realizado cuando una sesión termina para determinar el costo final. La liquidación procesa todos los segmentos de precios, aplica los multiplicadores correspondientes, agrega tarifas de inicio e IVA, deduce cualquier descuento de miembro y produce el monto total a cobrar.

Turno El periodo de trabajo de un cajero desde el inicio de sesión hasta el cierre. Todas las transacciones, operaciones de sesión y acciones administrativas realizadas durante un turno se atribuyen al cajero conectado. Los datos de turno se usan para rendición de cuentas y análisis de rendimiento.

Tarifa de inicio Un cargo mínimo aplicado por sesión sin importar la duración. Si el costo calculado de una sesión (basado en tiempo y precios) es menor que la tarifa de inicio, se cobra la tarifa de inicio en su lugar. Esto garantiza un ingreso base por sesión.

Sincronización El proceso de sincronización de archivos desde el servidor de HandyCafe a los PCs cliente. Usa comparación basada en manifiesto y transferencia por fragmentos para distribuir archivos eficientemente a través de la red.

Nivel Un nivel de fidelidad en el sistema de niveles de miembros. Los niveles se definen por umbrales de puntos y proporcionan tasas de descuento en sesiones y pedidos. A medida que los miembros acumulan puntos a través del gasto, avanzan a niveles más altos con mejores beneficios.

Transacción Un registro financiero de un pago por sesión, pedido, recarga de monedero u otro evento facturable. Las transacciones registran el monto, método de pago, miembro o cajero asociado y marca de tiempo.

IVA (Impuesto al Valor Agregado) Un porcentaje de impuesto aplicado a los cargos de sesión y montos de pedidos. La tasa de IVA se configura en los ajustes de precios y se incluye en el cálculo de liquidación. Los montos de IVA se registran por separado para fines de declaración de impuestos.

Monedero El saldo monetario prepagado de un miembro almacenado en el sistema HandyCafe. El monedero se compone de una o más entradas de crédito y puede usarse para pagar sesiones, pedidos y otros servicios. Las recargas pueden hacerse mediante efectivo, paquetes o campañas.