HandyCafe Docs
owner

Como configurar seu café do zero

Este guia orienta você em cada etapa de uma nova instalação do HandyCafe para seu cibercafé, centro de jogos ou arena de esportes eletrônicos. No final, você terá um servidor funcionando, pelo menos um PC cliente conectado, preços configurados e uma sessão de teste concluída com o pagamento registrado em seu relatório de caixa.

O que você precisa

  • Um PC com Windows para atuar como seu servidor HandyCafe (Windows 10 ou posterior, mínimo de 4 GB de RAM).
  • Pelo menos um PC Windows adicional para atuar como estação cliente.
  • Uma rede local conectando todos os PCs (Ethernet com fio recomendada para maior confiabilidade).
  • Uma chave de licença válida do HandyCafe beta. Você inserirá isso durante a primeira configuração.
  • Sua taxa horária e moeda desejadas são decididas com antecedência.

Fase 1: Instalar e configurar o servidor

  1. Baixe o instalador mais recente do HandyCafe Server no painel do HandyCafe.
  2. Execute o instalador no PC que você designou como servidor. Siga as instruções na tela e aceite o diretório de instalação padrão.
  3. Inicie o servidor HandyCafe. O assistente de primeira configuração aparecerá automaticamente na primeira execução.
  4. Insira sua chave de licença beta quando solicitado. O servidor validará a chave online e exibirá o nome do seu café e o limite do PC.
  5. Crie sua conta de administrador. Digite um nome de usuário e uma senha forte. Esta conta tem acesso irrestrito a todos os recursos.
  6. Defina o nome do seu café. Este nome aparecerá nas telas inativas do cliente e nos relatórios.
  7. Clique em Concluir para concluir o assistente.

Resultado esperado: A janela principal do servidor é aberta mostrando o Painel de Administração sem nenhum cliente conectado. O nome do seu café aparece na barra de título.

Fase 2: Configurar preços

  1. Abra a página Configurações clicando no ícone de engrenagem na barra lateral esquerda.
  2. Navegue até a guia Preços.
  3. Defina sua moeda base. Selecione no menu suspenso de moeda. Todos os preços, transações e relatórios usarão esta moeda.
  4. Insira sua taxa horária. Este é o preço base por hora para sessões pós-pagas. Por exemplo, insira 10,00 para dez unidades da sua moeda por hora.
  5. Defina a taxa de IVA. Insira a porcentagem (0 a 100) que se aplica às cobranças da sessão. Insira 0 se o IVA não for aplicável.
  6. Defina a taxa inicial. Este é o custo mínimo por sessão, independentemente da duração. Digite 0 se não desejar uma cobrança mínima.
  7. Crie predefinições de preços para durações comuns. Role para baixo até a seção Predefinições. Clique em Adicionar predefinição. Crie predefinições como:
    • “30 Minutos” com duração de 30 minutos.
    • “1 Hora” com duração de 60 minutos.
    • “2 Horas” com duração de 120 minutos.
  8. Clique em Salvar para aplicar sua configuração de preços.

Resultado esperado: A guia Preços mostra sua taxa por hora, taxa de IVA, taxa inicial e todas as predefinições listadas abaixo. Essas predefinições aparecerão como botões de seleção rápida ao iniciar sessões pré-pagas.

Fase 3: Verifique as configurações de rede

  1. Ainda em Configurações, navegue até a guia Rede.
  2. Verifique a porta de escuta. O padrão é 7842. Altere-o somente se outro serviço na sua rede usar essa porta.
  3. Defina ou anote a chave de conexão. Esta chave autentica as conexões do cliente. Todos os PCs clientes devem usar a mesma chave para se conectar.
  4. Certifique-se de que o firewall do PC servidor permita conexões TCP de entrada na porta configurada. No Windows, o HandyCafe normalmente adiciona esta regra durante a instalação. Se você alterou a porta, adicione uma nova regra de firewall manualmente.
  5. Anote o endereço IP do PC servidor exibido na guia Rede. Você precisará dele se os clientes não conseguirem encontrar o servidor por meio da descoberta automática.

Resultado esperado: A guia Rede mostra a porta de escuta e a chave de conexão. O indicador de status do servidor mostra “Listening” em verde.

Fase 4: Implantar o primeiro cliente

  1. Baixe o instalador do HandyCafe Client em seu painel.
  2. Instale-o no seu primeiro PC cliente. Execute o instalador e siga as instruções.
  3. Inicie o cliente HandyCafe. O cliente tentará descobrir o servidor automaticamente via mDNS na rede local.
  4. Se a descoberta automática falhar, insira o endereço IP e a porta do servidor manualmente na caixa de diálogo de conexão do cliente.
  5. Insira a chave de conexão anotada na Fase 3.
  6. Aguarde o estabelecimento da conexão. A tela do cliente mudará para a página Inativa mostrando uma tela de bloqueio com um relógio.

Resultado esperado: No servidor, o Painel de Administração agora mostra um cliente conectado. O bloco do cliente exibe o nome do host e um status azul "Inativo". O PC cliente mostra a tela de bloqueio.

  1. O servidor atribuirá automaticamente um nome de exibição ao cliente com base em seu nome de host. Para renomeá-lo, selecione o bloco do cliente no servidor e clique em Renomear.

Fase 5: Execute sua primeira sessão de teste

  1. No painel de administração do servidor, clique em Iniciar no bloco do cliente inativo.
  2. Na caixa de diálogo da sessão, selecione Pós-pago. Deixe o campo de membro vazio para uma sessão de convidado.
  3. Clique em Confirmar para iniciar a sessão.

Resultado esperado: O bloco do cliente fica verde e mostra um cronômetro em contagem crescente. No PC cliente, a tela de bloqueio desaparece e a área de trabalho da Página Online aparece.

  1. Deixe a sessão durar pelo menos 5 minutos para que você possa verificar os cálculos de preços.
  2. Clique em Parar no bloco verde do cliente no servidor.
  3. Revise a caixa de diálogo detalhamento de custos. Ele mostrará:
    • Duração (por exemplo, 5 minutos).
    • Taxa horária aplicada.
    • Valor do IVA.
    • Carga total.
  4. Selecione uma forma de pagamento (dinheiro é o padrão).
  5. Clique em Confirmar para encerrar a sessão e registrar o pagamento.

Resultado esperado: O bloco do cliente retorna ao status azul "Inativo". O PC cliente mostra a tela de bloqueio novamente. Uma transação é registrada no sistema.

Fase 6: Relatório de verificação em dinheiro

  1. Navegue até a página Relatório de Caixa usando a barra lateral esquerda.
  2. Confirme se o relatório de hoje mostra uma transação de sessão.
  3. Verifique se o valor da transação corresponde ao detalhamento de custos que você viu ao interromper a sessão.
  4. Verifique se a coluna da forma de pagamento mostra "Dinheiro" (ou qualquer método que você selecionou).

Resultado esperado: O relatório de caixa lista uma sessão concluída com o valor, duração e forma de pagamento corretos. Seu café agora está operacional.

Fase 7: Próximas etapas opcionais

Assim que sua configuração básica estiver funcionando, considere configurar estes recursos:

  1. Adicione membros. Navegue até a página Membros. Clique em Adicionar para criar contas de membros com nomes de usuário e saldos de carteira opcionais. Os membros podem fazer login em PCs clientes.
  2. Configurar produtos. Navegue até a página Produtos. Adicione alimentos e bebidas aos preços para que os caixas possam criar pedidos.
  3. Configure o menu do cliente. Navegue até Configurações > Menu do cliente. Adicione categorias de aplicativos e aplicativos para que os clientes vejam uma grade de inicialização na página online.
  4. Implante clientes adicionais. Instale o HandyCafe Client em cada estação de PC do seu café. Cada um aparecerá automaticamente no servidor.
  5. Crie contas de caixa. Navegue até a página Gerenciamento. Adicione contas de caixa com funções apropriadas para que a equipe possa fazer login e gerenciar sessões.
  6. Configure preços de pico/fora de pico. Navegue até Configurações > Programação de preços. Crie multiplicadores baseados em tempo para cobrar mais durante horários de pico.
  7. Ative o login do OAuth. Navegue até Configurações > OAuth. Configure o Google ou outros provedores para que os clientes possam fazer login com suas contas sociais.

Erros comuns a evitar

  • Ignorando a regra do firewall. Se os clientes não conseguirem se conectar, a causa mais comum é uma regra do Firewall do Windows bloqueando a porta de escuta. Verifique se a regra existe antes de solucionar outros problemas.
  • Chaves de conexão incompatíveis. A chave em cada cliente deve corresponder exatamente à chave no servidor. Copie e cole para evitar erros de digitação.
  • Definindo a taxa horária como 0. Se você deixar a taxa horária em zero, todas as sessões pós-pagas serão gratuitas. Sempre verifique seus preços antes de ir ao ar.
  • Esquecer de salvar as configurações. As alterações na página Configurações não se aplicam até que você clique em Salvar. Se as configurações parecerem inalteradas após a reinicialização, provavelmente você se esqueceu de salvar.
  • Executar servidor e cliente no mesmo PC. Embora seja tecnicamente possível para testes, isso não é recomendado para produção. O PC servidor deve ser uma estação dedicada.