feat(菜单管理): 添加菜单管理功能截图并更新文档

添加菜单管理各功能对应的截图文件
更新菜单配置文档以包含功能截图引用
This commit is contained in:
sheng
2026-05-06 15:25:32 +08:00
parent fb4cedb504
commit 451bb4f318
8 changed files with 27 additions and 68 deletions

Binary file not shown.

After

Width:  |  Height:  |  Size: 7.9 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 5.5 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 17 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 24 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 50 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 23 KiB

View File

@@ -13,6 +13,10 @@
- 菜单权限关联:新增菜单自动关联超级管理员角色 - 菜单权限关联:新增菜单自动关联超级管理员角色
- 菜单导航属性:控制菜单是否在导航栏显示 - 菜单导航属性:控制菜单是否在导航栏显示
**功能对应截图**
![图片:菜单管理功能截图](/public/image/menu_configuration/图片:菜单管理功能截图.png)
## 2. 术语说明 ## 2. 术语说明
#### 2.1.1 菜单相关术语 #### 2.1.1 菜单相关术语
@@ -46,6 +50,10 @@
3. 点击【查询】按钮获取菜单列表 3. 点击【查询】按钮获取菜单列表
4. 点击【重置】按钮清空查询条件 4. 点击【重置】按钮清空查询条件
**功能对应截图**
![图片:菜单管理查询功能截图](/public/image/menu_configuration/图片:菜单管理查询功能截图.png)
### 3.2 新增菜单 ### 3.2 新增菜单
**操作步骤:** **操作步骤:**
@@ -73,6 +81,10 @@
**【提示】** 新增菜单时,系统会自动将其关联到超级管理员角色。 **【提示】** 新增菜单时,系统会自动将其关联到超级管理员角色。
**功能对应截图**
![图片:菜单管理新增功能截图](/public/image/menu_configuration/图片:菜单管理新增功能截图.png)
### 3.3 编辑菜单 ### 3.3 编辑菜单
**操作步骤:** **操作步骤:**
@@ -83,6 +95,10 @@
**【注意】** 菜单名称在同一模块内不能重复。 **【注意】** 菜单名称在同一模块内不能重复。
**功能对应截图**
![图片:菜单管理编辑功能截图](/public/image/menu_configuration/图片:菜单管理编辑功能截图.png)
### 3.4 删除菜单 ### 3.4 删除菜单
**操作步骤:** **操作步骤:**
@@ -91,6 +107,10 @@
2. 点击菜单右侧的【删除】按钮 2. 点击菜单右侧的【删除】按钮
3. 在确认对话框中点击【确定】 3. 在确认对话框中点击【确定】
**功能对应截图**
![图片:菜单管理删除功能截图](/public/image/menu_configuration/图片:菜单管理删除功能截图.png)
**【重要】** 如果该菜单或其子级菜单正在被角色使用,则无法删除。 **【重要】** 如果该菜单或其子级菜单正在被角色使用,则无法删除。
### 3.5 启用/禁用菜单 ### 3.5 启用/禁用菜单
@@ -103,6 +123,10 @@
**【注意】** 状态切换会影响该菜单及其所有子级菜单。 **【注意】** 状态切换会影响该菜单及其所有子级菜单。
**功能对应截图**
![图片:菜单管理删除功能截图](/public/image/menu_configuration/图片:菜单管理删除功能截图.png)
### 3.6 菜单排序 ### 3.6 菜单排序
**操作步骤:** **操作步骤:**
@@ -114,73 +138,8 @@
- 拖拽到同级菜单的前面或后面 - 拖拽到同级菜单的前面或后面
- 拖拽到其他菜单下作为子菜单 - 拖拽到其他菜单下作为子菜单
## 4. 后台API接口 **功能对应截图**
![图片:菜单管理排序功能截图](/public/image/menu_configuration/图片:菜单管理排序功能截图.png)
### 4.1 接口列表
| API路径 | 方法 | 功能描述 | 所属文件 |
|---------|------|---------|---------|
| `/api/background/v1/system_settings/menu_configuration/menu/all` | GET | 获取用户权限内的菜单列表 | MenuService.php:58 |
| `/api/background/v1/system_settings/menu_configuration/menu/list` | GET | 获取菜单列表(带筛选条件) | MenuService.php:124 |
| `/api/background/v1/system_settings/menu_configuration/menu/create` | POST | 创建新菜单 | MenuService.php:186 |
| `/api/background/v1/system_settings/menu_configuration/menu/edit` | POST | 编辑菜单信息 | MenuService.php:250 |
| `/api/background/v1/system_settings/menu_configuration/menu/delete` | POST | 删除菜单 | MenuService.php:307 |
| `/api/background/v1/system_settings/menu_configuration/menu/update_status` | POST | 更新菜单状态 | MenuService.php:328 |
| `/api/background/v1/system_settings/menu_configuration/menu/update_sort` | POST | 更新菜单排序 | MenuService.php:352 |
### 4.2 数据模型
**菜单表字段:**
| 字段名 | 类型 | 说明 |
|--------|------|------|
| id | int | 菜单唯一标识 |
| parent_id | int | 父菜单ID |
| name | varchar | 菜单名称 |
| alias | varchar | 菜单别名 |
| icon | varchar | 菜单图标 |
| is_navi | tinyint | 是否导航显示(0/1) |
| module | varchar | 所属模块(admin/pda) |
| params | varchar | 链接参数 |
| remark | varchar | 备注说明 |
| sort | int | 排序序号 |
| status | tinyint | 状态(0禁用/1启用) |
| target | varchar | 打开方式 |
| type | tinyint | 链接类型(0模块/1外链) |
| url | varchar | 链接地址 |
## 5. 前端组件结构
### 5.1 组件目录
```
menu_configuration/
└── menu/
├── components/
│ ├── PageHeader/
│ │ └── index.vue # 查询条件头部组件
│ └── PageMain/
│ └── index.vue # 主内容区域组件
└── index.vue # 页面入口组件
```
### 5.2 核心组件功能
| 组件 | 功能 | 关键特性 |
|------|------|---------|
| PageHeader | 查询条件面板 | 支持模块切换、状态筛选、导航属性筛选 |
| PageMain | 菜单树和表单 | 树形展示、拖拽排序、增删改操作 |
## 6. 权限控制
菜单管理涉及以下权限点:
| 权限标识 | 权限名称 | 说明 |
|---------|---------|------|
| `/system_settings/menu_configuration/menu/create` | 新增菜单 | 允许创建新菜单 |
| `/system_settings/menu_configuration/menu/edit` | 编辑菜单 | 允许修改菜单信息 |
| `/system_settings/menu_configuration/menu/delete` | 删除菜单 | 允许删除菜单 |
| `/system_settings/menu_configuration/menu/disabled_enable` | 启用/禁用菜单 | 允许切换菜单状态 |
## 7. 数据流程图 ## 7. 数据流程图

View File

@@ -4,7 +4,7 @@
|:---|:---|:---|:---|:---|:---|:---|:---| |:---|:---|:---|:---|:---|:---|:---|:---|
| **系统设置 (System Administration)** | 用户管理 (User Management) | 角色 (Role) | 设置用户组并分配权限(增删改查用户组,并实现权限分配功能) | | √ | √ | | | **系统设置 (System Administration)** | 用户管理 (User Management) | 角色 (Role) | 设置用户组并分配权限(增删改查用户组,并实现权限分配功能) | | √ | √ | |
| **系统设置 (System Administration)** | 用户管理 (User Management) | 用户 (User) | 管理用户账号并绑定对应角色 | | √ | √ | | | **系统设置 (System Administration)** | 用户管理 (User Management) | 用户 (User) | 管理用户账号并绑定对应角色 | | √ | √ | |
| **系统设置 (System Administration)** | 菜单管理 (Menu Management) | 菜单配置 (Menu Configuration) | 系统菜单配置 | | √ | | | | **系统设置 (System Administration)** | 菜单管理 (Menu Management) | 菜单配置 (Menu Configuration) | 系统菜单配置 | | √ | | |
| **系统设置 (System Administration)** | 系统助手 (System Utilities) | 操作日志 (Operation Logs) | 系统操作日志 | | √ | | | | **系统设置 (System Administration)** | 系统助手 (System Utilities) | 操作日志 (Operation Logs) | 系统操作日志 | | √ | | |
| **系统设置 (System Administration)** | 系统助手 (System Utilities) | 接口日志 (API Logs) | 与设备对接流程交互日志(支持按 IP 和接口名称查询) | | √ | | | | **系统设置 (System Administration)** | 系统助手 (System Utilities) | 接口日志 (API Logs) | 与设备对接流程交互日志(支持按 IP 和接口名称查询) | | √ | | |
| **系统设置 (System Administration)** | 系统监控 (System Monitoring) | 监控设置 (Monitoring Configuration) | 系统监控配置 | | √ | | | | **系统设置 (System Administration)** | 系统监控 (System Monitoring) | 监控设置 (Monitoring Configuration) | 系统监控配置 | | √ | | |