HandyCafe Docs
admin

Операции с лицензиями в облачной админ-панели

Уполномоченные администраторы платформы HandyCafe управляют коммерческим доступом клиента на странице сведений о клиенте. Страница начинается с обзора учетной записи, статуса профиля, текущего состояния соединения и количества лицензий Genesis. У каждой лицензии Genesis есть своя карточка операций, где видны текущий тариф, лимиты по ПК и консолям, баланс ИИ, баланс участника, доступ к дополнительным модулям и состояние в Stripe.

Устаревшие и бета-инструменты вынесены в отдельный раскрывающийся раздел. Активность пингов и изменения профиля доступны в разделе диагностики и истории изменений. Так текущий рабочий процесс Genesis остается на виду, а прежние инструменты поддержки никуда не пропадают.

Просмотр всех лицензий Genesis

Откройте раздел Лицензии во внутренней панели администратора. Вкладка Genesis открывается по умолчанию и показывает только действующие тарифы Free и Genesis. Исторические бета-выдачи остаются на отдельной вкладке Beta.

Сводные карточки показывают общее количество лицензий, а также количество активных, платных и бесплатных. В списке можно искать по названию кафе, учетной записи, электронной почте, тарифу или лицензионному ключу. Администраторы также могут отфильтровать его по типу тарифа или по статусу. В каждой строке видны лимиты, доступ к «Облаку» и «Кафетерию», баланс ИИ, срок действия и статус. Выберите Управление, чтобы открыть рабочую область клиента для операций с тарифом, сервисами, кредитами и выставлением счетов.

Создание первой лицензии Genesis

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

До создания у учетной записи должны быть заполнены название кафе и страна. Выберите Редактировать профиль, чтобы дополнить недостающие данные. Тариф задает лимиты и по ПК, и по консолям. Выбранная дата окончания действует до конца этих суток по UTC.

Доступные операции

  • Назначение тарифа Genesis. Лицензии, созданные вручную, получают лимиты и дату окончания выбранного тарифа. Для подписок, управляемых через Stripe, применяются обычные правила повышения и понижения тарифа, включая немедленное списание или запланированное изменение.
  • Управление «Облаком» и «Кафетерием». Доступ к «Облаку» обновляется в самой лицензии. Включение «Кафетерия» дополнительно создает или повторно активирует соответствующего арендатора на handy.cafe, а отключение приостанавливает его. Эти два сервиса никогда не синхронизируются, пока удерживается блокировка базы данных.
  • Начисление кредита ИИ. Раздел операций с кредитами показывает текущий баланс ИИ выбранной лицензии до того, как администратор введет сумму пополнения. Начисление добавляет предоплаченный кредит в долларах США в кошелек ИИ и создает запись аудита.
  • Начисление кредита участнику. Добавляет бонусный кредит на учетную запись участника HandyCafe с тем же адресом электронной почты. Операция недоступна, если подходящего участника нет.
  • Изменение даты следующего списания. Для подписок Stripe дата сначала обновляется в Stripe, а затем синхронизируется с локальной подпиской и лицензией. Запланированную смену тарифа нужно предварительно отменить.
  • Возврат платежа. Администратор выбирает подлежащее возврату списание в Stripe, указывает причину из списка Stripe, вводит обязательное внутреннее пояснение и подтверждает возврат. Возврат не отменяет подписку и не закрывает доступ к продукту.

Безопасность и аудит

Каждое изменяющее действие требует подтверждения в панели. Наиболее чувствительные серверные операции ограничены административным ключом API, проверяют принадлежность списания в Stripe и создают запись в журнале аудита, который допускает только добавление. История платежей загружается только по запросу и ограничена недавними списаниями. Возвраты используют уникальный ключ идемпотентности, чтобы исключить случайную повторную отправку.

Если у старой лицензии больше нет восстановимого ключа в открытом виде, автоматическая подготовка «Кафетерия» безопасно прерывается, и панель сообщает, что администратору сначала нужно разобраться с учетными данными этой лицензии.

Страновые префиксы лицензий

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

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