HandyCafe Docs
owner cashier

Forfaits de temps

Les forfaits de temps fournissent aux membres un solde de minutes prépayées. Au lieu de payer à l'heure au tarif standard, un membre peut acheter un bloc de minutes à l'avance et les utiliser sur plusieurs sessions. Le système suit le solde restant et déduit les minutes automatiquement lorsque le membre utilise des PC ou des consoles.

Système de crédits de temps

De manière similaire au système de portefeuille, les forfaits de temps utilisent une architecture basée sur les crédits. Chaque ajout de solde de temps crée un nouveau crédit de temps. Chaque crédit est un enregistrement indépendant avec son propre solde de minutes, sa source, sa date d'expiration et ses restrictions d'appareil.

Le total de minutes disponibles d'un membre est la somme de toutes les minutes restantes de ses crédits de temps actifs.

Champs du crédit de temps

Chaque enregistrement de crédit de temps contient :

Champ Description
Minutes totales Le nombre initial de minutes chargées dans ce crédit lors de sa création.
Minutes restantes Le solde actuel de minutes non utilisées dans ce crédit. Diminue au fur et à mesure que le membre utilise des sessions.
Type de crédit Comment ce crédit a été créé (voir Types de crédit ci-dessous).
Restriction d'appareil Quels types d'appareils peuvent consommer ce crédit (voir Restriction d'appareil ci-dessous).
Statut L'état actuel du cycle de vie du crédit.
Expire le Horodatage d'expiration facultatif. Passe cette date, les minutes restantes ne peuvent plus être utilisées.
ID d'achat Si ce crédit a été créé à partir d'un achat de forfait de campagne, une référence vers cet enregistrement d'achat.

Types de crédit

Chaque crédit de temps suit la manière dont il a été créé :

Type de crédit Description
Payé Le membre a payé ces minutes, soit par un achat direct, soit comme droit de base d'un forfait de campagne.
Bonus Minutes promotionnelles accordées en bonus avec un achat de forfait. Par exemple : "achetez 120 minutes, obtenez 30 minutes bonus gratuites."
Manuel Minutes ajoutées manuellement par un caissier ou un administrateur. Utilisé pour les crédits de bonne volonté, les compensations ou les arrangements spéciaux.

Statut du crédit

Chaque crédit de temps passe par les états suivants :

  • Actif : le crédit dispose de minutes restantes et n'a pas expiré. Les minutes peuvent être consommées à partir de ce crédit.
  • Expiré : la date d'expiration du crédit est passée. Les minutes restantes ne sont plus utilisables, même si le solde est supérieur à zéro.
  • Consommé : les minutes restantes du crédit ont atteint zéro par utilisation normale.
  • Annulé : le crédit a été annulé manuellement par un administrateur, invalidant toutes les minutes restantes.

Restrictions d'appareil

Chaque crédit de temps possède une restriction d'appareil qui contrôle quels types d'appareils peuvent déduire de ce crédit :

Restriction Signification
Client Utilisable sur les PC clients. Également utilisable sur les consoles, sauf restriction explicite.
Console Utilisable sur les consoles de jeux. Également utilisable sur les PC, sauf restriction explicite.
PC uniquement Utilisable exclusivement sur les PC clients. Les sessions console ne peuvent pas déduire de ce crédit.
Consoles uniquement Utilisable exclusivement sur les consoles de jeux. Les sessions PC ne peuvent pas déduire de ce crédit.
Les deux Utilisable sur tout type d'appareil sans restriction. C'est la valeur par défaut.

La restriction d'appareil est définie lors de la création du crédit et ne peut pas être modifiée par la suite. La restriction est généralement héritée de la définition du forfait de campagne qui a généré le crédit.

Suivi de la consommation

Chaque fois que des minutes sont déduites d'un crédit de temps, le système crée un enregistrement de consommation de temps :

Champ Description
Minutes consommées Le nombre de minutes déduites lors de cet événement de consommation. Toujours un entier positif.
Consommé le L'horodatage de la déduction.
Contexte Ce qui a déclenché la déduction (voir ci-dessous).
Référence Une référence vers la session, le crédit ou l'ajustement spécifique qui a provoqué la déduction.

Types de contexte

Contexte Description
Utilisation de session Minutes consommées pour payer une session active. C'est le principal canal de consommation.
Expiration Minutes retirées lorsqu'un crédit expire ou lorsque les minutes restantes sont ajustées suite à un événement d'expiration.
Remboursement Minutes restituées au crédit dans le cadre d'un processus de remboursement (enregistré comme une consommation négative ou une nouvelle entrée de crédit).

Intégration avec les forfaits de campagne

Les crédits de temps sont le plus souvent créés via les achats de forfaits de campagne :

  1. Un propriétaire crée une campagne avec un ou plusieurs forfaits de type "minutes".
  2. Un membre sélectionne et achète un forfait (depuis le panneau Membre côté client ou auprès d'un caissier au comptoir).
  3. Le système crée les crédits de temps appropriés :
    • Un crédit payé pour le droit de base en minutes (le montant de base du forfait).
    • Si le forfait définit un type de bonus "minutes" avec un montant bonus supérieur à zéro, un crédit bonus distinct est créé pour les minutes bonus.
  4. Les crédits héritent du paramètre de restriction d'appareil du forfait.
  5. Si le forfait a une période de validité définie, la date d'expiration du crédit est calculée à partir de la date d'achat plus le nombre de jours de validité.

Déduction du temps durant les sessions

Lorsqu'un membre disposant de minutes de temps démarre une session :

  1. Le système recherche les crédits de temps actifs correspondant au type d'appareil de la session.
  2. Les crédits sont consommés par ordre de date d'expiration (les plus proches de l'expiration en premier) pour minimiser les pertes dues aux crédits sur le point d'expirer.
  3. Pendant le déroulement de la session, les minutes sont périodiquement déduites des crédits éligibles.
  4. Chaque déduction crée un enregistrement de consommation en tant qu'entrée "Utilisation de session".
  5. Si tous les crédits de temps sont épuisés avant la fin de la session, la session se poursuit et le temps restant est facturé au tarif horaire standard (payé à la clôture de la session).

Cela signifie que le solde de temps et le solde de portefeuille d'un membre peuvent fonctionner ensemble. Les crédits de temps couvrent autant de minutes que disponibles et tout dépassement est reporté sur le solde du portefeuille ou le paiement en espèces.