用户与账号
查找账号,查看它持有的内容,分配角色,封禁与恢复,以及修复积分余额。
运营在 /admin/users/dashboard 查看单个账号:买了什么、持有什么、为什么无法登录。这个页面不是 CRM,没有关于客户的自由文本备注,只显示产品写入的数据行。
准备工作
- 打开目录和详情页需要
users.read,修改状态需要users.write,修改角色需要roles.write。见角色与权限。 - 这三个权限相互独立,可以分别授予。客服通常需要第一个,偶尔需要第二个,不需要第三个。
设置
打开目录
/admin/users/dashboard 列出账号及其状态和角色,可按姓名或邮箱搜索。
打开一个账号
/admin/users/$userId 显示这个账号的角色、访问状态、许可证、积分余额和近期活动。这些数据行与客户在 /app 看到的相同,通过同一批仓储读取。
封禁与恢复
被封禁的账号保留所有数据,失去会话。守卫在布局层拒绝该账号,所以 /app 和 /admin 的每个页面都无法访问,不需要逐页检查。恢复账号即解除封禁,期间不删除任何数据。
修复积分余额
如果账本和缓存余额不一致,adminRepairUserCreditBalance({ userId }) 根据账本条目重新计算余额。它对应详情页上的按钮,需要 credits.write。用户无法调用它,也没有任何由用户写入余额的途径。
账号状态
Prop
Type
users-rbac.ts 中每个服务端操作都通过 requireAdminPermission 校验权限。能看到页面不代表有权限执行操作。
验证
- 用只有
users.read的角色打开/admin/users/dashboard。列表正常显示,封禁操作被拒绝。 - 封禁一个账号,然后用这个账号打开
/app。布局层拒绝该账号,/app下的页面都打不开。 - 恢复账号。同一个账号能重新登录,许可证和积分保持不变。
- 给账号加一个角色并刷新详情页,权限列表是它各角色的并集。
参考
- 角色与权限
- 认证:身份在哪里解析
- Better Auth:用户与账号