HandyCafe Docs
owner cashier

Forfaits de temps

Les forfaits de temps fournissent aux membres un solde de minutes prepayees. Au lieu de payer a l'heure au tarif standard, un membre peut acheter un bloc de minutes a l'avance et les utiliser sur plusieurs sessions. Le systeme suit le solde restant et deduit les minutes automatiquement lorsque le membre utilise des PC ou des consoles.

Systeme de credits de temps

De maniere similaire au systeme de portefeuille, les forfaits de temps utilisent une architecture basee sur les credits. Chaque ajout de solde de temps cree un nouveau credit de temps. Chaque credit est un enregistrement independant 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 credits de temps actifs.

Champs du credit de temps

Chaque enregistrement de credit de temps contient :

Champ Description
Minutes totales Le nombre initial de minutes chargees dans ce credit lors de sa creation.
Minutes restantes Le solde actuel de minutes non utilisees dans ce credit. Diminue au fur et a mesure que le membre utilise des sessions.
Type de credit Comment ce credit a ete cree (voir Types de credit ci-dessous).
Restriction d'appareil Quels types d'appareils peuvent consommer ce credit (voir Restriction d'appareil ci-dessous).
Statut L'etat actuel du cycle de vie du credit.
Expire le Horodatage d'expiration facultatif. Passe cette date, les minutes restantes ne peuvent plus etre utilisees.
ID d'achat Si ce credit a ete cree a partir d'un achat de forfait de campagne, une reference vers cet enregistrement d'achat.

Types de credit

Chaque credit de temps suit la maniere dont il a ete cree :

Type de credit Description
Paye Le membre a paye ces minutes, soit par un achat direct, soit comme droit de base d'un forfait de campagne.
Bonus Minutes promotionnelles accordees en bonus avec un achat de forfait. Par exemple : "achetez 120 minutes, obtenez 30 minutes bonus gratuites."
Manuel Minutes ajoutees manuellement par un caissier ou un administrateur. Utilise pour les credits de bonne volonte, les compensations ou les arrangements speciaux.

Statut du credit

Chaque credit de temps passe par les etats suivants :

  • Actif : le credit dispose de minutes restantes et n'a pas expire. Les minutes peuvent etre consommees a partir de ce credit.
  • Expire : la date d'expiration du credit est passee. Les minutes restantes ne sont plus utilisables, meme si le solde est superieur a zero.
  • Consomme : les minutes restantes du credit ont atteint zero par utilisation normale.
  • Annule : le credit a ete annule manuellement par un administrateur, invalidant toutes les minutes restantes.

Restrictions d'appareil

Chaque credit de temps possede une restriction d'appareil qui controle quels types d'appareils peuvent deduire de ce credit :

Restriction Signification
Client Utilisable sur les PC clients. Egalement utilisable sur les consoles, sauf restriction explicite.
Console Utilisable sur les consoles de jeux. Egalement utilisable sur les PC, sauf restriction explicite.
PC uniquement Utilisable exclusivement sur les PC clients. Les sessions console ne peuvent pas deduire de ce credit.
Consoles uniquement Utilisable exclusivement sur les consoles de jeux. Les sessions PC ne peuvent pas deduire de ce credit.
Les deux Utilisable sur tout type d'appareil sans restriction. C'est la valeur par defaut.

La restriction d'appareil est definie lors de la creation du credit et ne peut pas etre modifiee par la suite. La restriction est generalement heritee de la definition du forfait de campagne qui a genere le credit.

Suivi de la consommation

Chaque fois que des minutes sont deduites d'un credit de temps, le systeme cree un enregistrement de consommation de temps :

Champ Description
Minutes consommees Le nombre de minutes deduites lors de cet evenement de consommation. Toujours un entier positif.
Consomme le L'horodatage de la deduction.
Contexte Ce qui a declenche la deduction (voir ci-dessous).
Reference Une reference vers la session, le credit ou l'ajustement specifique qui a provoque la deduction.

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 retirees lorsqu'un credit expire ou lorsque les minutes restantes sont ajustees suite a un evenement d'expiration.
Remboursement Minutes restituees au credit dans le cadre d'un processus de remboursement (enregistre comme une consommation negative ou une nouvelle entree de credit).

Integration avec les forfaits de campagne

Les credits de temps sont le plus souvent crees via les achats de forfaits de campagne :

  1. Un proprietaire cree une campagne avec un ou plusieurs forfaits de type "minutes".
  2. Un membre selectionne et achete un forfait (depuis le panneau Membre cote client ou aupres d'un caissier au comptoir).
  3. Le systeme cree les credits de temps appropries :
    • Un credit paye pour le droit de base en minutes (le montant de base du forfait).
    • Si le forfait definit un type de bonus "minutes" avec un montant bonus superieur a zero, un credit bonus distinct est cree pour les minutes bonus.
  4. Les credits heritent du parametre de restriction d'appareil du forfait.
  5. Si le forfait a une periode de validite definie, la date d'expiration du credit est calculee a partir de la date d'achat plus le nombre de jours de validite.

Deduction du temps durant les sessions

Lorsqu'un membre disposant de minutes de temps demarre une session :

  1. Le systeme recherche les credits de temps actifs correspondant au type d'appareil de la session.
  2. Les credits sont consommes par ordre de date d'expiration (les plus proches de l'expiration en premier) pour minimiser les pertes dues aux credits sur le point d'expirer.
  3. Pendant le deroulement de la session, les minutes sont periodiquement deduites des credits eligibles.
  4. Chaque deduction cree un enregistrement de consommation en tant qu'entree "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 credits de temps couvrent autant de minutes que disponibles et tout depassement est reporte sur le solde du portefeuille ou le paiement en especes.