Cloud 管理员许可证操作
获得授权的 HandyCafe 平台管理员可以在客户详情页管理该客户的商业访问权限。页面开头是账户概览、资料状态、实时连接状态和 Genesis 许可证数量。每个 Genesis 许可证都有一张操作卡片，显示它当前的套餐、PC 与主机上限、AI 余额、会员余额、附加服务访问权限以及 Stripe 状态。
旧版工具和 Beta 工具收纳在一个可展开的独立区块中。Ping 活动和资料变更记录可在诊断与变更历史中查看。这样既能突出当前的 Genesis 工作流程，又不必移除较早的支持工具。
查看所有 Genesis 许可证
在内部管理仪表板中打开许可证页面。Genesis 标签页默认打开，只列出当前的 Free 和 Genesis 套餐。历史上发放的 Beta 授权仍保留在单独的 Beta 标签页中。
摘要卡片显示许可证总数，以及有效、付费和免费许可证的数量。列表可以按网咖、账户、邮箱、套餐或许可证密钥搜索。管理员还可以按套餐类型或状态筛选。每一行显示容量、Cloud 与咖啡厅访问权限、AI 余额、有效期和状态。选择管理即可打开该客户的工作区，进行套餐、服务、额度和账单操作。
创建第一个 Genesis 许可证
当某个账户还没有 Genesis 许可证时，客户详情页会显示许可证创建表单，而不是空白结果。选择一个处于启用状态的 Genesis 套餐和一个未来的到期日期。在确认对话框中核对套餐、到期日期和国家/地区。选择创建许可证，即可把它直接分配给该客户账户。
创建之前，账户必须已填写网咖名称和国家/地区。选择编辑资料补全缺失信息。套餐同时决定 PC 上限和主机上限。所选到期日期在该 UTC 日结束之前均有效。
可用操作
- 分配 Genesis 套餐。 手动创建的许可证会获得所选套餐的容量和到期日期。由 Stripe 管理的订阅遵循常规的升级和降级规则，包括立即扣费或已排期的变更。
- 管理 Cloud 与咖啡厅。 Cloud 权限直接更新在许可证上。启用咖啡厅还会在
handy.cafe上开通或重新启用对应的租户；停用则会暂停该租户。这两项服务绝不会在持有数据库锁期间同步。 - 发放 AI 额度。 在管理员输入充值金额之前，额度操作区会先显示所选许可证的当前 AI 余额。发放操作会向 AI 钱包充入预付的美元余额，并记录一条审计条目。
- 发放会员赠送余额。 向邮箱地址相同的 HandyCafe 会员账户添加赠送余额。当找不到匹配的会员时，该操作不可用。
- 修改下一个账单日期。 对于 Stripe 订阅，日期先在 Stripe 中更新，然后同步到本地订阅和许可证。如果已经安排了套餐变更，必须先取消该变更。
- 退还一笔付款。 管理员选择一笔可退款的 Stripe 扣款，选定 Stripe 退款原因，填写必填的内部说明，然后确认退款。退款不会取消订阅，也不会收回产品访问权限。
安全与审计行为
仪表板中的每一项变更操作都需要确认。影响面较大的后端操作受管理员 API 密钥限制，会校验 Stripe 扣款的归属关系，并写入只可追加的审计记录。付款历史只在请求时才加载，并且限定在最近的扣款范围内。退款使用唯一的幂等键，防止意外重复提交。
如果某个旧许可证已经无法恢复其明文密钥，咖啡厅的自动开通会直接失败而不放行，仪表板会提示管理员必须先解决该许可证的凭据问题。
许可证国家/地区前缀
新的账户绑定许可证密钥使用客户已完善资料中的两位国家/地区代码，例如管理员创建的 Genesis 许可证为 GEN-TR-...，与套餐无关的账户许可证为 HC-TR-...。当资料中没有有效的国家/地区时，管理员创建流程会中止。系统绝不会创建 GEN-XX-... 或 HC-XX-... 这样的密钥。
修改现有许可证上的国家/地区字段，不会悄悄轮换它正在使用的密钥。管理员必须统筹安排国家/地区更正和密钥轮换，因为已安装的服务端在凭据变更之后必须重新登录。