HandyCafe Docs
owner cashier

Painel Administrativo

O Painel Administrativo (identificado como "Computadores" na barra lateral) e o espaco de trabalho principal para monitorar e gerenciar todos os PCs clientes da sua lan house ou centro de jogos. Ele oferece uma visao em tempo real de cada maquina conectada, com ferramentas para iniciar sessoes, controlar energia e acessar recursos de gerenciamento remoto.

Cartoes de Resumo do Painel

No topo do Painel Administrativo, uma fileira de cartoes de resumo exibe as metricas principais do turno atual:

Cartao Descricao
Uso Percentual de PCs em uso, exibido como um medidor. Calculado como (PCs online / total de PCs) x 100.
Rede Velocidades combinadas de download e upload de todos os clientes conectados, em Mbps.
Tempo de Uso Tempo total de sessoes ativas em todos os clientes, exibido em minutos.
Recebido Receita ja arrecadada de sessoes concluidas.
Receita Pendente Receita de sessoes que estao ativas mas ainda nao foram pagas.
Receita Total Soma da receita recebida e pendente.

Todos os valores monetarios utilizam o simbolo de moeda e as casas decimais configurados em Configuracoes > Precos.

Modos de Visualizacao

O Painel Administrativo suporta tres modos de visualizacao, alternados pela barra de filtros:

Visualizacao em Icones (Grade)

Exibe cada PC cliente como um cartao em layout de grade. Cada cartao mostra o hostname, cor de status, cronometro de sessao, nome do membro e velocidades de rede. Este e o modo padrao e oferece a melhor visao geral.

Visualizacao Detalhada (Grade com Cartoes Expandidos)

Similar a visualizacao em icones mas com cartoes maiores mostrando detalhes adicionais como a barra de progresso para sessoes com tempo limitado e informacoes mais detalhadas de tempo.

Visualizacao em Lista

Exibe todos os clientes em formato de tabela com uma linha por cliente. Esta visualizacao e compacta e eficiente para gerenciar um grande numero de PCs.

Cartoes de Cliente

Cada cartao de cliente na visualizacao em grade exibe as seguintes informacoes:

Elemento Descricao
Hostname O nome de exibicao do PC cliente
Cor de status Uma borda ou fundo colorido indicando o estado atual
Cronometro de sessao Horario de inicio, horario de termino (para pre-pago), tempo utilizado e tempo restante
Barra de progresso Para sessoes com tempo limitado, uma barra visual mostrando quanto tempo foi consumido
Nome do membro O nome do membro atribuido, se houver
Dados de rede Velocidades atuais de download e upload do cliente

Cores de Status

Os cartoes de clientes sao codificados por cor de acordo com o status atual:

Status Cor Significado
Online Verde Uma sessao ativa esta em andamento
Disponivel Ciano O cliente esta conectado e pronto mas nenhuma sessao esta ativa
Pausado Laranja A sessao esta pausada; a cobranca foi interrompida
Admin Roxo O cliente esta em modo de administrador ou manutencao
Offline Vermelho O cliente nao esta conectado ao servidor
Ocupado Amarelo O cliente esta processando uma solicitacao

Barra de Filtros

A barra de filtros fica entre os cartoes de resumo e a grade de clientes. Ela oferece controles para filtrar e organizar os clientes exibidos:

Filtro de Status

Filtre clientes pelo estado de conexao e sessao:

Filtro Exibe
Todos Todos os clientes registrados
Conectados Todos os clientes conectados ao servidor (qualquer status exceto Offline)
Em Uso Clientes com sessao ativa ou pausada
Disponiveis Clientes conectados no estado Disponivel, prontos para novas sessoes
Offline Clientes que nao estao conectados no momento

Cada botao de filtro exibe a contagem de clientes correspondentes.

Busca

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

Ordenacao

Ordene a lista de clientes por:

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

Agrupar Por

Agrupe clientes visualmente:

  • Nenhum. Todos os clientes exibidos juntos
  • Status. Clientes agrupados em secoes pelo status atual

Espacamento dos Cartoes

Um controle deslizante (0-50px) que ajusta o espacamento entre os cartoes de clientes na visualizacao em grade. Util para personalizar a densidade visual do painel.

Alternador de Visualizacao

Alterna entre os modos de visualizacao Icones, Detalhada e Lista.

Botoes de Acao do Cartao de Cliente

Clicar ou passar o mouse sobre qualquer cartao de cliente revela botoes de acao para todas as operacoes disponiveis. As acoes sao organizadas por categoria:

Acoes de Sessao

Acao Descricao
Iniciar Sessao Inicia uma nova sessao pos-paga ou pre-paga neste PC
Encerrar Sessao Finaliza a sessao atual e abre a caixa de dialogo de pagamento
Pausar Interrompe temporariamente a cobranca da sessao ativa
Retomar Continua uma sessao pausada
Adicionar Tempo Adiciona ou subtrai minutos da sessao em andamento
Transferir Transfere a sessao para um PC diferente

Ferramentas Remotas

Acao Descricao
Area de Trabalho Remota Abre uma visualizacao remota ao vivo da tela do cliente
Capturar Tela Captura uma unica imagem da tela atual do cliente
Captura de Janela Captura janelas especificas de aplicativos no cliente
Enviar Mensagem Exibe uma mensagem pop-up na tela do cliente

Informacoes de Aplicativos

Acao Descricao
Apps em Execucao Visualiza a lista de aplicativos em execucao no cliente
Apps de Inicializacao Visualiza aplicativos configurados para iniciar junto com o Windows
Apps Instalados Visualiza todos os softwares instalados no PC cliente
Apps em Janela Visualiza aplicativos com janelas visiveis

Gerenciamento de Energia

Acao Descricao
Desligar Desliga o PC cliente remotamente
Reiniciar Reinicia o PC cliente remotamente
Acorde na LAN Envia um pacote mágico Wake-on-LAN para ligar um PC offline
Fechar Cliente Data do software HandyCafe Client no PC remoto

Acoes que nao se aplicam ao estado atual do cliente sao exibidas como desabilitadas. Por exemplo, nao e possivel pausar um cliente disponivel ou iniciar uma sessao em um PC que ja possui uma em andamento.

Painel de Detalhes do Cliente Selecionado

Ao clicar em um cartao de cliente, o painel de Detalhes do Cliente Selecionado aparece no lado direito do Painel Administrativo. Este painel exibe informacoes detalhadas sobre o PC selecionado:

Informacoes do Sistema

  • Versao e build do sistema operacional
  • Uso e capacidade de RAM

Listas de Aplicativos

Visualizacoes em abas mostrando:

  • Apps em Execucao. Aplicativos em execucao com nomes de processo e uso de memoria
  • Apps de Inicializacao. Aplicativos que iniciam automaticamente quando o PC e ligado
  • Apps Instalados. Todos os softwares instalados no cliente
  • Apps em Janela. Aplicativos com janelas visiveis que podem ser alvos de captura de janela

Controles de Energia

Botoes dedicados para Desligar, Reiniciar e Wake on LAN, com estados de carregamento e estados desabilitados baseados no status atual do cliente:

  • Desligar e Reiniciar so estao disponiveis quando o cliente esta conectado.
  • Wake on LAN so esta disponivel quando o cliente esta offline.

Operacoes em Lote

Voce pode selecionar multiplos clientes para acoes simultaneas:

  1. Segure Ctrl (ou Cmd no macOS) e clique em multiplos cartoes de clientes para seleciona-los.
  2. Use os botoes de acao em lote para executar operacoes em todos os clientes selecionados ao mesmo tempo.

Operacoes em lote disponiveis incluem:

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

Atualizacoes em Tempo Real

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

  • Quando um cliente se conecta ou desconecta, seu cartao aparece ou muda para o estado Offline.
  • Cronometros de sessao contam em tempo real sem recarregar a pagina.
  • Indicadores de velocidade de rede atualizam continuamente.
  • Cores de status mudam imediatamente quando sessoes sao iniciadas, pausadas, retomadas ou encerradas.

Verificacoes de Permissao

Todas as acoes no Painel Administrativo respeitam as permissoes da funcao do operador de caixa:

  • Se a funcao do operador nao concede permissao de gestao de sessoes, as acoes relacionadas a sessoes ficam desabilitadas.
  • Se a licenca beta esta em modo somente leitura, todas as acoes de modificacao ficam desabilitadas.
  • Acoes de gerenciamento de energia requerem o nivel de permissao apropriado.

Acoes desabilitadas aparecem esmaecidas no cartao do cliente e no painel de detalhes. Ao passar o mouse sobre uma acao desabilitada, uma dica explicativa indica o motivo da indisponibilidade.


Proximos Passos