186 lines
4.2 KiB
Markdown
186 lines
4.2 KiB
Markdown
|
# 多身份功能 - 执行清单
|
|||
|
|
|
|||
|
|
> 创建时间：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小时
|
|||
|
|
**难度等级：** ⭐⭐ 中等
|
|||
|
|
**风险等级：** ⭐ 极低
|
|||
|
|
|