HandyCafe Docs
owner operador it-admin

Solução de problemas

Esta página aborda soluções para problemas comuns organizadas por categoria.

Problemas de conexão

O cliente não consegue encontrar o servidor

Sintomas: O cliente mostra "Procurando servidor" ou "Nenhum servidor encontrado".

Soluções:

  1. Verifique se o HandyCafe Server está sendo executado no PC de gerenciamento.
  2. Confirme se ambos os PCs estão na mesma sub-rede (por exemplo, ambos em 192.168.1.x).
  3. Verifique se o mDNS não está bloqueado pelo switch ou roteador de rede.
  4. Experimente a conexão manual: insira o endereço IP do servidor diretamente nas configurações do cliente.
  5. Verifique se nenhum outro software está usando a porta TCP do servidor (padrão: 5001).

O cliente conecta e desconecta imediatamente

Sintomas: O cliente mostra brevemente "Conectado" e depois volta para "Pesquisando".

Soluções:

  1. Verifique se a chave de conexão corresponde no servidor e no cliente. A chave é definida em Configurações > Rede no servidor.
  2. Verifique a instabilidade da rede (perda de pacotes, problemas de cabo).
  3. Certifique-se de que o servidor não atingiu o limite de licença de PC.
  4. Revise os logs do servidor em busca de mensagens de falha de autenticação.

Cliente mostra "Offline" no servidor mas o PC está funcionando

Sintomas: O PC cliente está ligado e o aplicativo cliente está em execução, mas o servidor o mostra como offline.

Soluções:

  1. No PC cliente, verifique se o HandyCafe Client está realmente em execução (verifique a bandeja do sistema).
  2. Verifique a conexão de rede no PC cliente (ele consegue executar ping no servidor?).
  3. Verifique as regras de firewall: As portas TCP 5001-5003 devem estar abertas no servidor e no cliente.
  4. Reinicie o HandyCafe Client no PC afetado.
  5. Se estiver usando VLANs, certifique-se de que as VLANs do servidor e do cliente possam se comunicar.

Não é possível conectar após alterar as configurações de rede

Sintomas: Após alterar as portas ou a chave de conexão, os clientes não conseguem se conectar.

Soluções:

  1. Certifique-se de que os clientes estejam atualizados com os novos números de porta e chave de conexão.
  2. Reinicie o HandyCafe Server após alterar as configurações de rede.
  3. Atualize as regras de firewall para permitir as novas portas.
  4. Todos os clientes devem ser reconfigurados com os novos valores.

Problemas de sessão

Não é possível iniciar uma sessão em um cliente

Sintomas: O botão Iniciar está desativado ou a ação inicial falha com um erro.

Soluções:

  1. Verifique o status da licença. Se estiver no modo somente leitura, novas sessões não poderão ser iniciadas.
  2. Verifique se o status do cliente é "Inativo". As sessões só podem ser iniciadas em clientes inativos.
  3. Verifique as permissões do caixa. A função deve ter permissão AUTH_CLIENT_LOGIN.
  4. Certifique-se de que o preço esteja configurado (Configurações > Preço deve ter uma taxa horária válida).

O cronômetro da sessão mostra a hora incorreta

Sintomas: O tempo exibido não corresponde ao tempo real decorrido.

Soluções:

  1. Verifique os relógios do sistema nos PCs servidor e cliente. Eles devem estar sincronizados (use NTP).
  2. Se a sessão foi pausada, a duração da pausa não será contada.
  3. Para sessões pré-pagas, o cronômetro mostra o tempo restante, e não o tempo decorrido.

O custo da sessão parece errado

Sintomas: O valor cobrado não corresponde às expectativas.

Soluções:

  1. Verifique a tabela de preços. Se ativado, a sessão pode ter passado por vários slots de preços com multiplicadores diferentes.
  2. Revise as configurações de preços: taxa horária básica, IVA, taxa inicial, arredondamento.
  3. Verifique os segmentos de preços da sessão nos detalhes da transação para obter um detalhamento.
  4. Verifique as comissões e taxas fixas do meio de pagamento.
  5. Para sessões pré-pagas, verifique se o modo "Bloquear na compra" ou "Agenda ao vivo" está ativo.

A sessão pausada não pode ser retomada

Sintomas: A ação de retomada falha ou não está disponível.

Soluções:

  1. Verifique se o PC cliente ainda está conectado ao servidor.
  2. Verifique se o status do cliente mostra "Pausado" (laranja).
  3. Se o cliente se desconectou durante a pausa, talvez seja necessário reconectar-se primeiro.

Problemas de pagamento

A forma de pagamento está faltando no menu suspenso

Sintomas: A forma de pagamento esperada não aparece ao fechar uma sessão ou pedido.

Soluções:

  1. Verifique se a forma de pagamento existe em Gerenciamento > Formas de Pagamento.
  2. Verifique se a forma de pagamento está ativa (não excluída ou desativada).
  3. Verifique as permissões do caixa. PAYMENT_MANAGE deve ser concedido para ver todos os métodos.

O cálculo da comissão parece incorreto

Sintomas: A comissão deduzida não corresponde à taxa esperada.

Soluções:

  1. Verifique a taxa de comissão (em percentual) e taxa fixa do meio de pagamento.
  2. Fórmula de comissão: comissão = (valor cobrado * taxa de comissão / 100) + taxa fixa.
  3. Verifique se o caixa aplicou um cancelamento manual no valor cobrado.

Problemas de exibição do cliente

A tela inativa do cliente está em branco

Sintomas: A tela inativa não mostra nada em vez da apresentação de slides configurada.

Soluções:

  1. Verifique se a tela inativa está habilitada em Configurações > Clientes > Tela inativa.
  2. Verifique se pelo menos um item de mídia (imagem ou vídeo) foi adicionado.
  3. Verifique se os arquivos de mídia são válidos e não estão corrompidos.
  4. Acione uma sincronização para enviar as configurações mais recentes ao cliente.

O menu do cliente não mostra aplicativos

Sintomas: O inicializador de aplicativos está vazio ou com categorias ausentes.

Soluções:

  1. Verifique se os aplicativos e categorias estão configurados em Configurações > Clientes > Conteúdo.
  2. Verifique se as categorias e aplicativos estão com a visibilidade ativada.
  3. Verifique se o cliente recebeu os dados de menu mais recentes (alterações push automaticamente via TCP).
  4. Reinicie o cliente se a sincronização em tempo real não for aplicada.

O tema de aparência do cliente não é aplicado

Sintomas: O cliente mostra a aparência padrão em vez do tema configurado.

Soluções:

  1. Verifique se as configurações do tema estão salvas em Configurações > Clientes > Aparência.
  2. Acione um push de configurações para os clientes.
  3. Reinicie o aplicativo cliente.

Problemas de área de trabalho remota

A área de trabalho remota está lenta ou instável

Sintomas: O feed de vídeo está atrasado, com falhas ou com baixa taxa de quadros.

Soluções:

  1. Reduza a taxa de bits (tente 1000-2000 kbps para uso de LAN padrão).
  2. Reduza a configuração de FPS.
  3. Use Ethernet com fio em vez de WiFi.
  4. Verifique se há congestionamento de rede ou alto uso de largura de banda de outros aplicativos.
  5. Certifique-se de que a porta UDP 5004 não esteja bloqueada ou com taxa limitada.

Área de trabalho remota mostra tela preta

Sintomas: A janela da área de trabalho remota é aberta, mas mostra apenas preto.

Soluções:

  1. Verifique se o cliente está online e respondendo (tente fazer uma captura de tela primeiro).
  2. Verifique se a porta UDP 5004 está aberta bidirecionalmente.
  3. O driver gráfico do cliente pode precisar de atualização.
  4. Tente solicitar uma atualização de quadro-chave.

Não é possível controlar o mouse ou o teclado remotamente

Sintomas: Você pode ver a tela remota, mas cliques e pressionamentos de teclas não têm efeito.

Soluções:

  1. Verifique se a porta de gerenciamento remoto (TCP 5003) está aberta.
  2. Verifique se o aplicativo cliente possui permissões de sistema apropriadas.
  3. Alguns jogos em tela cheia podem bloquear a entrada remota.

Problemas de licenciamento

A licença mostra "offline_grace"

Sintomas: O status da licença mostra offline_grace com uma contagem regressiva.

Soluções:

  1. Restaure a conectividade com a Internet no PC servidor.
  2. Verifique a resolução DNS. O servidor deve alcançar o servidor de licenciamento.
  3. Verifique se há proxy ou firewall bloqueando conexões HTTPS de saída.
  4. Você tem 72 horas para restaurar a conectividade antes que o servidor seja bloqueado.

Licença mostra "over_limit"

Sintomas: Mais clientes estão conectados do que a licença permite.

Soluções:

  1. Desconecte clientes inativos que não estejam em uso.
  2. Verifique a contagem atual de clientes em relação ao seu limite de licença.
  3. Atualize sua licença para obter mais capacidade de PC.
  4. Observação: os consoles contam para o limite total de PCs.

A licença mostra "expirada" ou "revogada"

Sintomas: O servidor entra no modo restrito.

Soluções:

  1. Verifique a data de expiração da sua licença.
  2. Renove sua licença através do site HandyCafe.
  3. Para licenças revogadas, entre em contato com o suporte do HandyCafe.

Problemas Gerais

As alterações nas configurações não estão sendo salvas

Sintomas: As alterações são revertidas após sair das configurações.

Soluções:

  1. Certifique-se de clicar no botão Salvar após fazer as alterações.
  2. Verifique erros de validação (campos destacados com mensagens de erro).
  3. Verifique se você tem permissões de administrador.

Os registros de auditoria estão faltando entradas

Sintomas: As ações esperadas não aparecem na página Logs.

Soluções:

  1. Verifique os filtros de log. Certifique-se de que a categoria e o intervalo de datas corretos sejam selecionados.
  2. Verifique se a permissão LOG_DISPLAY_FULL foi concedida (caso contrário, apenas os logs de hoje serão mostrados).
  3. Pesquise usando o campo de pesquisa de texto para a ação específica.