Glosario

Una referencia alfabetica de terminos de dominio utilizados en toda la documentacion de HandyCafe.

Panel de administracion El panel principal de monitoreo en HandyCafe Server. Muestra todos los clientes conectados, sus estados y las sesiones activas. Tambien proporciona botones de accion en cada tarjeta de cliente para el control de sesiones y operaciones de gestion remota.

Tasa de comision Un porcentaje utilizado para expresar las tarifas de procesamiento de pagos. Por ejemplo, 1% o 5%. Se usa en la configuracion de metodos de pago para definir el costo de aceptar un metodo de pago particular.

Protocolo binario Un formato de codificacion compacto utilizado para la comunicacion TCP entre el servidor de HandyCafe y los clientes. Elegido por su velocidad y tamano de mensaje reducido en comparacion con formatos basados en texto.

Cliente Un PC de uso publico que ejecuta el software HandyCafe Client. Los clientes se conectan al servidor a traves de la red local, reciben comandos de sesion y reportan datos de estado y uso. Cada cliente se identifica por su direccion MAC y nombre de equipo.

Clave de conexion Un secreto compartido configurado tanto en el servidor como en cada cliente durante la configuracion. Se utiliza para generar tokens de autenticacion criptografica para la comunicacion 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 direccion MAC.

Cibercafe / Cybercafe Un negocio que proporciona acceso publico a computadoras y conectividad a internet, generalmente cobrando por hora. Tambien conocido como cafe internet. HandyCafe gestiona todos los aspectos de las operaciones de cibercafes incluyendo sesiones, facturacion y membresias.

Restriccion de dispositivo Un ajuste que especifica a que tipos de dispositivos aplica un credito de monedero, credito 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, areas de competicion y asientos para espectadores. HandyCafe admite arenas de esports con gestion de sesiones, seguimiento de miembros y facturacion de consolas.

Derecho El valor que un miembro recibe al comprar un paquete. Puede ser un credito de tiempo (minutos prepagados de uso de sesion), un saldo de monedero o una combinacion de ambos. Los derechos se registran como entradas de credito 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 visualizacion local. Esto permite que los cafes 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 esta construido para gestionar las operaciones de centros de gaming desde la facturacion de sesiones hasta los programas de membresia.

Autenticacion criptografica Un mecanismo de verificacion 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 conexion para calcular y validar codigos de autenticacion.

Cafe internet Un negocio que proporciona a los clientes acceso temporal a computadoras y servicios de internet. Los cafes internet son el caso de uso principal de HandyCafe, que maneja gestion de sesiones, precios, programas de membresia y operaciones de punto de venta.

Inactivo El estado del cliente cuando el PC esta conectado al servidor pero no hay sesion activa. En estado inactivo, el cliente muestra la pantalla de bloqueo (pagina de espera) y espera el inicio de sesion, el inicio de sesion de un miembro o una accion administrativa.

Credito de monedero / Credito de tiempo Una entrada discreta de saldo de monedero o minutos prepagados creada por una recarga o compra de paquete. Cada entrada de credito registra su origen (recarga en efectivo, derecho de paquete, bonificacion de campana), valor restante y restriccion de dispositivo aplicable. Los creditos se consumen en orden durante la liquidacion de la sesion.

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

mDNS (DNS Multicast) Un protocolo para la deteccion automatica de servicios en redes locales. Los clientes de HandyCafe anuncian su presencia via mDNS, permitiendo que el servidor los detecte sin configuracion 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 sesion en PCs cliente para sesiones personalizadas. Los miembros tambien pueden tener cuentas vinculadas por OAuth.

Unidades menores La denominacion mas pequena de una moneda, utilizada internamente para todos los calculos financieros para evitar errores de redondeo en punto flotante. Por ejemplo, USD usa centavos (1 dolar = 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 estandar. Un multiplicador de 1.5 significa que la tarifa es 50% mas alta (por ejemplo, horas pico), mientras que 0.5 significa mitad de precio (por ejemplo, descuentos fuera de pico).

PC Bang Un cibercafe 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 gestion de sesiones.

En linea El estado del cliente durante una sesion activa. Cuando esta en linea, el cliente muestra la interfaz de escritorio (pagina en linea), permitiendo al cliente usar aplicaciones, navegar e interactuar con el menu del cliente.

Pospago Un modo de facturacion de sesion donde el cliente usa el PC libremente y paga al final segun la duracion de uso real. El costo final se calcula al cierre de la sesion usando los segmentos del horario de precios que aplican.

Prepago Un modo de facturacion de sesion donde el cliente paga por adelantado por una duracion fija. La sesion termina automaticamente cuando el tiempo comprado expira, a menos que se extienda.

Segmento de precios Una porcion de una sesion durante la cual aplica un solo multiplicador de precios. Los limites de los segmentos se crean por eventos como inicio de sesion, pausa, reanudacion o una transicion de franja horaria en el horario.

Franja de precios Una zona codificada por color en la cuadricula 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 especificas en dias especificos, 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 que 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.

Limite de segmento Un evento que activa la creacion de un nuevo segmento de precios dentro de una sesion. Los limites incluyen: inicio de sesion, fin de sesion, pausa de sesion, reanudacion de sesion y cambio de franja de precios (cuando el reloj cruza de una franja de precios a otra).

Sesion 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.

Liquidacion El calculo realizado cuando una sesion termina para determinar el costo final. La liquidacion 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 sesion hasta el cierre. Todas las transacciones, operaciones de sesion y acciones administrativas realizadas durante un turno se atribuyen al cajero conectado. Los datos de turno se usan para rendicion de cuentas y analisis de rendimiento.

Tarifa de inicio Un cargo minimo aplicado por sesion sin importar la duracion. Si el costo calculado de una sesion (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 sesion.

Sincronizacion El proceso de sincronizacion de archivos desde el servidor de HandyCafe a los PCs cliente. Usa comparacion basada en manifiesto y transferencia por fragmentos para distribuir archivos eficientemente a traves 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 traves del gasto, avanzan a niveles mas altos con mejores beneficios.

Transaccion Un registro financiero de un pago por sesion, pedido, recarga de monedero u otro evento facturable. Las transacciones registran el monto, metodo de pago, miembro o cajero asociado y marca de tiempo.

IVA (Impuesto al Valor Agregado) Un porcentaje de impuesto aplicado a los cargos de sesion y montos de pedidos. La tasa de IVA se configura en los ajustes de precios y se incluye en el calculo de liquidacion. Los montos de IVA se registran por separado para fines de declaracion de impuestos.

Monedero El saldo monetario prepagado de un miembro almacenado en el sistema HandyCafe. El monedero se compone de una o mas entradas de credito y puede usarse para pagar sesiones, pedidos y otros servicios. Las recargas pueden hacerse mediante efectivo, paquetes o campanas.