HandyCafe Docs
admin

Cloud 管理员许可证操作

获得授权的 HandyCafe 平台管理员可以在客户详情页管理该客户的商业访问权限。页面开头是账户概览、资料状态、实时连接状态和 Genesis 许可证数量。每个 Genesis 许可证都有一张操作卡片,显示它当前的套餐、PC 与主机上限、AI 余额、会员余额、附加服务访问权限以及 Stripe 状态。

旧版工具和 Beta 工具收纳在一个可展开的独立区块中。Ping 活动和资料变更记录可在诊断与变更历史中查看。这样既能突出当前的 Genesis 工作流程,又不必移除较早的支持工具。

查看所有 Genesis 许可证

在内部管理仪表板中打开许可证页面。Genesis 标签页默认打开,列出当前的 Genesis 套餐和 14 天试用。2026 年 7 月 24 日停用的免费方案遗留下来的许可证标为 Free (retired),并保持锁定。历史上发放的 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-... 这样的密钥。

修改现有许可证上的国家/地区字段,不会悄悄轮换它正在使用的密钥。管理员必须统筹安排国家/地区更正和密钥轮换,因为已安装的服务端在凭据变更之后必须重新登录。