增加后端，后台管理系统，uniapp会员端的自动化测试。

2026-07-21 18:09:29 +08:00
parent df0e68469b
commit 6b60b3b4da
64 changed files with 13095 additions and 376 deletions
@@ -0,0 +1,156 @@
+# 小程序 E2E 自动化测试
+
+## 测试范围
+
+| 套件 | 文件 | 用例数 | 覆盖内容 |
+|---|---|---|---|
+| 冒烟测试 | `smoke/app-launch.spec.js` | 2 | 首页加载、TabBar 导航（4 个 tab 互切） |
+| 个人中心旅程 | `journeys/profile-journey.spec.js` | 2 | 我的课程页、个人中心（会员信息） |
+| 团课预约旅程 | `journeys/booking-journey.spec.js` | 3 | 首页课程元素、搜索功能（"瑜伽"）、课程卡片→详情 |
+
+---
+
+## 环境要求
+
+- 微信开发者工具（安装路径 `D:\微信web开发者工具\`）
+- 小程序项目已编译：`unpackage/dist/dev/mp-weixin`
+- 服务端口：`63956`（默认，可通过 `WECHAT_DEVTOOLS_PORT` 环境变量修改）
+
+---
+
+## 触发方式
+
+### 1. npm scripts（日常开发首选）
+
+| 命令 | 说明 | IDE 管理 |
+|---|---|---|
+| `npm test` | 全量测试 | 自动启动，保持运行 |
+| `npm run test:smoke` | 仅冒烟测试 | 自动启动，保持运行 |
+| `npm run test:journeys` | 仅用户旅程测试 | 自动启动，保持运行 |
+| `npm run test:profile` | 仅个人中心 | 自动启动，保持运行 |
+| `npm run test:booking` | 仅团课预约 | 自动启动，保持运行 |
+| `npm run test:all` | 全量 + 测试后关闭 IDE | 自动启动，自动关闭 |
+| `npm run test:watch` | Watch 模式（文件变更自动重测） | 需要 IDE 预先运行 |
+| `npm run test:quick` | 快速运行（IDE 需已开启） | 不管理 IDE |
+| `npm run test:quick:smoke` | 快速冒烟（IDE 需已开启） | 不管理 IDE |
+
+### 2. 一键脚本
+
+```powershell
+# 全量测试
+node e2e/run-tests.js
+
+# 仅冒烟
+node e2e/run-tests.js --smoke
+
+# 仅用户旅程
+node e2e/run-tests.js --journeys
+
+# 全量 + 关闭 IDE（CI 用）
+node e2e/run-tests.js --close
+
+# 详细日志
+node e2e/run-tests.js --verbose
+
+# Watch 模式
+node e2e/run-tests.js --watch
+```
+
+### 3. IDE 保持运行 + 反复快测
+
+```powershell
+# 首次：启动 IDE
+npm test
+
+# 后续修改代码后：秒级快速验证
+npm run test:quick
+npm run test:quick:smoke
+```
+
+### 4. Git Pre-commit Hook
+
+安装：
+
+```bash
+# 方式 A：Husky（推荐）
+npx husky init
+npx husky add .husky/pre-commit "sh gym-manage-uniapp/scripts/pre-commit-miniapp-test.sh"
+
+# 方式 B：手动
+cp scripts/pre-commit-miniapp-test.sh .git/hooks/pre-commit
+```
+
+行为：
+- 仅当 `gym-manage-uniapp/pages/` 或 `gym-manage-uniapp/e2e/` 有变更 **且** IDE 在运行时触发
+- 不满足条件 → 静默跳过，不阻塞提交
+- 失败时提示 `git commit --no-verify` 可跳过
+
+### 5. Jenkins CI
+
+```
+Jenkins → Build with Parameters → TEST_SCOPE = miniapp
+```
+
+Pipeline 自动完成：编译 → 启动 IDE → 测试 → 关闭 IDE → 归档报告。
+
+---
+
+## 架构
+
+```
+e2e/
+├── jest.config.js          # Jest 配置（maxWorkers:1 顺序执行）
+├── setup.js                # 全局变量注入
+├── globalSetup.js          # 测试前准备
+├── globalTeardown.js       # 测试后清理（不关 IDE）
+├── run-tests.js            # ★ 主入口：IDE 管理 + 测试调度
+├── helpers/
+│   └── automator.js        # 连接/断开 IDE（单例模式）
+├── pages/                  # Page Object 层
+│   ├── HomePage.js
+│   ├── LoginPage.js
+│   ├── SearchPage.js
+│   ├── CourseDetailPage.js
+│   ├── ProfilePage.js
+│   └── MyCoursesPage.js
+├── smoke/
+│   └── app-launch.spec.js  # 冒烟测试
+└── journeys/
+    ├── profile-journey.spec.js
+    └── booking-journey.spec.js
+```
+
+---
+
+## 执行顺序与状态管理
+
+```
+suite 执行顺序（jest.config.js 中 testMatch 固定）：
+  1. smoke/app-launch.spec.js     → 结束于 index tabbar ✓
+  2. journeys/profile-journey     → 结束于 index tabbar ✓
+  3. journeys/booking-journey     → 最后一个测试进入 course-detail（非 tabbar）
+                                     ↑ 放在最后执行，不影响后续套件
+```
+
+**关键约束**：`miniprogram-automator` 的 `switchTab` / `reLaunch` 从非 tabbar 页面调用会超时。所有测试必须确保：
+- 从 tabbar 页面开始（每个测试自己 `switchTab` 到目标 tab）
+- 最后一个套件的最后一个测试可以进入非 tabbar 页面
+
+---
+
+## 环境变量
+
+| 变量 | 默认值 | 说明 |
+|---|---|---|
+| `WECHAT_DEVTOOLS_CLI` | `D:\微信web开发者工具\cli.bat` | 微信开发者工具 CLI 路径 |
+| `UNIAPP_OUTPUT` | `unpackage/dist/dev/mp-weixin` | 小程序编译输出目录 |
+| `WECHAT_DEVTOOLS_PORT` | `63956` | 自动化服务端口 |
+
+---
+
+## 已知限制
+
+1. `miniprogram-automator` 的 `switchTab` / `reLaunch` 从非 tabbar 页（如 course-detail）调用会超时 10s
+2. 微信开发者工具 CLI 路径含中文，需 `shell: true` 启动
+3. 多个测试套件不能共享 IDE 时同时运行（`maxWorkers: 1`）
+4. 搜索页 `.clickResult()` 不会触发页面跳转（搜索结果为同页内展示）