# 用户管理

## 1. 功能概述

用户管理模块用于管理系统用户账号和角色权限，实现用户的增删改查、角色分配、密码管理以及权限配置功能。

**核心功能：**

- 用户账号管理：创建、编辑、删除用户账号
- 用户状态控制：启用/禁用用户账号
- 角色管理：创建、编辑、删除角色（用户组）
- 权限分配：为角色分配菜单和API权限
- 密码管理：修改密码、重置密码

**功能对应截图** ：

![图片：用户管理功能截图](/public/image/user_management/图片：用户管理功能截图.png)

## 2. 术语说明

#### 2.1.1 用户管理术语

| 术语 | 定义 | 说明 |
|------|------|------|
| 用户组/角色 | 用户所属的权限分组 | 同一角色的用户拥有相同权限 |
| 出入证编号 | 用户的证件编号 | 用于门禁等场景 |
| 超级管理员 | 系统最高权限角色 | 默认拥有所有菜单权限 |


## 3. 角色管理

### 3.1 角色列表查询

**查询条件：**

| 查询条件 | 说明 |
|---------|------|
| 状态 | 筛选启用或禁用状态的角色 |

**操作步骤：**

1. 进入【系统设置】→【用户管理】→【角色】
2. 在顶部查询区域选择状态条件
3. 点击【查询】按钮获取角色列表

**功能对应截图** ：

![图片：角色管理查询功能截图](/public/image/user_management/图片：角色管理查询功能截图.png)

### 3.2 新增角色

**操作步骤：**

1. 点击【新增角色】按钮
2. 填写角色名称和描述
3. 设置角色状态
4. 点击【确定】完成新增

**字段说明：**

| 字段 | 说明 | 必填 |
|------|------|------|
| 名称 | 角色名称，如"管理员"、"普通用户" | 是 |
| 描述 | 角色的详细说明 | 否 |
| 状态 | 启用或禁用 | 是 |

**【提示】** 角色名称不能重复。

**功能对应截图** ：

![图片：角色管理新增功能截图](/public/image/user_management/图片：角色管理新增功能截图.png)

### 3.3 编辑角色

**操作步骤：**

1. 在角色列表中点击需要编辑的角色
2. 修改角色信息
3. 点击【确定】保存更改

**功能对应截图** ：

![图片：角色管理编辑功能截图](/public/image/user_management/图片：角色管理编辑功能截图.png)

### 3.4 删除角色

**操作步骤：**

1. 在角色列表中找到需要删除的角色
2. 点击【删除】按钮
3. 在确认对话框中点击【确定】

**【重要】** 如果角色下存在用户，无法删除该角色。

**功能对应截图** ：

![图片：角色管理删除功能截图](/public/image/user_management/图片：角色管理删除功能截图.png)

### 3.5 权限分配

**操作步骤：**

1. 在角色列表中点击【权限配置】按钮
2. 在权限配置页面选择需要分配的菜单和API
3. 点击【确定】保存权限配置

**【提示】** 权限配置会覆盖角色原有的所有权限。

**功能对应截图** ：

![图片：角色管理权限分配功能截图](/public/image/user_management/图片：角色管理权限分配功能截图.png)


## 4. 用户管理

### 4.1 用户列表查询

**查询条件：**

| 查询条件 | 说明 |
|---------|------|
| 账号 | 按用户名模糊查询 |
| 姓名 | 按昵称模糊查询 |
| 用户组 | 按角色筛选 |
| 状态 | 筛选启用或禁用状态的用户 |

**功能对应截图** ：

![图片：用户管理查询功能截图](/public/image/user_management/图片：用户管理查询功能截图.png)


### 4.2 新增用户

**操作步骤：**

1. 点击【新增用户】按钮
2. 填写用户信息
3. 设置用户组和状态
4. 点击【确定】完成新增

**字段说明：**

| 字段 | 说明 | 必填 |
|------|------|------|
| 账号 | 用户登录账号 | 是 |
| 姓名 | 用户昵称或真实姓名 | 是 |
| 出入证编号 | 用户的证件编号 | 否 |
| 密码 | 用户登录密码 | 是 |
| 确认密码 | 再次输入密码确认 | 是 |
| 用户组 | 选择用户所属角色 | 是 |
| 状态 | 启用或禁用 | 是 |

**【注意】** 两次输入的密码必须一致，已删除或禁用的用户组无法选择。

**功能对应截图** ：

![图片：用户管理新增功能截图](/public/image/user_management/图片：用户管理新增功能截图.png)



### 4.3 编辑用户

**操作步骤：**

1. 在用户列表中点击需要编辑的用户
2. 修改用户信息
3. 点击【确定】保存更改

**【注意】** 不能禁用自己的账号。

**功能对应截图** ：

![图片：用户管理编辑功能截图](/public/image/user_management/图片：用户管理编辑功能截图.png)


### 4.4 删除用户

**操作步骤：**

1. 在用户列表中找到需要删除的用户
2. 点击【删除】按钮
3. 在确认对话框中点击【确定】

**【重要】** 不能删除自己的账号。

**功能对应截图** ：

![图片：用户管理删除功能截图](/public/image/user_management/图片：用户管理删除功能截图.png)

### 4.5 批量操作

**支持的批量操作：**

- 批量删除：选择多个用户后点击【批量删除】
- 批量启用/禁用：选择多个用户后点击【批量启用】或【批量禁用】

**功能对应截图** ：

![图片：用户管理批量操作功能截图](/public/image/user_management/图片：用户管理批量操作功能截图.png)

### 4.6 密码管理

#### 修改密码

**操作步骤：**

1. 在页面右上角鼠标移动到用户名字，点击下拉框中的【修改密码】按钮
2. 输入旧密码和新密码
3. 点击【确定】完成修改

**功能对应截图** ：

![图片：用户管理修改密码功能截图](/public/image/user_management/图片：用户管理修改密码功能截图.png)

#### 重置密码

**操作步骤：**

1. 在用户列表中点击【重置密码】按钮
2. 在确认对话框中点击【确定】
3. 密码将被重置为默认密码"123456"

**功能对应截图** ：

![图片：用户管理重置密码功能截图](/public/image/user_management/图片：用户管理重置密码功能截图.png)


### 4.7 用户数据导入导出

#### 导入用户数据

**操作步骤：**

1. 点击【下载导入模板】获取导入模板文件
2. 按照模板格式填写用户数据
3. 上传填写好的Excel文件
4. 点击【导入】完成批量导入

**导入模板字段：**

| 字段 | 说明 | 必填 |
|------|------|------|
| 账号 | 用户登录账号 | 是 |
| 姓名 | 用户昵称 | 是 |
| 出入证编号 | 用户证件编号 | 否 |
| 密码 | 用户密码 | 是 |
| 状态 | 启用或禁用 | 是 |
| 用户组 | 用户所属角色名称 | 是 |

**功能对应截图** ：

![图片：用户管理导入功能截图](/public/image/user_management/图片：用户管理导入功能截图.png)
![图片：EXCEL模板](/public/image/user_management/图片：EXCEL模板.png)
#### 导出用户数据

**操作步骤：**

1. 设置查询条件筛选需要导出的用户
2. 点击【导出】按钮
3. 系统后台生成导出任务
4. 在下载管理中获取导出文件

**功能对应截图** ：

![图片：用户管理导出功能截图](/public/image/user_management/图片：用户管理导出功能截图.png)

## 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. 注意事项

**【重要】** 用户在进行删除或禁用操作时，不能操作自己的账号。

**【注意】** 删除或禁用角色前，请确保该角色下没有关联的用户。

**【提示】** 导入用户数据时，如果用户名已存在，该行数据将被跳过。