管理员后台
用户管理
管理员用户管理页的入口、权限、可用操作与关键实现文件。
用户管理页用于查看与管理站内用户,包含搜索、分页、角色管理、删除。

访问入口
页面路径:/app/admin/users
页面能力
- 用户列表(分页 + 搜索,附带计费合约信息展示)
- 创建用户
- 编辑用户资料
- 设置密码
- 封禁/解封(支持
banReason封禁原因与banExpiresIn封禁期限) - session 管理(查看活跃 session,吊销单个或全部)
- impersonate 模拟登录(配合
ImpersonationBanner常驻提示与一键退出) - 分配/移除管理员角色
- 删除用户
扩展建议
- 新增用户维度(例如来源渠道)时,先改 query,再改列定义与筛选。
- 新增管理动作时,优先复用
src/modules/admin-users/hooks/use-user-actions.ts(封装了authClient.admin的各项操作),并在成功后失效用户列表缓存。 - 各操作对话框位于
src/modules/admin-users/components/,包括CreateUserDialog、EditUserDialog、BanUserDialog、SetPasswordDialog、UserSessionsDialog,操作入口统一挂在UserActionsMenu。 - 用户列表响应在
src/backend/api/routes/admin/serialize-admin-users.ts中为每个用户附带计费合约数据,扩展列表字段可从这里入手。 - 模拟登录期间的常驻提示与退出按钮由
src/modules/layout/default/components/ImpersonationBanner.tsx渲染。 - 升级逻辑依赖产品配置,调整前先检查
src/config/index.ts与src/config/saas/pricing-desc-usage.ts。