Appearance
角色管理
功能需求表
| 序号 | 功能需求 | 需求描述 | 功能说明 | 校验规则 | 交互说明与流程 | 涉及字段 | 错误提示 | 成功提示 |
|---|---|---|---|---|---|---|---|---|
| 1 | 角色查询 | 提供多条件组合查询功能，支持按角色名称进行筛选 | 查询字段： • 角色名称：文本输入框，支持模糊匹配，最多50个字符 操作按钮： • 查询：根据当前筛选条件刷新角色列表 • 重置：清空所有筛选条件，恢复初始状态 | - | 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个字符 • 备注：文本输入框，非必填，最多200个字符 • 菜单授权：树形复选框，必填，配置角色初始权限 菜单授权树结构： 权限树展示为层级结构，支持多选，支持父子节点联动（选中父节点自动选中所有子节点），支持全选/取消全选，可展开/折叠树节点 默认规则： • 新增角色时，菜单授权默认不选中任何权限 | 名称：不能为空；2-50个字符 | 1.点击"新增"按钮 2.弹出"新增"表单弹窗 3.填写角色信息（带*为必填） 4.配置菜单权限 5.点击"确认"按钮 6.校验数据 7.保存成功，显示成功提示 8.列表刷新 | 名称、备注、菜单授权 | 请输入角色名称 角色名称长度为2-50个字符 网络异常，请稍后重试 | 角色创建成功 |
| 4 | 编辑角色 | 支持编辑角色基本信息 | 可编辑字段： • 名称：文本输入框，必填，2-50个字符 • 备注：文本输入框，非必填，最多200个字符 • 菜单授权：树形复选框，非必填，配置角色初始权限 数据回显： • 弹窗打开时，自动回显该角色的现有信息 • 菜单授权树回显该角色当前拥有的权限 业务规则： • 编辑操作不影响角色与用户的关联关系 | 名称：不能为空；2-50个字符 | 1.点击角色行的"编辑"链接 2.弹出"编辑"表单弹窗，回显数据 3.修改角色信息 4.修改菜单权限 5.点击"确认"按钮 6.校验数据 7.保存成功，显示成功提示 8.列表刷新 | 名称、备注、菜单授权 | 请输入角色名称 角色名称长度为2-50个字符 网络异常，请稍后重试 | 角色信息更新成功 |
| 5 | 删除角色 | 支持删除角色 | 点击"删除"链接，弹出二次确认对话框："确定要删除该角色吗？" 删除操作为软删除（逻辑删除），设置 is_deleted = 1 业务规则： • 不允许删除超级管理员角色（super_admin） • 不允许删除已关联用户的角色 • 删除角色时需检查是否有相关业务数据，如有则提示无法删除 • 系统必须至少保留一个管理员角色 | - | 1.点击角色行的"删除"链接 2.弹出确认对话框："确定要删除该角色吗？此操作不可恢复。" 3.点击"确定"按钮 4.调用删除接口 5.显示成功提示 6.列表刷新 | - | 不能删除超级管理员角色 该角色已关联用户，不能删除 系统至少保留一个管理员角色 网络异常，请稍后重试 | 角色删除成功 |
| 6 | 分页功能 | 支持分页浏览角色列表 | 分页规则： • 每页显示10条数据（可切换10/20/50/100条） • 支持"上一页"、"下一页"翻页 • 支持页码跳转 • 显示总数据条数"共 X 条" | - | 1.角色列表加载时自动显示分页控件 2.点击"上一页"、"下一页"按钮翻页 3.输入页码直接跳转 4.选择每页显示条数（10/20/50/100） 5.显示当前页码、总页数、总数据条数 | pageNum、pageSize | - | - |
提示信息表
| 场景 | 提示类型 | 提示内容 |
|---|---|---|
| 角色创建成功 | Success | 角色创建成功 |
| 角色信息更新成功 | Success | 角色信息更新成功 |
| 角色删除成功 | Success | 角色删除成功 |
| 请输入角色名称 | Error | 请输入角色名称 |
| 角色名称格式不正确 | Error | 角色名称长度为2-50个字符 |
| 请输入角色编码 | Error | 请输入角色编码 |
| 角色编码格式不正确 | Error | 角色编码格式不正确 |
| 角色编码已存在 | Error | 该角色编码已存在 |
| 不能删除超级管理员角色 | Error | 不能删除超级管理员角色 |
| 角色已关联用户 | Error | 该角色已关联用户，不能删除 |
| 系统需保留管理员角色 | Error | 系统至少保留一个管理员角色 |
| 网络异常 | Error | 网络异常，请稍后重试 |
| 删除确认 | Warning | 确定要删除该角色吗？ |