HandyCafe Docs
owner cashier it-admin

Painel de Controle

O painel de controle do HandyCafe Server e o hub central para gerenciar sua lan house ou centro de jogos. Apos fazer login, voce chega na MainPage, que atua como um roteador carregando todas as outras paginas do sistema. Toda navegacao, monitoramento e tarefas de gerenciamento comecam aqui.

Visao Geral do Layout

O painel e dividido em quatro areas:

  1. Painel Superior. Uma barra de cabecalho horizontal no topo da janela. Exibe o nome HandyCafe e o titulo da pagina atualmente ativa.
  2. Barra Lateral. Uma barra de navegacao vertical no lado esquerdo. Cada item e um botao com icone que alterna para uma pagina diferente. A pagina ativa e destacada visualmente.
  3. Area de Conteudo. O espaco de trabalho principal a direita da barra lateral. Esta area renderiza a pagina selecionada (Painel de Administracao, Membros, Relatorios e assim por diante).
  4. Barra de Status. Uma barra de rodape opcional na parte inferior da janela. Voce pode mostra-la ou oculta-la nas configuracoes de Visualizacao.

Navegacao pela Barra Lateral

A barra lateral oferece acesso rapido a todas as paginas do sistema. Cada entrada mostra um icone e, ao passar o mouse, o nome da pagina. As seguintes paginas estao disponiveis:

Pagina Icone Descricao
Computadores (Painel de Admin) Monitor Monitorar e gerenciar todos os PCs clientes
Consoles Gamepad Gerenciar sessoes de consoles de jogos
Licencas Certificado Visualizar e gerenciar licencas de software
Membros Contas Criar e gerenciar contas de membros
Solicitacoes Pergunta de Conta Revisar solicitacoes pendentes de login e OAuth
Pedidos Carrinho Gerenciar pedidos de alimentos, bebidas e produtos
Despesas Dinheiro Menos Registrar e rastrear despesas do negocio
Logs Documento Navegar nos logs do sistema e de auditoria
Relatorios Grafico de Linha Visualizar relatorios de caixa e turnos
Estatisticas Grafico de Caixa Analisar estatisticas de receita, sessao e membros
Configuracoes Engrenagem Configurar todas as opcoes do sistema

A pagina de Configuracoes e acessada por um icone de engrenagem separado na parte inferior da barra lateral, distinto dos itens de navegacao principais.

Badge de Pedidos em Aberto

O item de navegacao Pedidos exibe um badge mostrando a contagem de pedidos atualmente em aberto (nao atendidos). Essa contagem atualiza em tempo real sempre que pedidos sao criados ou fechados para que os operadores possam ver imediatamente se ha trabalho pendente.

Acesso a Paginas Baseado em Funcao

Nem todo usuario ve a mesma barra lateral. A visibilidade das paginas depende da funcao e permissoes do operador logado:

  • Contas admin (criadas durante o Assistente de Configuracao Inicial) tem acesso irrestrito a todas as paginas.
  • Contas de operador recebem uma funcao com flags de permissao especificas. Se a funcao de um operador nao concede acesso a uma pagina especifica, essa pagina fica oculta na barra lateral.
  • Quando um operador faz login, o sistema verifica suas permissoes de funcao e redireciona automaticamente para a primeira pagina acessivel se ele estiver em uma pagina restrita.

Para mais informacoes sobre funcoes e permissoes, consulte Funcoes e Permissoes de Operadores.

Verificacao de Atualizacao Automatica

Ao iniciar, o painel verifica atualizacoes de software disponiveis. Se uma versao mais nova do HandyCafe Server estiver disponivel, uma notificacao persistente aparece no canto superior direito da tela. A notificacao exibe o numero da nova versao e oferece a opcao de baixar e instalar a atualizacao.

Essa verificacao executa silenciosamente. Se nenhuma atualizacao estiver disponivel ou o endpoint de atualizacao estiver inacessivel, nenhuma notificacao e exibida.

Heartbeat de Licenca

Apos o carregamento do painel, um processo de heartbeat de licenca inicia em segundo plano. Esse processo valida periodicamente sua licenca HandyCafe com o servidor de licenciamento. Se a licenca expirar ou encontrar um problema, uma Sobreposicao de Licenca Beta pode aparecer sobre o painel, restringindo o aplicativo ao modo somente leitura ate que a licenca seja resolvida.

Consulte Licenciamento para detalhes sobre gerenciamento de licencas.

Barra de Status

A barra de status e uma barra horizontal fina na parte inferior do painel. Ela exibe informacoes contextuais sobre o estado atual do aplicativo. Sua visibilidade e controlada por uma configuracao:

  • Para mostrar ou ocultar a barra de status: Va a Configuracoes e alterne a opcao Barra de Status na secao Visualizacao.

Quando oculta, a area de conteudo se expande para preencher a altura total da janela.

Sequencia de Inicializacao

Quando o painel carrega apos um login bem-sucedido, varias etapas de inicializacao acontecem automaticamente:

  1. As configuracoes do sistema sao carregadas do banco de dados.
  2. Sessoes salvas sao restauradas (se alguma estava em execucao antes de um reinicio).
  3. O socket do servidor comeca a escutar conexoes de clientes.
  4. Uma solicitacao de ping de rede e enviada para descobrir clientes conectados.
  5. As permissoes da funcao do operador sao carregadas e paginas restritas ficam ocultas.
  6. O status da licenca beta e verificado.
  7. O temporizador de heartbeat de licenca comeca.
  8. A contagem de pedidos em aberto e inicializada para o badge da barra lateral.
  9. Uma verificacao de atualizacao automatica executa em segundo plano.

Todas essas etapas sao nao bloqueantes. Se alguma etapa individual falhar, o painel continua funcionando. A falha e registrada no console mas nao impede o uso do sistema.

Fonte do Sistema

O painel respeita a configuracao de fonte do sistema definida em Configuracoes > Geral. Todo o texto na interface utiliza a familia de fontes selecionada.

Proximos Passos