Gestao de Sessoes

Sessoes sao a unidade basica de cobranca do HandyCafe. Toda vez que um cliente da sua lan house ou centro de jogos utiliza um PC ou console de jogos, uma sessao registra o tempo de uso e calcula o custo. Esta pagina explica o ciclo de vida completo das sessoes, desde o inicio ate a cobranca do pagamento.

Tipos de Sessao

O HandyCafe suporta dois tipos de sessoes:

• Sessoes de PC. Sessoes em PCs clientes gerenciadas pelo Painel Administrativo. O software cliente bloqueia o PC quando esta ocioso e o desbloqueia quando uma sessao e iniciada.
• Sessoes de console. Sessoes em consoles de jogos (PlayStation, Xbox, etc.) gerenciadas pela pagina de Consoles. Estas sao monitoradas apenas pelo servidor; nao ha software cliente no console.

Ambos os tipos de sessao seguem o mesmo motor de precos e ciclo de vida mas sao gerenciados em paginas diferentes do painel de controle.

Ciclo de Vida da Sessao

Toda sessao segue um ciclo de vida definido com transicoes claras de estado:

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

Os estados em detalhe:

1. Iniciar. Um operador de caixa inicia a sessao. O PC cliente e desbloqueado ou o cronometro do console comeca.
2. Em Execucao. A sessao esta ativa. O tempo esta contando e a cobranca esta acumulando.
3. Pausar. O operador interrompe temporariamente a sessao. A cobranca para. O cliente exibe um estado de pausa.
4. Retomar. O operador continua uma sessao pausada. A cobranca retoma a partir de um novo segmento de precos.
5. Adicionar Tempo. O operador adiciona (ou remove) minutos de uma sessao ativa.
6. Encerrar. A sessao termina. O sistema calcula o custo final e solicita o pagamento.

Iniciando uma Sessao

Para iniciar uma nova sessao em um PC cliente:

1. Selecione o cliente. No Painel Administrativo, clique em um PC que esteja no estado Disponivel (ciano) para exibir os botoes de acao.
2. Escolha o tipo de cobranca. Selecione Pos-pago (paga no final) ou Pre-pago (paga antecipadamente).
3. Atribua um membro (opcional). Se o cliente e um membro cadastrado, busque sua conta usando o campo de busca com autocompletar. Atribuir um membro habilita pagamentos por carteira e registra a sessao no historico dele.
4. Defina a duracao ou valor (somente pre-pago). Para sessoes pre-pagas, informe o numero de minutos que o cliente esta comprando ou o valor monetario que esta pagando. O sistema calcula o tempo correspondente com base na faixa de precos atual.
5. Selecione o metodo de pagamento. Escolha o metodo de pagamento (Dinheiro, Cartao de Credito ou qualquer metodo personalizado que voce tenha configurado).
6. Confirme. Revise os detalhes e confirme. O PC cliente e desbloqueado imediatamente e o cronometro da sessao comeca.

Para sessoes de console, o processo e semelhante mas e iniciado pela pagina de Consoles.

Sessoes Pos-pagas

Em uma sessao pos-paga, o cliente utiliza o PC primeiro e paga quando terminar. Este e o modo de cobranca mais comum em lan houses, cybercafes e centros de jogos.

Como funciona:

• A sessao comeca sem pagamento antecipado.
• O cronometro roda e o custo acumula em tempo real com base na faixa de precos ativa.
• Quando a sessao e encerrada, o sistema apresenta o custo final calculado.
• O operador de caixa recebe o pagamento e confirma a transacao.

Sessoes pos-pagas nao tem limite de tempo. Elas continuam ate o operador encerra-las ou o cliente pedir para sair.

Sessoes Pre-pagas

Em uma sessao pre-paga, o cliente paga antecipadamente por um periodo especifico de tempo. A sessao encerra automaticamente quando o tempo comprado expira.

Existem dois modos de precos pre-pagos, configurados em Configuracoes > Precos:

Travar na Compra

O custo e congelado no momento em que a sessao comeca. A faixa de precos e o multiplicador ativos no momento da compra sao usados por toda a duracao da sessao, independente de alteracoes na agenda que ocorram enquanto a sessao esta em andamento.

Exemplo: Um cliente compra 60 minutos as 10:00 durante uma faixa de tarifa padrao. Mesmo que a agenda de precos mude para uma faixa de meia tarifa as 11:00, o tempo restante do cliente nao e afetado. Ele recebeu exatamente o que pagou na tarifa original.

Agenda ao Vivo

O custo se ajusta em tempo real conforme a sessao passa por diferentes faixas de precos. Se a sessao do cliente cruzar uma mudanca de faixa, o tempo restante e recalculado com base nos novos precos.

Exemplo: Um cliente compra 60 minutos as 10:00 durante uma faixa de tarifa padrao. As 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 Sessao

Pausar interrompe temporariamente a cobranca sem encerrar a sessao. Isso e util quando um cliente precisa sair brevemente.

Para pausar uma sessao:

1. Selecione o PC ativo no Painel Administrativo e clique no botao Pausar no cartao.

O que acontece quando uma sessao e pausada:

• A cobranca para imediatamente. Nenhum custo acumula durante a pausa.
• O segmento de precos atual e fechado com um limite de "pausa".
• O PC cliente exibe um estado de pausa com um indicador de status laranja.
• O cronometro da sessao congela.

Sessoes pausadas permanecem pausadas indefinidamente ate que um operador de caixa retome ou encerre.

Retomando uma Sessao

Retomar continua uma sessao pausada de onde parou.

Para retomar uma sessao:

1. Selecione o PC pausado no Painel Administrativo e clique no botao Retomar no cartao.

O que acontece quando uma sessao e retomada:

• Um novo segmento de precos comeca no horario atual, usando a faixa de precos ativa.
• A cobranca retoma.
• O PC cliente retorna ao estado ativo (verde).

Note que a faixa de precos no momento da retomada pode diferir da faixa quando a sessao foi pausada. O novo segmento usa qualquer tarifa que esteja ativa na agenda de precos.

Adicionando Tempo

Voce pode adicionar ou remover minutos de uma sessao ativa a qualquer momento.

Para adicionar tempo:

1. Selecione o PC ativo no Painel Administrativo e clique no botao Adicionar Tempo no cartao.
2. Informe o numero de minutos a adicionar. Use um valor positivo para estender a sessao ou um valor negativo para reduzi-la.
3. Confirme.

O que acontece quando tempo e adicionado:

• Um registro de transacao e criado no historico da sessao.
• Para sessoes pre-pagas, o horario de termino e ajustado para frente (ou para tras) pelo numero de minutos especificado.
• Para sessoes pos-pagas, o evento de adicao de tempo e registrado mas nao define um horario de termino fixo.

Encerrando uma Sessao

Encerrar uma sessao finaliza toda a cobranca, bloqueia o PC cliente e aciona o processo de pagamento.

Para encerrar uma sessao:

1. Selecione o PC ativo ou pausado no Painel Administrativo e clique no botao Parar no cartao.
2. A Caixa de Dialogo de Pagamento aparece mostrando um resumo da sessao.

Caixa de Dialogo de Pagamento

A caixa de dialogo de pagamento exibe as seguintes informacoes:

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 e sempre preservado nos registros para auditoria.

4. Selecione um metodo de pagamento e confirme. A sessao e registrada, o PC cliente e bloqueado e a transacao e salva.

Processo de Liquidacao

Quando uma sessao e encerrada, o motor de liquidacao executa estas etapas:

1. Fecha o ultimo segmento de precos aberto.
2. Soma todos os valores dos segmentos fechados.
3. Aplica regras de arredondamento (sempre arredonda para cima ate o passo de arredondamento configurado).
4. Aplica o minimo da taxa de inicio (o total nunca e menor que a taxa de inicio).
5. Calcula a comissao do metodo de pagamento (baseada em BPS) e a taxa fixa.
6. Apresenta os valores finais na caixa de dialogo de pagamento.

Para uma explicacao detalhada de como os segmentos de precos e calculos de liquidacao funcionam, consulte Precos de Sessao.

Sessoes de Membros

Quando um membro e atribuido a uma sessao, opcoes adicionais de cobranca ficam disponiveis:

• Pagamento por carteira. O custo da sessao pode ser descontado do saldo da carteira do membro.
• Deducao de pacote de tempo. Se o membro comprou um pacote de tempo, os minutos sao descontados do saldo do pacote em vez de cobrar um valor monetario.
• Desconto de membro. Se o membro tem um desconto configurado (em pontos base), ele e aplicado ao custo da sessao.
• Historico de sessoes. A sessao e vinculada a conta do membro e aparece no historico de sessoes dele.

Membros tambem podem iniciar suas proprias sessoes na tela de espera do cliente fazendo login com nome de usuario e senha ou por OAuth (se configurado).

Valores de Status de Sessao

Cada PC cliente exibe um indicador de status colorido:

Estas cores de status aparecem nos cartoes de clientes no Painel Administrativo, facilitando a visualizacao do estado de cada PC.

Segmentos de Precos de Sessao

Cada sessao e dividida em um ou mais segmentos de precos. Um novo segmento e criado sempre que um evento relevante para a cobranca ocorre:

• Inicio de sessao
• Pausa
• Retomada
• Mudanca de faixa de precos (quando o relogio cruza para uma faixa horaria diferente na agenda)
• Alteracao de preco base (se o administrador muda a tarifa por hora durante a sessao)
• Desconexao ou reconexao

Cada segmento registra a faixa de precos, multiplicador, preco base, horario de inicio, horario de termino e valor calculado. O total da sessao e a soma de todos os segmentos, sujeito a regras de arredondamento e cobranca minima.

Para detalhes completos sobre como os segmentos sao calculados, consulte Precos de Sessao.

Cobranca Minima e Taxa de Inicio

Mesmo sessoes muito curtas sao cobradas pelo menos no valor da taxa de inicio. Esta e configurada em Configuracoes > Precos e garante que toda sessao gere um nivel minimo de receita, independente de quao breve foi o uso.

Exemplo: Se sua taxa de inicio e R$ 1,00 e um cliente usa um PC por apenas 30 segundos, o valor cobrado e R$ 1,00 e nao a fracao de centavo que 30 segundos custaria na tarifa por hora.

Proximos Passos

• Precos de Sessao: Detalhes sobre o motor de precos, segmentos e calculos de liquidacao
• Painel Administrativo: Monitore e controle os PCs clientes
• Membros: Gerencie contas e carteiras de membros
• Relatorio de Caixa: Revise a receita de sessoes e resumos de turnos