cattleTransportation/快速启动指南.md

🚀 权限管理功能 - 快速启动指南

第一步：执行数据库脚本 📊

在您的MySQL数据库客户端中执行：

c:/cattleTransport/权限管理功能初始化SQL.sql

这个脚本会：

• ✅ 创建权限管理相关菜单
• ✅ 设置 15900000000 为超级管理员（密码：123456）
• ✅ 配置所有必要的权限数据

第二步：启动服务 🔌

后端已经启动 ✅

后端服务正在后台运行：

• 地址：http://127.0.0.1:16200

如需重启后端，执行：

# 停止Java进程
taskkill /F /IM java.exe

# 重新启动
cd c:\cattleTransport\tradeCattle\aiotagro-cattle-trade
java -jar target\aiotagro-cattletrade-1.0.1.jar

启动前端

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是否启动（如果配置了）

解决方案：

# 查看后端日志
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 表是否有数据

解决方案：

-- 检查菜单数据
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》文档。