Perguntas Frequentes

Configuracao e Instalacao

Quais tipos de negocios o HandyCafe suporta?

O HandyCafe foi projetado para lan houses, centros de jogos, arenas de esports, cybercafes e PC bangs. Qualquer negocio que forneca acesso temporizado a PCs ou consoles de jogos pode usar o HandyCafe para gerenciar sessoes, cobranca e associacoes.

Quais sao os requisitos do sistema para o HandyCafe Server?

O servidor requer Windows 10 ou posterior (64 bits), pelo menos 4 GB de RAM, 500 MB de espaco em disco e uma conexao de rede local. Os PCs clientes precisam de Windows 10 ou posterior com 2 GB de RAM. Todos os PCs devem estar na mesma rede local. Consulte Requisitos do Sistema para detalhes completos.

Como instalar o HandyCafe Server?

Baixe o instalador do site oficial, execute-o e siga as instrucoes. Na primeira execucao, o Assistente de Configuracao Inicial cria sua conta de administrador. Consulte Instalacao do Servidor para instrucoes passo a passo.

Como conecto um PC cliente ao servidor?

Instale o HandyCafe Client no PC. Ele usa mDNS para descobrir o servidor automaticamente na rede local. Se a descoberta automatica falhar, insira o endereco IP do servidor manualmente nas configuracoes do cliente. Consulte Instalacao do Cliente.

Por que meu cliente nao esta conectando ao servidor?

Causas comuns: o servidor nao esta em execucao, os PCs estao em sub-redes diferentes, o firewall esta bloqueando portas (TCP 5001, 5002, 5003 e UDP 5004) ou a chave de conexao nao coincide. Consulte Solucao de Problemas para solucoes detalhadas.

Quais portas o HandyCafe utiliza?

TCP 5001 (comandos), TCP 5002 (transferencias de arquivo), TCP 5003 (gerenciamento remoto), UDP 5004 (streaming de tela). Essas sao configuraveis em Configuracoes de Rede.

Como ativo minha licenca?

Insira sua chave de licenca no painel de licencas. O servidor valida com o servidor de licenciamento. Uma conexao ativa com a internet e necessaria para a ativacao inicial. Consulte Licenciamento.

O que acontece quando meu servidor fica offline por mais de 72 horas?

O HandyCafe possui um periodo de graca offline de 72 horas. Durante esse tempo, todos os recursos funcionam normalmente. Apos 72 horas sem conectividade com o servidor de licenciamento, o servidor entra em estado bloqueado ate que o acesso a internet seja restaurado.

Sessoes e Precos

Como inicio uma sessao em um PC?

No Painel de Administracao, selecione um PC ocioso (ciano) e clique em Iniciar no cartao. Escolha modo pos-pago ou pre-pago, opcionalmente atribua um membro, defina duracao/valor se pre-pago, selecione um metodo de pagamento e confirme. Consulte Sessoes.

Qual a diferenca entre sessoes pre-pagas e pos-pagas?

No modo pos-pago, o cliente paga ao final com base no tempo real de uso. No modo pre-pago, o cliente paga antecipadamente por uma duracao ou valor fixo. O pre-pago suporta dois sub-modos: Travar na Compra (custo congelado no inicio) e Agenda ao Vivo (custo ajusta com mudancas de faixa horaria). Consulte Sessoes.

Como funciona a agenda de precos?

A agenda de precos e uma grade de 7 dias por 24 horas onde cada bloco de tempo e atribuido a uma faixa de preco codificada por cor. Cada faixa possui um multiplicador (por exemplo, 1,0x padrao, 1,5x pico, 0,5x fora do pico). O custo da sessao e calculado como: tarifa horaria base multiplicada pelo multiplicador da faixa multiplicado pela duracao. Consulte Precos de Sessao.

Como defino precos diferentes para fins de semana vs dias uteis?

Em Configuracoes > Agenda de Precos, crie faixas de preco com multiplicadores diferentes (por exemplo, "Dia Util" a 1,0x, "Fim de Semana" a 1,3x). Pinte as colunas de fim de semana com a cor da faixa Fim de Semana e as colunas de dias uteis com a cor da faixa Dia Util. Consulte Configuracoes de Agenda de Precos.

Como pauso e retomo uma sessao?

Clique em Pausar no cartao do PC online. A cobranca para enquanto pausado. Para retomar, clique em Retomar no cartao do PC pausado. Um novo segmento de preco comeca ao retomar. Consulte Sessoes.

Como adiciono tempo extra a uma sessao ativa?

Clique em Adicionar Tempo no cartao do PC online. Insira o numero de minutos a adicionar (positivo para estender, negativo para reduzir). Um registro de transacao e criado para o ajuste.

O que acontece quando uma sessao abrange varias faixas de preco?

A sessao e automaticamente dividida em segmentos nos limites das faixas. Cada segmento usa o multiplicador ativo durante aquele periodo. O custo total e a soma de todos os custos dos segmentos. Consulte Precos de Sessao.

O que e a taxa de inicio?

A taxa de inicio e uma cobranca minima aplicada a cada sessao. Mesmo que uma sessao seja muito curta, o cliente e cobrado pelo menos esse valor. Configure em Configuracoes de Precos.

Membros e Fidelidade

Como crio um novo membro?

Navegue ate a pagina de Membros e clique em Adicionar Membro. Insira o nome de usuario, nome de exibicao, email, telefone e outros detalhes opcionais. Atribua um nivel se aplicavel. Consulte Membros.

Como funciona o sistema de carteira?

Cada membro possui um saldo de carteira. Quando voce carrega a carteira, um credito de carteira e criado com um valor especifico e tipo de credito (pago, bonus, manual, etc.). Durante as sessoes, a carteira e consumida automaticamente. Os creditos podem ter datas de expiracao e restricoes de dispositivo. Consulte Carteira do Membro.

O que e um credito de carteira?

Um credito de carteira e uma entrada discreta de saldo criada por uma unica recarga. Cada credito rastreia seu proprio valor, tipo de credito (pago, bonus, manual), status (ativo, expirado, consumido) e restricao de dispositivo elegivel. Os creditos sao consumidos em ordem (mais antigo primeiro). Consulte Carteira do Membro.

Como funcionam os niveis de fidelidade e pontos?

Membros ganham pontos por atividades (gastos, visitas, recargas, pedidos). Cada nivel tem um limite de pontos. Quando um membro acumula pontos suficientes, ele avanca para o proximo nivel. Niveis mais altos podem ter melhores taxas de desconto. Consulte Niveis de Fidelidade.

Como recarrego a carteira de um membro?

Selecione o membro na pagina de Membros, clique na opcao de pagamento/recarga, insira o valor, selecione o tipo de credito e metodo de pagamento e confirme. Um novo credito de carteira e criado. Consulte Carteira do Membro.

Um membro pode usar o saldo da carteira tanto para PCs quanto para consoles?

Depende da restricao de dispositivo do credito. Os creditos podem ser restritos a "apenas PCs", "apenas consoles" ou "ambos". Ao comprar um pacote, a restricao de dispositivo e definida pela configuracao do pacote. Consulte Pacotes.

O que acontece quando um credito de carteira expira?

Quando um credito atinge sua data de expiracao, seu status muda para "expirado" e o saldo restante nao fica mais disponivel para uso. O valor expirado e registrado no historico de transacoes do membro.

Como visualizo o historico de transacoes de um membro?

Selecione o membro na pagina de Membros. O painel de detalhes do membro mostra o livro-razao de transacoes com todas as cargas de carteira, gastos, reembolsos e ajustes com datas e valores.

Produtos, Pedidos e Estoque

Como adiciono um produto ao catalogo?

Navegue ate Produtos e clique em Adicionar Produto. Insira nome, categoria, unidade, codigo de barras, preco de venda, preco de custo e taxa de imposto. Alterne ativo/inativo. Consulte Produtos.

Como crio um pedido para um cliente?

Navegue ate Pedidos, clique em Novo Pedido, opcionalmente atribua a um PC ou adicione uma nota, adicione itens do catalogo de produtos com quantidades e feche o pedido com um metodo de pagamento. Consulte Pedidos.

Como cancelo ou reembolso um pedido?

Abra o pedido na pagina de Pedidos e clique em Cancelar. O pedido e anulado e nenhum pagamento e registrado. Para reembolsos de pedidos fechados, use o fluxo de reembolso apropriado.

Como funciona o rastreamento de estoque?

Cada produto possui um nivel de estoque. O log de estoque rastreia alteracoes com motivos: venda (decrementado automaticamente no fechamento do pedido), compra (de entradas de estoque), ajuste, desperdicio e devolucao. Consulte Produtos e Estoque.

Campanhas e Pacotes

Como crio uma campanha?

Navegue ate Campanhas e clique em Adicionar Campanha. Insira nome, descricao, defina como ativa e configure uma data de expiracao se aplicavel. Em seguida, adicione pacotes a campanha. Consulte Campanhas.

Qual a diferenca entre pacotes baseados em minutos e baseados em dinheiro?

Pacotes baseados em minutos dao ao membro tempo (minutos) que pode ser usado para sessoes. Pacotes baseados em dinheiro adicionam fundos a carteira do membro. Ambos podem incluir valores bonus. Consulte Pacotes.

Como funciona o sistema de bonus nos pacotes?

Um pacote pode incluir um bonus alem do beneficio base. Por exemplo, um pacote pode oferecer "60 minutos + 15 minutos bonus" ou "R$ 50 + R$ 10 bonus". O bonus cria uma entrada de credito separada marcada com o tipo "Bonus".

Como funcionam as restricoes de dispositivo nos pacotes?

Cada pacote define uma restricao de dispositivo: cliente (PCs), console (consoles), ambos, apenas PCs ou apenas consoles. Quando o pacote e comprado, os creditos de carteira/tempo criados herdam essa restricao e so podem ser usados em tipos de dispositivos correspondentes.

Gerenciamento de Operadores

Como crio uma conta de operador?

Navegue ate Gerenciamento > Operadores. Clique em Adicionar Operador, insira usuario e senha e atribua uma funcao. O operador pode entao fazer login com essas credenciais. Consulte Funcoes de Operadores.

Como defino permissoes para uma funcao de operador?

Navegue ate Gerenciamento > Funcoes de Operadores. Crie uma nova funcao ou edite uma existente. Marque ou desmarque flags de permissao individuais em cada uma das 6 categorias (Autenticacao, Membros, Consoles, Logs, Relatorios, Metodos de Pagamento). Consulte Funcoes de Operadores.

Quais sao as 6 categorias de permissao?

Autenticacao (1 flag), Membros (6 flags: visualizar, adicionar, excluir, atualizar, exibir email, exibir telefone), Consoles (4 flags: visualizar, adicionar, excluir, atualizar), Logs (4 flags: visualizar, historico completo, apenas hoje, excluir), Relatorios (3 flags: visualizar, historico completo, apenas hoje), Metodos de Pagamento (4 flags: gerenciar, adicionar, excluir, atualizar). Total: 22 flags de permissao individuais.

Como funciona a protecao contra forca bruta no login?

Apos 5 tentativas de login falhas dentro de 10 minutos, a conta e bloqueada por 15 minutos. Todas as tentativas falhas sao registradas no rastro de auditoria com um alerta de seguranca.

Como visualizo relatorios de turno do operador?

Abra a pagina de Relatorio de Caixa. Filtre por nome do operador para ver transacoes processadas por um operador especifico durante seu turno. O resumo do turno mostra totais e detalhamento por metodo de pagamento.

Configuracoes

Como mudo o idioma?

Navegue ate Configuracoes > Geral e selecione seu idioma no menu suspenso. O HandyCafe suporta 24 idiomas. A interface atualiza imediatamente. Consulte Configuracoes Gerais.

Como configuro o login OAuth com Google?

Navegue ate Configuracoes > OAuth. Habilite OAuth globalmente e entao habilite Google. Insira seu Google Client ID e Client Secret (do Google Cloud Console). Opcionalmente importe o arquivo de credenciais JSON. Teste iniciando um login OAuth de um PC cliente. Consulte Configuracoes OAuth.

Como configuro a grade de agenda de precos?

Navegue ate Configuracoes > Agenda de Precos. Habilite a agenda, crie faixas codificadas por cor com multiplicadores e clique/arraste na grade de 7x24 horas para pintar blocos de tempo com a faixa desejada. Consulte Configuracoes de Agenda de Precos.

Como personalizo a tela de espera do cliente?

Navegue ate Configuracoes > Clientes > aba Tela de Espera. Habilite o slideshow, adicione imagens ou videos, defina duracoes e transicoes. Opcionalmente habilite sobreposicoes de relogio e nome do estabelecimento. Consulte Tela de Espera do Cliente.

Como altero o tema de aparencia do cliente?

Navegue ate Configuracoes > Clientes > aba Aparencia. Selecione um tema (Neon Arena, Crimson Pulse, Emerald Depth), escolha um preset de layout e configure fundo, densidade de cartoes e efeitos. Consulte Aparencia do Cliente.

Como configuro notificacoes sonoras?

Navegue ate Configuracoes > Sons. Habilite o botao mestre de sons e selecione um som para cada evento (Chamar Operador, Novo Pedido, Fim de Sessao, Solicitacao de Login) entre as 15 opcoes integradas. Consulte Configuracoes de Sons.

O que e a chave de conexao e por que e importante?

A chave de conexao e um segredo compartilhado usado para autenticacao criptografica entre servidor e clientes. Ela impede que dispositivos nao autorizados se conectem ao seu servidor. Todos os clientes devem usar a mesma chave do servidor. Configure em Configuracoes de Rede.

Gerenciamento Remoto

Como tiro uma captura de tela remota de um PC cliente?

Selecione o cliente no Painel de Administracao e clique em Captura de Tela no cartao. O visualizador exibe a imagem capturada. Voce pode atualizar para uma nova captura ou baixar a imagem. Consulte Capturas de Tela.

Como uso o acesso remoto para controlar um PC cliente?

Selecione o cartao do cliente e clique em Acesso Remoto. Uma janela abre com streaming de video H.264 ao vivo. Voce pode controlar mouse e teclado remotamente e a sincronizacao de area de transferencia funciona entre servidor e cliente. Consulte Acesso Remoto.

Como funciona o sistema de sincronizacao de arquivos?

Configure diretorios para sincronizar em Configuracoes > Sincronizacao de Arquivos. Quando acionado, o servidor cria um manifesto de arquivos. Os clientes comparam o manifesto com os arquivos locais e baixam apenas arquivos alterados ou novos usando transferencia baseada em blocos. Consulte Sincronizacao de Arquivos.

Como vejo quais aplicativos estao em execucao em um PC cliente?

Selecione o cliente no Painel de Administracao e clique em Apps em Execucao no cartao. Um painel mostra todos os processos em execucao com nomes e detalhes. Voce tambem pode visualizar Apps de Inicializacao, Apps Instalados e Apps com Janela nos mesmos botoes de acao.

Como envio uma mensagem para um PC cliente?

Selecione o cartao do cliente e clique em Enviar Mensagem. Digite sua mensagem e confirme. A mensagem aparece na tela do cliente.

Como desligo ou reinicio um PC cliente remotamente?

Selecione o cartao do cliente e clique em Desligar ou Reiniciar. Voce tambem pode selecionar varios clientes para operacoes em lote. Wake on LAN esta disponivel para ligar PCs offline que suportam esse recurso.

Relatorios e Analises

Como visualizo o relatorio de caixa?

Navegue ate Relatorio de Caixa pela barra lateral. O relatorio mostra cartoes de resumo, historico de transacoes, ganhos por maquina e graficos. Use filtros de data para restringir o periodo. Consulte Relatorio de Caixa.

Como exporto dados de relatorio?

No Relatorio de Caixa, use a funcao de exportar/copiar para copiar dados de transacao para a area de transferencia em formato CSV. Voce pode entao colar no Excel ou qualquer aplicativo de planilha.

Quais analises estao disponiveis na pagina de Estatisticas?

Nove abas de analise: Tendencias de receita, Analise de vendas, Rastreamento de despesas, Estatisticas de sessao, Utilizacao de consoles, Uso de aplicativos, Taxas de uso de computadores, Atividade de membros e Desempenho de operadores. Consulte Estatisticas.

Como verifico as taxas de utilizacao de computadores?

Navegue ate Estatisticas > aba Uso de Computadores. Mostra porcentagens de utilizacao por PC, tempo de atividade e receita por maquina. Tambem identifica seus PCs mais movimentados. Consulte Estatisticas de Sessoes e Computadores.

Solucao de Problemas

O cliente aparece "offline" mas o PC esta ligado. O que fazer?

Verifique se: 1) O HandyCafe Client esta em execucao no PC, 2) Ambos os PCs estao na mesma rede/sub-rede, 3) O firewall permite as portas TCP 5001-5003, 4) A chave de conexao coincide entre servidor e cliente. Consulte Solucao de Problemas.

Os precos da sessao parecem incorretos. Como verifico?

Verifique as configuracoes de precos (Configuracoes > Precos) para a tarifa horaria base e impostos. Verifique a agenda de precos (Configuracoes > Agenda de Precos) para multiplicadores ativos no horario da sessao. Revise os segmentos de preco da sessao nos detalhes da transacao para ver como cada segmento foi calculado.

O login OAuth esta travado em "pendente". Como resolvo?

Verifique se o administrador aprovou a solicitacao na pagina de Solicitacoes. Se a solicitacao esta travada, verifique: 1) As credenciais do provedor OAuth estao corretas em Configuracoes > OAuth, 2) O servidor tem acesso a internet para alcancar a API do provedor, 3) O codigo do dispositivo nao expirou (eles normalmente expiram em 15-30 minutos).

O acesso remoto esta com atraso. Como melhoro o desempenho?

Reduza a taxa de bits nas configuracoes de streaming (tente 1000-2000 kbps para rede local). Verifique a largura de banda da rede entre servidor e cliente. Certifique-se de que a porta UDP 5004 nao esta bloqueada. Use Ethernet cabeada em vez de Wi-Fi para melhores resultados.

Minha licenca mostra "over_limit". O que significa?

Mais PCs clientes estao conectados do que sua licenca permite. Desconecte clientes nao utilizados ou atualize sua licenca. O servidor nao iniciara novas sessoes ate que o numero de clientes conectados esteja igual ou abaixo do limite.

Um operador foi bloqueado apos muitas tentativas de login falhas. Como desbloqueio?

Aguarde 15 minutos para o bloqueio automatico expirar. Se for urgente, um administrador pode gerenciar a conta do operador pela interface de gerenciamento.