用户管理

概述

用户管理模块用于管理平台的终端用户。管理员可以创建、编辑、搜索、挂起和删除用户，以及管理用户的角色分配和组织归属。

导航路径: 侧边栏 -> 用户管理

用户列表

用户列表页面展示所有已注册的用户，支持分页浏览和搜索筛选。

列表字段

字段	说明
用户名	用户的唯一标识
邮箱	用户的主要邮箱地址
手机号	用户的主要手机号码
姓名	用户的显示名称
状态	正常 / 已挂起
登录次数	用户累计登录次数
最后登录	最近一次登录时间
创建时间	用户账号创建时间

搜索与筛选

支持以下搜索条件：

• 关键词搜索 (search): 模糊匹配用户名、邮箱、姓名等
• 用户名 (username): 精确匹配用户名
• 邮箱 (primary_email): 精确匹配邮箱
• 手机号 (primary_phone): 精确匹配手机号
• 用户 ID (id): 精确匹配用户 ID

创建用户

点击用户列表页面的 "新建用户" 按钮，进入创建用户页面。

导航路径: 用户管理 -> 新建用户

必填字段

字段	要求
用户名	必填，唯一标识符
密码	必填，最少 6 个字符

可选字段

字段	说明
邮箱	用户的邮箱地址
手机号	用户的手机号码
姓名	用户的显示名称
头像	头像图片 URL

API 调用

POST /api/v1/users

请求示例：

{
  "username": "john_doe",
  "password": "secure123",
  "primary_email": "john@example.com",
  "name": "John Doe"
}

编辑用户

在用户列表中点击用户名或操作列的编辑按钮，进入用户详情编辑页面。

导航路径: 用户管理 -> 编辑用户

编辑页面包含以下标签页：

基本信息标签

可修改用户的以下信息：

• 用户名
• 邮箱
• 手机号
• 姓名
• 头像
• 自定义数据 (custom_data)

角色标签

管理用户关联的角色：

• 查看用户当前已分配的角色列表
• 通过选择角色 ID 列表为用户分配角色
• 移除用户的某个角色

API 调用:

GET /api/v1/users/:id/roles        # 获取用户角色
PUT /api/v1/users/:id/roles        # 设置用户角色

请求示例（设置角色）：

{
  "role_ids": ["role_id_1", "role_id_2"]
}

组织标签

查看用户所属的组织列表（只读视图）：

• 展示用户加入的所有组织
• 显示组织名称、描述和创建时间
• 支持分页浏览

API 调用:

GET /api/v1/users/:id/organizations

重置密码

管理员可以为用户重置登录密码。

操作方式: 在用户编辑页面或用户列表的操作菜单中选择 "重置密码"。

API 调用:

PATCH /api/v1/users/:id/password

请求示例：

{
  "password": "newPassword123"
}

挂起/恢复用户

管理员可以挂起（Suspend）或恢复（Unsuspend）用户账号。被挂起的用户将无法登录系统。

API 调用:

PATCH /api/v1/users/:id/suspend

请求示例：

{
  "is_suspended": true
}

• is_suspended: true - 挂起用户
• is_suspended: false - 恢复用户

删除用户

删除用户将永久移除该用户账号及其关联数据。此操作不可逆。

API 调用:

DELETE /api/v1/users/:id

注意: 删除用户前请确认该用户不再需要访问任何应用资源。删除操作会同时移除用户的角色分配和组织成员关系。