HandyCafe Docs
admin

Operațiuni de licențiere în administrarea Cloud

Administratorii autorizați ai platformei HandyCafe pot gestiona accesul comercial al unui client din pagina de detalii a clientului. Pagina începe cu o prezentare generală a contului, starea profilului, starea conexiunii live și numărul de licențe Genesis. Fiecare licență Genesis are un card de operațiuni care afișează planul curent, limitele de PC-uri și de console, soldul AI, soldul de membru, accesul la serviciile suplimentare și starea Stripe.

Instrumentele legacy și cele de beta sunt păstrate într-o secțiune extensibilă separată. Activitatea de ping și modificările de profil sunt disponibile în secțiunile Diagnosticare și Istoricul modificărilor. Astfel, fluxul Genesis actual rămâne vizibil fără a elimina instrumentele de asistență mai vechi.

Vizualizarea tuturor licențelor Genesis

Deschideți Licențe în tabloul de bord intern de administrare. Fila Genesis se deschide implicit și listează doar planurile Free și Genesis curente. Acordările Beta istorice rămân în fila separată Beta.

Cardurile de rezumat afișează numărul total de licențe și numărul celor active, plătite și gratuite. Lista poate fi căutată după cafenea, cont, e-mail, plan sau cheie de licență. Administratorii pot filtra și după tipul planului sau după stare. Fiecare rând afișează capacitatea, accesul la Cloud și Cafenea, soldul AI, valabilitatea și starea. Selectați Gestionează pentru a deschide spațiul de lucru al clientului, unde se realizează operațiunile de plan, de servicii, de credite și de facturare.

Crearea primei licențe Genesis

Când un cont nu are nicio licență Genesis, pagina de detalii a clientului afișează un formular de creare a licenței în loc de un rezultat gol. Selectați un plan Genesis activ și o dată de expirare viitoare. Verificați planul, expirarea și țara în dialogul de confirmare. Selectați Creează licența pentru a o atribui direct contului clientului.

Contul trebuie să aibă un nume de cafenea și o țară înainte de creare. Selectați Editează profilul pentru a completa datele lipsă. Planul definește deopotrivă limita de PC-uri și limita de console. Data de expirare selectată este valabilă până la sfârșitul acelei zile UTC.

Operațiuni disponibile

  • Atribuirea unui plan Genesis. Licențele manuale primesc capacitatea și data de expirare ale planului selectat. Abonamentele gestionate prin Stripe respectă regulile obișnuite de upgrade și downgrade, inclusiv taxarea imediată sau modificările programate.
  • Gestionarea serviciilor Cloud și Cafenea. Dreptul de acces Cloud este actualizat pe licență. Activarea Cafenelei creează sau reactivează și tenantul corespunzător pe handy.cafe; dezactivarea suspendă acel tenant. Cele două servicii nu sunt niciodată sincronizate cât timp este menținut un blocaj pe baza de date.
  • Acordarea de credit AI. Secțiunea de operațiuni cu credite afișează soldul AI curent al licenței selectate înainte ca administratorul să introducă o alimentare. Acordarea de credit adaugă credit preplătit în USD în portofelul AI și înregistrează o intrare de audit.
  • Acordarea de credit pentru membru. Adaugă credit bonus în contul de membru HandyCafe cu aceeași adresă de e-mail. Operațiunea nu este disponibilă când nu există un membru corespunzător.
  • Modificarea următoarei date de facturare. Pentru abonamentele Stripe, data este actualizată în Stripe și apoi sincronizată cu abonamentul și cu licența locale. O modificare de plan programată trebuie anulată mai întâi.
  • Rambursarea unei plăți. Administratorul selectează o tranzacție Stripe rambursabilă, alege un motiv Stripe, introduce o explicație internă obligatorie și confirmă rambursarea. Rambursarea nu anulează abonamentul și nu retrage accesul la produs.

Comportamentul de siguranță și de audit

Fiecare acțiune care modifică date necesită confirmare în tabloul de bord. Operațiunile de backend cu impact ridicat sunt restricționate prin cheia API de administrare, validează dreptul de proprietate asupra tranzacțiilor Stripe și scriu o intrare într-un jurnal de audit care permite doar adăugări. Istoricul plăților este încărcat doar la cerere și este limitat la tranzacțiile recente. Rambursările folosesc o cheie de idempotență unică pentru a preveni trimiterile duplicate accidentale.

Dacă o licență veche nu mai are o cheie în text clar recuperabilă, provizionarea automată a Cafenelei eșuează în siguranță, iar tabloul de bord anunță că un administrator trebuie să rezolve mai întâi credențialul licenței.

Prefixele de țară din licențe

Cheile de licență noi, legate de cont, folosesc codul de țară din două litere preluat din profilul completat al clientului, de exemplu GEN-TR-... pentru o licență Genesis creată de administrator sau HC-TR-... pentru o licență de cont neutră față de plan. Crearea de către administrator se oprește când profilul nu are o țară validă. Sistemul nu creează niciodată o cheie nouă de tip GEN-XX-... sau HC-XX-....

Actualizarea câmpului de țară pe o licență existentă nu îi rotește tacit cheia activă. Administratorii trebuie să coordoneze corectarea țării cu rotirea cheii, deoarece serverul instalat trebuie să se autentifice din nou după schimbarea credențialului său.