HandyCafe Docs
owner cashier

Gerenciamento de Consoles

O HandyCafe gerencia consoles de jogos junto com PCs, oferecendo ao seu centro de jogos ou arena de esports um sistema unificado para rastrear sessões, preços e receita em todos os dispositivos.


O Que São Consoles?

Consoles no HandyCafe representam estações de jogos como PlayStation, Xbox, Nintendo Switch e outros tipos de dispositivos personalizados. Eles são gerenciados separadamente dos PCs, mas seguem o mesmo ciclo de vida de sessão. Você pode iniciar, pausar, retomar e encerrar sessões com suporte completo a preços e cobrança.

A página de Consoles exibe todos os consoles registrados como cartões de status, oferecendo uma visão geral visual rápida de quais dispositivos estão em uso, disponíveis ou com pagamentos pendentes.


Status do Console

Cada console possui um dos três status:

Status Descrição
Online Uma sessão ativa está em execução neste console. Um cliente está usando no momento.
Ocioso O console está disponível e pronto para uma nova sessão. Ninguém está usando.
Não Pago Uma sessão terminou mas o pagamento ainda não foi cobrado. Requer atenção do operador.

Os cartões de status na página de Consoles usam codificação de cores para facilitar a identificação de cada estado.


Adicionando um Console

Para registrar um novo console no HandyCafe:

  1. Navegue até a página de Consoles.
  2. Clique no botão Adicionar Console.
  3. Preencha os detalhes do console:
    • Nome: Um nome descritivo para o console (por exemplo, "PS5 Estação 1", "Área Xbox - Esquerda", "Nintendo Dock 3").
    • Endereço MAC: O endereço MAC de rede do console. Deve estar em formato válido (por exemplo, AA:BB:CC:DD:EE:FF). O sistema valida o formato antes de salvar.
    • Tipo de Console: Selecione entre os tipos predefinidos (PlayStation, Xbox, Nintendo ou Personalizado). Isso determina o ícone e a categoria exibidos no cartão de status.
    • Tipo de Preço: Escolha como este console é tarifado:
      • Padrão: Usa a tarifa horária global definida nas suas configurações de preços. Se você alterar a tarifa global, a tarifa deste console muda automaticamente.
      • Personalizado: Defina uma tarifa horária específica apenas para este console. Útil quando consoles premium (por exemplo, PS5 com VR) devem custar mais que estações padrão.
    • Preço Horário Personalizado: Visível apenas quando o Tipo de Preço está definido como Personalizado. Insira a tarifa por hora para este console específico.
  4. Clique em Salvar para registrar o console.

O novo console aparece na página de Consoles como um cartão de status Ocioso, pronto para aceitar sessões.


Sessões de Console

Sessões de console seguem o mesmo ciclo de vida das sessões de PC:

Iniciando uma Sessão

Selecione um console Ocioso e inicie uma nova sessão. Você pode opcionalmente atribuir um membro à sessão para cobrança por carteira ou baseada em tempo.

Pausando uma Sessão

Se um cliente precisar de uma pausa, você pode pausar a sessão. O cronômetro para e nenhuma cobrança acumula durante a pausa.

Retomando uma Sessão

Retome uma sessão pausada para continuar o cronômetro e a cobrança de onde parou.

Encerrando uma Sessão

Encerre a sessão. O sistema calcula o valor total com base na duração e na tarifa horária aplicável. O console muda para o status Não Pago até o pagamento ser cobrado, ou diretamente para Ocioso se o pagamento for processado imediatamente.

Sessões de console são identificadas pelo nome do console e não por uma conexão de endereço MAC (como nos PCs). Isso significa que o operador inicia e encerra sessões nos consoles manualmente, em vez do sistema detectar conexões automaticamente.


Preços de Console

Cada console pode ser configurado com seus próprios preços ou usar o padrão global:

  • Preço Padrão: O console herda a tarifa horária global das suas configurações de preços (Configurações > Preços). Quaisquer alterações na tarifa global são refletidas automaticamente.
  • Preço Personalizado: Uma tarifa horária fixa específica para este console. Alterações na tarifa global não afetam consoles com preço personalizado.
  • Taxa de Início: Sessões de console também podem ter uma taxa de início configurável que é cobrada uma vez no início de cada sessão, separada da tarifa horária. Isso é configurado nas configurações de preços.

Exemplo de Preços

Se sua tarifa global é R$ 10,00/hora e você tem um PS5 premium com VR:

  • Consoles padrão (Preço Padrão): R$ 10,00/hora
  • Estação PS5 VR (Preço Personalizado): R$ 22,50/hora

Quando você aumenta a tarifa global para R$ 12,50/hora, os consoles padrão atualizam automaticamente, mas a estação PS5 VR permanece em R$ 22,50/hora até você alterá-la manualmente.


Filtragem e Ordenação

A página de Consoles oferece ferramentas para encontrar rapidamente o console desejado:

Filtrar por Tipo de Console

Restrinja a visualização para mostrar apenas tipos específicos de console (por exemplo, mostrar apenas consoles PlayStation ou apenas consoles Xbox). Útil em estabelecimentos com muitos tipos diferentes de consoles.

Filtrar por Status

Mostre apenas consoles com um status específico (Online, Ocioso ou Não Pago). Útil para encontrar rapidamente consoles disponíveis ou identificar sessões não pagas.

Ordenar por Nome

Ordene consoles alfabeticamente por nome para localizar rapidamente uma estação específica.


Atribuição de Membro

Membros podem ser atribuídos a sessões de console para habilitar cobrança por carteira ou baseada em tempo:

  • Ao iniciar uma sessão de console, selecione um membro da lista.
  • As cobracas da sessão são deduzidas do saldo da carteira do membro, assim como nas sessões de PC.
  • Se o membro possui uma associação baseada em tempo, o tempo restante é consumido durante a sessão de console.
  • O histórico de sessões do membro inclui tanto sessões de PC quanto de console.

Clientes não registrados (sem cadastro) também podem usar consoles sem atribuição de membro. Nesse caso, o pagamento é cobrado manualmente quando a sessão termina.


Limite de Licença

Consoles contam para o limite total de dispositivos na sua licença HandyCafe. Se sua licença beta permite 50 PCs, esse limite inclui tanto PCs quanto consoles combinados.

Por exemplo, se você tem 40 PCs e 10 consoles, você atingiu o limite de 50 dispositivos. Adicionar um 11o console exigiria atualizar sua licença.


Contagem e Estatísticas de Consoles

O cabeçalho da página de Consoles exibe estatísticas agregadas:

  • Total de Consoles: O número de consoles registrados no seu sistema.
  • Online: Quantos consoles atualmente possuem sessões ativas.
  • Ocioso: Quantos consoles estão disponíveis.
  • Não Pago: Quantos consoles possuem sessões aguardando pagamento.

Essas contagens atualizam em tempo real conforme sessões iniciam e encerram.


Permissões Necessárias

O acesso ao gerenciamento de consoles é controlado pela categoria de permissões de Consoles no sistema de funções de operador:

Permissão Necessária Para
CONSOLE_VIEW Visualizar a página de Consoles e ver os cartões de status
CONSOLE_ADD Registrar novos consoles no sistema
CONSOLE_DELETE Remover consoles do sistema
CONSOLE_UPDATE Editar detalhes de consoles (nome, endereço MAC, tipo de preço, tarifa personalizada)

Um operador sem CONSOLE_VIEW não pode acessar a página de Consoles. Um operador com apenas CONSOLE_VIEW pode ver o status dos consoles, mas não pode adicionar, editar ou remover consoles.

Consulte Funções e Permissões de Operadores para detalhes sobre a configuração de acesso baseado em funções.