Glossario
Uma referencia alfabetica dos termos de dominio usados na documentacao do HandyCafe.
Painel de Administracao O painel principal de monitoramento no HandyCafe Server. Exibe todos os clientes conectados, seus status e sessoes ativas. Tambem fornece botoes de acao em cada cartao de cliente para controle de sessao e operacoes de gerenciamento remoto.
Taxa de Comissao Uma porcentagem usada para expressar taxas de processamento de pagamento. Por exemplo, 1% ou 5%. Usada na configuracao de metodos de pagamento para definir o custo de aceitar um metodo de pagamento especifico.
Protocolo Binario Um formato de codificacao compacto usado para comunicacao 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 sessao e reportam status e dados de uso. Cada cliente e identificado por seu endereco MAC e nome do host.
Chave de Conexao Um segredo compartilhado configurado tanto no servidor quanto em cada cliente durante a configuracao. E usado para gerar tokens de autenticacao criptografica para comunicacao 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 sessoes, precos e uso por membros assim como PCs clientes, mas nao executam o software HandyCafe Client. Sao rastreados por endereco MAC.
Cybercafe / Lan House Um negocio que fornece acesso publico a computadores e conectividade com a internet, normalmente cobrando por hora. O HandyCafe gerencia todos os aspectos das operacoes de uma lan house incluindo sessoes, cobranca e associacoes.
Restricao de Dispositivo Uma configuracao que especifica a quais tipos de dispositivos um credito de carteira, credito de tempo ou regra de preco se aplica. Valores possiveis sao: 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, areas de torneio e assentos para espectadores. O HandyCafe suporta arenas de esports com gerenciamento de sessoes, rastreamento de membros e cobranca de consoles.
Beneficio O valor que um membro recebe ao comprar um pacote. Pode ser um credito de tempo (minutos pre-pagos de uso de sessao), um saldo monetario de carteira ou uma combinacao de ambos. Beneficios sao registrados como entradas de credito na carteira ou saldo de tempo do membro.
Taxa de Cambio Taxa de cambio usada para converter a moeda base para uma moeda de exibicao local. Isso permite que estabelecimentos em regioes com moedas diferentes precifiquem na moeda local mantendo uma base contabil 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 e feito para gerenciar operacoes de centros de jogos desde cobranca de sessoes ate programas de associacao.
Autenticacao Criptografica Um mecanismo de verificacao 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 Conexao para calcular e validar codigos de autenticacao.
Lan House / Internet Cafe Um negocio que fornece aos clientes acesso temporizado a computadores e servicos de internet. Lan houses sao o caso de uso principal do HandyCafe, que gerencia sessoes, precos, programas de associacao e operacoes de ponto de venda.
Ocioso O estado do cliente quando o PC esta conectado ao servidor mas nenhuma sessao esta ativa. No estado ocioso, o cliente exibe a tela de bloqueio (IdlePage) e aguarda inicio de sessao, login de membro ou acao administrativa.
Credito de Carteira / Credito de Tempo Uma entrada discreta de saldo de carteira ou minutos pre-pagos criada por uma recarga ou compra de pacote. Cada entrada de credito registra sua origem (recarga em dinheiro, beneficio de pacote, bonus de campanha), valor restante e restricao de dispositivo aplicavel. Os creditos sao consumidos em ordem durante a liquidacao da sessao.
Endereco MAC Um identificador de hardware atribuido a uma interface de rede. O HandyCafe usa enderecos MAC para identificar exclusivamente clientes e consoles, garantindo que os dispositivos sejam reconhecidos mesmo se seus enderecos IP mudarem.
mDNS (Multicast DNS) Um protocolo para descoberta automatica de servicos em redes locais. Os clientes HandyCafe anunciam sua presenca via mDNS, permitindo que o servidor os detecte sem configuracao manual de IP.
Membro Um cliente registrado com um perfil no sistema HandyCafe. Membros possuem uma carteira, nivel de fidelidade e historico de transacoes. Eles podem fazer login nos PCs clientes para sessoes personalizadas. Membros tambem podem ter contas vinculadas por OAuth.
Unidades Menores A menor denominacao de uma moeda, usada internamente para todos os calculos 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 horaria base dentro de uma faixa da agenda de precos. Um multiplicador de 1,0 significa que a tarifa padrao se aplica. Um multiplicador de 1,5 significa que a tarifa e 50% mais alta (por exemplo, horarios de pico), enquanto 0,5 significa metade do preco (por exemplo, descontos fora do pico).
PC Bang Uma lan house e centro de jogos em estilo coreano onde clientes pagam por acesso horario a PCs. PC bangs sao conhecidos por hardware de jogos de ponta e cultura de jogos competitivos. O HandyCafe suporta operacoes de PC bang com agendas de precos flexiveis e gerenciamento de sessoes.
Online O estado do cliente durante uma sessao ativa. Quando online, o cliente exibe a interface de area de trabalho (OnlinePage), permitindo que o cliente use aplicativos, navegue e interaja com o menu do cliente.
Pos-pago Um modo de cobranca de sessao onde o cliente usa o PC livremente e paga ao final com base na duracao real de uso. O custo final e calculado no encerramento da sessao usando os segmentos de agenda de precos aplicaveis.
Pre-pago Um modo de cobranca de sessao onde o cliente paga antecipadamente por uma duracao fixa. A sessao termina automaticamente quando o tempo comprado expira, a menos que seja estendido.
Segmento de Preco Uma porcao de uma sessao durante a qual um unico multiplicador de preco se aplica. Os limites do segmento sao criados por eventos como inicio de sessao, pausa, retomada ou transicao de faixa de preco na agenda.
Faixa de Preco Uma zona codificada por cor na grade semanal da agenda de precos. Cada faixa define um periodo e um multiplicador que modifica a tarifa horaria base. As faixas podem cobrir horarios especificos em dias especificos, permitindo precos diferentes para periodos de pico versus fora do pico.
Funcao Um conjunto nomeado de permissoes atribuido a uma conta de operador. As funcoes definem quais acoes um operador pode executar (por exemplo, iniciar sessoes, gerenciar membros, visualizar relatorios). Varios operadores podem compartilhar a mesma funcao e as permissoes sao aplicadas em toda a interface.
Limite de Segmento Um evento que aciona a criacao de um novo segmento de preco dentro de uma sessao. Os limites incluem: inicio de sessao, encerramento, pausa, retomada e mudanca de faixa de preco (quando o relogio cruza de uma faixa para outra).
Sessao Um periodo temporizado de uso de PC ou console por um cliente. Sessoes rastreiam horario de inicio, horario de termino, pausas, segmentos de preco e o valor total cobrado. Podem ser pre-pagas ou pos-pagas.
Liquidacao O calculo realizado quando uma sessao termina para determinar o custo final. A liquidacao processa todos os segmentos de preco, aplica os multiplicadores relevantes, adiciona taxas de inicio e impostos, deduz quaisquer descontos de membro e produz o valor total devido.
Turno O periodo de trabalho de um operador do login ao logout. Todas as transacoes, operacoes de sessao e acoes administrativas realizadas durante um turno sao atribuidas ao operador logado. Os dados do turno sao usados para responsabilidade e analise de desempenho.
Taxa de Inicio Uma cobranca minima aplicada por sessao independente da duracao. Se o custo calculado de uma sessao (baseado em tempo e precos) for menor que a taxa de inicio, a taxa de inicio e cobrada no lugar. Isso garante uma receita minima por sessao.
Sincronizacao O processo de sincronizacao de arquivos do HandyCafe Server para PCs clientes. Usa comparacao baseada em manifesto e transferencia baseada em blocos para distribuir arquivos eficientemente pela rede.
Nivel Um nivel de fidelidade no sistema de niveis de membro. Niveis sao definidos por limites de pontos e fornecem taxas de desconto em sessoes e pedidos. Conforme membros acumulam pontos por gastos, eles avancam para niveis mais altos com melhores beneficios.
Transacao Um registro financeiro de um pagamento por sessao, pedido, recarga de carteira ou outro evento faturavel. Transacoes registram o valor, metodo de pagamento, membro ou operador associado e data/hora.
Imposto (IVA) Uma porcentagem de imposto aplicada a cobranças de sessao e valores de pedidos. A taxa de imposto e configurada nas configuracoes de precos e e incluida no calculo de liquidacao. Os valores de imposto sao rastreados separadamente para fins de declaracao fiscal.
Carteira O saldo monetario pre-pago de um membro armazenado no sistema HandyCafe. A carteira e composta por uma ou mais entradas de credito e pode ser usada para pagar sessoes, pedidos e outros servicos. Recargas podem ser feitas via dinheiro, pacotes ou campanhas.