HandyCafe Docs
owner cashier

Paquetes de tiempo

Los paquetes de tiempo proporcionan a los miembros un saldo prepagado de minutos. En lugar de pagar por hora a la tarifa estándar, un miembro puede comprar un bloque de minutos por adelantado y usarlos en múltiples sesiones. El sistema hace seguimiento del saldo restante y deduce minutos automáticamente mientras el miembro usa PCs o consolas.

Sistema de créditos de tiempo

Similar al sistema de monedero, los paquetes de tiempo usan una arquitectura basada en créditos. Cada adición de saldo de tiempo crea un nuevo crédito de tiempo. Cada crédito es un registro independiente con su propio saldo de minutos, origen, expiración y restricciones de dispositivo.

Los minutos totales disponibles de un miembro son la suma de todos los minutos restantes en sus créditos de tiempo activos.

Campos del crédito de tiempo

Cada registro de crédito de tiempo contiene:

Campo Descripción
Minutos totales La cantidad original de minutos cargados en este crédito cuando fue creado.
Minutos restantes El saldo actual de minutos no usados en este crédito. Disminuye a medida que el miembro usa sesiones.
Tipo de crédito Cómo se creó este crédito (ver Tipos de crédito abajo).
Restricción de dispositivo Qué tipos de dispositivo pueden consumir de este crédito (ver Restricción de dispositivo abajo).
Estado El estado actual del ciclo de vida del crédito.
Expira el Marca de tiempo de expiración opcional. Después de esta fecha, los minutos restantes ya no pueden usarse.
ID de compra Si este crédito fue creado a partir de una compra de paquete de campaña, una referencia a ese registro de compra.

Tipos de crédito

Cada crédito de tiempo registra cómo fue creado:

Tipo de crédito Descripción
Pagado El miembro pagó por estos minutos, ya sea mediante una compra directa o como el derecho base de un paquete de campaña.
Bonificación Minutos promocionales otorgados como bonificación con la compra de un paquete. Por ejemplo, "compre 120 minutos y reciba 30 minutos de bonificación gratis".
Manual Minutos agregados manualmente por un cajero o administrador. Se usa para créditos de buena voluntad, compensaciones o acuerdos especiales.

Estado del crédito

Cada crédito de tiempo progresa a través de estos estados:

  • Activo: El crédito tiene minutos restantes y no ha expirado. Los minutos pueden consumirse de este crédito.
  • Expirado: La fecha de expiración del crédito ha pasado. Los minutos restantes ya no son utilizables, incluso si el saldo es mayor que cero.
  • Consumido: Los minutos restantes del crédito han llegado a cero a través del uso normal.
  • Cancelado: El crédito fue cancelado manualmente por un administrador, anulando los minutos restantes.

Restricciones de dispositivo

Cada crédito de tiempo tiene una restricción de dispositivo que controla qué tipos de dispositivos pueden deducir de él:

Restricción Significado
Cliente Utilizable en PCs cliente. También utilizable en consolas a menos que esté explícitamente restringido.
Consola Utilizable en consolas de juego. También utilizable en PCs a menos que esté explícitamente restringido.
Solo PCs Utilizable exclusivamente en PCs cliente. Las sesiones de consola no pueden deducir de este crédito.
Solo consolas Utilizable exclusivamente en consolas de juego. Las sesiones de PC no pueden deducir de este crédito.
Ambos Utilizable en cualquier tipo de dispositivo sin restricción. Este es el valor predeterminado.

La restricción de dispositivo se establece cuando el crédito se crea y no puede cambiarse después. La restricción se hereda típicamente de la definición del paquete de campaña que generó el crédito.

Seguimiento del consumo

Cada vez que se deducen minutos de un crédito de tiempo, el sistema crea un registro de consumo de tiempo:

Campo Descripción
Minutos consumidos La cantidad de minutos deducidos en este evento de consumo. Siempre es un entero positivo.
Consumido el La marca de tiempo de cuando ocurrió la deducción.
Contexto Qué activó la deducción (ver abajo).
Referencia Una referencia a la sesión, crédito o ajuste específico que causó la deducción.

Tipos de contexto

Contexto Descripción
Uso de sesión Minutos consumidos para pagar una sesión activa. La ruta de consumo principal.
Expiración Minutos eliminados cuando un crédito expira o cuando los minutos restantes se ajustan debido a un evento de expiración.
Reembolso Minutos devueltos al crédito como parte de un proceso de reembolso (registrado como un consumo negativo o una nueva entrada de crédito).

Integración con paquetes de campaña

Los créditos de tiempo se crean más comúnmente a través de compras de paquetes de campaña:

  1. Un propietario crea una campaña con uno o más paquetes con un tipo de paquete de "minutos".
  2. Un miembro selecciona y compra un paquete (desde el Panel de miembros en el cliente o a través de un cajero en el mostrador).
  3. El sistema crea los créditos de tiempo apropiados:
    • Un crédito pagado por los minutos base del derecho (el monto base del paquete).
    • Si el paquete define un tipo de bonificación de "minutos" con un monto de bonificación mayor que cero, se crea un crédito de bonificación separado para los minutos de bonificación.
  4. Los créditos heredan la configuración de restricción de dispositivo del paquete.
  5. Si el paquete tiene un periodo de validez establecido, la fecha de expiración del crédito se calcula desde la fecha de compra más la cantidad de días válidos.

Cómo se deducen los minutos durante las sesiones

Cuando un miembro con minutos de tiempo disponibles inicia una sesión:

  1. El sistema busca créditos de tiempo activos que coincidan con el tipo de dispositivo de la sesión.
  2. Los créditos se consumen en orden de fecha de expiración (los que expiran primero) para minimizar el desperdicio de créditos que están por expirar.
  3. A medida que la sesión avanza, se deducen minutos periódicamente de los créditos elegibles.
  4. Cada deducción crea un registro de consumo como una entrada de "Uso de sesión".
  5. Si todos los créditos de tiempo se agotan antes de que termine la sesión, la sesión continúa y el tiempo restante se cobra a la tarifa por hora estándar (se paga al cierre de la sesión).

Esto significa que el saldo de tiempo y el saldo de monedero de un miembro pueden trabajar juntos. Los créditos de tiempo cubren tantos minutos como estén disponibles y cualquier excedente se cubre con el saldo del monedero o pago en efectivo.