2.2 KiB
2.2 KiB
3.8 权限节点配置
:::tip 概述
权限节点用于控制用户能访问哪些接口。通过菜单管理界面配置，格式为 sys:{模块名}:{操作}。
:::
Example 模块权限码
| 权限码 | 说明 | 对应接口 |
|---|---|---|
sys:example:page |
案例演示分页列表 | GET /api/example/page |
sys:example:add |
添加案例演示 | POST /api/example/add |
sys:example:update |
修改案例演示 | PUT /api/example/update |
sys:example:delete |
删除案例演示 | DELETE /api/example/delete/:id |
sys:example:import |
导入案例演示 | POST /api/example/import |
sys:example:export |
导出案例演示 | GET /api/example/export |
配置步骤
1. 添加目录节点
在系统菜单管理中添加一级目录：
| 字段 | 值 |
|---|---|
| 菜单名称 | 工具管理 |
| 菜单类型 | 目录（type=0） |
| 路由地址 | /tool |
| 排序 | 60 |
2. 添加菜单节点
在目录下添加二级菜单：
| 字段 | 值 |
|---|---|
| 菜单名称 | 案例演示 |
| 菜单类型 | 菜单（type=1） |
| 路由地址 | /example |
| 组件路径 | tool/example/index |
| 权限标识 | sys:example:page |
| 排序 | 1 |
3. 添加按钮权限
在菜单下添加三级按钮权限：
| 字段 | 值 | 权限标识 |
|---|---|---|
| 添加案例演示 | type=2 | sys:example:add |
| 修改案例演示 | type=2 | sys:example:update |
| 删除案例演示 | type=2 | sys:example:delete |
| 导入案例演示 | type=2 | sys:example:import |
| 导出案例演示 | type=2 | sys:example:export |
4. 分配角色权限
在角色管理中，为角色勾选新增的权限节点。
菜单类型说明
| type | 说明 | 前端行为 |
|---|---|---|
| 0 | 目录 | 渲染为侧边栏分组 |
| 1 | 菜单 | 渲染为可点击的菜单项，对应一个页面 |
| 2 | 按钮 | 不渲染，仅用于权限校验 |
权限校验流程
1. 用户登录 → 获取用户角色
2. 角色关联菜单 → 获取权限节点列表
3. 请求接口 → AuthMiddleware 读取 #[Permission] 注解
4. 检查权限码是否在用户权限列表中
5. 超级管理员（uid=1）跳过校验，直接放行