Appearance
用户管理
功能需求表
| 序号 | 功能需求 | 需求描述 | 功能说明 | 校验规则 | 交互说明与流程 | 涉及字段 | 错误提示 | 成功提示 |
|---|---|---|---|---|---|---|---|---|
| 1 | 用户列表查询 | 提供多条件组合查询功能，支持按姓名、手机号、角色、状态进行筛选 | 查询字段： • 用户姓名：文本输入框，支持模糊匹配，最多50个字符 • 手机号：文本输入框，11位数字校验，支持模糊匹配 • 所属角色：下拉选择，默认显示"全部角色" • 用户状态：下拉选择，默认显示"全部状态"，可选"启用"/"禁用"/"锁定" 操作按钮： • 查询：根据当前筛选条件刷新用户列表 • 重置：清空所有筛选条件，恢复初始状态 | - | 1.输入查询条件（可多条件组合） 2.点击"查询"按钮，刷新用户列表 3.点击"重置"按钮，清空所有筛选条件，恢复初始状态 | 用户姓名、手机号、所属角色、用户状态 | - | - |
| 2 | 用户列表展示 | 以表格形式展示用户信息，支持分页浏览 | 表格字段： • ID：用户唯一标识 • 用户姓名：真实姓名 • 手机号：联系电话 • 邮箱：邮箱地址 • 所属角色：角色名称 • 用户状态：启用/禁用/锁定 • 创建时间：格式YYYY-MM-DD HH:mm:ss • 操作：编辑、重设密码、删除 分页规则： • 每页显示10条数据（可切换10/20/50/100条） • 支持"上一页"、"下一页"翻页 • 支持页码跳转 • 显示总数据条数"共 X 条" | - | 1.页面加载时自动查询并显示用户列表 2.表格和搜索条件排序 3.支持分页浏览 4.操作列显示"编辑"、"重设密码"、"删除"按钮 | ID、用户姓名、手机号、邮箱、所属角色、用户状态、创建时间、操作 | - | - |
| 3 | 新增用户 | 支持管理员创建新用户 | 字段定义： • 用户姓名：文本输入框，必填，2-50个字符 • 手机号：文本输入框，必填，11位数字，唯一性校验 • 邮箱：文本输入框，非必填，邮箱格式校验，唯一性校验 • 密码：密码输入框，必填，6-20位，需包含字母和数字 • 所属角色：下拉选择，必填，从角色列表中选择 • 用户状态：下拉选择，必填，默认"启用"，枚举：启用/禁用/锁定 | 用户姓名：不能为空；2-50个字符 手机号：不能为空；11位数字；唯一性校验 邮箱：邮箱格式校验；唯一性校验 所属角色：不能为空；必须选择角色 | 1.点击"新增"按钮 2.弹出"新增"表单弹窗 3.填写用户信息（带*为必填） 4.实时校验（账号唯一性、手机号唯一性） 5.选择角色 6.点击"确认"按钮 7.校验数据（唯一性、格式） 8.保存成功，显示成功提示 9.弹窗关闭，列表刷新 | 用户姓名、手机号、邮箱、密码、所属角色、用户状态 | 请输入用户姓名; 用户姓名长度为2-50个字符; 请输入手机号; 请输入正确的手机号; 该手机号已存在; 请输入正确的邮箱地址; 该邮箱已存在; 请选择所属角色; 请选择用户状态; 网络异常，请稍后重试 | 用户创建成功 |
| 4 | 编辑用户 | 支持编辑用户基本信息 | 可编辑字段： • 用户姓名：文本输入框，必填，2-50个字符 • 手机号：文本输入框，必填，11位数字，唯一性校验（编辑时排除自己） • 邮箱：文本输入框，非必填，邮箱格式校验，唯一性校验（编辑时排除自己） • 所属角色：下拉选择，必填，从角色列表中选择 • 菜单权限：树形结构选择，支持勾选权限 不可编辑字段： • 用户账号：唯一标识，不可修改 数据回显： • 弹窗打开时，自动回显该用户的现有信息 | 用户姓名：不能为空；2-50个字符 手机号：不能为空；11位数字；唯一性校验 邮箱：邮箱格式校验；唯一性校验 所属角色：不能为空；必须选择角色 | 1.点击"编辑"链接 2.弹出"编辑"表单弹窗，回显数据 3.修改用户信息 4.实时校验 5.修改角色 6.点击"确认"按钮 7.校验数据 8.保存成功，显示成功提示 9.弹窗关闭，列表刷新 | 用户姓名、手机号、邮箱、密码、所属角色、菜单权限 | 请输入用户姓名; 用户姓名长度为2-50个字符; 请输入手机号; 请输入正确的手机号; 该手机号已存在; 请输入正确的邮箱地址; 该邮箱已存在; 请选择所属角色; 请选择用户状态; 网络异常，请稍后重试 | 用户信息更新成功 |
| 5 | 用户状态管理 | 支持启用/禁用用户账号 | 状态枚举： • 启用：用户可正常登录 • 禁用：用户无法登录 • 锁定：用户无法登录 通过表格"用户状态"列的控件进行切换 业务规则： • 当前登录用户不能禁用自己 • 禁用用户后，该用户的所有会话将失效 • 锁定状态通常由系统自动触发（如密码错误超过5次） | - | 1.点击表格"用户状态"列的状态按钮 2.状态在"启用"、"禁用"、"锁定"之间切换 3.弹出确认提示 4.确认后更新用户状态 5.列表刷新，显示最新状态 | 用户状态 | 不能禁用当前登录用户; 网络异常，请稍后重试 | 用户状态更新成功 |
| 6 | 重置密码 | 支持管理员重置用户密码 | 点击"重设密码"链接，弹出确认弹窗 弹窗提示："确定重置密码为：123456" 确认后密码重置为默认密码"123456" 业务规则： • 重置密码后，用户下次登录需修改密码 • 不允许重置当前登录用户的密码（需通过"修改密码"功能） | - | 1.点击的"重设密码"链接 2.弹出确认弹窗："确定重置密码为：123456" 3.点击"确认"按钮 4.密码重置为123456 5.显示成功提示 6.弹窗关闭，列表刷新 | 密码 | 不能重置当前登录用户的密码; 网络异常，请稍后重试 | 密码重置成功 |
| 7 | 删除用户 | 支持删除用户账号 | 点击"删除"链接，弹出二次确认对话框："确定要删除该用户吗？" 删除操作为软删除（逻辑删除），设置 is_deleted = 1 删除操作不可恢复 业务规则： • 不允许删除当前登录用户 • 不允许删除超级管理员角色用户（需至少保留一个超级管理员） | - | 1.点击用户行的"删除"链接 2.弹出确认对话框："确定要删除该用户吗？" 3.点击"确定"按钮 4.调用删除接口 5.显示成功提示 6.弹窗关闭，列表刷新 | - | 不能删除当前登录用户; 不可删除系统管理员; 不可删除唯一超级管理员; 删除失败，该用户关联了业务数据; 网络异常，请稍后重试 | 用户删除成功 |
| 8 | 分页功能 | 支持分页浏览用户列表 | 分页规则： • 每页显示10条数据（可切换10/20/50/100条） • 支持"上一页"、"下一页"翻页 • 支持页码跳转 • 显示总数据条数"共 X 条" | - | 1.用户列表加载时自动显示分页控件 2.点击"上一页"、"下一页"按钮翻页 3.输入页码直接跳转 4.选择每页显示条数（10/20/50/100） 5.显示当前页码、总页数、总数据条数 | pageNum、pageSize | - | - |
提示信息表
| 场景 | 提示类型 | 提示内容 |
|---|---|---|
| 用户创建成功 | Success | 用户创建成功 |
| 用户信息更新成功 | Success | 用户信息更新成功 |
| 密码重置成功 | Success | 密码重置成功 |
| 用户删除成功 | Success | 用户删除成功 |
| 用户状态更新成功 | Success | 用户状态更新成功 |
| 用户账号已存在 | Error | 该用户账号已存在，请更换 |
| 请输入用户姓名 | Error | 请输入用户姓名 |
| 用户姓名格式不正确 | Error | 用户姓名长度为2-50个字符 |
| 请输入手机号 | Error | 请输入手机号 |
| 手机号格式不正确 | Error | 请输入正确的手机号 |
| 手机号已存在 | Error | 该手机号已存在，请更换 |
| 邮箱格式不正确 | Error | 请输入正确的邮箱地址 |
| 邮箱已存在 | Error | 该邮箱已存在，请更换 |
| 请输入密码 | Error | 请输入密码 |
| 密码格式不正确 | Error | 密码长度为6-20位，需包含字母和数字 |
| 请选择所属角色 | Error | 请选择所属角色 |
| 不能禁用当前登录用户 | Error | 不能禁用当前登录用户 |
| 不能重置当前登录用户的密码 | Error | 不能重置当前登录用户的密码 |
| 不能删除当前登录用户 | Error | 不能删除当前登录用户 |
| 不可删除系统管理员 | Error | 不可删除系统管理员 |
| 不可删除唯一超级管理员 | Error | 不可删除唯一超级管理员 |
| 删除失败，用户关联业务数据 | Error | 删除失败，该用户关联了业务数据 |
| 网络异常 | Error | 网络异常，请稍后重试 |
| 删除确认 | Warning | 确定要删除该用户吗？ |
| 重置密码确认 | Warning | 确定重置密码为：123456 |