Opérations de licence dans l'administration Cloud

Les administrateurs autorisés de la plateforme HandyCafe gèrent les accès commerciaux d'un client depuis la page de détail de ce client. La page s'ouvre sur une vue d'ensemble du compte, l'état du profil, l'état de connexion en direct et le nombre de licences Genesis. Chaque licence Genesis dispose d'une carte d'opérations qui indique son forfait actuel, ses limites de PC et de consoles, son solde IA, son solde membre, l'accès aux modules complémentaires et son état Stripe.

Les outils hérités et bêta sont regroupés dans une section dépliable distincte. L'activité de ping et les modifications de profil se consultent sous Diagnostics et historique des modifications. Le flux Genesis actuel reste ainsi visible sans que les anciens outils d'assistance soient supprimés.

Consulter toutes les licences Genesis

Ouvrez Licences dans le tableau de bord d'administration interne. L'onglet Genesis s'ouvre par défaut et ne liste que les forfaits Free et Genesis en cours. Les attributions Beta historiques restent dans l'onglet Beta distinct.

Les cartes de synthèse affichent le nombre total de licences ainsi que le nombre de licences actives, payantes et gratuites. La recherche dans la liste porte sur le café, le compte, l'e-mail, le forfait ou la clé de licence. Les administrateurs peuvent également filtrer par type de forfait ou par statut. Chaque ligne indique la capacité, l'accès Cloud et Cafétéria, le solde IA, la validité et le statut. Sélectionnez Gérer pour ouvrir l'espace de travail du client dédié aux opérations de forfait, de service, de crédit et de facturation.

Créer la première licence Genesis

Lorsqu'un compte ne possède aucune licence Genesis, la page de détail du client affiche un formulaire de création de licence au lieu d'un résultat vide. Sélectionnez un forfait Genesis actif et une date d'expiration future. Vérifiez le forfait, l'expiration et le pays dans la boîte de dialogue de confirmation. Sélectionnez Créer la licence pour l'attribuer directement au compte client.

Le compte doit disposer d'un nom de café et d'un pays avant la création. Sélectionnez Modifier le profil pour compléter les informations manquantes. Le forfait définit à la fois les limites de PC et de consoles. La date d'expiration choisie reste valable jusqu'à la fin de cette journée UTC.

Opérations disponibles

Attribuer un forfait Genesis. Les licences manuelles reçoivent la capacité et la date d'expiration du forfait sélectionné. Les abonnements gérés par Stripe suivent les règles habituelles de changement de forfait à la hausse ou à la baisse, y compris les débits immédiats ou les changements programmés.
Gérer Cloud et Cafétéria. Le droit d'accès Cloud est mis à jour sur la licence. Activer Cafétéria provisionne ou réactive également le locataire correspondant sur handy.cafe ; le désactiver suspend ce locataire. Les deux services ne sont jamais synchronisés pendant qu'un verrou de base de données est détenu.
Accorder du crédit IA. La section des opérations de crédit affiche le solde IA actuel de la licence sélectionnée avant que l'administrateur ne saisisse une recharge. L'octroi de crédit ajoute du crédit prépayé en USD au portefeuille IA et enregistre une entrée d'audit.
Accorder du crédit membre. Ajoute du crédit bonus au compte membre HandyCafe portant la même adresse e-mail. L'opération est indisponible lorsqu'aucun membre correspondant n'existe.
Modifier la prochaine date de facturation. Pour les abonnements Stripe, la date est mise à jour dans Stripe puis synchronisée avec l'abonnement et la licence locaux. Un changement de forfait déjà programmé doit d'abord être annulé.
Rembourser un paiement. L'administrateur sélectionne un débit Stripe remboursable, choisit un motif Stripe, saisit une explication interne obligatoire et confirme le remboursement. Le remboursement n'annule pas l'abonnement et ne retire pas l'accès au produit.

Sécurité et comportement d'audit

Chaque action modifiant des données exige une confirmation dans le tableau de bord. Les opérations backend à fort impact sont restreintes par la clé d'API d'administration, vérifient la propriété des débits Stripe et écrivent un enregistrement d'audit en ajout seul. L'historique des paiements n'est chargé que sur demande et se limite aux débits récents. Les remboursements utilisent une clé d'idempotence unique afin d'éviter les envois en double accidentels.

Si une ancienne licence ne dispose plus d'une clé en clair récupérable, le provisionnement automatique de Cafétéria échoue par sécurité et le tableau de bord signale qu'un administrateur doit d'abord corriger l'identifiant de la licence.

Préfixes de pays des licences

Les nouvelles clés de licence liées à un compte utilisent le code pays à deux lettres issu du profil client complété, par exemple GEN-TR-... pour une licence Genesis créée par un administrateur ou HC-TR-... pour une licence de compte indépendante du forfait. La création par un administrateur s'interrompt lorsque le profil ne comporte aucun pays valide. Le système ne crée jamais de clé GEN-XX-... ou HC-XX-....

Modifier le champ pays d'une licence existante ne déclenche pas silencieusement la rotation de sa clé active. Les administrateurs doivent coordonner la correction du pays et la rotation de la clé car le serveur installé doit se reconnecter après le changement de son identifiant.