Carteira do Membro
A carteira do membro é um sistema de saldo monetário que permite aos membros pagar antecipadamente por serviços da lan house. Em vez de pagar em dinheiro por cada sessão 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 Créditos
A carteira usa um sistema de créditos em vez de um único saldo corrente. Toda vez que fundos são adicionados à carteira de um membro, o sistema cria um novo crédito de carteira. Cada entrada de crédito é um registro individual com seu próprio saldo, origem, validade e restrição de dispositivo. Esse design oferece:
- Rastreabilidade completa de onde cada unidade de saldo veio.
- Datas de validade independentes por entrada de crédito.
- Restrições específicas de dispositivo (alguns créditos só podem ser usados em PCs, outros apenas em consoles).
- Separação clara entre fundos pagos e bônus promocionais.
O saldo total da carteira do membro é a soma de todos os valores restantes nas suas entradas de crédito ativas.
Tipos de Crédito
Cada crédito de carteira tem um tipo de crédito que identifica como os fundos entraram no sistema:
| Tipo de Crédito | Descrição |
|---|---|
| Pago | O membro pagou por esses fundos (dinheiro, cartão ou outro método de pagamento). Criado ao comprar um pacote de campanha baseado em dinheiro. |
| Bônus | Fundos promocionais concedidos como parte de uma compra de pacote. Por exemplo, "pague por 100 minutos, ganhe 20 minutos de bônus em crédito." |
| Manual | Carregado manualmente por um operador de caixa ou administrador. Usado para créditos de boa vontade ou arranjos especiais. |
| Correção | Um ajuste administrativo para corrigir um erro no saldo do membro. |
| Migração | Fundos importados de um sistema legado durante a migração de dados. |
| Reembolso revertido | Fundos restaurados quando um reembolso emitido anteriormente é revertido. |
O tipo de crédito é definido quando o crédito é criado e não pode ser alterado depois. Serve como uma trilha de auditoria permanente.
Status do Crédito
Cada crédito de carteira passa por um ciclo de vida rastreado pelo seu status:
- Ativo: O crédito possui fundos restantes e não expirou. Fundos podem ser consumidos deste crédito.
- Expirado: A data de validade do crédito passou. Quaisquer fundos restantes não são mais utilizáveis.
- Consumido: O saldo restante do crédito chegou a zero pelo consumo normal.
- Cancelado: O crédito foi cancelado manualmente por um administrador, anulando qualquer saldo restante.
Consumo da Carteira
Quando a carteira de um membro é cobrada (por tempo de sessão, um pedido ou outro evento faturável), o sistema cria um registro de consumo de carteira que vincula a uma entrada de crédito específica e registra exatamente quanto foi descontado.
Cada registro de consumo inclui um contexto que identifica o que acionou a dedução:
| Contexto | Descrição |
|---|---|
| Uso de sessão | Fundos consumidos para pagar pelo tempo de uso da sessão. O sistema desconta da carteira conforme a sessão 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 balcão ou entregue ao PC do membro. |
| Reembolso | Um ajuste negativo criado quando um reembolso é processado, reduzindo o consumo para devolver fundos à entrada de crédito. |
Cada registro de consumo vincula de volta à sessão, pedido ou transação específica que o causou, permitindo rastreamento completo de auditoria.
Log de Saldo
Além dos registros de consumo no nível do crédito, o sistema mantém um log de saldo do membro que registra cada evento que altera o saldo geral da carteira:
| Tipo de Evento | Descrição |
|---|---|
load |
Fundos foram adicionados à carteira (nova entrada de crédito criada ou existente recarregada). |
spend |
Fundos foram consumidos da carteira (pagamento de sessão, pagamento de pedido). |
refund |
Fundos foram devolvidos à carteira (reembolso de pedido, reembolso de sessão). |
adjustment |
Uma alteração administrativa foi feita no saldo (correção, baixa). |
Cada entrada do log de saldo registra o valor da alteração e o saldo resultante, permitindo reconstruir o saldo do membro em qualquer momento lendo o log cronologicamente.
Restrição de Dispositivo
Cada crédito de carteira tem uma restrição de dispositivo que controla quais tipos de dispositivos podem consumi-lo:
| Restrição | Significado |
|---|---|
| Cliente | Utilizável em PCs clientes. Também utilizável em consoles a menos que o crédito tenha sido 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. Não pode ser consumido por sessões de console. |
| Somente Consoles | Utilizável exclusivamente em consoles de jogos. Não pode ser consumido por sessões de PC. |
| Ambos | Utilizável em qualquer tipo de dispositivo sem restrição. Este é o padrão. |
Quando o sistema precisa descontar da carteira de um membro, ele filtra os créditos disponíveis pela restrição de dispositivo para garantir que apenas créditos elegíveis sejam cobrados.
Categoria de Carteira e Gasto entre Categorias
Créditos 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 só podem ser gastos em determinados contextos.
A opção de gasto entre categorias em cada crédito controla se os fundos podem ser usados fora da categoria designada:
- Quando desabilitada (padrão), o crédito só pode ser consumido na sua própria categoria.
- Quando habilitada, o crédito também pode ser consumido por transações em outras categorias.
Se um crédito não tem categoria de carteira atribuída, ele é tratado como um crédito de uso geral e pode ser consumido por qualquer transação independente da categoria.
Como Funcionam as Recargas
Fundos podem ser adicionados à carteira por vários métodos:
Compra de pacote de campanha: Quando um membro compra um pacote baseado em dinheiro de uma campanha, o sistema cria automaticamente créditos de carteira com base na definição do pacote. Uma única compra pode criar múltiplos créditos (um para a parcela paga, um para a parcela de bônus).
Carga manual: Um operador de caixa pode adicionar fundos manualmente à carteira de um membro pelo painel de detalhes do membro. Isso cria uma entrada de crédito com o tipo "Manual".
Migração: Durante a configuração do sistema, saldos existentes de um sistema anterior podem ser importados como entradas de crédito com o tipo "Migração".
Como a Carteira é Consumida Durante Sessões
Quando um membro com saldo na carteira inicia uma sessão, o sistema pode pagar automaticamente pela sessão a partir da carteira:
- O motor de preços de sessão calcula o custo por minuto com base na faixa de preços ativa e quaisquer descontos de nível aplicáveis.
- Conforme a sessão roda, o sistema periodicamente desconta o custo acumulado dos créditos elegíveis da carteira do membro.
- Créditos são consumidos em ordem de data de validade (os que expiram primeiro são usados primeiro) para minimizar o desperdício por vencimento.
- Se o saldo da carteira se esgotar antes do término da sessão, o custo restante é cobrado como pagamento em dinheiro no encerramento da sessão.
- Cada dedução cria um registro de consumo vinculado à sessão como entrada de "Uso de sessão".