HandyCafe Docs
admin

クラウド管理者のライセンス運用

権限を持つHandyCafeプラットフォーム管理者は、顧客詳細ページから顧客の商用アクセスを管理できます。ページの冒頭には、アカウントの概要、プロフィールの状態、ライブ接続状態、Genesisライセンス数が表示されます。Genesisライセンスごとに運用カードが1枚あり、現在のプラン、PCとコンソールの上限、AI残高、メンバー残高、アドオンの利用状況、Stripeの状態が示されます。

レガシー機能とベータ機能は、折りたたみ可能な別のセクションにまとめられています。Pingの記録とプロフィールの変更内容は、診断と変更履歴のセクションで確認できます。これにより、従来のサポート機能を残したまま、現行のGenesisワークフローを見やすく保っています。

すべてのGenesisライセンスを表示する

社内の管理ダッシュボードでライセンスを開きます。既定ではGenesisタブが開き、現行のFreeプランとGenesisプランのみが一覧表示されます。過去に付与されたベータライセンスは、別のベータタブに残ります。

サマリーカードには、ライセンスの総数、有効数、有料数、無料数が表示されます。一覧はカフェ、アカウント、メールアドレス、プラン、ライセンスキーで検索できます。管理者はプラン種別やステータスで絞り込むこともできます。各行には、収容台数、クラウドとカフェテリアの利用状況、AI残高、有効期限、ステータスが表示されます。管理を選択すると、プラン、サービス、クレジット、請求の各操作を行う顧客ワークスペースが開きます。

最初のGenesisライセンスを作成する

アカウントにGenesisライセンスがない場合、顧客詳細ページには空の結果ではなくライセンス作成フォームが表示されます。有効なGenesisプランと将来の有効期限を選択します。確認ダイアログでプラン、有効期限、国を確認し、ライセンスを作成を選択すると、顧客アカウントに直接割り当てられます。

作成の前に、アカウントにカフェ名と国が設定されている必要があります。不足している情報はプロフィールを編集から追加します。プランによってPCとコンソールの両方の上限が決まります。選択した有効期限は、そのUTC日の終わりまで有効です。

実行できる操作

  • Genesisプランの割り当て。 手動で作成したライセンスには、選択したプランの収容台数と有効期限が設定されます。Stripeで管理されているサブスクリプションは、即時課金や変更予約を含む通常のアップグレードとダウングレードの規則に従います。
  • クラウドとカフェテリアの管理。 クラウドの利用権はライセンス側で更新されます。カフェテリアを有効にすると、handy.cafe 上の対応するテナントも作成または再有効化されます。無効にすると、そのテナントは停止されます。この2つのサービスは、データベースロックを保持したまま同期されることはありません。
  • AIクレジットの付与。 クレジット操作のセクションには、管理者がチャージ額を入力する前に、選択中のライセンスの現在のAI残高が表示されます。クレジットを付与すると、前払いのUSDクレジットがAIウォレットに追加され、監査記録が残ります。
  • メンバークレジットの付与。 同じメールアドレスを持つHandyCafeメンバーアカウントにボーナスクレジットを追加します。該当するメンバーが存在しない場合、この操作は利用できません。
  • 次回請求日の変更。 Stripeサブスクリプションの場合、日付はStripe側で更新されてから、ローカルのサブスクリプションとライセンスに同期されます。変更予約中のプラン変更がある場合は、先にそれをキャンセルする必要があります。
  • 支払いの返金。 管理者は返金可能なStripeの支払いを選び、Stripeの理由を選択し、社内向けの説明（必須）を入力して返金を確定します。返金してもサブスクリプションは解約されず、製品へのアクセスも失われません。

安全性と監査の挙動

データを変更する操作はすべて、ダッシュボード上で確認が求められます。影響の大きいバックエンド操作は管理APIキーによって制限され、Stripeの支払いの所有権を検証し、追記のみの監査記録を書き込みます。支払い履歴は要求されたときにのみ読み込まれ、直近の支払いに限定されます。返金には一意の冪等キーが使われ、誤った二重送信を防ぎます。

古いライセンスで平文のキーを復元できない場合、カフェテリアの自動プロビジョニングは安全側に倒れて失敗し、管理者が先にライセンスの資格情報を解決する必要がある旨がダッシュボードに表示されます。

ライセンスキーの国コード接頭辞

新しくアカウントに紐付けられるライセンスキーには、顧客の入力済みプロフィールにある2文字の国コードが使われます。管理者が作成したGenesisライセンスであれば GEN-TR-...、プランに依存しないアカウントライセンスであれば HC-TR-... のような形式になります。プロフィールに有効な国が設定されていない場合、管理者による作成は中止されます。GEN-XX-... や HC-XX-... のようなキーがシステムによって作成されることはありません。

既存ライセンスの国フィールドを更新しても、有効なキーが自動的に入れ替わることはありません。資格情報が変わるとインストール済みサーバーは再度サインインする必要があるため、管理者は国の修正とキーのローテーションを合わせて調整してください。