MuseMVP 文档
管理员后台

用户管理

管理员用户管理页的入口、权限、可用操作与关键实现文件。

用户管理页用于查看与管理站内用户,包含搜索、分页、角色管理、删除。

API 架构

访问入口

页面路径:/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/,包括 CreateUserDialogEditUserDialogBanUserDialogSetPasswordDialogUserSessionsDialog,操作入口统一挂在 UserActionsMenu
  • 用户列表响应在 src/backend/api/routes/admin/serialize-admin-users.ts 中为每个用户附带计费合约数据,扩展列表字段可从这里入手。
  • 模拟登录期间的常驻提示与退出按钮由 src/modules/layout/default/components/ImpersonationBanner.tsx 渲染。
  • 升级逻辑依赖产品配置,调整前先检查 src/config/index.tssrc/config/saas/pricing-desc-usage.ts

On this page

Ship your startup everywhere.
In minutes.

Get MuseMVP