everything-is-suitable/docs/plans/2026-02-25-frontend-migration-checklist.md

# 前端双应用架构迁移检查清单

## 概述

本检查清单用于验证前端项目（Uniapp和Admin）是否已完成从单API架构到双应用架构的迁移。

## 迁移前准备

### 环境检查

- [ ] 确认后端client-app已部署并运行在端口8081
- [ ] 确认后端admin-app已部署并运行在端口8082
- [ ] 确认API网关已配置并正常运行
- [ ] 确认网络连接正常，前端可以访问后端服务

### 备份检查

- [ ] 已备份Uniapp项目的当前配置文件
- [ ] 已备份Admin项目的当前配置文件
- [ ] 已创建Git分支用于迁移工作
- [ ] 已记录当前API端点列表

## Uniapp迁移检查

### 环境配置

- [ ] 开发环境配置已更新 ([`config/env/dev.ts`](../everything-is-suitable-uniapp/config/env/dev.ts))
  - [ ] baseURL设置为 `http://127.0.0.1:8081`
  - [ ] enableMock设置为false
- [ ] 测试环境配置已更新 ([`config/env/test.ts`](../everything-is-suitable-uniapp/config/env/test.ts))
  - [ ] baseURL设置为 `https://test.api.ziweidoushu.com`
  - [ ] enableMock设置为false
- [ ] 生产环境配置已更新 ([`config/env/prod.ts`](../everything-is-suitable-uniapp/config/env/prod.ts))
  - [ ] baseURL设置为 `https://api.ziweidoushu.com`
  - [ ] enableMock设置为false
- [ ] 本地环境配置已更新 ([`config/env/local.ts`](../everything-is-suitable-uniapp/config/env/local.ts))
  - [ ] baseURL设置为 `http://127.0.0.1:8081`
  - [ ] enableMock设置为false

### API路径前缀

- [ ] 所有API调用已添加 `/client/` 前缀
  - [ ] 日历转换API: `/client/calendar/convert`
  - [ ] 农历转换API: `/client/lunar-calendar/convert`
  - [ ] 每日运势API: `/client/fortune/daily`
  - [ ] 紫微斗数API: `/client/ziwei/analyze`
  - [ ] 其他所有API端点

### E2E测试配置

- [ ] Playwright配置已更新 ([`playwright.config.ts`](../everything-is-suitable-uniapp/playwright.config.ts))
  - [ ] baseURL使用appConfig.baseURL
  - [ ] webServer配置正确
- [ ] 小程序Playwright配置已更新 ([`playwright.miniprogram.config.ts`](../everything-is-suitable-uniapp/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`](../everything-is-suitable-admin/.env.development))
  - [ ] VITE_API_BASE_URL设置为 `http://127.0.0.1:8082`
  - [ ] VITE_MOCK_ENABLED设置为false
- [ ] 本地开发环境配置已更新 ([`.env.development-local`](../everything-is-suitable-admin/.env.development-local))
  - [ ] VITE_API_BASE_URL设置为 `http://127.0.0.1:8082`
  - [ ] VITE_MOCK_ENABLED设置为false
- [ ] 测试环境配置已创建 ([`.env.test`](../everything-is-suitable-admin/.env.test))
  - [ ] VITE_API_BASE_URL设置为 `https://test.api.ziweidoushu.com`
  - [ ] VITE_MOCK_ENABLED设置为false
- [ ] 生产环境配置已更新 ([`.env.production`](../everything-is-suitable-admin/.env.production))
  - [ ] VITE_API_BASE_URL设置为 `https://api.ziweidoushu.com`
  - [ ] VITE_MOCK_ENABLED设置为false

### API配置文件

- [ ] API配置文件已更新 ([`src/config/api.config.ts`](../everything-is-suitable-admin/src/config/api.config.ts))
  - [ ] 所有端点使用 `/admin/` 前缀
  - [ ] 认证端点: `/admin/auth/*`
  - [ ] 用户端点: `/admin/user/*`
  - [ ] 角色端点: `/admin/role/*`
  - [ ] 菜单端点: `/admin/menu/*`
  - [ ] 操作日志端点: `/admin/operationLog/*`

### API服务文件

- [ ] 所有API服务文件已更新
  - [ ] 认证服务 ([`src/api/auth.ts`](../everything-is-suitable-admin/src/api/auth.ts))
  - [ ] 用户服务 ([`src/api/user.ts`](../everything-is-suitable-admin/src/api/user.ts))
  - [ ] 角色服务 ([`src/api/role.ts`](../everything-is-suitable-admin/src/api/role.ts))
  - [ ] 菜单服务 ([`src/api/menu.ts`](../everything-is-suitable-admin/src/api/menu.ts))
  - [ ] 操作日志服务 ([`src/api/operationLog.ts`](../everything-is-suitable-admin/src/api/operationLog.ts))
  - [ ] 其他所有服务文件

### E2E测试配置

- [ ] Playwright配置已更新 ([`playwright.config.ts`](../everything-is-suitable-admin/playwright.config.ts))
  - [ ] baseURL配置正确
  - [ ] webServer配置正确
- [ ] 测试配置已更新 ([`e2e/config/test-config.ts`](../everything-is-suitable-admin/e2e/config/test-config.ts))
  - [ ] apiBaseURL设置为 `http://127.0.0.1:8082`
  - [ ] 所有端点使用 `/admin/` 前缀
- [ ] 测试常量已更新 ([`e2e/constants/index.ts`](../everything-is-suitable-admin/e2e/constants/index.ts))
  - [ ] API_ENDPOINTS常量使用 `/admin/` 前缀

### 代码验证

- [ ] 运行TypeScript编译检查：`npm run type-check`
- [ ] 运行代码检查：`npm run lint`
- [ ] 运行单元测试：`npm run test:unit`
- [ ] 运行E2E测试：`npm run test:e2e`

## 集成测试

### 健康检查

- [ ] client-app健康检查通过
  ```bash
  curl http://127.0.0.1:8081/client/health
  ```
- [ ] admin-app健康检查通过
  ```bash
  curl http://127.0.0.1:8082/admin/health
  ```

### 集成测试脚本

- [ ] 集成测试脚本已创建 ([`scripts/integration-test.js`](../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`](./2026-02-25-frontend-deployment-config.md))
- [ ] API文档已更新
- [ ] README文档已更新
- [ ] 变更日志已记录
- [ ] 团队成员已通知迁移完成

## 回滚准备

- [ ] 已记录迁移前的Git提交哈希
- [ ] 已准备回滚步骤文档
- [ ] 已确认可以快速回滚到迁移前状态
- [ ] 已备份生产环境配置

## 最终验收

### 功能验收

- [ ] 所有原有功能正常工作
- [ ] 无新增的bug或问题
- [ ] 性能无明显下降
- [ ] 用户体验无负面影响

### 安全验收

- [ ] API路径前缀正确配置
- [ ] CORS配置正确
- [ ] 认证授权正常工作
- [ ] 无安全漏洞引入

### 性能验收

- [ ] API响应时间在可接受范围内
- [ ] 页面加载速度无明显变化
- [ ] 无内存泄漏
- [ ] 无性能瓶颈

## 签字确认

| 角色 | 姓名 | 签字 | 日期 |
|------|------|------|------|
| 前端开发负责人 | | | |
| 后端开发负责人 | | | |
| 测试负责人 | | | |
| 运维负责人 | | | |
| 项目经理 | | | |

## 备注

在此记录迁移过程中的重要信息、遇到的问题和解决方案。

---

**检查清单版本**: 1.0  
**创建日期**: 2026-02-25  
**最后更新**: 2026-02-25