Carteira do Membro
A carteira do membro e um sistema de saldo monetario que permite aos membros pagar antecipadamente por servicos da lan house. Em vez de pagar em dinheiro por cada sessao individual, um membro pode carregar fundos na sua carteira e o sistema desconta automaticamente desse saldo conforme ele usa PCs, consoles ou faz pedidos de produtos.
Arquitetura Baseada em Creditos
A carteira usa um sistema de creditos em vez de um unico saldo corrente. Toda vez que fundos sao adicionados a carteira de um membro, o sistema cria um novo credito de carteira. Cada entrada de credito e um registro individual com seu proprio saldo, origem, validade e restricao de dispositivo. Esse design oferece:
- Rastreabilidade completa de onde cada unidade de saldo veio.
- Datas de validade independentes por entrada de credito.
- Restricoes especificas de dispositivo (alguns creditos so podem ser usados em PCs, outros apenas em consoles).
- Separacao clara entre fundos pagos e bonus promocionais.
O saldo total da carteira do membro e a soma de todos os valores restantes nas suas entradas de credito ativas.
Tipos de Credito
Cada credito de carteira tem um tipo de credito que identifica como os fundos entraram no sistema:
| Tipo de Credito | Descricao |
|---|---|
| Pago | O membro pagou por esses fundos (dinheiro, cartao ou outro metodo de pagamento). Criado ao comprar um pacote de campanha baseado em dinheiro. |
| Bonus | Fundos promocionais concedidos como parte de uma compra de pacote. Por exemplo, "pague por 100 minutos, ganhe 20 minutos de bonus em credito." |
| Manual | Carregado manualmente por um operador de caixa ou administrador. Usado para creditos de boa vontade ou arranjos especiais. |
| Correcao | Um ajuste administrativo para corrigir um erro no saldo do membro. |
| Migracao | Fundos importados de um sistema legado durante a migracao de dados. |
| Reembolso revertido | Fundos restaurados quando um reembolso emitido anteriormente e revertido. |
O tipo de credito e definido quando o credito e criado e nao pode ser alterado depois. Serve como uma trilha de auditoria permanente.
Status do Credito
Cada credito de carteira passa por um ciclo de vida rastreado pelo seu status:
- Ativo: O credito possui fundos restantes e nao expirou. Fundos podem ser consumidos deste credito.
- Expirado: A data de validade do credito passou. Quaisquer fundos restantes nao sao mais utilizaveis.
- Consumido: O saldo restante do credito chegou a zero pelo consumo normal.
- Cancelado: O credito foi cancelado manualmente por um administrador, anulando qualquer saldo restante.
Consumo da Carteira
Quando a carteira de um membro e cobrada (por tempo de sessao, um pedido ou outro evento faturavel), o sistema cria um registro de consumo de carteira que vincula a uma entrada de credito especifica e registra exatamente quanto foi descontado.
Cada registro de consumo inclui um contexto que identifica o que acionou a deducao:
| Contexto | Descricao |
|---|---|
| Uso de sessao | Fundos consumidos para pagar pelo tempo de uso da sessao. O sistema desconta da carteira conforme a sessao roda. |
| Pagamento por carteira | Um pagamento direto da carteira (por exemplo, quando o membro paga por um pedido de produto usando saldo da carteira). |
| Pedido | Fundos consumidos para pagar por um pedido de produto no balcao ou entregue ao PC do membro. |
| Reembolso | Um ajuste negativo criado quando um reembolso e processado, reduzindo o consumo para devolver fundos a entrada de credito. |
Cada registro de consumo vincula de volta a sessao, pedido ou transacao especifica que o causou, permitindo rastreamento completo de auditoria.
Log de Saldo
Alem dos registros de consumo no nivel do credito, o sistema mantem um log de saldo do membro que registra cada evento que altera o saldo geral da carteira:
| Tipo de Evento | Descricao |
|---|---|
load |
Fundos foram adicionados a carteira (nova entrada de credito criada ou existente recarregada). |
spend |
Fundos foram consumidos da carteira (pagamento de sessao, pagamento de pedido). |
refund |
Fundos foram devolvidos a carteira (reembolso de pedido, reembolso de sessao). |
adjustment |
Uma alteracao administrativa foi feita no saldo (correcao, baixa). |
Cada entrada do log de saldo registra o valor da alteracao e o saldo resultante, permitindo reconstruir o saldo do membro em qualquer momento lendo o log cronologicamente.
Restricao de Dispositivo
Cada credito de carteira tem uma restricao de dispositivo que controla quais tipos de dispositivos podem consumi-lo:
| Restricao | Significado |
|---|---|
| Cliente | Utilizavel em PCs clientes. Tambem utilizavel em consoles a menos que o credito tenha sido explicitamente restrito. |
| Console | Utilizavel em consoles de jogos. Tambem utilizavel em PCs a menos que explicitamente restrito. |
| Somente PCs | Utilizavel exclusivamente em PCs clientes. Nao pode ser consumido por sessoes de console. |
| Somente Consoles | Utilizavel exclusivamente em consoles de jogos. Nao pode ser consumido por sessoes de PC. |
| Ambos | Utilizavel em qualquer tipo de dispositivo sem restricao. Este e o padrao. |
Quando o sistema precisa descontar da carteira de um membro, ele filtra os creditos disponiveis pela restricao de dispositivo para garantir que apenas creditos elegiveis sejam cobrados.
Categoria de Carteira e Gasto entre Categorias
Creditos de carteira podem ser marcados com uma categoria de carteira (por exemplo, "jogos" ou "geral"). Isso permite que a lan house crie pools de saldo isolados que so podem ser gastos em determinados contextos.
A opcao de gasto entre categorias em cada credito controla se os fundos podem ser usados fora da categoria designada:
- Quando desabilitada (padrao), o credito so pode ser consumido na sua propria categoria.
- Quando habilitada, o credito tambem pode ser consumido por transacoes em outras categorias.
Se um credito nao tem categoria de carteira atribuida, ele e tratado como um credito de uso geral e pode ser consumido por qualquer transacao independente da categoria.
Como Funcionam as Recargas
Fundos podem ser adicionados a carteira por varios metodos:
Compra de pacote de campanha: Quando um membro compra um pacote baseado em dinheiro de uma campanha, o sistema cria automaticamente creditos de carteira com base na definicao do pacote. Uma unica compra pode criar multiplos creditos (um para a parcela paga, um para a parcela de bonus).
Carga manual: Um operador de caixa pode adicionar fundos manualmente a carteira de um membro pelo painel de detalhes do membro. Isso cria uma entrada de credito com o tipo "Manual".
Migracao: Durante a configuracao do sistema, saldos existentes de um sistema anterior podem ser importados como entradas de credito com o tipo "Migracao".
Como a Carteira e Consumida Durante Sessoes
Quando um membro com saldo na carteira inicia uma sessao, o sistema pode pagar automaticamente pela sessao a partir da carteira:
- O motor de precos de sessao calcula o custo por minuto com base na faixa de precos ativa e quaisquer descontos de nivel aplicaveis.
- Conforme a sessao roda, o sistema periodicamente desconta o custo acumulado dos creditos elegiveis da carteira do membro.
- Creditos sao consumidos em ordem de data de validade (os que expiram primeiro sao usados primeiro) para minimizar o desperdicio por vencimento.
- Se o saldo da carteira se esgotar antes do termino da sessao, o custo restante e cobrado como pagamento em dinheiro no encerramento da sessao.
- Cada deducao cria um registro de consumo vinculado a sessao como entrada de "Uso de sessao".