Perguntas Frequentes

Configuração e Instalação

Quais tipos de negócios o HandyCafe suporta?

O HandyCafe foi projetado para lan houses, centros de jogos, arenas de esports, cybercafés e PC bangs. Qualquer negócio que forneça acesso temporizado a PCs ou consoles de jogos pode usar o HandyCafe para gerenciar sessões, cobrança e associações.

Quais são 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 espaço em disco e uma conexão 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 instruções. Na primeira execução, o Assistente de Configuração Inicial cria sua conta de administrador. Consulte Instalação do Servidor para instruções 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 automática falhar, insira o endereço IP do servidor manualmente nas configurações do cliente. Consulte Instalação do Cliente.

Por que meu cliente não está conectando ao servidor?

Causas comuns: o servidor não está em execução, os PCs estão em sub-redes diferentes, o firewall está bloqueando portas (TCP 5001, 5002, 5003 e UDP 5004) ou a chave de conexão não coincide. Consulte Solução de Problemas para soluções detalhadas.

Quais portas o HandyCafe utiliza?

TCP 5001 (comandos), TCP 5002 (transferências de arquivo), TCP 5003 (gerenciamento remoto), UDP 5004 (streaming de tela). Essas são configuráveis em Configurações de Rede.

Como ativo minha licença?

Insira sua chave de licença no painel de licenças. O servidor valida com o servidor de licenciamento. Uma conexão ativa com a internet é necessária para a ativação inicial. Consulte Licenciamento.

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

O HandyCafe possui um período de graça offline de 72 horas. Durante esse tempo, todos os recursos funcionam normalmente. Após 72 horas sem conectividade com o servidor de licenciamento, o servidor entra em estado bloqueado até que o acesso à internet seja restaurado.

Sessões e Preços

Como inicio uma sessão em um PC?

No Painel de Administração, selecione um PC ocioso (ciano) e clique em Iniciar no cartão. Escolha modo pós-pago ou pré-pago, opcionalmente atribua um membro, defina duração/valor se pré-pago, selecione um método de pagamento e confirme. Consulte Sessões.

Qual a diferença entre sessões pré-pagas e pós-pagas?

No modo pós-pago, o cliente paga ao final com base no tempo real de uso. No modo pré-pago, o cliente paga antecipadamente por uma duração ou valor fixo. O pré-pago suporta dois sub-modos: Travar na Compra (custo congelado no início) e Agenda ao Vivo (custo ajusta com mudanças de faixa horária). Consulte Sessões.

Como funciona a agenda de preços?

A agenda de preços é uma grade de 7 dias por 24 horas onde cada bloco de tempo é atribuído a uma faixa de preço codificada por cor. Cada faixa possui um multiplicador (por exemplo, 1,0x padrão, 1,5x pico, 0,5x fora do pico). O custo da sessão é calculado como: tarifa horária base multiplicada pelo multiplicador da faixa multiplicado pela duração. Consulte Preços de Sessão.

Como defino preços diferentes para fins de semana vs dias úteis?

Em Configurações > Agenda de Preços, crie faixas de preço com multiplicadores diferentes (por exemplo, "Dia Útil" 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 úteis com a cor da faixa Dia Útil. Consulte Configurações de Agenda de Preços.

Como pauso e retomo uma sessão?

Clique em Pausar no cartão do PC online. A cobrança para enquanto pausado. Para retomar, clique em Retomar no cartão do PC pausado. Um novo segmento de preço começa ao retomar. Consulte Sessões.

Como adiciono tempo extra a uma sessão ativa?

Clique em Adicionar Tempo no cartão do PC online. Insira o número de minutos a adicionar (positivo para estender, negativo para reduzir). Um registro de transação é criado para o ajuste.

O que acontece quando uma sessão abrange várias faixas de preço?

A sessão é automaticamente dividida em segmentos nos limites das faixas. Cada segmento usa o multiplicador ativo durante aquele período. O custo total é a soma de todos os custos dos segmentos. Consulte Preços de Sessão.

O que é a taxa de início?

A taxa de início é uma cobrança mínima aplicada a cada sessão. Mesmo que uma sessão seja muito curta, o cliente é cobrado pelo menos esse valor. Configure em Configurações de Preços.

Membros e Fidelidade

Como crio um novo membro?

Navegue até a página de Membros e clique em Adicionar Membro. Insira o nome de usuário, nome de exibição, email, telefone e outros detalhes opcionais. Atribua um nível se aplicável. Consulte Membros.

Como funciona o sistema de carteira?

Cada membro possui um saldo de carteira. Quando você carrega a carteira, um crédito de carteira é criado com um valor específico e tipo de crédito (pago, bônus, manual, etc.). Durante as sessões, a carteira é consumida automaticamente. Os créditos podem ter datas de expiração e restrições de dispositivo. Consulte Carteira do Membro.

O que é um crédito de carteira?

Um crédito de carteira é uma entrada discreta de saldo criada por uma única recarga. Cada crédito rastreia seu próprio valor, tipo de crédito (pago, bônus, manual), status (ativo, expirado, consumido) e restrição de dispositivo elegível. Os créditos são consumidos em ordem (mais antigo primeiro). Consulte Carteira do Membro.

Como funcionam os níveis de fidelidade e pontos?

Membros ganham pontos por atividades (gastos, visitas, recargas, pedidos). Cada nível tem um limite de pontos. Quando um membro acumula pontos suficientes, ele avança para o próximo nível. Níveis mais altos podem ter melhores taxas de desconto. Consulte Níveis de Fidelidade.

Como recarrego a carteira de um membro?

Selecione o membro na página de Membros, clique na opção de pagamento/recarga, insira o valor, selecione o tipo de crédito e método de pagamento e confirme. Um novo crédito de carteira é criado. Consulte Carteira do Membro.

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

Depende da restrição de dispositivo do crédito. Os créditos podem ser restritos a "apenas PCs", "apenas consoles" ou "ambos". Ao comprar um pacote, a restrição de dispositivo é definida pela configuração do pacote. Consulte Pacotes.

O que acontece quando um crédito de carteira expira?

Quando um crédito atinge sua data de expiração, seu status muda para "expirado" e o saldo restante não fica mais disponível para uso. O valor expirado é registrado no histórico de transações do membro.

Como visualizo o histórico de transações de um membro?

Selecione o membro na página de Membros. O painel de detalhes do membro mostra o livro-razão de transações com todas as cargas de carteira, gastos, reembolsos e ajustes com datas e valores.

Produtos, Pedidos e Estoque

Como adiciono um produto ao catálogo?

Navegue até Produtos e clique em Adicionar Produto. Insira nome, categoria, unidade, código de barras, preço de venda, preço de custo e taxa de imposto. Alterne ativo/inativo. Consulte Produtos.

Como crio um pedido para um cliente?

Navegue até Pedidos, clique em Novo Pedido, opcionalmente atribua a um PC ou adicione uma nota, adicione itens do catálogo de produtos com quantidades e feche o pedido com um método de pagamento. Consulte Pedidos.

Como cancelo ou reembolso um pedido?

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

Como funciona o rastreamento de estoque?

Cada produto possui um nível de estoque. O log de estoque rastreia alterações com motivos: venda (decrementado automaticamente no fechamento do pedido), compra (de entradas de estoque), ajuste, desperdício e devolução. Consulte Produtos e Estoque.

Campanhas e Pacotes

Como crio uma campanha?

Navegue até Campanhas e clique em Adicionar Campanha. Insira nome, descrição, defina como ativa e configure uma data de expiração se aplicável. Em seguida, adicione pacotes à campanha. Consulte Campanhas.

Qual a diferença entre pacotes baseados em minutos e baseados em dinheiro?

Pacotes baseados em minutos dão ao membro tempo (minutos) que pode ser usado para sessões. Pacotes baseados em dinheiro adicionam fundos à carteira do membro. Ambos podem incluir valores bônus. Consulte Pacotes.

Como funciona o sistema de bônus nos pacotes?

Um pacote pode incluir um bônus além do benefício base. Por exemplo, um pacote pode oferecer "60 minutos + 15 minutos bônus" ou "R$ 50 + R$ 10 bônus". O bônus cria uma entrada de crédito separada marcada com o tipo "Bônus".

Como funcionam as restrições de dispositivo nos pacotes?

Cada pacote define uma restrição de dispositivo: cliente (PCs), console (consoles), ambos, apenas PCs ou apenas consoles. Quando o pacote é comprado, os créditos de carteira/tempo criados herdam essa restrição e só podem ser usados em tipos de dispositivos correspondentes.

Gerenciamento de Operadores

Como crio uma conta de operador?

Navegue até Gerenciamento > Operadores. Clique em Adicionar Operador, insira usuário e senha e atribua uma função. O operador pode então fazer login com essas credenciais. Consulte Funções de Operadores.

Como defino permissões para uma função de operador?

Navegue até Gerenciamento > Funções de Operadores. Crie uma nova função ou edite uma existente. Marque ou desmarque flags de permissão individuais em cada uma das 6 categorias (Autenticação, Membros, Consoles, Logs, Relatórios, Métodos de Pagamento). Consulte Funções de Operadores.

Quais são as 6 categorias de permissão?

Autenticação (1 flag), Membros (6 flags: visualizar, adicionar, excluir, atualizar, exibir email, exibir telefone), Consoles (4 flags: visualizar, adicionar, excluir, atualizar), Logs (4 flags: visualizar, histórico completo, apenas hoje, excluir), Relatórios (3 flags: visualizar, histórico completo, apenas hoje), Métodos de Pagamento (4 flags: gerenciar, adicionar, excluir, atualizar). Total: 22 flags de permissão individuais.

Como funciona a proteção contra força bruta no login?

Após 5 tentativas de login falhas dentro de 10 minutos, a conta é bloqueada por 15 minutos. Todas as tentativas falhas são registradas no rastro de auditoria com um alerta de segurança.

Como visualizo relatórios de turno do operador?

Abra a página de Relatório de Caixa. Filtre por nome do operador para ver transações processadas por um operador específico durante seu turno. O resumo do turno mostra totais e detalhamento por método de pagamento.

Configurações

Como mudo o idioma?

Navegue até Configurações > Geral e selecione seu idioma no menu suspenso. O HandyCafe suporta 24 idiomas. A interface atualiza imediatamente. Consulte Configurações Gerais.

Como configuro o login OAuth com Google?

Navegue até Configurações > OAuth. Habilite OAuth globalmente e então 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 Configurações OAuth.

Como configuro a grade de agenda de preços?

Navegue até Configurações > Agenda de Preços. 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 Configurações de Agenda de Preços.

Como personalizo a tela de espera do cliente?

Navegue até Configurações > Clientes > aba Tela de Espera. Habilite o slideshow, adicione imagens ou vídeos, defina durações e transições. Opcionalmente habilite sobreposições de relógio e nome do estabelecimento. Consulte Tela de Espera do Cliente.

Como altero o tema de aparência do cliente?

Navegue até Configurações > Clientes > aba Aparência. Selecione um tema (Neon Arena, Crimson Pulse, Emerald Depth), escolha um preset de layout e configure fundo, densidade de cartões e efeitos. Consulte Aparência do Cliente.

Como configuro notificações sonoras?

Navegue até Configurações > Sons. Habilite o botão mestre de sons e selecione um som para cada evento (Chamar Operador, Novo Pedido, Fim de Sessão, Solicitação de Login) entre as 15 opções integradas. Consulte Configurações de Sons.

O que é a chave de conexão e por que é importante?

A chave de conexão é um segredo compartilhado usado para autenticação criptográfica entre servidor e clientes. Ela impede que dispositivos não autorizados se conectem ao seu servidor. Todos os clientes devem usar a mesma chave do servidor. Configure em Configurações de Rede.

Gerenciamento Remoto

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

Selecione o cliente no Painel de Administração e clique em Captura de Tela no cartão. O visualizador exibe a imagem capturada. Você 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 cartão do cliente e clique em Acesso Remoto. Uma janela abre com streaming de vídeo H.264 ao vivo. Você pode controlar mouse e teclado remotamente e a sincronização de área de transferência funciona entre servidor e cliente. Consulte Acesso Remoto.

Como funciona o sistema de sincronização de arquivos?

Configure diretórios para sincronizar em Configurações > Sincronização 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 transferência baseada em blocos. Consulte Sincronização de Arquivos.

Como vejo quais aplicativos estão em execução em um PC cliente?

Selecione o cliente no Painel de Administração e clique em Apps em Execução no cartão. Um painel mostra todos os processos em execução com nomes e detalhes. Você também pode visualizar Apps de Inicialização, Apps Instalados e Apps com Janela nos mesmos botões de ação.

Como envio uma mensagem para um PC cliente?

Selecione o cartão 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 cartão do cliente e clique em Desligar ou Reiniciar. Você também pode selecionar vários clientes para operações em lote. Wake on LAN está disponível para ligar PCs offline que suportam esse recurso.

Relatórios e Análises

Como visualizo o relatório de caixa?

Navegue até Relatório de Caixa pela barra lateral. O relatório mostra cartões de resumo, histórico de transações, ganhos por máquina e gráficos. Use filtros de data para restringir o período. Consulte Relatório de Caixa.

Como exporto dados de relatório?

No Relatório de Caixa, use a função de exportar/copiar para copiar dados de transação para a área de transferência em formato CSV. Você pode então colar no Excel ou qualquer aplicativo de planilha.

Quais análises estão disponíveis na página de Estatísticas?

Nove abas de análise: Tendências de receita, Análise de vendas, Rastreamento de despesas, Estatísticas de sessão, Utilização de consoles, Uso de aplicativos, Taxas de uso de computadores, Atividade de membros e Desempenho de operadores. Consulte Estatísticas.

Como verifico as taxas de utilização de computadores?

Navegue até Estatísticas > aba Uso de Computadores. Mostra porcentagens de utilização por PC, tempo de atividade e receita por máquina. Também identifica seus PCs mais movimentados. Consulte Estatísticas de Sessões e Computadores.

Solução de Problemas

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

Verifique se: 1) O HandyCafe Client está em execução no PC, 2) Ambos os PCs estão na mesma rede/sub-rede, 3) O firewall permite as portas TCP 5001-5003, 4) A chave de conexão coincide entre servidor e cliente. Consulte Solução de Problemas.

Os preços da sessão parecem incorretos. Como verifico?

Verifique as configurações de preços (Configurações > Preços) para a tarifa horária base e impostos. Verifique a agenda de preços (Configurações > Agenda de Preços) para multiplicadores ativos no horário da sessão. Revise os segmentos de preço da sessão nos detalhes da transação para ver como cada segmento foi calculado.

O login OAuth está travado em "pendente". Como resolvo?

Verifique se o administrador aprovou a solicitação na página de Solicitações. Se a solicitação está travada, verifique: 1) As credenciais do provedor OAuth estão corretas em Configurações > OAuth, 2) O servidor tem acesso à internet para alcançar a API do provedor, 3) O código do dispositivo não expirou (eles normalmente expiram em 15-30 minutos).

O acesso remoto está com atraso. Como melhoro o desempenho?

Reduza a taxa de bits nas configurações 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 não está bloqueada. Use Ethernet cabeada em vez de Wi-Fi para melhores resultados.

Minha licença mostra "over_limit". O que significa?

Mais PCs clientes estão conectados do que sua licença permite. Desconecte clientes não utilizados ou atualize sua licença. O servidor não iniciará novas sessões até que o número de clientes conectados esteja igual ou abaixo do limite.

Um operador foi bloqueado após muitas tentativas de login falhas. Como desbloqueio?

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

Cafeteria

Como os clientes fazem pedidos a partir da mesa?

Eles escaneiam o código QR da mesa com o celular, informam o código de segurança de 6 dígitos fornecido pela equipe, navegam pelo menu no próprio idioma, adicionam itens ao carrinho e enviam com pagamento em Dinheiro ou Online (Stripe). Os pedidos aparecem no painel de Pedidos da Cafeteria em até 3 segundos. Consulte Menu do Cliente.

Como ativo o módulo Cafeteria?

Abra Configurações > Cafeteria e ative Habilitar Cafeteria. O servidor usa automaticamente sua licença do HandyCafe como autorização. Um assistente de provisionamento pede slug, nome de exibição, país, moeda e fuso horário. Consulte Cafeteria e Como Configurar a Cafeteria.

Quais idiomas o menu do cliente suporta?

O menu do cliente em handy.cafe/{slug} suporta 24 idiomas. A primeira visita escolhe a melhor correspondência com base no cabeçalho Accept-Language do navegador. O cliente pode trocar de idioma a qualquer momento pelo seletor no topo.

A Cafeteria funciona sem internet?

Não. A Cafeteria é cloud-first. O provisionamento, a sincronização do menu e a consulta de pedidos dependem de acesso de saída à internet. As páginas visíveis ao cliente são servidas pela nuvem e não dependem de o servidor local ficar acessível pela internet.

Clientes Legados

O HandyCafe suporta meus clientes antigos V3 ou V4?

Sim. Ative o suporte em tempo de execução em Configurações > Clientes Legados e o servidor inicia listeners nas portas legadas originais (UDP 710/711, TCP 712, transferência de arquivos 717). Seus clientes existentes se conectam sem nenhuma alteração do lado deles. Eles aparecem no Painel Administrativo com um conjunto reduzido de ações (Login, Logout, Adicionar Tempo, Captura de Tela, Logoff, Reiniciar e Desligar). Consulte Clientes Legados.

Clientes legados e modernos podem rodar no mesmo servidor ao mesmo tempo?

Sim. As duas pilhas de protocolo usam portas diferentes e não entram em conflito. Você pode misturar clientes antigos e novos na mesma LAN e gerenciá-los pelo mesmo Painel Administrativo.

Posso trazer meus dados de uma instalação HandyCafe antiga?

Sim, no Windows. Abra Configurações > Clientes Legados, role até Migração de Banco de Dados e clique em Iniciar Migração. Membros, preços, produtos, pedidos, transações e logs são importados. Os arquivos originais não são modificados nem apagados. Se o resultado não for o esperado, clique em Desfazer Migração para reverter. Consulte Como Migrar de uma Instalação Legada.

Qual é a diferença entre as variantes de protocolo STE e Standard?

Os quadros STE (Smart/Turbo Edition) incluem um prefixo de informações de licença de 70 bytes; o tamanho do quadro é 1337 bytes. Os quadros Standard não incluem o prefixo; o tamanho do quadro é 1267 bytes. Escolha a variante que corresponde à forma como seu servidor legado foi construído. Escolher a variante errada faz com que quadros sejam descartados ou lidos incorretamente.