张翔
7.7 KiB
7.7 KiB
前端双应用架构迁移检查清单
概述
本检查清单用于验证前端项目（Uniapp和Admin）是否已完成从单API架构到双应用架构的迁移。
迁移前准备
环境检查
- 确认后端client-app已部署并运行在端口8081
- 确认后端admin-app已部署并运行在端口8082
- 确认API网关已配置并正常运行
- 确认网络连接正常，前端可以访问后端服务
备份检查
- 已备份Uniapp项目的当前配置文件
- 已备份Admin项目的当前配置文件
- 已创建Git分支用于迁移工作
- 已记录当前API端点列表
Uniapp迁移检查
环境配置
- 开发环境配置已更新 (
config/env/dev.ts)- baseURL设置为
http://127.0.0.1:8081 - enableMock设置为false
- baseURL设置为
- 测试环境配置已更新 (
config/env/test.ts)- baseURL设置为
https://test.api.ziweidoushu.com - enableMock设置为false
- baseURL设置为
- 生产环境配置已更新 (
config/env/prod.ts)- baseURL设置为
https://api.ziweidoushu.com - enableMock设置为false
- baseURL设置为
- 本地环境配置已更新 (
config/env/local.ts)- baseURL设置为
http://127.0.0.1:8081 - enableMock设置为false
- baseURL设置为
API路径前缀
- 所有API调用已添加
/client/前缀- 日历转换API:
/client/calendar/convert - 农历转换API:
/client/lunar-calendar/convert - 每日运势API:
/client/fortune/daily - 紫微斗数API:
/client/ziwei/analyze - 其他所有API端点
- 日历转换API:
E2E测试配置
- Playwright配置已更新 (
playwright.config.ts)- baseURL使用appConfig.baseURL
- webServer配置正确
- 小程序Playwright配置已更新 (
playwright.miniprogram.config.ts)- baseURL使用appConfig.baseURL
- webServer配置正确
代码验证
- 运行TypeScript编译检查：
npm run type-check - 运行代码检查：
npm run lint - 运行单元测试：
npm run test:unit - 运行E2E测试：
npm run test:e2e
Admin迁移检查
环境配置
- 开发环境配置已更新 (
.env.development)- VITE_API_BASE_URL设置为
http://127.0.0.1:8082 - VITE_MOCK_ENABLED设置为false
- VITE_API_BASE_URL设置为
- 本地开发环境配置已更新 (
.env.development-local)- VITE_API_BASE_URL设置为
http://127.0.0.1:8082 - VITE_MOCK_ENABLED设置为false
- VITE_API_BASE_URL设置为
- 测试环境配置已创建 (
.env.test)- VITE_API_BASE_URL设置为
https://test.api.ziweidoushu.com - VITE_MOCK_ENABLED设置为false
- VITE_API_BASE_URL设置为
- 生产环境配置已更新 (
.env.production)- VITE_API_BASE_URL设置为
https://api.ziweidoushu.com - VITE_MOCK_ENABLED设置为false
- VITE_API_BASE_URL设置为
API配置文件
- API配置文件已更新 (
src/config/api.config.ts)- 所有端点使用
/admin/前缀 - 认证端点:
/admin/auth/* - 用户端点:
/admin/user/* - 角色端点:
/admin/role/* - 菜单端点:
/admin/menu/* - 操作日志端点:
/admin/operationLog/*
- 所有端点使用
API服务文件
- 所有API服务文件已更新
- 认证服务 (
src/api/auth.ts) - 用户服务 (
src/api/user.ts) - 角色服务 (
src/api/role.ts) - 菜单服务 (
src/api/menu.ts) - 操作日志服务 (
src/api/operationLog.ts) - 其他所有服务文件
- 认证服务 (
E2E测试配置
- Playwright配置已更新 (
playwright.config.ts)- baseURL配置正确
- webServer配置正确
- 测试配置已更新 (
e2e/config/test-config.ts)- apiBaseURL设置为
http://127.0.0.1:8082 - 所有端点使用
/admin/前缀
- apiBaseURL设置为
- 测试常量已更新 (
e2e/constants/index.ts)- API_ENDPOINTS常量使用
/admin/前缀
- API_ENDPOINTS常量使用
代码验证
- 运行TypeScript编译检查：
npm run type-check - 运行代码检查：
npm run lint - 运行单元测试：
npm run test:unit - 运行E2E测试：
npm run test:e2e
集成测试
健康检查
- client-app健康检查通过
curl http://127.0.0.1:8081/client/health - admin-app健康检查通过
curl http://127.0.0.1:8082/admin/health
集成测试脚本
- 集成测试脚本已创建 (
scripts/integration-test.js) - 集成测试脚本已运行
- Uniapp所有端点测试通过
- Admin所有端点测试通过
手动测试
Uniapp功能测试
- 用户可以正常打开Uniapp应用
- 日历转换功能正常
- 农历转换功能正常
- 每日运势查询功能正常
- 紫微斗数分析功能正常
- 无网络错误或API调用失败
Admin功能测试
- 用户可以正常打开Admin管理后台
- 登录功能正常
- 用户管理功能正常
- 角色管理功能正常
- 菜单管理功能正常
- 操作日志查询功能正常
- 无网络错误或API调用失败
部署验证
开发环境
- Uniapp开发服务器启动成功
- Admin开发服务器启动成功
- 前端可以正常访问后端API
- 所有功能在开发环境正常工作
测试环境
- Uniapp已部署到测试环境
- Admin已部署到测试环境
- 测试环境API网关配置正确
- 所有功能在测试环境正常工作
生产环境
- Uniapp已部署到生产环境
- Admin已部署到生产环境
- 生产环境API网关配置正确
- HTTPS证书配置正确
- 所有功能在生产环境正常工作
文档更新
- 部署配置文档已创建 (
docs/plans/2026-02-25-frontend-deployment-config.md) - API文档已更新
- README文档已更新
- 变更日志已记录
- 团队成员已通知迁移完成
回滚准备
- 已记录迁移前的Git提交哈希
- 已准备回滚步骤文档
- 已确认可以快速回滚到迁移前状态
- 已备份生产环境配置
最终验收
功能验收
- 所有原有功能正常工作
- 无新增的bug或问题
- 性能无明显下降
- 用户体验无负面影响
安全验收
- API路径前缀正确配置
- CORS配置正确
- 认证授权正常工作
- 无安全漏洞引入
性能验收
- API响应时间在可接受范围内
- 页面加载速度无明显变化
- 无内存泄漏
- 无性能瓶颈
签字确认
| 角色 | 姓名 | 签字 | 日期 |
|---|---|---|---|
| 前端开发负责人 | |||
| 后端开发负责人 | |||
| 测试负责人 | |||
| 运维负责人 | |||
| 项目经理 |
备注
在此记录迁移过程中的重要信息、遇到的问题和解决方案。
检查清单版本: 1.0
创建日期: 2026-02-25
最后更新: 2026-02-25