129 lines
3.4 KiB
Markdown
129 lines
3.4 KiB
Markdown
# 超级管理员权限管理指南
|
||
|
||
## 概述
|
||
本指南说明如何为超级管理员账户（手机号：15900000000）打开全部菜单权限。
|
||
|
||
## 方法一：通过权限管理界面操作（推荐）
|
||
|
||
### 步骤：
|
||
1. **登录系统**
|
||
- 使用超级管理员账户登录系统
|
||
- 导航到权限管理页面：`/permission/menu`
|
||
|
||
2. **选择目标用户**
|
||
- 在左侧用户列表中找到手机号为 `15900000000` 的用户
|
||
- 点击选择该用户
|
||
|
||
3. **分配权限**
|
||
- **方法A：手动全选**
|
||
- 在右侧菜单树中，手动勾选所有菜单项
|
||
- 点击"保存菜单权限"按钮
|
||
|
||
- **方法B：一键分配（新增功能）**
|
||
- 点击"一键分配全部权限"按钮
|
||
- 确认操作
|
||
- 系统将自动为该用户分配所有菜单权限
|
||
|
||
## 方法二：使用工具函数（开发者）
|
||
|
||
### 导入工具函数
|
||
```javascript
|
||
import {
|
||
assignAllPermissionsToSuperAdmin,
|
||
checkSuperAdminPermissions,
|
||
quickAssignAllPermissions
|
||
} from '@/utils/superAdminHelper.js';
|
||
```
|
||
|
||
### 检查权限状态
|
||
```javascript
|
||
// 检查超级管理员当前权限状态
|
||
const status = await checkSuperAdminPermissions('15900000000');
|
||
console.log('权限状态:', status);
|
||
```
|
||
|
||
### 分配所有权限
|
||
```javascript
|
||
// 为超级管理员分配所有菜单权限
|
||
const success = await assignAllPermissionsToSuperAdmin('15900000000');
|
||
if (success) {
|
||
console.log('权限分配成功');
|
||
}
|
||
```
|
||
|
||
### 一键分配（包含确认提示）
|
||
```javascript
|
||
// 一键分配权限（包含UI确认提示）
|
||
const success = await quickAssignAllPermissions('15900000000');
|
||
```
|
||
|
||
## 方法三：通过API直接调用
|
||
|
||
### 获取所有菜单
|
||
```javascript
|
||
// GET /sysMenu/list
|
||
const menuListRes = await getMenuList();
|
||
const allMenuIds = menuListRes.data.map(menu => menu.id);
|
||
```
|
||
|
||
### 分配权限
|
||
```javascript
|
||
// POST /sysMenu/assignRoleMenus
|
||
const assignRes = await assignRoleMenus({
|
||
roleId: targetUser.roleId,
|
||
menuIds: allMenuIds
|
||
});
|
||
```
|
||
|
||
## 权限验证
|
||
|
||
### 前端验证
|
||
系统会自动检查用户权限：
|
||
- 超级管理员（roleId = 1）自动拥有 `*:*:*` 权限
|
||
- 普通用户根据分配的菜单权限进行验证
|
||
|
||
### 后端验证
|
||
```java
|
||
// 在 LoginServiceImpl.java 中
|
||
if (roleId.equals(RoleConstants.SUPER_ADMIN_ROLE_ID)) {
|
||
return Collections.singletonList(RoleConstants.ALL_PERMISSION);
|
||
}
|
||
```
|
||
|
||
## 注意事项
|
||
|
||
1. **超级管理员特权**：
|
||
- 超级管理员（roleId = 1）在代码层面已经拥有所有权限
|
||
- 菜单权限分配主要用于界面显示和权限管理
|
||
|
||
2. **权限持久化**：
|
||
- 权限分配会保存到数据库的 `sys_role_menu` 表中
|
||
- 重新登录后权限仍然有效
|
||
|
||
3. **安全考虑**：
|
||
- 只有拥有 `permission:menu:assign` 权限的用户才能分配权限
|
||
- 建议定期检查权限分配情况
|
||
|
||
## 故障排除
|
||
|
||
### 常见问题
|
||
1. **找不到用户**：确认手机号是否正确
|
||
2. **权限分配失败**：检查是否有分配权限的权限
|
||
3. **菜单不显示**：确认菜单权限已正确分配
|
||
|
||
### 调试信息
|
||
系统会在控制台输出详细的调试信息：
|
||
```
|
||
=== 获取用户菜单 ===
|
||
=== 用户权限检查 ===
|
||
=== 权限路由生成 ===
|
||
=== 处理后的菜单列表 ===
|
||
```
|
||
|
||
## 相关文件
|
||
- 前端权限管理：`src/views/permission/menuPermission.vue`
|
||
- 权限API：`src/api/permission.js`
|
||
- 工具函数：`src/utils/superAdminHelper.js`
|
||
- 后端控制器：`SysMenuController.java`
|
||
- 权限验证：`StpInterfaceImpl.java`
|