Gestão de Sessões

Sessões são a unidade básica de cobrança do HandyCafe. Toda vez que um cliente da sua lan house ou centro de jogos utiliza um PC ou console de jogos, uma sessão registra o tempo de uso e calcula o custo. Esta página explica o ciclo de vida completo das sessões, desde o início até a cobrança do pagamento.

Tipos de Sessão

O HandyCafe suporta dois tipos de sessões:

• Sessões de PC. Sessões em PCs clientes gerenciadas pelo Painel Administrativo. O software cliente bloqueia o PC quando está ocioso e o desbloqueia quando uma sessão é iniciada.
• Sessões de console. Sessões em consoles de jogos (PlayStation, Xbox, etc.) gerenciadas pela página de Consoles. Estas são monitoradas apenas pelo servidor; não há software cliente no console.

Ambos os tipos de sessão seguem o mesmo motor de preços e ciclo de vida mas são gerenciados em páginas diferentes do painel de controle.

Ciclo de Vida da Sessão

Toda sessão segue um ciclo de vida definido com transições claras de estado:

Iniciar --> Em Execucao --> (Pausar <--> Retomar) --> Adicionar Tempo --> Encerrar

Os estados em detalhe:

1. Iniciar. Um operador de caixa inicia a sessão. O PC cliente é desbloqueado ou o cronômetro do console começa.
2. Em Execução. A sessão está ativa. O tempo está contando e a cobrança está acumulando.
3. Pausar. O operador interrompe temporariamente a sessão. A cobrança para. O cliente exibe um estado de pausa.
4. Retomar. O operador continua uma sessão pausada. A cobrança retoma a partir de um novo segmento de preços.
5. Adicionar Tempo. O operador adiciona (ou remove) minutos de uma sessão ativa.
6. Encerrar. A sessão termina. O sistema calcula o custo final e solicita o pagamento.

Iniciando uma Sessão

Para iniciar uma nova sessão em um PC cliente:

1. Selecione o cliente. No Painel Administrativo, clique em um PC que esteja no estado Disponível (ciano) para exibir os botões de ação.
2. Escolha o tipo de cobrança. Selecione Pós-pago (paga no final) ou Pré-pago (paga antecipadamente).
3. Atribua um membro (opcional). Se o cliente é um membro cadastrado, busque sua conta usando o campo de busca com autocompletar. Atribuir um membro habilita pagamentos por carteira e registra a sessão no histórico dele.
4. Defina a duração ou valor (somente pré-pago). Para sessões pré-pagas, informe o número de minutos que o cliente está comprando ou o valor monetário que está pagando. O sistema calcula o tempo correspondente com base na faixa de preços atual.
5. Selecione o método de pagamento. Escolha o método de pagamento (Dinheiro, Cartão de Crédito ou qualquer método personalizado que você tenha configurado).
6. Confirme. Revise os detalhes e confirme. O PC cliente é desbloqueado imediatamente e o cronômetro da sessão começa.

Para sessões de console, o processo é semelhante mas é iniciado pela página de Consoles.

Sessões Pós-pagas

Em uma sessão pós-paga, o cliente utiliza o PC primeiro e paga quando terminar. Este é o modo de cobrança mais comum em lan houses, cybercafés e centros de jogos.

Como funciona:

• A sessão começa sem pagamento antecipado.
• O cronômetro roda e o custo acumula em tempo real com base na faixa de preços ativa.
• Quando a sessão é encerrada, o sistema apresenta o custo final calculado.
• O operador de caixa recebe o pagamento e confirma a transação.

Sessões pós-pagas não têm limite de tempo. Elas continuam até o operador encerrá-las ou o cliente pedir para sair.

Sessões Pré-pagas

Em uma sessão pré-paga, o cliente paga antecipadamente por um período específico de tempo. A sessão encerra automaticamente quando o tempo comprado expira.

Existem dois modos de preços pré-pagos, configurados em Configurações > Preços:

Travar na Compra

O custo é congelado no momento em que a sessão começa. A faixa de preços e o multiplicador ativos no momento da compra são usados por toda a duração da sessão, independente de alterações na agenda que ocorram enquanto a sessão está em andamento.

Exemplo: Um cliente compra 60 minutos às 10:00 durante uma faixa de tarifa padrão. Mesmo que a agenda de preços mude para uma faixa de meia tarifa às 11:00, o tempo restante do cliente não é afetado. Ele recebeu exatamente o que pagou na tarifa original.

Agenda ao Vivo

O custo se ajusta em tempo real conforme a sessão passa por diferentes faixas de preços. Se a sessão do cliente cruzar uma mudança de faixa, o tempo restante é recalculado com base nos novos preços.

Exemplo: Um cliente compra 60 minutos às 10:00 durante uma faixa de tarifa padrão. Às 11:00, a agenda muda para uma faixa de meia tarifa. Como cada minuto agora custa metade, o tempo restante do cliente efetivamente se estende. Ele pode acabar com mais minutos totais do que os originalmente comprados.

Pausando uma Sessão

Pausar interrompe temporariamente a cobrança sem encerrar a sessão. Isso é útil quando um cliente precisa sair brevemente.

Para pausar uma sessão:

1. Selecione o PC ativo no Painel Administrativo e clique no botão Pausar no cartão.

O que acontece quando uma sessão é pausada:

• A cobrança para imediatamente. Nenhum custo acumula durante a pausa.
• O segmento de preços atual é fechado com um limite de "pausa".
• O PC cliente exibe um estado de pausa com um indicador de status laranja.
• O cronômetro da sessão congela.

Sessões pausadas permanecem pausadas indefinidamente até que um operador de caixa retome ou encerre.

Retomando uma Sessão

Retomar continua uma sessão pausada de onde parou.

Para retomar uma sessão:

1. Selecione o PC pausado no Painel Administrativo e clique no botão Retomar no cartão.

O que acontece quando uma sessão é retomada:

• Um novo segmento de preços começa no horário atual, usando a faixa de preços ativa.
• A cobrança retoma.
• O PC cliente retorna ao estado ativo (verde).

Note que a faixa de preços no momento da retomada pode diferir da faixa quando a sessão foi pausada. O novo segmento usa qualquer tarifa que esteja ativa na agenda de preços.

Adicionando Tempo

Você pode adicionar ou remover minutos de uma sessão ativa a qualquer momento.

Para adicionar tempo:

1. Selecione o PC ativo no Painel Administrativo e clique no botão Adicionar Tempo no cartão.
2. Informe o número de minutos a adicionar. Use um valor positivo para estender a sessão ou um valor negativo para reduzi-la.
3. Confirme.

O que acontece quando tempo é adicionado:

• Um registro de transação é criado no histórico da sessão.
• Para sessões pré-pagas, o horário de término é ajustado para frente (ou para trás) pelo número de minutos especificado.
• Para sessões pós-pagas, o evento de adição de tempo é registrado mas não define um horário de término fixo.

Encerrando uma Sessão

Encerrar uma sessão finaliza toda a cobrança, bloqueia o PC cliente e aciona o processo de pagamento.

Para encerrar uma sessão:

1. Selecione o PC ativo ou pausado no Painel Administrativo e clique no botão Parar no cartão.
2. A Caixa de Diálogo de Pagamento aparece mostrando um resumo da sessão.

Caixa de Diálogo de Pagamento

A caixa de diálogo de pagamento exibe as seguintes informações:

Ajuste do operador: O operador de caixa pode ajustar manualmente o valor cobrado. Por exemplo, pode arredondar para baixo como cortesia ou aplicar um desconto manual. O valor original calculado é sempre preservado nos registros para auditoria.

4. Selecione um método de pagamento e confirme. A sessão é registrada, o PC cliente é bloqueado e a transação é salva.

Processo de Liquidação

Quando uma sessão é encerrada, o motor de liquidação executa estas etapas:

1. Fecha o último segmento de preços aberto.
2. Soma todos os valores dos segmentos fechados.
3. Aplica regras de arredondamento (sempre arredonda para cima até o passo de arredondamento configurado).
4. Aplica o mínimo da taxa de início (o total nunca é menor que a taxa de início).
5. Calcula a comissão do método de pagamento (baseada em BPS) e a taxa fixa.
6. Apresenta os valores finais na caixa de diálogo de pagamento.

Para uma explicação detalhada de como os segmentos de preços e cálculos de liquidação funcionam, consulte Preços de Sessão.

Sessões de Membros

Quando um membro é atribuído a uma sessão, opções adicionais de cobrança ficam disponíveis:

• Pagamento por carteira. O custo da sessão pode ser descontado do saldo da carteira do membro.
• Dedução de pacote de tempo. Se o membro comprou um pacote de tempo, os minutos são descontados do saldo do pacote em vez de cobrar um valor monetário.
• Desconto de membro. Se o membro tem um desconto configurado (em pontos base), ele é aplicado ao custo da sessão.
• Histórico de sessões. A sessão é vinculada à conta do membro e aparece no histórico de sessões dele.

Membros também podem iniciar suas próprias sessões na tela de espera do cliente fazendo login com nome de usuário e senha ou por OAuth (se configurado).

Valores de Status de Sessão

Cada PC cliente exibe um indicador de status colorido:

Estas cores de status aparecem nos cartões de clientes no Painel Administrativo, facilitando a visualização do estado de cada PC.

Segmentos de Preços de Sessão

Cada sessão é dividida em um ou mais segmentos de preços. Um novo segmento é criado sempre que um evento relevante para a cobrança ocorre:

• Início de sessão
• Pausa
• Retomada
• Mudança de faixa de preços (quando o relógio cruza para uma faixa horária diferente na agenda)
• Alteração de preço base (se o administrador muda a tarifa por hora durante a sessão)
• Desconexão ou reconexão

Cada segmento registra a faixa de preços, multiplicador, preço base, horário de início, horário de término e valor calculado. O total da sessão é a soma de todos os segmentos, sujeito a regras de arredondamento e cobrança mínima.

Para detalhes completos sobre como os segmentos são calculados, consulte Preços de Sessão.

Cobrança Mínima e Taxa de Início

Mesmo sessões muito curtas são cobradas pelo menos no valor da taxa de início. Esta é configurada em Configurações > Preços e garante que toda sessão gere um nível mínimo de receita, independente de quão breve foi o uso.

Exemplo: Se sua taxa de início é R$ 1,00 e um cliente usa um PC por apenas 30 segundos, o valor cobrado é R$ 1,00 e não a fração de centavo que 30 segundos custaria na tarifa por hora.

Próximos Passos

• Preços de Sessão: Detalhes sobre o motor de preços, segmentos e cálculos de liquidação
• Painel Administrativo: Monitore e controle os PCs clientes
• Membros: Gerencie contas e carteiras de membros
• Relatório de Caixa: Revise a receita de sessões e resumos de turnos