# 多身份功能 - 执行清单

> 创建时间：2026-02-28  
> 用途：快速部署和测试多身份功能

---

## ✅ 代码已完成

所有代码已编写完成，共18个文件：
- 数据库文件：3个
- 后端文件：4个
- 前端文件：5个
- 文档文件：5个
- 部署脚本：1个

---

## 📋 执行步骤

### 步骤1：执行数据库脚本（5分钟）

```bash
# 方式1：使用批处理脚本（推荐）
Archive\[一次性]执行创建user_roles表-2026-02-28.bat

# 方式2：手动执行SQL
mysql -h 115.190.64.57 -P 3306 -u root -p123456 peidu < Archive\[一次性]创建user_roles表-2026-02-28.sql
```

**验证：**
```sql
-- 检查表是否创建成功
SHOW TABLES LIKE 'user_roles';

-- 查看数据是否同步
SELECT COUNT(*) FROM user_roles;
```

---

### 步骤2：编译后端（10分钟）

```bash
cd peidu/backend
mvn clean compile -DskipTests
```

**验证：**
- 检查控制台是否有编译错误
- 确认新增的4个Java文件编译成功

---

### 步骤3：重启后端服务（5分钟）

```bash
# 停止现有服务
# 启动新服务
```

**验证：**
- 访问 Swagger 文档
- 检查是否有新增的5个API接口

---

### 步骤4：编译前端（10分钟）

```bash
cd peidu/uniapp
npm run dev:mp-weixin
```

**验证：**
- 检查控制台是否有编译错误
- 确认新页面 `apply-role` 是否注册成功

---

### 步骤5：测试功能（30分钟）

参考文档：`Archive/[一次性]多身份功能-API测试指南-2026-02-28.md`

**后端测试：**
- [ ] GET /api/user/roles/list - 获取所有身份
- [ ] POST /api/user/roles/apply - 申请新身份
- [ ] POST /api/user/roles/switch - 切换主身份
- [ ] DELETE /api/user/roles/remove - 删除角色
- [ ] GET /api/user/roles/has - 检查角色

**前端测试：**
- [ ] 登录后查看身份
- [ ] 申请新身份
- [ ] 切换身份
- [ ] 验证页面刷新

**数据库验证：**
- [ ] user_roles 表数据正确
- [ ] 数据一致性检查通过

---

## 🚀 快速部署（一键执行）

```bash
# 执行快速部署脚本（包含步骤1-4）
Archive\[一次性]多身份功能-快速部署-2026-02-28.bat
```

**脚本会自动：**
1. 执行数据库脚本
2. 编译后端
3. 编译前端
4. 验证数据库

**注意：** 脚本不包含重启后端服务，需要手动重启。

---

## 📚 参考文档

1. **实施方案：** `Archive/[一次性]多身份功能-低风险实现方案-2026-02-26.md`
2. **实施完成报告：** `Archive/[一次性]多身份功能实施完成-2026-02-28.md`
3. **API测试指南：** `Archive/[一次性]多身份功能-API测试指南-2026-02-28.md`
4. **实施总结：** `Archive/[一次性]多身份功能-实施总结-2026-02-28.md`

---

## ⚠️ 注意事项

1. **数据库脚本必须先执行** - 否则后端启动会报错
2. **后端必须重新编译** - 新增的Java文件需要编译
3. **前端必须重新编译** - 新增的页面需要注册
4. **后端服务必须重启** - 新代码才能生效

---

## 🐛 常见问题

### 问题1：数据库脚本执行失败
**错误信息：** `ERROR 1045: Access denied`  
**解决方案：** 检查数据库连接信息（host、port、username、password）

### 问题2：后端编译失败
**错误信息：** `Cannot find symbol`  
**解决方案：** 检查Maven依赖是否正确，执行 `mvn clean install`

### 问题3：前端编译失败
**错误信息：** `Module not found`  
**解决方案：** 执行 `npm install` 安装依赖

### 问题4：API返回404
**错误信息：** `404 Not Found`  
**解决方案：** 检查后端服务是否重启，Controller是否正确注册

---

## ✅ 完成标志

当以下所有项都完成时，多身份功能部署成功：

- [ ] 数据库脚本执行成功
- [ ] 后端编译成功
- [ ] 前端编译成功
- [ ] 后端服务重启成功
- [ ] 所有API测试通过
- [ ] 前端功能测试通过
- [ ] 数据库验证通过

---

## 🎉 部署完成后

1. **通知相关人员** - 功能已上线，可以开始使用
2. **监控日志** - 观察是否有异常错误
3. **收集反馈** - 听取用户使用体验
4. **持续优化** - 根据反馈进行优化

---

**预计总时间：** 1小时  
**难度等级：** ⭐⭐ 中等  
**风险等级：** ⭐ 极低