HandyCafe Docs
owner cashier

Pacotes de Tempo

Pacotes de tempo fornecem aos membros um saldo de minutos pré-pagos. Em vez de pagar por hora na tarifa padrão, um membro pode comprar um bloco de minutos antecipadamente e usá-los em múltiplas sessões. O sistema rastreia o saldo restante e desconta minutos automaticamente conforme o membro usa PCs ou consoles.

Sistema de Créditos de Tempo

Similar ao sistema de carteira, os pacotes de tempo usam uma arquitetura baseada em créditos. Cada adição de saldo de tempo cria um novo crédito de tempo. Cada crédito é um registro independente com seu próprio saldo de minutos, origem, validade e restrições de dispositivo.

O total de minutos disponíveis de um membro é a soma de todos os minutos restantes nos seus créditos de tempo ativos.

Campos do Crédito de Tempo

Cada registro de crédito de tempo contém:

Campo Descrição
Total de minutos O número original de minutos carregados neste crédito quando foi criado.
Minutos restantes O saldo atual de minutos não utilizados neste crédito. Diminui conforme o membro usa sessões.
Tipo de crédito Como este crédito foi criado (veja Tipos de Crédito abaixo).
Restrição de dispositivo Quais tipos de dispositivo podem consumir deste crédito (veja Restrição de Dispositivo abaixo).
Status O estado atual do ciclo de vida do crédito.
Expira em Timestamp opcional de validade. Após esta data, os minutos restantes não podem mais ser utilizados.
ID da compra Se este crédito foi criado a partir de uma compra de pacote de campanha, uma referência ao registro da compra.

Tipos de Crédito

Cada crédito de tempo rastreia como foi criado:

Tipo de Crédito Descrição
Pago O membro pagou por esses minutos, seja por compra direta ou como a parcela base de um pacote de campanha.
Bônus Minutos promocionais concedidos como bônus com uma compra de pacote. Por exemplo, "compre 120 minutos, ganhe 30 minutos de bônus grátis."
Manual Minutos adicionados manualmente por um operador de caixa ou administrador. Usado para créditos de boa vontade, compensação ou arranjos especiais.

Status do Crédito

Cada crédito de tempo progride por estes estados:

  • Ativo: O crédito possui minutos restantes e não expirou. Minutos podem ser consumidos deste crédito.
  • Expirado: A data de validade do crédito passou. Quaisquer minutos restantes não são mais utilizáveis, mesmo que o saldo seja maior que zero.
  • Consumido: Os minutos restantes do crédito chegaram a zero pelo uso normal.
  • Cancelado: O crédito foi cancelado manualmente por um administrador, anulando quaisquer minutos restantes.

Restrições de Dispositivo

Cada crédito de tempo tem uma restrição de dispositivo que controla quais tipos de dispositivos podem descontar dele:

Restrição Significado
Cliente Utilizável em PCs clientes. Também utilizável em consoles a menos que explicitamente restrito.
Console Utilizável em consoles de jogos. Também utilizável em PCs a menos que explicitamente restrito.
Somente PCs Utilizável exclusivamente em PCs clientes. Sessões de console não podem descontar deste crédito.
Somente Consoles Utilizável exclusivamente em consoles de jogos. Sessões de PC não podem descontar deste crédito.
Ambos Utilizável em qualquer tipo de dispositivo sem restrição. Este é o padrão.

A restrição de dispositivo é definida quando o crédito é criado e não pode ser alterada depois. A restrição é tipicamente herdada da definição do pacote de campanha que gerou o crédito.

Rastreamento de Consumo

Toda vez que minutos são descontados de um crédito de tempo, o sistema cria um registro de consumo de tempo:

Campo Descrição
Minutos consumidos O número de minutos descontados neste evento de consumo. Sempre um inteiro positivo.
Consumido em O timestamp de quando a dedução ocorreu.
Contexto O que acionou a dedução (veja abaixo).
Referência Uma referência à sessão, crédito ou ajuste específico que causou a dedução.

Tipos de Contexto

Contexto Descrição
Uso de sessão Minutos consumidos para pagar por uma sessão ativa. O caminho principal de consumo.
Expiração Minutos removidos quando um crédito expira ou quando os minutos restantes são ajustados devido a um evento de expiração.
Reembolso Minutos devolvidos ao crédito como parte de um processo de reembolso (registrado como consumo negativo ou nova entrada de crédito).

Integração com Pacotes de Campanha

Créditos de tempo são mais comumente criados por meio de compras de pacotes de campanha:

  1. Um proprietário cria uma campanha com um ou mais pacotes do tipo "minutos".
  2. Um membro seleciona e compra um pacote (pelo Painel do Membro no cliente ou pelo operador de caixa no balcão).
  3. O sistema cria os créditos de tempo apropriados:
    • Um crédito pago para a parcela base de minutos (o valor base do pacote).
    • Se o pacote define um tipo de bônus de "minutos" com valor de bônus maior que zero, um crédito de bônus separado é criado para os minutos de bônus.
  4. Os créditos herdam a configuração de restrição de dispositivo do pacote.
  5. Se o pacote tem um período de validade definido, a data de expiração do crédito é calculada a partir da data de compra mais o número de dias válidos.

Como o Tempo é Descontado Durante Sessões

Quando um membro com minutos disponíveis inicia uma sessão:

  1. O sistema verifica créditos de tempo ativos que correspondem ao tipo de dispositivo da sessão.
  2. Créditos são consumidos em ordem de data de validade (os que expiram primeiro são usados primeiro) para minimizar o desperdício de créditos prestes a expirar.
  3. Conforme a sessão roda, minutos são periodicamente descontados dos créditos elegíveis.
  4. Cada dedução cria um registro de consumo como entrada de "Uso de sessão".
  5. Se todos os créditos de tempo se esgotarem antes do término da sessão, a sessão continua e o tempo restante é cobrado na tarifa padrão por hora (pago no encerramento da sessão).

Isso significa que o saldo de tempo e o saldo da carteira de um membro podem trabalhar juntos. Créditos de tempo cobrem quantos minutos estiverem disponíveis e qualquer excedente recai sobre o saldo da carteira ou pagamento em dinheiro.