Operazioni sulle Licenze da Amministratore Cloud
Gli amministratori autorizzati della piattaforma HandyCafe possono gestire l'accesso commerciale di un cliente dalla pagina di dettaglio del cliente. La pagina si apre con una panoramica dell'account, lo stato del profilo, lo stato della connessione in tempo reale e il numero di licenze Genesis. Ogni licenza Genesis ha una scheda operativa che mostra il piano attuale, i limiti di PC e console, il saldo AI, il saldo membri, l'accesso ai moduli aggiuntivi e lo stato Stripe.
Gli strumenti legacy e beta sono raccolti in una sezione espandibile separata. L'attività di ping e le modifiche al profilo sono disponibili nella sezione Diagnostica e cronologia delle modifiche. In questo modo il flusso Genesis attuale resta in primo piano senza rimuovere i vecchi strumenti di supporto.
Vedere tutte le licenze Genesis
Apri Licenze nella dashboard di amministrazione interna. La scheda Genesis si apre per impostazione predefinita ed elenca solo i piani Free e Genesis attuali. Le concessioni Beta storiche restano nella scheda Beta separata.
Le schede di riepilogo mostrano il numero di licenze totali, attive, a pagamento e gratuite. È possibile cercare nell'elenco per cafe, account, email, piano o chiave di licenza. Gli amministratori possono anche filtrare per tipo di piano o per stato. Ogni riga mostra capacità, accesso a Cloud e Caffetteria, saldo AI, validità e stato. Seleziona Gestisci per aprire l'area di lavoro del cliente e svolgere le operazioni su piano, servizi, credito e fatturazione.
Creare la prima licenza Genesis
Quando un account non ha nessuna licenza Genesis, la pagina di dettaglio del cliente mostra un modulo di creazione della licenza invece di un risultato vuoto. Seleziona un piano Genesis attivo e una data di scadenza futura. Controlla piano, scadenza e paese nella finestra di conferma. Seleziona Crea licenza per assegnarla direttamente all'account del cliente.
Prima della creazione l'account deve avere un nome del cafe e un paese. Seleziona Modifica profilo per aggiungere i dati mancanti. Il piano definisce sia il limite di PC sia quello di console. La data di scadenza selezionata è valida fino alla fine di quel giorno UTC.
Operazioni disponibili
- Assegnare un piano Genesis. Le licenze manuali ricevono la capacità e la data di scadenza del piano selezionato. Gli abbonamenti gestiti da Stripe seguono le normali regole di upgrade e downgrade, compresi gli addebiti immediati o le modifiche programmate.
- Gestire Cloud e Caffetteria. L'abilitazione Cloud viene aggiornata sulla licenza. Attivando la Caffetteria viene anche creato o riattivato il tenant corrispondente su
handy.cafe; disattivandola quel tenant viene sospeso. I due servizi non vengono mai sincronizzati mentre è in corso un blocco del database. - Assegnare credito AI. La sezione Operazioni sul credito mostra il saldo AI attuale della licenza selezionata prima che l'amministratore inserisca una ricarica. L'assegnazione aggiunge credito prepagato in USD al portafoglio AI e registra una voce di audit.
- Assegnare credito membro. Aggiunge credito bonus all'account membro HandyCafe con lo stesso indirizzo email. L'operazione non è disponibile quando non esiste un membro corrispondente.
- Modificare la data del prossimo addebito. Per gli abbonamenti Stripe la data viene aggiornata in Stripe e poi sincronizzata con l'abbonamento e la licenza locali. Un cambio di piano già programmato va prima annullato.
- Rimborsare un pagamento. L'amministratore seleziona un addebito Stripe rimborsabile, sceglie un motivo Stripe, inserisce una spiegazione interna obbligatoria e conferma il rimborso. Il rimborso non annulla l'abbonamento e non rimuove l'accesso al prodotto.
Sicurezza e comportamento dell'audit
Ogni azione che modifica dati richiede una conferma nella dashboard. Le operazioni di backend a forte impatto sono protette dalla chiave API di amministrazione, verificano la titolarità degli addebiti Stripe e scrivono una registrazione di audit in sola aggiunta. La cronologia dei pagamenti viene caricata solo su richiesta ed è limitata agli addebiti recenti. I rimborsi usano una chiave di idempotenza univoca per evitare invii duplicati accidentali.
Se una vecchia licenza non ha più una chiave in chiaro recuperabile, il provisioning automatico della Caffetteria si blocca in sicurezza e la dashboard segnala che un amministratore deve prima risolvere il problema delle credenziali della licenza.
Prefissi paese delle licenze
Le nuove chiavi di licenza legate a un account usano il codice paese di due lettere presente nel profilo completato del cliente, ad esempio GEN-TR-... per una licenza Genesis creata da un amministratore oppure HC-TR-... per una licenza di account indipendente dal piano. La creazione da parte dell'amministratore si interrompe quando il profilo non ha un paese valido. Il sistema non crea mai una nuova chiave GEN-XX-... o HC-XX-....
L'aggiornamento del campo paese su una licenza esistente non ne ruota silenziosamente la chiave attiva. Gli amministratori devono coordinare la correzione del paese e la rotazione della chiave perché il server installato deve accedere di nuovo dopo la modifica delle sue credenziali.