用户管理

在用户管理中，管理员可以查看和调整平台所有用户。

能做什么

操作	接口
列出用户	GET /users
更新用户	PUT /users/:id
删除用户	DELETE /users/:id
查看返佣明细	GET /referral-commissions

通过更新用户，通常可以调整：

• 余额：手动增减用户余额（如补偿、线下充值）；
• 分组：调整主分组或分组成员关系，影响计费倍率；
• 管理员标记：把用户提升为管理员或取消；
• 启用/封禁 等状态（以界面提供为准）。

用户的关键属性

属性	说明
username / email	标识，唯一
balance	余额，调用 API 时扣费
group / groups	主分组与多分组成员关系，决定倍率
oidc_sub	绑定的 OIDC subject（如用 OIDC 登录）
referral_code / referrer_id	邀请码与邀请人
is_admin	是否管理员
email_verified	邮箱是否验证

常见运营操作

给用户线下充值后加余额 在用户编辑里增加 balance。建议同时在备注/工单系统留痕，便于对账。

给某用户长期优惠 把他加入一个低倍率分组（可设到期时间实现限时优惠）。

提升管理员 设置 is_admin = true。也可通过 BOOTSTRAP_ADMIN_EMAILS 在登录时自动提升，见 初始化设置。

处理疑似滥用账户 禁用其 API 密钥、调整分组倍率，或按界面提供的封禁能力处理。

删除用户

删除用户会影响其关联数据（密钥、日志、订单等）。删除前确认无未结算事项，必要时先导出其日志留档。此操作不可逆。

邀请返佣明细

GET /referral-commissions 列出全平台的返佣记录，可用于核对邀请返佣的发放情况。每条记录关联触发返佣的消费日志与受益的邀请人。配置见 签到与邀请返佣。