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 estandar, un miembro puede comprar un bloque de minutos por adelantado y usarlos en multiples sesiones. El sistema hace seguimiento del saldo restante y deduce minutos automaticamente mientras el miembro usa PCs o consolas.

Sistema de creditos de tiempo

Similar al sistema de monedero, los paquetes de tiempo usan una arquitectura basada en creditos. Cada adicion de saldo de tiempo crea un nuevo credito de tiempo. Cada credito es un registro independiente con su propio saldo de minutos, origen, expiracion y restricciones de dispositivo.

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

Campos del credito de tiempo

Cada registro de credito de tiempo contiene:

Campo Descripcion
Minutos totales La cantidad original de minutos cargados en este credito cuando fue creado.
Minutos restantes El saldo actual de minutos no usados en este credito. Disminuye a medida que el miembro usa sesiones.
Tipo de credito Como se creo este credito (ver Tipos de credito abajo).
Restriccion de dispositivo Que tipos de dispositivo pueden consumir de este credito (ver Restriccion de dispositivo abajo).
Estado El estado actual del ciclo de vida del credito.
Expira el Marca de tiempo de expiracion opcional. Despues de esta fecha, los minutos restantes ya no pueden usarse.
ID de compra Si este credito fue creado a partir de una compra de paquete de campana, una referencia a ese registro de compra.

Tipos de credito

Cada credito de tiempo registra como fue creado:

Tipo de credito Descripcion
Pagado El miembro pago por estos minutos, ya sea mediante una compra directa o como el derecho base de un paquete de campana.
Bonificacion Minutos promocionales otorgados como bonificacion con la compra de un paquete. Por ejemplo, "compre 120 minutos y reciba 30 minutos de bonificacion gratis".
Manual Minutos agregados manualmente por un cajero o administrador. Se usa para creditos de buena voluntad, compensaciones o acuerdos especiales.

Estado del credito

Cada credito de tiempo progresa a traves de estos estados:

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

Restricciones de dispositivo

Cada credito de tiempo tiene una restriccion de dispositivo que controla que tipos de dispositivos pueden deducir de el:

Restriccion Significado
Cliente Utilizable en PCs cliente. Tambien utilizable en consolas a menos que este explicitamente restringido.
Consola Utilizable en consolas de juego. Tambien utilizable en PCs a menos que este explicitamente restringido.
Solo PCs Utilizable exclusivamente en PCs cliente. Las sesiones de consola no pueden deducir de este credito.
Solo consolas Utilizable exclusivamente en consolas de juego. Las sesiones de PC no pueden deducir de este credito.
Ambos Utilizable en cualquier tipo de dispositivo sin restriccion. Este es el valor predeterminado.

La restriccion de dispositivo se establece cuando el credito se crea y no puede cambiarse despues. La restriccion se hereda tipicamente de la definicion del paquete de campana que genero el credito.

Seguimiento del consumo

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

Campo Descripcion
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 ocurrio la deduccion.
Contexto Que activo la deduccion (ver abajo).
Referencia Una referencia a la sesion, credito o ajuste especifico que causo la deduccion.

Tipos de contexto

Contexto Descripcion
Uso de sesion Minutos consumidos para pagar una sesion activa. La ruta de consumo principal.
Expiracion Minutos eliminados cuando un credito expira o cuando los minutos restantes se ajustan debido a un evento de expiracion.
Reembolso Minutos devueltos al credito como parte de un proceso de reembolso (registrado como un consumo negativo o una nueva entrada de credito).

Integracion con paquetes de campana

Los creditos de tiempo se crean mas comunmente a traves de compras de paquetes de campana:

  1. Un propietario crea una campana con uno o mas 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 traves de un cajero en el mostrador).
  3. El sistema crea los creditos de tiempo apropiados:
    • Un credito pagado por los minutos base del derecho (el monto base del paquete).
    • Si el paquete define un tipo de bonificacion de "minutos" con un monto de bonificacion mayor que cero, se crea un credito de bonificacion separado para los minutos de bonificacion.
  4. Los creditos heredan la configuracion de restriccion de dispositivo del paquete.
  5. Si el paquete tiene un periodo de validez establecido, la fecha de expiracion del credito se calcula desde la fecha de compra mas la cantidad de dias validos.

Como se deducen los minutos durante las sesiones

Cuando un miembro con minutos de tiempo disponibles inicia una sesion:

  1. El sistema busca creditos de tiempo activos que coincidan con el tipo de dispositivo de la sesion.
  2. Los creditos se consumen en orden de fecha de expiracion (los que expiran primero) para minimizar el desperdicio de creditos que estan por expirar.
  3. A medida que la sesion avanza, se deducen minutos periodicamente de los creditos elegibles.
  4. Cada deduccion crea un registro de consumo como una entrada de "Uso de sesion".
  5. Si todos los creditos de tiempo se agotan antes de que termine la sesion, la sesion continua y el tiempo restante se cobra a la tarifa por hora estandar (se paga al cierre de la sesion).

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