307 lines
8.3 KiB
Markdown
307 lines
8.3 KiB
Markdown
# 用户管理
|
||
|
||
## 1. 功能概述
|
||
|
||
用户管理模块用于管理系统用户账号和角色权限，实现用户的增删改查、角色分配、密码管理以及权限配置功能。
|
||
|
||
**核心功能：**
|
||
|
||
- 用户账号管理：创建、编辑、删除用户账号
|
||
- 用户状态控制：启用/禁用用户账号
|
||
- 角色管理：创建、编辑、删除角色（用户组）
|
||
- 权限分配：为角色分配菜单和API权限
|
||
- 密码管理：修改密码、重置密码
|
||
|
||
**功能对应截图** ：
|
||
|
||
|
||
|
||
## 2. 术语说明
|
||
|
||
#### 2.1.1 用户管理术语
|
||
|
||
| 术语 | 定义 | 说明 |
|
||
|------|------|------|
|
||
| 用户组/角色 | 用户所属的权限分组 | 同一角色的用户拥有相同权限 |
|
||
| 出入证编号 | 用户的证件编号 | 用于门禁等场景 |
|
||
| 超级管理员 | 系统最高权限角色 | 默认拥有所有菜单权限 |
|
||
|
||
|
||
## 3. 角色管理
|
||
|
||
### 3.1 角色列表查询
|
||
|
||
**查询条件：**
|
||
|
||
| 查询条件 | 说明 |
|
||
|---------|------|
|
||
| 状态 | 筛选启用或禁用状态的角色 |
|
||
|
||
**操作步骤：**
|
||
|
||
1. 进入【系统设置】→【用户管理】→【角色】
|
||
2. 在顶部查询区域选择状态条件
|
||
3. 点击【查询】按钮获取角色列表
|
||
|
||
**功能对应截图** ：
|
||
|
||
|
||
|
||
### 3.2 新增角色
|
||
|
||
**操作步骤：**
|
||
|
||
1. 点击【新增角色】按钮
|
||
2. 填写角色名称和描述
|
||
3. 设置角色状态
|
||
4. 点击【确定】完成新增
|
||
|
||
**字段说明：**
|
||
|
||
| 字段 | 说明 | 必填 |
|
||
|------|------|------|
|
||
| 名称 | 角色名称，如"管理员"、"普通用户" | 是 |
|
||
| 描述 | 角色的详细说明 | 否 |
|
||
| 状态 | 启用或禁用 | 是 |
|
||
|
||
**【提示】** 角色名称不能重复。
|
||
|
||
**功能对应截图** ：
|
||
|
||
|
||
|
||
### 3.3 编辑角色
|
||
|
||
**操作步骤：**
|
||
|
||
1. 在角色列表中点击需要编辑的角色
|
||
2. 修改角色信息
|
||
3. 点击【确定】保存更改
|
||
|
||
**功能对应截图** ：
|
||
|
||
|
||
|
||
### 3.4 删除角色
|
||
|
||
**操作步骤：**
|
||
|
||
1. 在角色列表中找到需要删除的角色
|
||
2. 点击【删除】按钮
|
||
3. 在确认对话框中点击【确定】
|
||
|
||
**【重要】** 如果角色下存在用户，无法删除该角色。
|
||
|
||
**功能对应截图** ：
|
||
|
||
|
||
|
||
### 3.5 权限分配
|
||
|
||
**操作步骤：**
|
||
|
||
1. 在角色列表中点击【权限配置】按钮
|
||
2. 在权限配置页面选择需要分配的菜单和API
|
||
3. 点击【确定】保存权限配置
|
||
|
||
**【提示】** 权限配置会覆盖角色原有的所有权限。
|
||
|
||
**功能对应截图** ：
|
||
|
||
|
||
|
||
|
||
## 4. 用户管理
|
||
|
||
### 4.1 用户列表查询
|
||
|
||
**查询条件：**
|
||
|
||
| 查询条件 | 说明 |
|
||
|---------|------|
|
||
| 账号 | 按用户名模糊查询 |
|
||
| 姓名 | 按昵称模糊查询 |
|
||
| 用户组 | 按角色筛选 |
|
||
| 状态 | 筛选启用或禁用状态的用户 |
|
||
|
||
**功能对应截图** ：
|
||
|
||
|
||
|
||
|
||
### 4.2 新增用户
|
||
|
||
**操作步骤：**
|
||
|
||
1. 点击【新增用户】按钮
|
||
2. 填写用户信息
|
||
3. 设置用户组和状态
|
||
4. 点击【确定】完成新增
|
||
|
||
**字段说明：**
|
||
|
||
| 字段 | 说明 | 必填 |
|
||
|------|------|------|
|
||
| 账号 | 用户登录账号 | 是 |
|
||
| 姓名 | 用户昵称或真实姓名 | 是 |
|
||
| 出入证编号 | 用户的证件编号 | 否 |
|
||
| 密码 | 用户登录密码 | 是 |
|
||
| 确认密码 | 再次输入密码确认 | 是 |
|
||
| 用户组 | 选择用户所属角色 | 是 |
|
||
| 状态 | 启用或禁用 | 是 |
|
||
|
||
**【注意】** 两次输入的密码必须一致，已删除或禁用的用户组无法选择。
|
||
|
||
**功能对应截图** ：
|
||
|
||
|
||
|
||
|
||
|
||
### 4.3 编辑用户
|
||
|
||
**操作步骤：**
|
||
|
||
1. 在用户列表中点击需要编辑的用户
|
||
2. 修改用户信息
|
||
3. 点击【确定】保存更改
|
||
|
||
**【注意】** 不能禁用自己的账号。
|
||
|
||
**功能对应截图** ：
|
||
|
||
|
||
|
||
|
||
### 4.4 删除用户
|
||
|
||
**操作步骤：**
|
||
|
||
1. 在用户列表中找到需要删除的用户
|
||
2. 点击【删除】按钮
|
||
3. 在确认对话框中点击【确定】
|
||
|
||
**【重要】** 不能删除自己的账号。
|
||
|
||
**功能对应截图** ：
|
||
|
||
|
||
|
||
### 4.5 批量操作
|
||
|
||
**支持的批量操作：**
|
||
|
||
- 批量删除：选择多个用户后点击【批量删除】
|
||
- 批量启用/禁用：选择多个用户后点击【批量启用】或【批量禁用】
|
||
|
||
**功能对应截图** ：
|
||
|
||
|
||
|
||
### 4.6 密码管理
|
||
|
||
#### 修改密码
|
||
|
||
**操作步骤：**
|
||
|
||
1. 在页面右上角鼠标移动到用户名字，点击下拉框中的【修改密码】按钮
|
||
2. 输入旧密码和新密码
|
||
3. 点击【确定】完成修改
|
||
|
||
**功能对应截图** ：
|
||
|
||
|
||
|
||
#### 重置密码
|
||
|
||
**操作步骤：**
|
||
|
||
1. 在用户列表中点击【重置密码】按钮
|
||
2. 在确认对话框中点击【确定】
|
||
3. 密码将被重置为默认密码"123456"
|
||
|
||
**功能对应截图** ：
|
||
|
||
|
||
|
||
|
||
### 4.7 用户数据导入导出
|
||
|
||
#### 导入用户数据
|
||
|
||
**操作步骤：**
|
||
|
||
1. 点击【下载导入模板】获取导入模板文件
|
||
2. 按照模板格式填写用户数据
|
||
3. 上传填写好的Excel文件
|
||
4. 点击【导入】完成批量导入
|
||
|
||
**导入模板字段：**
|
||
|
||
| 字段 | 说明 | 必填 |
|
||
|------|------|------|
|
||
| 账号 | 用户登录账号 | 是 |
|
||
| 姓名 | 用户昵称 | 是 |
|
||
| 出入证编号 | 用户证件编号 | 否 |
|
||
| 密码 | 用户密码 | 是 |
|
||
| 状态 | 启用或禁用 | 是 |
|
||
| 用户组 | 用户所属角色名称 | 是 |
|
||
|
||
**功能对应截图** ：
|
||
|
||
|
||
|
||
#### 导出用户数据
|
||
|
||
**操作步骤：**
|
||
|
||
1. 设置查询条件筛选需要导出的用户
|
||
2. 点击【导出】按钮
|
||
3. 系统后台生成导出任务
|
||
4. 在下载管理中获取导出文件
|
||
|
||
**功能对应截图** ：
|
||
|
||
|
||
|
||
## 5. 操作逻辑流程图
|
||
|
||
```mermaid
|
||
flowchart TD
|
||
A[用户管理] --> B[新增用户]
|
||
A --> C[编辑用户]
|
||
A --> D[删除用户]
|
||
A --> E[修改密码]
|
||
|
||
B --> F{验证用户名唯一性}
|
||
F -->|已存在| G[提示错误]
|
||
F -->|不存在| H{验证密码一致性}
|
||
H -->|不一致| I[提示错误]
|
||
H -->|一致| J{验证角色有效性}
|
||
J -->|无效| K[提示错误]
|
||
J -->|有效| L[保存用户数据]
|
||
|
||
C --> M{验证用户名唯一性}
|
||
M -->|重复| N[提示错误]
|
||
M -->|唯一| O{是否禁用自己}
|
||
O -->|是| P[提示错误]
|
||
O -->|否| Q[更新用户数据]
|
||
|
||
D --> R{是否删除自己}
|
||
R -->|是| S[提示错误]
|
||
R -->|否| T[删除用户并重新排序]
|
||
|
||
E --> U{验证密码一致性}
|
||
U -->|不一致| V[提示错误]
|
||
U -->|一致| W{新旧密码是否相同}
|
||
W -->|相同| X[提示错误]
|
||
W -->|不同| Y[更新密码]
|
||
```
|
||
|
||
## 6. 注意事项
|
||
|
||
**【重要】** 用户在进行删除或禁用操作时，不能操作自己的账号。
|
||
|
||
**【注意】** 删除或禁用角色前，请确保该角色下没有关联的用户。
|
||
|
||
**【提示】** 导入用户数据时，如果用户名已存在，该行数据将被跳过。 |