HandyCafe Docs
admin

Операції з ліцензіями в панелі адміністратора Cloud

Уповноважені адміністратори платформи HandyCafe керують комерційним доступом клієнта зі сторінки деталей клієнта. Сторінка починається з огляду облікового запису, стану профілю, стану живого з'єднання та кількості ліцензій Genesis. Кожна ліцензія Genesis має одну картку операцій, де показано її поточний план, ліміти ПК і консолей, баланс AI, баланс учасника, доступ до додаткових служб та стан Stripe.

Застарілі та бета-інструменти винесено в окремий згортаний розділ. Активність перевірок зв'язку та зміни профілю доступні в розділі діагностики й історії змін. Так поточний робочий процес Genesis лишається на видноті, а старіші інструменти підтримки нікуди не зникають.

Перегляд усіх ліцензій Genesis

Відкрийте розділ Ліцензії у внутрішній панелі адміністратора. Вкладка Genesis відкривається за замовчуванням і показує лише чинні плани Free та Genesis. Раніше видані ліцензії Beta лишаються на окремій вкладці Beta.

Зведені картки показують загальну кількість ліцензій, а також кількість активних, платних і безкоштовних. У списку можна шукати за кафе, обліковим записом, електронною поштою, планом або ключем ліцензії. Адміністратори також можуть фільтрувати за типом плану чи станом. У кожному рядку видно місткість, доступ до Cloud і Кафетерії, баланс AI, термін дії та стан. Натисніть Керувати, щоб відкрити робочу область клієнта для операцій із планом, службами, кредитами та оплатою.

Створення першої ліцензії Genesis

Коли в обліковому записі немає жодної ліцензії Genesis, сторінка деталей клієнта показує форму створення ліцензії замість порожнього результату. Виберіть активний план Genesis і майбутню дату завершення. Перевірте план, дату завершення та країну в діалозі підтвердження. Натисніть Створити ліцензію, щоб призначити її безпосередньо обліковому запису клієнта.

До створення в обліковому записі мають бути вказані назва кафе та країна. Натисніть Редагувати профіль, щоб додати відсутні дані. План визначає ліміти і для ПК, і для консолей. Вибрана дата завершення чинна до кінця відповідної доби за UTC.

Доступні операції

  • Призначення плану Genesis. Ручні ліцензії отримують місткість і дату завершення вибраного плану. Підписки під керуванням Stripe працюють за звичайними правилами підвищення та зниження плану, включно з негайним списанням або запланованими змінами.
  • Керування Cloud і Кафетерією. Право на Cloud оновлюється в самій ліцензії. Увімкнення Кафетерії також створює або повторно активує відповідний обліковий простір на handy.cafe, а вимкнення призупиняє його. Ці дві служби ніколи не синхронізуються, поки утримується блокування бази даних.
  • Нарахування кредиту AI. Розділ кредитних операцій показує поточний баланс AI вибраної ліцензії до того, як адміністратор введе суму поповнення. Нарахування додає передплачений кредит у доларах США до гаманця AI та створює запис в аудиті.
  • Нарахування кредиту учаснику. Додає бонусний кредит до облікового запису учасника HandyCafe з такою самою адресою електронної пошти. Операція недоступна, якщо відповідного учасника немає.
  • Зміна дати наступного списання. Для підписок Stripe дата оновлюється у Stripe, а потім синхронізується з локальною підпискою та ліцензією. Заплановану зміну плану потрібно спершу скасувати.
  • Повернення платежу. Адміністратор вибирає списання Stripe, яке підлягає поверненню, зазначає причину зі списку Stripe, вводить обов'язкове внутрішнє пояснення та підтверджує повернення. Повернення не скасовує підписку й не забирає доступ до продукту.

Захист і поведінка аудиту

Кожна дія, що змінює дані, потребує підтвердження в панелі. Серверні операції з високим впливом обмежені адміністраторським ключем API, перевіряють належність списань Stripe та створюють аудитний запис, доступний лише для дописування. Історія платежів завантажується тільки на запит і обмежена останніми списаннями. Повернення використовують унікальний ключ ідемпотентності, щоб запобігти випадковому повторному надсиланню.

Якщо для старої ліцензії вже неможливо відновити ключ у відкритому вигляді, автоматичне створення Кафетерії безпечно припиняється, а панель повідомляє, що адміністратор має спершу залагодити облікові дані ліцензії.

Префікси країни в ключах ліцензій

Нові ключі ліцензій, прив'язані до облікового запису, використовують дволітерний код країни із заповненого профілю клієнта, наприклад GEN-TR-... для ліцензії Genesis, створеної адміністратором, або HC-TR-... для ліцензії облікового запису без прив'язки до плану. Створення адміністратором зупиняється, якщо в профілі немає дійсної країни. Система ніколи не створює новий ключ GEN-XX-... чи HC-XX-....

Оновлення поля країни в наявній ліцензії не змінює її активний ключ непомітно. Адміністратори мають узгоджувати виправлення країни та заміну ключа, адже після зміни облікових даних встановлений сервер повинен увійти повторно.