Glossário

Uma referência alfabética dos termos de domínio usados na documentação do HandyCafe.

Painel de Administração O painel principal de monitoramento no HandyCafe Server. Exibe todos os clientes conectados, seus status e sessões ativas. Também fornece botões de ação em cada cartão de cliente para controle de sessão e operações de gerenciamento remoto.

Taxa de Comissão Uma porcentagem usada para expressar taxas de processamento de pagamento. Por exemplo, 1% ou 5%. Usada na configuração de métodos de pagamento para definir o custo de aceitar um método de pagamento específico.

Protocolo Binário Um formato de codificação compacto usado para comunicação TCP entre o HandyCafe Server e os clientes. Escolhido por sua velocidade e tamanho pequeno de mensagem comparado a formatos baseados em texto.

Cliente Um PC voltado ao cliente executando o software HandyCafe Client. Os clientes se conectam ao servidor pela rede local, recebem comandos de sessão e reportam status e dados de uso. Cada cliente é identificado por seu endereço MAC e nome do host.

Chave de Conexão Um segredo compartilhado configurado tanto no servidor quanto em cada cliente durante a configuração. É usado para gerar tokens de autenticação criptográfica para comunicação TCP, garantindo que apenas dispositivos autorizados possam trocar comandos com o servidor.

Console Um dispositivo de jogos como PlayStation ou Xbox gerenciado pelo HandyCafe. Consoles suportam sessões, preços e uso por membros assim como PCs clientes, mas não executam o software HandyCafe Client. São rastreados por endereço MAC.

Cybercafe / Lan House Um negócio que fornece acesso público a computadores e conectividade com a internet, normalmente cobrando por hora. O HandyCafe gerencia todos os aspectos das operações de uma lan house incluindo sessões, cobrança e associações.

Restrição de Dispositivo Uma configuração que especifica a quais tipos de dispositivos um crédito de carteira, crédito de tempo ou regra de preço se aplica. Valores possíveis são: cliente (PCs), console (consoles de jogos), apenas PCs, apenas consoles ou ambos (qualquer dispositivo).

Arena de Esports Um local dedicado a jogos competitivos e eventos de esports, frequentemente com PCs de alto desempenho, áreas de torneio e assentos para espectadores. O HandyCafe suporta arenas de esports com gerenciamento de sessões, rastreamento de membros e cobrança de consoles.

Benefício O valor que um membro recebe ao comprar um pacote. Pode ser um crédito de tempo (minutos pré-pagos de uso de sessão), um saldo monetário de carteira ou uma combinação de ambos. Benefícios são registrados como entradas de crédito na carteira ou saldo de tempo do membro.

Taxa de Câmbio Taxa de câmbio usada para converter a moeda base para uma moeda de exibição local. Isso permite que estabelecimentos em regiões com moedas diferentes precifiquem na moeda local mantendo uma base contábil interna consistente.

Centro de Jogos Um local comercial onde clientes pagam para usar PCs ou consoles de jogos, normalmente oferecendo hardware de alto desempenho e um ambiente social de jogos. O HandyCafe é feito para gerenciar operações de centros de jogos desde cobrança de sessões até programas de associação.

Autenticação Criptográfica Um mecanismo de verificação de mensagens usado para garantir a integridade e autenticidade das mensagens TCP entre o servidor e os clientes. Ambas as partes usam a Chave de Conexão para calcular e validar códigos de autenticação.

Lan House / Internet Cafe Um negócio que fornece aos clientes acesso temporizado a computadores e serviços de internet. Lan houses são o caso de uso principal do HandyCafe, que gerencia sessões, preços, programas de associação e operações de ponto de venda.

Ocioso O estado do cliente quando o PC está conectado ao servidor mas nenhuma sessão está ativa. No estado ocioso, o cliente exibe a tela de bloqueio (IdlePage) e aguarda início de sessão, login de membro ou ação administrativa.

Crédito de Carteira / Crédito de Tempo Uma entrada discreta de saldo de carteira ou minutos pré-pagos criada por uma recarga ou compra de pacote. Cada entrada de crédito registra sua origem (recarga em dinheiro, benefício de pacote, bônus de campanha), valor restante e restrição de dispositivo aplicável. Os créditos são consumidos em ordem durante a liquidação da sessão.

Endereço MAC Um identificador de hardware atribuído a uma interface de rede. O HandyCafe usa endereços MAC para identificar exclusivamente clientes e consoles, garantindo que os dispositivos sejam reconhecidos mesmo se seus endereços IP mudarem.

mDNS (Multicast DNS) Um protocolo para descoberta automática de serviços em redes locais. Os clientes HandyCafe anunciam sua presença via mDNS, permitindo que o servidor os detecte sem configuração manual de IP.

Membro Um cliente registrado com um perfil no sistema HandyCafe. Membros possuem uma carteira, nível de fidelidade e histórico de transações. Eles podem fazer login nos PCs clientes para sessões personalizadas. Membros também podem ter contas vinculadas por OAuth.

Unidades Menores A menor denominação de uma moeda, usada internamente para todos os cálculos financeiros para evitar erros de arredondamento de ponto flutuante. Por exemplo, BRL usa centavos (1 real = 100 unidades menores), enquanto JPY usa ienes diretamente (1 iene = 1 unidade menor).

Multiplicador Um fator aplicado a tarifa horária base dentro de uma faixa da agenda de preços. Um multiplicador de 1,0 significa que a tarifa padrão se aplica. Um multiplicador de 1,5 significa que a tarifa é 50% mais alta (por exemplo, horários de pico), enquanto 0,5 significa metade do preço (por exemplo, descontos fora do pico).

PC Bang Uma lan house e centro de jogos em estilo coreano onde clientes pagam por acesso horário a PCs. PC bangs são conhecidos por hardware de jogos de ponta e cultura de jogos competitivos. O HandyCafe suporta operações de PC bang com agendas de preços flexíveis e gerenciamento de sessões.

Online O estado do cliente durante uma sessão ativa. Quando online, o cliente exibe a interface de área de trabalho (OnlinePage), permitindo que o cliente use aplicativos, navegue e interaja com o menu do cliente.

Pós-pago Um modo de cobrança de sessão onde o cliente usa o PC livremente e paga ao final com base na duração real de uso. O custo final é calculado no encerramento da sessão usando os segmentos de agenda de preços aplicáveis.

Pré-pago Um modo de cobrança de sessão onde o cliente paga antecipadamente por uma duração fixa. A sessão termina automaticamente quando o tempo comprado expira, a menos que seja estendido.

Segmento de Preço Uma porção de uma sessão durante a qual um único multiplicador de preço se aplica. Os limites do segmento são criados por eventos como início de sessão, pausa, retomada ou transição de faixa de preço na agenda.

Faixa de Preço Uma zona codificada por cor na grade semanal da agenda de preços. Cada faixa define um período e um multiplicador que modifica a tarifa horária base. As faixas podem cobrir horários específicos em dias específicos, permitindo preços diferentes para períodos de pico versus fora do pico.

Função Um conjunto nomeado de permissões atribuído a uma conta de operador. As funções definem quais ações um operador pode executar (por exemplo, iniciar sessões, gerenciar membros, visualizar relatórios). Vários operadores podem compartilhar a mesma função e as permissões são aplicadas em toda a interface.

Limite de Segmento Um evento que aciona a criação de um novo segmento de preço dentro de uma sessão. Os limites incluem: início de sessão, encerramento, pausa, retomada e mudança de faixa de preço (quando o relógio cruza de uma faixa para outra).

Sessão Um período temporizado de uso de PC ou console por um cliente. Sessões rastreiam horário de início, horário de término, pausas, segmentos de preço e o valor total cobrado. Podem ser pré-pagas ou pós-pagas.

Liquidação O cálculo realizado quando uma sessão termina para determinar o custo final. A liquidação processa todos os segmentos de preço, aplica os multiplicadores relevantes, adiciona taxas de início e impostos, deduz quaisquer descontos de membro e produz o valor total devido. Na Cafeteria, a liquidação também é uma ação de um clique que encerra todos os pedidos abertos de uma mesa com o método de pagamento escolhido e devolve a mesa para ocioso.

Turno O período de trabalho de um operador do login ao logout. Todas as transações, operações de sessão e ações administrativas realizadas durante um turno são atribuídas ao operador logado. Os dados do turno são usados para responsabilidade e análise de desempenho.

Taxa de Início Uma cobrança mínima aplicada por sessão independente da duração. Se o custo calculado de uma sessão (baseado em tempo e preços) for menor que a taxa de início, a taxa de início é cobrada no lugar. Isso garante uma receita mínima por sessão.

Sincronização O processo de sincronização de arquivos do HandyCafe Server para PCs clientes. Usa comparação baseada em manifesto e transferência baseada em blocos para distribuir arquivos eficientemente pela rede.

Nível Um nível de fidelidade no sistema de níveis de membro. Níveis são definidos por limites de pontos e fornecem taxas de desconto em sessões e pedidos. Conforme membros acumulam pontos por gastos, eles avançam para níveis mais altos com melhores benefícios.

Transação Um registro financeiro de um pagamento por sessão, pedido, recarga de carteira ou outro evento faturável. Transações registram o valor, método de pagamento, membro ou operador associado e data/hora.

Imposto (IVA) Uma porcentagem de imposto aplicada a cobranças de sessão e valores de pedidos. A taxa de imposto é configurada nas configurações de preços e é incluída no cálculo de liquidação. Os valores de imposto são rastreados separadamente para fins de declaração fiscal.

Carteira O saldo monetário pré-pago de um membro armazenado no sistema HandyCafe. A carteira é composta por uma ou mais entradas de crédito e pode ser usada para pagar sessões, pedidos e outros serviços. Recargas podem ser feitas via dinheiro, pacotes ou campanhas.