HandyCafe Docs
owner cashier it-admin

Painel de Controle

O painel de controle do HandyCafe Server é o hub central para gerenciar sua lan house ou centro de jogos. Após fazer login, você chega na MainPage, que atua como um roteador carregando todas as outras páginas do sistema. Toda navegação, monitoramento e tarefas de gerenciamento começam aqui.

Visão Geral do Layout

O painel é dividido em quatro áreas:

  1. Painel Superior. Uma barra de cabeçalho horizontal no topo da janela. Exibe o nome HandyCafe e o título da página atualmente ativa.
  2. Barra Lateral. Uma barra de navegação vertical no lado esquerdo. Cada item é um botão com ícone que alterna para uma página diferente. A página ativa é destacada visualmente.
  3. Área de Conteúdo. O espaço de trabalho principal à direita da barra lateral. Esta área renderiza a página selecionada (Painel de Administração, Membros, Relatórios e assim por diante).
  4. Barra de Status. Uma barra de rodapé opcional na parte inferior da janela. Você pode mostrá-la ou ocultá-la nas configurações de Visualização.

Navegação pela Barra Lateral

A barra lateral oferece acesso rápido a todas as páginas do sistema. Cada entrada mostra um ícone e, ao passar o mouse, o nome da página. As seguintes páginas estão disponíveis:

Página Ícone Descrição
Computadores (Painel de Admin) Monitor Monitorar e gerenciar todos os PCs clientes
Consoles Gamepad Gerenciar sessões de consoles de jogos
Licenças Certificado Visualizar e gerenciar licenças de software
Membros Contas Criar e gerenciar contas de membros
Solicitações Pergunta de Conta Revisar solicitações pendentes de login e OAuth
Pedidos Carrinho Gerenciar pedidos de alimentos, bebidas e produtos
Despesas Dinheiro Menos Registrar e rastrear despesas do negócio
Logs Documento Navegar nos logs do sistema e de auditoria
Relatórios Gráfico de Linha Visualizar relatórios de caixa e turnos
Estatísticas Gráfico de Caixa Analisar estatísticas de receita, sessão e membros
Configurações Engrenagem Configurar todas as opções do sistema

A página de Configurações é acessada por um ícone de engrenagem separado na parte inferior da barra lateral, distinto dos itens de navegação principais.

Badge de Pedidos em Aberto

O item de navegação Pedidos exibe um badge mostrando a contagem de pedidos atualmente em aberto (não atendidos). Essa contagem atualiza em tempo real sempre que pedidos são criados ou fechados para que os operadores possam ver imediatamente se há trabalho pendente.

Acesso a Páginas Baseado em Função

Nem todo usuário vê a mesma barra lateral. A visibilidade das páginas depende da função e permissões do operador logado:

  • Contas admin (criadas durante o Assistente de Configuração Inicial) têm acesso irrestrito a todas as páginas.
  • Contas de operador recebem uma função com flags de permissão específicas. Se a função de um operador não concede acesso a uma página específica, essa página fica oculta na barra lateral.
  • Quando um operador faz login, o sistema verifica suas permissões de função e redireciona automaticamente para a primeira página acessível se ele estiver em uma página restrita.

Para mais informações sobre funções e permissões, consulte Funções e Permissões de Operadores.

Verificação de Atualização Automática

Ao iniciar, o painel verifica atualizações de software disponíveis. Se uma versão mais nova do HandyCafe Server estiver disponível, uma notificação persistente aparece no canto superior direito da tela. A notificação exibe o número da nova versão e oferece a opção de baixar e instalar a atualização.

Essa verificação executa silenciosamente. Se nenhuma atualização estiver disponível ou o endpoint de atualização estiver inacessível, nenhuma notificação é exibida.

Heartbeat de Licença

Após o carregamento do painel, um processo de heartbeat de licença inicia em segundo plano. Esse processo valida periodicamente sua licença HandyCafe com o servidor de licenciamento. Se a licença expirar ou encontrar um problema, uma Sobreposição de Licença Beta pode aparecer sobre o painel, restringindo o aplicativo ao modo somente leitura até que a licença seja resolvida.

Consulte Licenciamento para detalhes sobre gerenciamento de licenças.

Barra de Status

A barra de status é uma barra horizontal fina na parte inferior do painel. Ela exibe informações contextuais sobre o estado atual do aplicativo. Sua visibilidade é controlada por uma configuração:

  • Para mostrar ou ocultar a barra de status: Vá a Configurações e alterne a opção Barra de Status na seção Visualização.

Quando oculta, a área de conteúdo se expande para preencher a altura total da janela.

Sequência de Inicialização

Quando o painel carrega após um login bem-sucedido, várias etapas de inicialização acontecem automaticamente:

  1. As configurações do sistema são carregadas do banco de dados.
  2. Sessões salvas são restauradas (se alguma estava em execução antes de um reinício).
  3. O socket do servidor começa a escutar conexões de clientes.
  4. Uma solicitação de ping de rede é enviada para descobrir clientes conectados.
  5. As permissões da função do operador são carregadas e páginas restritas ficam ocultas.
  6. O status da licença beta é verificado.
  7. O temporizador de heartbeat de licença começa.
  8. A contagem de pedidos em aberto é inicializada para o badge da barra lateral.
  9. Uma verificação de atualização automática executa em segundo plano.

Todas essas etapas são não bloqueantes. Se alguma etapa individual falhar, o painel continua funcionando. A falha é registrada no console mas não impede o uso do sistema.

Fonte do Sistema

O painel respeita a configuração de fonte do sistema definida em Configurações > Geral. Todo o texto na interface utiliza a família de fontes selecionada.

Próximos Passos