cattleTransportation/快速启动指南.md

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

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

在您的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》文档。