HandyCafe Docs
owner cashier

Painel Administrativo

O Painel Administrativo (rotulado como "Computadores" na barra lateral) é o espaço principal para monitorar e gerenciar todos os PCs clientes da sua lan house ou centro de jogos. Ele oferece uma visão em tempo real de cada máquina conectada, com ferramentas para iniciar sessões, controlar energia e acessar recursos de gerenciamento remoto.

Cartões de resumo

No topo do Painel Administrativo, uma fileira de cartões de resumo mostra métricas importantes do turno atual:

Cartão Descrição
Uso Percentual de PCs atualmente em uso, exibido como um medidor. Calculado como (PCs online / total de PCs) x 100.
Rede Velocidade combinada de download e upload de todos os clientes conectados, em Mbps.
Tempo de uso Tempo total de sessões ativas em todos os clientes, exibido em minutos.
Recebido Receita já arrecadada de sessões concluídas.
Receita pendente Receita de sessões que estão ativas, mas ainda não foram pagas.
Receita total Soma da receita recebida e da receita pendente.

Todos os valores monetários usam o símbolo de moeda e as casas decimais configuradas em Configurações > Preços.

Modos de visualização

O Painel Administrativo suporta três modos de visualização, alternados pela barra de filtros:

Visualização por ícones (grade)

Exibe cada PC cliente como um cartão em uma grade. Cada cartão mostra o hostname, a cor de status, o cronômetro da sessão, o nome do membro e as velocidades de rede. É a visualização padrão e oferece a melhor visão geral.

Visualização detalhada (grade com cartões expandidos)

Semelhante à visualização por ícones, mas com cartões maiores que mostram detalhes adicionais, como a barra de progresso para sessões com tempo limitado e informações de tempo mais detalhadas.

Visualização em lista

Exibe todos os clientes em formato de tabela, com uma linha por cliente. Essa visualização é compacta e eficiente quando se gerencia um grande número de PCs.

Cartões de cliente

Cada cartão de cliente na visualização em grade exibe as seguintes informações:

Elemento Descrição
Hostname Nome de exibição do PC cliente
Cor de status Borda ou fundo colorido indicando o estado atual
Cronômetro da sessão Hora de início, hora de término (para pré-pago), tempo usado e tempo restante
Barra de progresso Para sessões com tempo limitado, uma barra visual que mostra quanto tempo já foi consumido
Nome do membro Nome do membro associado, se houver
Dados de rede Velocidades atuais de download e upload do cliente

Cores de status

Os cartões de cliente são codificados por cor de acordo com o status atual:

Status Cor Significado
Online Verde Uma sessão ativa está em andamento
Ocioso Ciano O cliente está conectado e pronto, mas nenhuma sessão está ativa
Pausado Laranja A sessão está pausada; a cobrança foi interrompida
Admin Roxo O cliente está em modo de administrador ou manutenção
Offline Vermelho O cliente não está conectado ao servidor
Ocupado Amarelo O cliente está processando uma solicitação

Barra de filtros

A barra de filtros fica entre os cartões de resumo e a grade de clientes. Ela oferece controles para refinar e organizar os clientes exibidos:

Filtro de status

Filtre clientes pelo estado de conexão e sessão:

Filtro Mostra
Todos Todos os clientes cadastrados
Conectados Todos os clientes atualmente conectados ao servidor (qualquer status exceto Offline)
Em uso Clientes com sessão ativa ou pausada
Prontos Clientes conectados no estado Ocioso, disponíveis para novas sessões
Offline Clientes que não estão conectados no momento

Cada botão de filtro exibe a quantidade de clientes correspondentes.

Busca

Um campo de busca por texto que filtra clientes pelo hostname. Digite qualquer parte do hostname para reduzir a lista.

Ordenação

Ordene a lista de clientes por:

  • Hostname (crescente ou decrescente)
  • Status
  • Tempo usado (crescente ou decrescente)

Agrupar por

Agrupe os clientes visualmente:

  • Nenhum. Todos os clientes exibidos juntos
  • Status. Clientes agrupados em seções pelo status atual

Espaçamento dos cartões

Um controle deslizante (0 a 50 px) que ajusta o espaço entre os cartões de cliente na visualização em grade. Útil para personalizar a densidade visual do painel.

Alternador de visualização

Alterna entre os modos de visualização por ícones, detalhada e em lista.

Botões de ação do cartão de cliente

Clicar ou passar o mouse sobre qualquer cartão de cliente revela botões de ação para todas as operações disponíveis. As ações são organizadas por categoria:

Ações de sessão

Ação Descrição
Iniciar sessão Inicia uma nova sessão pós-paga ou pré-paga neste PC
Encerrar sessão Finaliza a sessão atual e abre a janela de pagamento
Pausar Interrompe temporariamente a cobrança da sessão ativa
Retomar Continua uma sessão pausada
Adicionar tempo Adiciona ou subtrai minutos da sessão em andamento
Trocar Transfere a sessão para outro PC

Ferramentas remotas

Ação Descrição
Acesso Remoto Abre uma visualização remota ao vivo da tela do cliente
Captura de Tela Captura uma única imagem da tela atual do cliente
Captura de Janela Captura janelas específicas de aplicativos no cliente
Enviar mensagem Exibe uma mensagem pop-up na tela do cliente

Informações de aplicativos

Ação Descrição
Aplicativos em execução Visualiza a lista de aplicativos atualmente em execução no cliente
Aplicativos de inicialização Visualiza os aplicativos configurados para iniciar junto com o Windows
Aplicativos instalados Visualiza todos os softwares instalados no PC cliente
Aplicativos com janela Visualiza aplicativos com janelas visíveis

Gerenciamento de energia

Ação Descrição
Desligar Desliga o PC cliente remotamente
Reiniciar Reinicia o PC cliente remotamente
Wake on LAN Envia um pacote mágico Wake-on-LAN para ligar um PC offline
Fechar Cliente Encerra o software HandyCafe Client na máquina remota

As ações que não se aplicam ao estado atual do cliente aparecem desabilitadas. Por exemplo, não é possível pausar um cliente ocioso ou iniciar uma sessão em um PC que já possui uma sessão em andamento.

Painel de detalhes do cliente selecionado

Quando você clica em um cartão de cliente, o painel de Detalhes do cliente selecionado aparece no lado direito do Painel Administrativo. Esse painel mostra informações ampliadas sobre o PC escolhido:

Informações do sistema

  • Versão e build do sistema operacional
  • Uso e capacidade de RAM

Listas de aplicativos

Visualizações em abas mostrando:

  • Aplicativos em execução. Aplicativos em execução, com nomes de processo e uso de memória
  • Aplicativos de inicialização. Aplicativos que iniciam automaticamente quando o PC liga
  • Aplicativos instalados. Todos os softwares instalados no cliente
  • Aplicativos com janela. Aplicativos com janelas visíveis que podem ser alvo de captura de janela

Controles de energia

Botões dedicados para Desligar, Reiniciar e Wake on LAN, com estados de carregamento e de desabilitado com base no status atual do cliente:

  • Desligar e Reiniciar só ficam disponíveis quando o cliente está conectado.
  • Wake on LAN só fica disponível quando o cliente está offline.

Operações em lote

Você pode selecionar vários clientes para ações simultâneas:

  1. Segure Ctrl (ou Cmd no macOS) e clique em vários cartões de cliente para selecioná-los.
  2. Use os botões de ação em lote para executar operações em todos os clientes selecionados ao mesmo tempo.

Operações em lote disponíveis incluem:

  • Desligar. Desliga todos os PCs selecionados
  • Reiniciar. Reinicia todos os PCs selecionados
  • Enviar mensagem. Exibe a mesma mensagem em todos os PCs selecionados

Atualizações em tempo real

O Painel Administrativo se atualiza em tempo real pelo fluxo de eventos TCP entre o servidor e os clientes conectados. As mudanças acontecem instantaneamente:

  • Quando um cliente se conecta ou desconecta, o cartão aparece ou muda para o estado Offline.
  • Os cronômetros de sessão contam em tempo real sem recarregar a página.
  • Os indicadores de velocidade de rede atualizam continuamente.
  • As cores de status mudam imediatamente quando sessões começam, pausam, retomam ou encerram.

Verificações de permissão

Todas as ações no Painel Administrativo respeitam as permissões da função do operador de caixa:

  • Se a função do operador não concede permissão de gerenciamento de sessões, as ações relacionadas a sessões ficam desabilitadas.
  • Se a licença beta estiver em modo somente leitura, todas as ações de modificação ficam desabilitadas.
  • Ações de gerenciamento de energia exigem o nível de permissão apropriado.

As ações desabilitadas aparecem esmaecidas no cartão do cliente e no painel de detalhes. Ao passar o mouse sobre uma ação desabilitada, uma dica explica por que ela não está disponível.

Clientes legados

Clientes HandyCafe V3 e V4 aparecem no Painel Administrativo como um tipo próprio de cartão. A barra de ações é reduzida para corresponder ao que o protocolo legado suporta: Login, Logout, Adicionar Tempo, Captura de Tela, Logoff, Reiniciar e Desligar. Habilite o suporte em tempo de execução em Configurações > Clientes Legados antes de esperar que eles apareçam. Consulte Clientes Legados para ver todos os detalhes.


Próximos passos