Pacotes de Tempo

Pacotes de tempo fornecem aos membros um saldo de minutos pre-pagos. Em vez de pagar por hora na tarifa padrao, um membro pode comprar um bloco de minutos antecipadamente e usa-los em multiplas sessoes. O sistema rastreia o saldo restante e desconta minutos automaticamente conforme o membro usa PCs ou consoles.

Sistema de Creditos de Tempo

Similar ao sistema de carteira, os pacotes de tempo usam uma arquitetura baseada em creditos. Cada adicao de saldo de tempo cria um novo credito de tempo. Cada credito e um registro independente com seu proprio saldo de minutos, origem, validade e restricoes de dispositivo.

O total de minutos disponiveis de um membro e a soma de todos os minutos restantes nos seus creditos de tempo ativos.

Campos do Credito de Tempo

Cada registro de credito de tempo contem:

Campo	Descricao
Total de minutos	O numero original de minutos carregados neste credito quando foi criado.
Minutos restantes	O saldo atual de minutos nao utilizados neste credito. Diminui conforme o membro usa sessoes.
Tipo de credito	Como este credito foi criado (veja Tipos de Credito abaixo).
Restricao de dispositivo	Quais tipos de dispositivo podem consumir deste credito (veja Restricao de Dispositivo abaixo).
Status	O estado atual do ciclo de vida do credito.
Expira em	Timestamp opcional de validade. Apos esta data, os minutos restantes nao podem mais ser utilizados.
ID da compra	Se este credito foi criado a partir de uma compra de pacote de campanha, uma referencia ao registro da compra.

Tipos de Credito

Cada credito de tempo rastreia como foi criado:

Tipo de Credito	Descricao
Pago	O membro pagou por esses minutos, seja por compra direta ou como a parcela base de um pacote de campanha.
Bonus	Minutos promocionais concedidos como bonus com uma compra de pacote. Por exemplo, "compre 120 minutos, ganhe 30 minutos de bonus gratis."
Manual	Minutos adicionados manualmente por um operador de caixa ou administrador. Usado para creditos de boa vontade, compensacao ou arranjos especiais.

Status do Credito

Cada credito de tempo progride por estes estados:

Ativo: O credito possui minutos restantes e nao expirou. Minutos podem ser consumidos deste credito.
Expirado: A data de validade do credito passou. Quaisquer minutos restantes nao sao mais utilizaveis, mesmo que o saldo seja maior que zero.
Consumido: Os minutos restantes do credito chegaram a zero pelo uso normal.
Cancelado: O credito foi cancelado manualmente por um administrador, anulando quaisquer minutos restantes.

Restricoes de Dispositivo

Cada credito de tempo tem uma restricao de dispositivo que controla quais tipos de dispositivos podem descontar dele:

Restricao	Significado
Cliente	Utilizavel em PCs clientes. Tambem utilizavel em consoles a menos que explicitamente restrito.
Console	Utilizavel em consoles de jogos. Tambem utilizavel em PCs a menos que explicitamente restrito.
Somente PCs	Utilizavel exclusivamente em PCs clientes. Sessoes de console nao podem descontar deste credito.
Somente Consoles	Utilizavel exclusivamente em consoles de jogos. Sessoes de PC nao podem descontar deste credito.
Ambos	Utilizavel em qualquer tipo de dispositivo sem restricao. Este e o padrao.

A restricao de dispositivo e definida quando o credito e criado e nao pode ser alterada depois. A restricao e tipicamente herdada da definicao do pacote de campanha que gerou o credito.

Rastreamento de Consumo

Toda vez que minutos sao descontados de um credito de tempo, o sistema cria um registro de consumo de tempo:

Campo	Descricao
Minutos consumidos	O numero de minutos descontados neste evento de consumo. Sempre um inteiro positivo.
Consumido em	O timestamp de quando a deducao ocorreu.
Contexto	O que acionou a deducao (veja abaixo).
Referencia	Uma referencia a sessao, credito ou ajuste especifico que causou a deducao.

Tipos de Contexto

Contexto	Descricao
Uso de sessao	Minutos consumidos para pagar por uma sessao ativa. O caminho principal de consumo.
Expiracao	Minutos removidos quando um credito expira ou quando os minutos restantes sao ajustados devido a um evento de expiracao.
Reembolso	Minutos devolvidos ao credito como parte de um processo de reembolso (registrado como consumo negativo ou nova entrada de credito).

Integracao com Pacotes de Campanha

Creditos de tempo sao mais comumente criados por meio de compras de pacotes de campanha:

Um proprietario cria uma campanha com um ou mais pacotes do tipo "minutos".
Um membro seleciona e compra um pacote (pelo Painel do Membro no cliente ou pelo operador de caixa no balcao).
O sistema cria os creditos de tempo apropriados:
- Um credito pago para a parcela base de minutos (o valor base do pacote).
- Se o pacote define um tipo de bonus de "minutos" com valor de bonus maior que zero, um credito de bonus separado e criado para os minutos de bonus.
Os creditos herdam a configuracao de restricao de dispositivo do pacote.
Se o pacote tem um periodo de validade definido, a data de expiracao do credito e calculada a partir da data de compra mais o numero de dias validos.

Como o Tempo e Descontado Durante Sessoes

Quando um membro com minutos disponiveis inicia uma sessao:

O sistema verifica creditos de tempo ativos que correspondem ao tipo de dispositivo da sessao.
Creditos sao consumidos em ordem de data de validade (os que expiram primeiro sao usados primeiro) para minimizar o desperdicio de creditos prestes a expirar.
Conforme a sessao roda, minutos sao periodicamente descontados dos creditos elegiveis.
Cada deducao cria um registro de consumo como entrada de "Uso de sessao".
Se todos os creditos de tempo se esgotarem antes do termino da sessao, a sessao continua e o tempo restante e cobrado na tarifa padrao por hora (pago no encerramento da sessao).

Isso significa que o saldo de tempo e o saldo da carteira de um membro podem trabalhar juntos. Creditos de tempo cobrem quantos minutos estiverem disponiveis e qualquer excedente recai sobre o saldo da carteira ou pagamento em dinheiro.