179 lines
4.4 KiB
Markdown
179 lines
4.4 KiB
Markdown
# 🚀 权限管理功能 - 快速启动指南
|
||
|
||
## 第一步：执行数据库脚本 📊
|
||
|
||
在您的MySQL数据库客户端中执行：
|
||
|
||
```bash
|
||
c:/cattleTransport/权限管理功能初始化SQL.sql
|
||
```
|
||
|
||
这个脚本会：
|
||
- ✅ 创建权限管理相关菜单
|
||
- ✅ 设置 15900000000 为超级管理员（密码：123456）
|
||
- ✅ 配置所有必要的权限数据
|
||
|
||
## 第二步：启动服务 🔌
|
||
|
||
### 后端已经启动 ✅
|
||
|
||
后端服务正在后台运行：
|
||
- 地址：`http://127.0.0.1:16200`
|
||
|
||
如需重启后端，执行：
|
||
```bash
|
||
# 停止Java进程
|
||
taskkill /F /IM java.exe
|
||
|
||
# 重新启动
|
||
cd c:\cattleTransport\tradeCattle\aiotagro-cattle-trade
|
||
java -jar target\aiotagro-cattletrade-1.0.1.jar
|
||
```
|
||
|
||
### 启动前端
|
||
|
||
```bash
|
||
cd c:\cattleTransport\pc-cattle-transportation
|
||
npm run dev
|
||
```
|
||
|
||
前端地址：`http://localhost:8080`
|
||
|
||
## 第三步：登录测试 👤
|
||
|
||
### 超级管理员登录
|
||
|
||
- **账号**：`15900000000`
|
||
- **密码**：`123456`
|
||
|
||
### 测试功能
|
||
|
||
登录后，在系统菜单中找到：
|
||
|
||
1. **权限管理** → **菜单权限管理**
|
||
- 查看和管理所有系统菜单
|
||
- 新增、编辑、删除菜单项
|
||
|
||
2. **权限管理** → **操作权限管理**
|
||
- 管理角色
|
||
- 为角色分配菜单和按钮权限
|
||
|
||
3. **运送清单** → **新增运送清单**
|
||
- 测试新的运送清单创建功能
|
||
- 验证权限控制是否生效
|
||
|
||
## 第四步：验证权限功能 ✔️
|
||
|
||
### 验证超级管理员权限
|
||
|
||
1. 使用 15900000000 登录
|
||
2. 确认所有菜单都可见
|
||
3. 确认所有按钮都可点击
|
||
4. 测试新增菜单
|
||
5. 测试为角色分配权限
|
||
|
||
### 创建普通角色并测试
|
||
|
||
1. 进入"操作权限管理"
|
||
2. 点击"新增角色"，创建"测试角色"
|
||
3. 为"测试角色"分配部分权限（如只分配运送清单查看权限）
|
||
4. 在用户管理中创建测试用户，分配"测试角色"
|
||
5. 退出超级管理员，用测试用户登录
|
||
6. 验证：
|
||
- ✅ 只能看到被分配的菜单
|
||
- ✅ 只能看到被分配的按钮
|
||
- ✅ 无权限操作被后端拦截
|
||
- ✅ 只能看到自己创建的数据
|
||
|
||
## 第五步：故障排查 🔧
|
||
|
||
### 问题1：SQL脚本执行失败
|
||
|
||
**检查点**：
|
||
- MySQL版本是否支持（建议5.7+）
|
||
- 数据库连接是否正常
|
||
- 是否有权限执行DDL和DML语句
|
||
|
||
**解决方案**：
|
||
- 分段执行SQL脚本
|
||
- 检查错误提示，手动修复冲突
|
||
|
||
### 问题2：后端启动失败
|
||
|
||
**检查点**：
|
||
- 16200端口是否被占用
|
||
- 数据库连接配置是否正确
|
||
- Redis是否启动（如果配置了）
|
||
|
||
**解决方案**：
|
||
```bash
|
||
# 查看后端日志
|
||
cd c:\cattleTransport\tradeCattle\aiotagro-cattle-trade
|
||
# 查看控制台输出或日志文件
|
||
```
|
||
|
||
### 问题3：前端访问不了后端API
|
||
|
||
**检查点**：
|
||
- 后端是否正常启动
|
||
- Vite proxy配置是否正确
|
||
- 浏览器控制台是否有跨域错误
|
||
|
||
**解决方案**：
|
||
- 检查 `vite.config.ts` 中的 proxy 配置
|
||
- 确认后端地址为 `http://127.0.0.1:16200`
|
||
- 重启前端服务
|
||
|
||
### 问题4：登录后看不到权限管理菜单
|
||
|
||
**检查点**：
|
||
- SQL脚本是否执行成功
|
||
- 用户角色是否正确
|
||
- sys_role_menu 表是否有数据
|
||
|
||
**解决方案**：
|
||
```sql
|
||
-- 检查菜单数据
|
||
SELECT * FROM sys_menu WHERE name LIKE '%权限%';
|
||
|
||
-- 检查用户角色
|
||
SELECT * FROM sys_user WHERE mobile = '15900000000';
|
||
|
||
-- 检查超级管理员权限
|
||
SELECT COUNT(*) FROM sys_role_menu WHERE role_id = 1;
|
||
```
|
||
|
||
### 问题5：权限控制不生效
|
||
|
||
**检查点**：
|
||
- 登录接口是否返回了permissions字段
|
||
- Pinia store是否保存了权限数据
|
||
- Controller是否添加了@SaCheckPermission注解
|
||
|
||
**解决方案**：
|
||
- 清除浏览器缓存和localStorage
|
||
- 重新登录
|
||
- 检查浏览器控制台和Network请求
|
||
|
||
## 📚 完整文档
|
||
|
||
- **使用说明**：`c:/cattleTransport/权限管理功能使用说明.md`
|
||
- **实施计划**：`c:/cattleTransport/权限管理和运送清单新增功能实施计划.md`
|
||
- **SQL脚本**：`c:/cattleTransport/权限管理功能初始化SQL.sql`
|
||
|
||
## 🎉 功能亮点
|
||
|
||
1. ✅ **完整的RBAC权限控制** - 角色、菜单、按钮三级权限
|
||
2. ✅ **超级管理员机制** - 一键拥有所有权限
|
||
3. ✅ **数据权限隔离** - 普通用户只能看自己的数据
|
||
4. ✅ **前后端权限联动** - 前端v-hasPermi指令 + 后端@SaCheckPermission注解
|
||
5. ✅ **可视化权限管理** - 树形权限分配界面
|
||
6. ✅ **新增运送清单功能** - PC端完整的创建表单
|
||
|
||
---
|
||
|
||
**祝您使用愉快！** 🎊
|
||
|
||
如有问题，请参考《权限管理功能使用说明.md》文档。
|
||
|