主题
菜单管理
SYS-PERM-01 | 模块
system| 维护目录、菜单、按钮三级结构,按钮上的权限标识就是接口的准入凭证。
1. 使用角色与场景
角色:管理员、开发者
- 新增一个页面菜单并配置路由
- 为列表页新增「导出」按钮权限
2. 接口与权限点
| 方法 | 路径 | 权限点 | 摘要 | 代码行 |
|---|---|---|---|---|
| POST | /system/menu/create | system:menu:create | 创建菜单 | MenuController#L35 |
| PUT | /system/menu/update | system:menu:update | 修改菜单 | MenuController#L43 |
| DELETE | /system/menu/delete | system:menu:delete | 删除菜单 | MenuController#L51 |
| DELETE | /system/menu/delete-list | system:menu:delete | 批量删除菜单 | MenuController#L60 |
| GET | /system/menu/list | system:menu:query | 获取菜单列表 | MenuController#L69 |
| GET | /system/menu/list-all-simple | — | 获取菜单精简信息列表 | MenuController#L78 |
| GET | /system/menu/simple-list | — | 获取菜单精简信息列表 | MenuController#L78 |
| GET | /system/menu/get | system:menu:query | 获取菜单信息 | MenuController#L89 |
3. 代码定位
| 层 | 位置 |
|---|---|
| Controller | modules/system/src/main/java/com/pmforge/module/system/controller/admin/permission/MenuController.java#L35 |
| DO | modules/system/src/main/java/com/pmforge/module/system/dal/dataobject/permission/MenuDO.java |
4. 数据表
| 表 | DO |
|---|---|
system_menu | MenuDO |
5. 机制与配置
- 菜单类型:目录/菜单/按钮;按钮记录只承载 permission 字符串
- 前端路由由菜单数据动态生成
6. 常见问题与排查
- 权限标识改名会导致已有角色失效,需同步更新
- parent_id 形成环会让菜单树加载死循环
7. 关联
- 需求原件:01-03-角色权限
- 相关卡片:SYS-ROLE-01
- 相关卡片:SYS-PERM-02