菜单与资源管理
菜单与资源管理模块定义系统的导航结构和按钮级权限。所有前端页面路由和操作按钮的访问控制均在此配置。
功能入口
登录管理后台后，点击左侧菜单 系统管理 > 菜单管理，进入菜单资源树页面。页面左侧展示菜单树，右侧展示当前选中菜单的详细信息。
菜单类型
系统中的菜单资源分为三种类型：
| 类型 | 说明 | 示例 |
|---|---|---|
| 目录 | 一级菜单分类，不绑定具体页面 | 系统管理、平台能力 |
| 菜单 | 绑定具体页面的可访问菜单项 | 用户管理、角色管理 |
| 按钮 | 页面内的操作按钮权限 | 新增、编辑、删除 |
新增菜单
- 在菜单树中，先点击目标父级节点（新菜单将创建在其下）
- 点击树工具栏中的 新增 按钮
- 弹出新增菜单表单，根据菜单类型填写对应信息：
目录/菜单：
- 菜单类型：选择 目录 或 菜单
- 菜单名称（必填）：在导航栏显示的文本
- 上级菜单：自动填入当前选中的父节点
- 路由地址：前端路由路径，如
/system/user - 组件路径：对应的 Vue 组件路径，如
system/user/index - 权限标识：权限控制字符串，如
system:user:list - 菜单图标：从图标选择器中选取
- 显示排序：同级菜单的显示顺序
- 是否外链：是否为外部链接
- 可见状态：显示 / 隐藏
- 状态：启用 / 停用
按钮：
- 菜单类型：选择 按钮
- 菜单名称：按钮标签，如"新增"
- 权限标识：按钮权限标识，如
system:user:add
- 点击 确定 完成创建
路由配置
路由地址是菜单与前端页面的桥梁，配置要点：
- 路由地址以
/开头，如/system/user - 父子菜单的路由地址应保持层级关系
- 组件路径对应
forge-admin-ui/src/views/下的.vue文件
权限标识
权限标识用于后端接口鉴权，与 @SaCheckPermission 注解配合使用：
- 菜单权限：
system:user:list（查看用户列表） - 按钮权限：
system:user:add、system:user:edit、system:user:remove - 遵循
模块:功能:操作的命名规范
图标选择
点击图标字段旁的图标选择器，可浏览并选取合适的图标。Forge Admin 内置丰富的图标库，支持按关键词搜索。
编辑与删除
- 在菜单树中点击目标节点，右侧面板显示其信息后，可修改并保存
- 删除菜单节点前，系统会检查是否存在子级菜单，如有则需先删除子级
- 删除菜单不会自动删除关联的角色权限，需在角色管理中手动清理
相关文档
- 角色管理 — 了解如何为角色分配菜单
- RBAC 权限配置指南 — 完整的权限配置流程