cattleTransportation/pc-cattle-transportation/DEPLOYMENT_GUIDE.md

# 用户权限管理系统部署指南

## 当前状态

✅ **前端已完成**：用户权限管理界面已实现，支持优雅的错误处理
❌ **后端待部署**：需要完成数据库表创建和后端服务重启

## 部署步骤

### 步骤1：创建数据库表

**执行SQL脚本：**
```sql
-- 在数据库中执行以下SQL
source C:\cattleTransport\tradeCattle\add_user_menu_table.sql;
```

**或者手动执行：**
```sql
CREATE TABLE IF NOT EXISTS `sys_user_menu` (
  `id` int(11) NOT NULL AUTO_INCREMENT COMMENT '主键ID',
  `user_id` int(11) NOT NULL COMMENT '用户ID',
  `menu_id` int(11) NOT NULL COMMENT '菜单ID',
  `create_time` datetime DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
  PRIMARY KEY (`id`),
  KEY `idx_user_id` (`user_id`),
  KEY `idx_menu_id` (`menu_id`),
  UNIQUE KEY `uk_user_menu` (`user_id`, `menu_id`) COMMENT '用户菜单唯一索引'
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='用户菜单权限表';
```

### 步骤2：重启后端服务

**停止当前服务：**
```bash
# 查找Java进程
jps -l

# 停止Spring Boot应用（替换为实际的进程ID）
taskkill /F /PID <进程ID>
```

**重新启动服务：**
```bash
cd C:\cattleTransport\tradeCattle\aiotagro-cattle-trade
mvn spring-boot:run
```

**或者使用IDE启动：**
- 在IDE中运行 `AiotagroCattletradeApplication.java`
- 确保端口8080可用

### 步骤3：验证部署

**检查服务状态：**
```bash
# 检查端口是否监听
netstat -ano | findstr :8080

# 测试API接口
curl http://localhost:8080/api/sysUserMenu/hasUserPermissions?userId=1
```

**预期响应：**
```json
{
  "code": 200,
  "data": {
    "hasUserPermissions": false,
    "permissionCount": 0,
    "permissionSource": "角色权限"
  }
}
```

## 功能验证

### 1. 前端界面测试

1. **访问权限管理页面**
   - 打开浏览器访问：`http://localhost:8082`
   - 登录后进入权限管理页面

2. **测试标签页切换**
   - 确认"角色权限管理"标签页正常
   - 确认"用户权限管理"标签页正常

3. **测试用户权限管理**
   - 切换到"用户权限管理"标签页
   - 选择用户，查看权限来源显示
   - 尝试修改权限设置

### 2. 后端API测试

**测试用户权限查询：**
```bash
GET /api/sysUserMenu/hasUserPermissions?userId=3
```

**测试用户权限分配：**
```bash
POST /api/sysUserMenu/assignUserMenus
Content-Type: application/json

{
  "userId": 3,
  "menuIds": [1, 2, 3, 16, 4, 5]
}
```

**测试权限清空：**
```bash
DELETE /api/sysUserMenu/clearUserMenus?userId=3
```

## 当前问题解决

### 问题：404错误
**现象：** `Failed to load resource: the server responded with a status of 404`

**原因：** 后端服务未包含新的用户权限管理接口

**解决方案：**
1. 确保数据库表已创建
2. 重新编译后端项目：`mvn clean compile`
3. 重启后端服务：`mvn spring-boot:run`

### 问题：前端错误处理
**已解决：** 前端现在能够优雅地处理API不可用的情况
- 显示警告信息而不是错误
- 使用默认值（角色权限）
- 不影响其他功能的使用

## 部署检查清单

- [ ] 数据库表 `sys_user_menu` 已创建
- [ ] 后端项目已重新编译
- [ ] 后端服务已重启
- [ ] API接口 `/api/sysUserMenu/*` 可访问
- [ ] 前端页面可正常加载
- [ ] 用户权限管理功能正常

## 故障排除

### 1. 后端启动失败
**检查：**
- Java版本是否正确
- 数据库连接是否正常
- 端口8080是否被占用

### 2. API接口404
**检查：**
- 控制器类是否正确扫描
- 请求路径是否正确
- 服务是否完全启动

### 3. 数据库连接失败
**检查：**
- 数据库服务是否运行
- 连接配置是否正确
- 用户权限是否足够

## 完成后的功能

部署完成后，系统将支持：

1. **双权限系统**：
   - 角色权限管理（影响所有使用相同角色的用户）
   - 用户权限管理（仅影响单个用户）

2. **权限优先级**：
   - 用户专属权限覆盖角色权限
   - 向后兼容现有功能

3. **界面友好**：
   - 标签页切换
   - 权限来源显示
   - 操作确认提示

4. **API完整**：
   - 用户权限查询
   - 用户权限分配
   - 用户权限清空

## 联系支持

如果在部署过程中遇到问题，请检查：
1. 后端服务日志
2. 数据库连接状态
3. 网络连接情况
4. 端口占用情况