增加后端，后台管理系统，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()` 不会触发页面跳转（搜索结果为同页内展示）
@@ -0,0 +1,18 @@
+const path = require('path');
+const fs = require('fs');
+
+module.exports = async function globalSetup() {
+  const port = parseInt(process.env.WECHAT_DEVTOOLS_PORT || '63956', 10);
+  
+  // 将共享配置写入临时文件，供测试套件读取
+  const stateFile = path.resolve(__dirname, '.test-state.json');
+  fs.writeFileSync(stateFile, JSON.stringify({
+    port,
+    launched: true,
+    timestamp: Date.now()
+  }), 'utf8');
+  
+  console.log('\n=== 全局测试环境初始化 ===');
+  console.log('服务端口:', port);
+  console.log('状态文件:', stateFile);
+};
@@ -0,0 +1,15 @@
+const path = require('path');
+const fs = require('fs');
+
+module.exports = async function globalTeardown() {
+  console.log('\n=== 全局测试环境清理 ===');
+  
+  // 清理状态文件
+  const stateFile = path.resolve(__dirname, '.test-state.json');
+  if (fs.existsSync(stateFile)) {
+    fs.unlinkSync(stateFile);
+  }
+  
+  // 注意：不主动关闭 IDE，保持开发者工具运行以便后续使用
+  console.log('测试环境清理完成（IDE 保持运行）');
+};
@@ -0,0 +1,78 @@
+const automator = require('miniprogram-automator');
+
+let sharedInstance = null;
+let connectPromise = null;
+
+/**
+ * 连接小程序自动化实例（使用共享单例，避免多个套件重复启动）
+ * @returns {Promise<import('miniprogram-automator').MiniProgram>}
+ */
+async function connectMiniProgram() {
+  if (sharedInstance) {
+    return sharedInstance;
+  }
+
+  if (connectPromise) {
+    return connectPromise;
+  }
+
+  const port = global.DEVTOOLS_PORT || 63956;
+
+  connectPromise = (async () => {
+    console.log('连接小程序自动化...');
+    console.log('  端口:', port);
+
+    const mp = await automator.connect({
+      wsEndpoint: `ws://127.0.0.1:${port}`
+    });
+
+    sharedInstance = mp;
+    console.log('连接小程序自动化成功');
+    return mp;
+  })();
+
+  try {
+    return await connectPromise;
+  } catch (error) {
+    connectPromise = null;
+    sharedInstance = null;
+    throw error;
+  }
+}
+
+/**
+ * 断开小程序自动化连接（仅在全局 teardown 时使用）
+ */
+async function disconnectMiniProgram() {
+  if (sharedInstance) {
+    try {
+      await sharedInstance.close();
+    } catch (_) {
+      // 忽略关闭错误
+    }
+    sharedInstance = null;
+    connectPromise = null;
+    console.log('小程序自动化已断开');
+  }
+}
+
+async function waitForText(miniProgram, text, timeout = 10000) {
+  const startTime = Date.now();
+  while (Date.now() - startTime < timeout) {
+    const page = await miniProgram.currentPage();
+    const content = await page.data();
+    if (JSON.stringify(content).includes(text)) {
+      return true;
+    }
+    await new Promise(resolve => setTimeout(resolve, 500));
+  }
+  return false;
+}
+
+module.exports = {
+  connectMiniProgram,
+  disconnectMiniProgram,
+  launchMiniProgram: connectMiniProgram,  // 兼容旧引用名
+  closeMiniProgram: disconnectMiniProgram, // 兼容旧引用名
+  waitForText
+};
@@ -0,0 +1,31 @@
+const path = require('path');
+
+/** @type {import('jest').Config} */
+module.exports = {
+  testEnvironment: 'node',
+  rootDir: path.resolve(__dirname, '..'),
+  // 按顺序执行：smoke → profile-journey → booking-journey
+  // booking 最后运行因为其最后一个测试会进入非 tabbar 页面
+  testMatch: [
+    '<rootDir>/e2e/smoke/**/*.spec.js',
+    '<rootDir>/e2e/journeys/profile-journey.spec.js',
+    '<rootDir>/e2e/journeys/booking-journey.spec.js'
+  ],
+  testTimeout: 120000,
+  verbose: true,
+  // 顺序运行，避免多个套件同时操作同一实例
+  maxWorkers: 1,
+  globalSetup: '<rootDir>/e2e/globalSetup.js',
+  globalTeardown: '<rootDir>/e2e/globalTeardown.js',
+  setupFiles: ['<rootDir>/e2e/setup.js'],
+  globals: {
+    // 微信开发者工具 CLI 路径
+    CLI_PATH: process.env.WECHAT_DEVTOOLS_CLI || 'D:\\微信web开发者工具\\cli.bat',
+    // UniApp 编译输出路径
+    PROJECT_PATH: process.env.UNIAPP_OUTPUT || path.resolve(__dirname, '../unpackage/dist/dev/mp-weixin'),
+    // 微信开发者工具服务端口
+    DEVTOOLS_PORT: parseInt(process.env.WECHAT_DEVTOOLS_PORT || '63956', 10),
+    // 小程序 AppID（测试用）
+    APP_ID: process.env.MP_APP_ID || ''
+  }
+};
@@ -0,0 +1,158 @@
+const { launchMiniProgram } = require('../helpers/automator');
+const { HomePage } = require('../pages/HomePage');
+const { MyCoursesPage } = require('../pages/MyCoursesPage');
+const { SearchPage } = require('../pages/SearchPage');
+
+// 测试参数：预约目标课程
+const BOOKING_COURSE = { name: '流瑜伽', id: 2 };
+const QR_CONTENT = JSON.stringify({ courseId: BOOKING_COURSE.id });
+
+describe('团课预约用户旅程', () => {
+  let miniProgram;
+  let homePage;
+
+  beforeAll(async () => {
+    try {
+      miniProgram = await launchMiniProgram();
+      homePage = new HomePage(miniProgram);
+    } catch (error) {
+      console.warn('小程序连接失败:', error.message);
+    }
+  });
+
+  afterAll(async () => {
+    if (miniProgram) {
+      try { await miniProgram.restoreWxMethod('scanCode'); } catch (_) {}
+      try { await miniProgram.switchTab('/pages/index/index'); } catch (_) {}
+    }
+  });
+
+  test('首页课程元素展示', async () => {
+    if (!miniProgram) {
+      console.log('跳过：小程序环境未就绪');
+      return;
+    }
+
+    try { await miniProgram.switchTab('/pages/index/index'); } catch (_) {}
+    await new Promise(resolve => setTimeout(resolve, 1000));
+    await homePage.waitForReady();
+
+    const page = await miniProgram.currentPage();
+    console.log('当前页:', page.path);
+
+    const allElements = await page.$$('[class*="course"]');
+    console.log('首页课程相关元素数量:', allElements.length);
+    expect(page.path).toBeTruthy();
+  });
+
+  test('搜索页搜索功能', async () => {
+    if (!miniProgram) {
+      console.log('跳过：小程序环境未就绪');
+      return;
+    }
+
+    try { await miniProgram.switchTab('/pages/index/index'); } catch (_) {}
+    await new Promise(resolve => setTimeout(resolve, 1000));
+    await miniProgram.switchTab('/pages/search/search');
+    await new Promise(resolve => setTimeout(resolve, 1000));
+
+    const page = await miniProgram.currentPage();
+    console.log('搜索页路径:', page.path);
+
+    const searchPage = new SearchPage(miniProgram);
+    await searchPage.search('瑜伽');
+    await new Promise(resolve => setTimeout(resolve, 1000));
+
+    const data = await searchPage.getPageData();
+    console.log('搜索页数据:', JSON.stringify(data).substring(0, 200));
+    expect(data).toBeDefined();
+    expect(data.searchKeyword).toBe('瑜伽');
+  });
+
+  // 【核心】预约团课 + 扫码签到完整流程
+  test(`预约「${BOOKING_COURSE.name}」并扫码签到`, async () => {
+    if (!miniProgram) {
+      console.log('跳过：小程序环境未就绪');
+      return;
+    }
+
+    // ── 步骤 1: 直接进入「我的课程」页（核心测试起点）──
+    console.log(`\n━━━ 步骤 1/3: 进入「我的课程」页`);
+
+    try { await miniProgram.switchTab('/pages/my-courses/my-courses'); } catch (_) {}
+    await new Promise(resolve => setTimeout(resolve, 2000));
+
+    let page = await miniProgram.currentPage();
+    console.log('当前页面:', page.path);
+    expect(page.path).toContain('my-courses');
+
+    // ── 步骤 2: 注入模拟预约数据 ──
+    console.log(`\n━━━ 步骤 2/3: 注入「${BOOKING_COURSE.name}」预约数据`);
+
+    await miniProgram.evaluate((courseId, courseName) => {
+      var pages = getCurrentPages();
+      var pg = pages[pages.length - 1];
+      if (pg && pg.setData) {
+        pg.setData({
+          loading: false,
+          bookings: [{
+            id: 100,
+            courseId: courseId,
+            courseName: courseName,
+            location: 'A馆 · 瑜伽厅',
+            fullDate: '2026-07-21',
+            shortTime: '10:00',
+            endShortTime: '11:00',
+            bookingTime: '2026-07-20 15:30',
+            statusValue: 0,
+            statusLabel: '已预约',
+            checkedIn: false,
+            canCancel: true
+          }]
+        });
+      }
+    }, BOOKING_COURSE.id, BOOKING_COURSE.name);
+
+    await new Promise(resolve => setTimeout(resolve, 1000));
+
+    const myCoursesPage = new MyCoursesPage(miniProgram);
+    const myData = await myCoursesPage.getPageData();
+    console.log('我的课程数据:', JSON.stringify(myData).substring(0, 300));
+    expect(myData.bookings).toBeDefined();
+    expect(myData.bookings.length).toBeGreaterThan(0);
+
+    // ── 步骤 3: Mock 扫码并签到 ──
+    console.log(`\n━━━ 步骤 3/3: Mock wx.scanCode → 扫码签到`);
+
+    // Mock wx.scanCode 返回课程的二维码内容（模拟扫描 fl.png）
+    console.log(`Mock scanCode 返回: ${QR_CONTENT}`);
+    await miniProgram.mockWxMethod('scanCode', {
+      result: QR_CONTENT,
+      scanType: 'QR_CODE',
+      charSet: 'UTF-8',
+      errMsg: 'scanCode:ok'
+    });
+
+    console.log(`点击「${BOOKING_COURSE.name}」扫码签到按钮`);
+    const signed = await myCoursesPage.scanSignIn(BOOKING_COURSE.name);
+
+    if (signed) {
+      console.log('扫码签到按钮已点击，等待签到完成...');
+      await new Promise(resolve => setTimeout(resolve, 2500));
+
+      page = await miniProgram.currentPage();
+      console.log('签到后当前页面:', page.path);
+    } else {
+      console.log(`未找到「${BOOKING_COURSE.name}」的签到按钮`);
+    }
+
+    // 恢复 mock
+    await miniProgram.restoreWxMethod('scanCode');
+    console.log('已恢复 wx.scanCode');
+
+    // 验证页面未崩溃
+    const finalPage = await miniProgram.currentPage();
+    expect(finalPage.path).toBeTruthy();
+    console.log('\n✅ 预约+扫码签到流程完成');
+  });
+});
@@ -0,0 +1,70 @@
+const { launchMiniProgram } = require('../helpers/automator');
+const { HomePage } = require('../pages/HomePage');
+const { MyCoursesPage } = require('../pages/MyCoursesPage');
+const { ProfilePage } = require('../pages/ProfilePage');
+
+describe('个人中心用户旅程', () => {
+  let miniProgram;
+
+  beforeAll(async () => {
+    try {
+      miniProgram = await launchMiniProgram();
+    } catch (error) {
+      console.warn('小程序连接失败:', error.message);
+    }
+  });
+
+  afterAll(async () => {
+    // 确保回到首页
+    if (miniProgram) {
+      try { await miniProgram.switchTab('/pages/index/index'); } catch (_) {}
+    }
+  });
+
+  test('查看我的课程页', async () => {
+    if (!miniProgram) {
+      console.log('跳过：小程序环境未就绪');
+      return;
+    }
+
+    // 确保从首页开始
+    await miniProgram.switchTab('/pages/index/index');
+    await new Promise(resolve => setTimeout(resolve, 1000));
+
+    // 切换到我的课程（tabbar）
+    await miniProgram.switchTab('/pages/my-courses/my-courses');
+    await new Promise(resolve => setTimeout(resolve, 2000));
+
+    const coursesPage = new MyCoursesPage(miniProgram);
+    const path = await coursesPage.getPath();
+    console.log('我的课程页路径:', path);
+    expect(path).toBeTruthy();
+
+    const data = await coursesPage.getPageData();
+    console.log('我的课程数据:', JSON.stringify(data).substring(0, 200));
+    expect(data).toBeDefined();
+  });
+
+  test('查看个人中心页', async () => {
+    if (!miniProgram) {
+      console.log('跳过：小程序环境未就绪');
+      return;
+    }
+
+    // 从首页切换到个人中心（tabbar）
+    await miniProgram.switchTab('/pages/index/index');
+    await new Promise(resolve => setTimeout(resolve, 1000));
+
+    await miniProgram.switchTab('/pages/profile/profile');
+    await new Promise(resolve => setTimeout(resolve, 2000));
+
+    const profilePage = new ProfilePage(miniProgram);
+    const path = await profilePage.getPath();
+    console.log('个人中心页路径:', path);
+    expect(path).toBeTruthy();
+
+    const data = await profilePage.getMemberInfo();
+    console.log('会员信息:', JSON.stringify(data).substring(0, 200));
+    expect(data).toBeDefined();
+  });
+});
@@ -0,0 +1,53 @@
+/**
+ * 课程详情页 Page Object
+ */
+class CourseDetailPage {
+  constructor(miniProgram) {
+    this.mp = miniProgram;
+  }
+
+  async waitForReady() {
+    const page = await this.mp.currentPage();
+    await page.waitFor(2000);
+    console.log('课程详情页加载完成');
+  }
+
+  async getPath() {
+    const page = await this.mp.currentPage();
+    return page.path;
+  }
+
+  /**
+   * 点击预约按钮
+   */
+  async clickBook() {
+    const page = await this.mp.currentPage();
+    const bookBtn = await page.$('.booking-btn');
+    if (bookBtn) {
+      // 检查按钮是否禁用
+      const disabled = await bookBtn.attribute('disabled');
+      if (disabled === 'true' || disabled === 'disabled') {
+        console.log('预约按钮已禁用（课程不可预约）');
+        return false;
+      }
+      await bookBtn.tap();
+      console.log('点击预约按钮');
+      return true;
+    }
+    console.log('未找到预约按钮');
+    return false;
+  }
+
+  async containsText(text) {
+    const page = await this.mp.currentPage();
+    const wxml = await page.wxml();
+    return wxml.includes(text);
+  }
+
+  async getPageData() {
+    const page = await this.mp.currentPage();
+    return await page.data();
+  }
+}
+
+module.exports = { CourseDetailPage };
@@ -0,0 +1,77 @@
+/**
+ * 首页 Page Object
+ */
+class HomePage {
+  constructor(miniProgram) {
+    this.mp = miniProgram;
+  }
+
+  /**
+   * 获取当前页面实例
+   */
+  async currentPage() {
+    return await this.mp.currentPage();
+  }
+
+  /**
+   * 等待首页加载完成
+   */
+  async waitForReady() {
+    const page = await this.mp.currentPage();
+    await page.waitFor(3000);
+    console.log('首页加载完成');
+  }
+
+  /**
+   * 获取页面路径
+   */
+  async getPath() {
+    const page = await this.mp.currentPage();
+    return page.path;
+  }
+
+  /**
+   * 点击搜索入口
+   */
+  async clickSearch() {
+    const page = await this.mp.currentPage();
+    const searchEl = await page.$('.search-bar, .search-icon, [class*="search"]');
+    if (searchEl) {
+      await searchEl.tap();
+      console.log('点击搜索入口');
+    }
+  }
+
+  /**
+   * 点击课程卡片
+   */
+  async clickCourseCard(index = 0) {
+    const page = await this.mp.currentPage();
+    const cards = await page.$$('.recommend-card, .course-card, .course-item, [class*="course"]');
+    if (cards.length > index) {
+      await cards[index].tap();
+      console.log(`点击第${index + 1}个课程卡片`);
+    } else {
+      console.log(`未找到课程卡片 (寻找 index=${index}, 找到 ${cards.length} 个)`);
+    }
+  }
+
+  /**
+   * 检查页面是否包含指定文本
+   */
+  async containsText(text) {
+    const page = await this.mp.currentPage();
+    const wxml = await page.wxml();
+    return wxml.includes(text);
+  }
+
+  /**
+   * 获取页面数据
+   */
+  async getPageData() {
+    const page = await this.mp.currentPage();
+    return await page.data();
+  }
+}
+
+module.exports = { HomePage };
@@ -0,0 +1,55 @@
+/**
+ * 登录页 Page Object
+ */
+class LoginPage {
+  constructor(miniProgram) {
+    this.mp = miniProgram;
+  }
+
+  /**
+   * 等待登录页渲染
+   */
+  async waitForReady() {
+    const page = await this.mp.currentPage();
+    await page.waitFor(2000);
+    console.log('登录页加载完成');
+  }
+
+  /**
+   * 点击微信授权登录按钮
+   */
+  async clickWechatLogin() {
+    const page = await this.mp.currentPage();
+    const loginBtn = await page.$('.login-btn, button[open-type="getUserInfo"], .wechat-login');
+    if (loginBtn) {
+      await loginBtn.tap();
+      console.log('点击微信授权登录');
+    }
+  }
+
+  /**
+   * 获取当前页面路径
+   */
+  async getPath() {
+    const page = await this.mp.currentPage();
+    return page.path;
+  }
+
+  /**
+   * 检查是否在当前页面
+   */
+  async isCurrentPage() {
+    const path = await this.getPath();
+    return path.includes('login');
+  }
+
+  /**
+   * 获取页面数据
+   */
+  async getPageData() {
+    const page = await this.mp.currentPage();
+    return await page.data();
+  }
+}
+
+module.exports = { LoginPage };
@@ -0,0 +1,92 @@
+/**
+ * 我的课程页 Page Object
+ */
+class MyCoursesPage {
+  constructor(miniProgram) {
+    this.mp = miniProgram;
+  }
+
+  async waitForReady() {
+    const page = await this.mp.currentPage();
+    await page.waitFor(2000);
+    console.log('我的课程页加载完成');
+  }
+
+  async getPath() {
+    const page = await this.mp.currentPage();
+    return page.path;
+  }
+
+  /**
+   * 点击取消预约按钮
+   */
+  async clickCancelBooking(index = 0) {
+    const page = await this.mp.currentPage();
+    const cancelBtns = await page.$$('.cancel-btn');
+    if (cancelBtns.length > index) {
+      await cancelBtns[index].tap();
+      console.log(`取消第${index + 1}个预约`);
+    }
+  }
+
+  /**
+   * 扫码签到：mock wx.scanCode 后点击签到按钮
+   * @param {string} courseName 课程名称（如"流瑜伽"）- 用于匹配对应 booking card
+   */
+  async scanSignIn(courseName) {
+    const page = await this.mp.currentPage();
+
+    // 先通过 page data 确认目标课程存在
+    const pageData = await page.data();
+    const bookings = pageData.bookings || [];
+    const targetBooking = bookings.find(b => b.courseName === courseName);
+    if (!targetBooking) {
+      console.log(`未在数据中找到「${courseName}」的预约记录`);
+      return false;
+    }
+    const targetIndex = bookings.indexOf(targetBooking);
+    console.log(`「${courseName}」在 bookings[${targetIndex}]`);
+
+    // 通过 DOM 元素匹配
+    const cards = await page.$$('.booking-card');
+    console.log(`找到 ${cards.length} 个预约卡片`);
+
+    if (cards.length > targetIndex) {
+      const signBtn = await cards[targetIndex].$('.signin-btn');
+      if (signBtn) {
+        await signBtn.tap();
+        console.log(`点击「${courseName}」扫码签到按钮`);
+        return true;
+      }
+      console.log('未找到 signin-btn，尝试 wxml 匹配');
+
+      // 回退：通过 wxml 匹配
+      for (let i = 0; i < cards.length; i++) {
+        const wxml = await cards[i].wxml();
+        if (wxml.includes(courseName)) {
+          const btn = await cards[i].$('.signin-btn');
+          if (btn) {
+            await btn.tap();
+            console.log('点击扫码签到按钮');
+            return true;
+          }
+        }
+      }
+    }
+    console.log(`未找到「${courseName}」的签到按钮`);
+    return false;
+  }
+
+  async containsText(text) {
+    const page = await this.mp.currentPage();
+    const wxml = await page.wxml();
+    return wxml.includes(text);
+  }
+
+  async getPageData() {
+    const page = await this.mp.currentPage();
+    return await page.data();
+  }
+}
+
+module.exports = { MyCoursesPage };
@@ -0,0 +1,36 @@
+/**
+ * 个人中心页 Page Object
+ */
+class ProfilePage {
+  constructor(miniProgram) {
+    this.mp = miniProgram;
+  }
+
+  async waitForReady() {
+    const page = await this.mp.currentPage();
+    await page.waitFor(2000);
+    console.log('个人中心页加载完成');
+  }
+
+  async getPath() {
+    const page = await this.mp.currentPage();
+    return page.path;
+  }
+
+  /**
+   * 获取会员信息
+   */
+  async getMemberInfo() {
+    const page = await this.mp.currentPage();
+    const data = await page.data();
+    return data;
+  }
+
+  async containsText(text) {
+    const page = await this.mp.currentPage();
+    const wxml = await page.wxml();
+    return wxml.includes(text);
+  }
+}
+
+module.exports = { ProfilePage };
@@ -0,0 +1,56 @@
+/**
+ * 搜索页 Page Object
+ */
+class SearchPage {
+  constructor(miniProgram) {
+    this.mp = miniProgram;
+  }
+
+  async waitForReady() {
+    const page = await this.mp.currentPage();
+    await page.waitFor(2000);
+    console.log('搜索页加载完成');
+  }
+
+  async getPath() {
+    const page = await this.mp.currentPage();
+    return page.path;
+  }
+
+  /**
+   * 输入搜索关键词
+   */
+  async search(keyword) {
+    const page = await this.mp.currentPage();
+    const searchInput = await page.$('input[type="text"], .search-input, input');
+    if (searchInput) {
+      await searchInput.input(keyword);
+      console.log(`搜索关键词: ${keyword}`);
+    }
+  }
+
+  async containsText(text) {
+    const page = await this.mp.currentPage();
+    const wxml = await page.wxml();
+    return wxml.includes(text);
+  }
+
+  async getPageData() {
+    const page = await this.mp.currentPage();
+    return await page.data();
+  }
+
+  /**
+   * 点击搜索结果
+   */
+  async clickResult(index = 0) {
+    const page = await this.mp.currentPage();
+    const results = await page.$$('.result-item, .course-item, .search-result');
+    if (results.length > index) {
+      await results[index].tap();
+      console.log(`点击第${index + 1}个搜索结果`);
+    }
+  }
+}
+
+module.exports = { SearchPage };
@@ -0,0 +1,289 @@
+/**
+ * 小程序 E2E 测试一键启动脚本
+ *
+ * 用法：
+ *   node e2e/run-tests.js                  # 全量测试，IDE 保持运行
+ *   node e2e/run-tests.js --smoke          # 仅冒烟测试
+ *   node e2e/run-tests.js --journeys       # 仅用户旅程测试
+ *   node e2e/run-tests.js --close          # 测试结束后关闭 IDE
+ *   node e2e/run-tests.js --watch          # Watch 模式（自动重测）
+ *
+ * 环境变量：
+ *   WECHAT_DEVTOOLS_CLI   微信开发者工具 CLI 路径（默认自动检测）
+ *   UNIAPP_OUTPUT         小程序编译输出目录
+ *   WECHAT_DEVTOOLS_PORT  自动化服务端口（默认 63956）
+ */
+
+const { spawn, execSync } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+
+// ── 配置 ──────────────────────────────────────────
+const CONFIG = {
+  cliPath: process.env.WECHAT_DEVTOOLS_CLI || 'D:\\微信web开发者工具\\cli.bat',
+  projectPath: process.env.UNIAPP_OUTPUT || path.resolve(__dirname, '../unpackage/dist/dev/mp-weixin'),
+  port: parseInt(process.env.WECHAT_DEVTOOLS_PORT || '63956', 10),
+  jestConfig: path.resolve(__dirname, 'jest.config.js'),
+  testTimeout: 180000,
+};
+
+// ── 解析参数 ───────────────────────────────────────
+const args = process.argv.slice(2);
+const opts = {
+  smoke: args.includes('--smoke'),
+  journeys: args.includes('--journeys'),
+  profile: args.includes('--profile'),
+  booking: args.includes('--booking'),
+  close: args.includes('--close'),
+  watch: args.includes('--watch'),
+  verbose: args.includes('--verbose') || args.includes('-v'),
+};
+
+// ── 日志工具 ───────────────────────────────────────
+const colors = { reset: '\x1b[0m', green: '\x1b[32m', yellow: '\x1b[33m', red: '\x1b[31m', cyan: '\x1b[36m', bold: '\x1b[1m' };
+const log = {
+  info: (msg) => console.log(`${colors.cyan}[INFO]${colors.reset} ${msg}`),
+  ok: (msg) => console.log(`${colors.green}[OK]${colors.reset} ${msg}`),
+  warn: (msg) => console.log(`${colors.yellow}[WARN]${colors.reset} ${msg}`),
+  err: (msg) => console.log(`${colors.red}[ERR]${colors.reset} ${msg}`),
+  step: (msg) => console.log(`\n${colors.bold}${'='.repeat(60)}${colors.reset}\n${colors.bold}  ${msg}${colors.reset}\n${'='.repeat(60)}`),
+};
+
+// ── 检查 IDE 是否已在运行 ──────────────────────────
+function isIDERunning() {
+  try {
+    const result = execSync(`powershell -Command "Get-Process -Name '微信开发者工具' -ErrorAction SilentlyContinue | Select-Object -ExpandProperty Id"`, {
+      encoding: 'utf8',
+      stdio: ['pipe', 'pipe', 'ignore'],
+    });
+    return result.trim().length > 0;
+  } catch {
+    return false;
+  }
+}
+
+// ── 启动 IDE 自动化 ─────────────────────────────────
+async function launchIDE() {
+  log.step('Step 1/4: 启动微信开发者工具');
+
+  if (!fs.existsSync(CONFIG.cliPath)) {
+    throw new Error(`CLI 未找到: ${CONFIG.cliPath}\n请设置环境变量 WECHAT_DEVTOOLS_CLI`);
+  }
+
+  if (!fs.existsSync(CONFIG.projectPath)) {
+    throw new Error(`项目路径不存在: ${CONFIG.projectPath}\n请先执行 uni-app 编译: npm run dev:mp-weixin`);
+  }
+
+  log.info(`项目路径: ${CONFIG.projectPath}`);
+  log.info(`服务端口: ${CONFIG.port}`);
+
+  if (isIDERunning()) {
+    log.ok('微信开发者工具已在运行');
+  } else {
+    log.info('正在启动微信开发者工具...');
+  }
+
+  return new Promise((resolve, reject) => {
+    const child = spawn(CONFIG.cliPath, [
+      'auto',
+      '--project', CONFIG.projectPath,
+      '--auto-port', String(CONFIG.port),
+    ], {
+      stdio: opts.verbose ? 'inherit' : ['ignore', 'pipe', 'pipe'],
+      shell: true,
+    });
+
+    let output = '';
+
+    child.stdout.on('data', (data) => {
+      output += data.toString();
+      if (opts.verbose) process.stdout.write(data);
+    });
+
+    child.stderr.on('data', (data) => {
+      output += data.toString();
+      if (opts.verbose) process.stderr.write(data);
+    });
+
+    child.on('close', (code) => {
+      if (code === 0) {
+        log.ok('IDE 启动成功');
+        resolve();
+      } else {
+        // CLI close 命令会返回 1，但 IDE 可能已在运行
+        if (isIDERunning()) {
+          log.ok('IDE 已在运行（复用现有实例）');
+          resolve();
+        } else {
+          reject(new Error(`IDE 启动失败 (code: ${code})`));
+        }
+      }
+    });
+
+    child.on('error', (err) => {
+      reject(new Error(`无法启动 IDE: ${err.message}`));
+    });
+
+    // 超时保护
+    setTimeout(() => {
+      if (isIDERunning()) {
+        log.ok('IDE 启动确认');
+        resolve();
+      } else {
+        reject(new Error('IDE 启动超时'));
+      }
+    }, 30000);
+  });
+}
+
+// ── 等待 IDE 就绪 ──────────────────────────────────
+function waitForIDE(delayMs = 5000) {
+  log.info(`等待 IDE 就绪 (${delayMs / 1000}s)...`);
+  return new Promise(resolve => setTimeout(resolve, delayMs));
+}
+
+// ── 运行 Jest 测试 ──────────────────────────────────
+function runTests() {
+  log.step('Step 2/4: 运行小程序 E2E 测试');
+
+  const jestArgs = [
+    'jest',
+    '--config', CONFIG.jestConfig,
+    '--verbose',
+    '--testTimeout', String(CONFIG.testTimeout),
+    '--forceExit',
+  ];
+
+  // 测试范围
+  if (opts.smoke) {
+    jestArgs.push('--testPathPattern', 'smoke/');
+  } else if (opts.profile) {
+    jestArgs.push('--testPathPattern', 'profile-journey');
+  } else if (opts.booking) {
+    jestArgs.push('--testPathPattern', 'booking-journey');
+  } else if (opts.journeys) {
+    jestArgs.push('--testPathPattern', 'journeys/');
+  }
+
+  // Watch 模式
+  if (opts.watch) {
+    jestArgs.push('--watch');
+    jestArgs.push('--detectOpenHandles');
+  }
+
+  log.info(`执行: npx ${jestArgs.join(' ')}`);
+
+  return new Promise((resolve, reject) => {
+    const child = spawn('npx', jestArgs, {
+      cwd: path.resolve(__dirname, '..'),
+      stdio: 'inherit',
+      shell: true,
+      env: {
+        ...process.env,
+        WECHAT_DEVTOOLS_PORT: String(CONFIG.port),
+        UNIAPP_OUTPUT: CONFIG.projectPath,
+        FORCE_COLOR: '1',
+      },
+    });
+
+    child.on('close', (code) => {
+      if (code === 0) {
+        resolve(true);
+      } else {
+        resolve(false);
+      }
+    });
+
+    child.on('error', (err) => {
+      reject(err);
+    });
+  });
+}
+
+// ── 生成/查看测试报告 ──────────────────────────────
+function openReport() {
+  log.step('Step 3/4: 测试报告');
+
+  const reportPath = path.resolve(__dirname, '../test-results/miniapp-report.html');
+
+  if (fs.existsSync(reportPath)) {
+    log.ok(`HTML 报告: file:///${reportPath.replace(/\\/g, '/')}`);
+
+    // 尝试用默认浏览器打开
+    try {
+      execSync(`start "" "${reportPath}"`, { stdio: 'ignore' });
+      log.info('报告已在浏览器中打开');
+    } catch {
+      // 无头环境跳过
+    }
+  } else {
+    log.warn('未找到 HTML 测试报告（可能 jest-html-reporter 未安装）');
+  }
+}
+
+// ── 关闭 IDE ──────────────────────────────────────
+async function closeIDE() {
+  if (!opts.close) return;
+
+  log.step('Step 4/4: 关闭 IDE');
+
+  return new Promise((resolve) => {
+    const child = spawn(CONFIG.cliPath, ['close'], {
+      stdio: opts.verbose ? 'inherit' : 'ignore',
+      shell: true,
+    });
+
+    child.on('close', () => {
+      log.ok('IDE 已关闭');
+      resolve();
+    });
+
+    setTimeout(() => resolve(), 10000);
+  });
+}
+
+// ── 主流程 ─────────────────────────────────────────
+async function main() {
+  const startTime = Date.now();
+
+  console.log(`
+${colors.bold}${colors.cyan}  ╔══════════════════════════════════════╗
+  ║   小程序 E2E 自动化测试启动器       ║
+  ╚══════════════════════════════════════╝${colors.reset}
+  测试范围: ${opts.smoke ? '冒烟测试' : opts.journeys ? '用户旅程' : '全量'}
+  关闭IDE : ${opts.close ? '是' : '否（保持运行）'}
+  Watch   : ${opts.watch ? '是' : '否'}
+`);
+
+  try {
+    if (!opts.watch) {
+      await launchIDE();
+      await waitForIDE();
+    }
+
+    const passed = await runTests();
+
+    if (!opts.watch) {
+      if (passed) {
+        openReport();
+      }
+      await closeIDE();
+    }
+
+    const elapsed = ((Date.now() - startTime) / 1000).toFixed(1);
+
+    if (passed) {
+      console.log(`\n${colors.green}${colors.bold}  全部测试通过！ 耗时: ${elapsed}s${colors.reset}\n`);
+      process.exit(0);
+    } else {
+      console.log(`\n${colors.red}${colors.bold}  测试未全部通过  耗时: ${elapsed}s${colors.reset}\n`);
+      process.exit(1);
+    }
+  } catch (error) {
+    log.err(error.message);
+    console.error(error);
+    process.exit(1);
+  }
+}
+
+main();
@@ -0,0 +1,12 @@
+const path = require('path');
+
+// 设置全局变量供测试使用
+global.CLI_PATH = process.env.WECHAT_DEVTOOLS_CLI || 'D:\\微信web开发者工具\\cli.bat';
+global.PROJECT_PATH = process.env.UNIAPP_OUTPUT || path.resolve(__dirname, '../unpackage/dist/dev/mp-weixin');
+global.DEVTOOLS_PORT = parseInt(process.env.WECHAT_DEVTOOLS_PORT || '63956', 10);
+global.APP_ID = process.env.MP_APP_ID || '';
+
+console.log('=== 小程序测试全局配置 ===');
+console.log('CLI路径:', global.CLI_PATH);
+console.log('项目路径:', global.PROJECT_PATH);
+console.log('开发者工具端口:', global.DEVTOOLS_PORT);
@@ -0,0 +1,81 @@
+const { launchMiniProgram } = require('../helpers/automator');
+const { HomePage } = require('../pages/HomePage');
+const { LoginPage } = require('../pages/LoginPage');
+
+describe('小程序冒烟测试', () => {
+  let miniProgram;
+  let homePage;
+
+  beforeAll(async () => {
+    try {
+      miniProgram = await launchMiniProgram();
+      homePage = new HomePage(miniProgram);
+    } catch (error) {
+      console.warn('小程序连接失败:', error.message);
+    }
+  });
+
+  afterAll(async () => {});
+
+  test('小程序首页加载与基本内容', async () => {
+    if (!miniProgram) {
+      console.log('跳过：小程序环境未就绪');
+      return;
+    }
+
+    // 确保在首页 tabbar
+    await miniProgram.switchTab('/pages/index/index');
+    await new Promise(resolve => setTimeout(resolve, 1500));
+
+    const page = await miniProgram.currentPage();
+    console.log('当前页面路径:', page.path);
+    expect(page).toBeDefined();
+    expect(page.path).toBeTruthy();
+
+    // 首页数据验证
+    const data = await homePage.getPageData();
+    console.log('首页数据:', JSON.stringify(data).substring(0, 200));
+    expect(data).toBeDefined();
+  });
+
+  test('TabBar 页面间导航', async () => {
+    if (!miniProgram) {
+      console.log('跳过：小程序环境未就绪');
+      return;
+    }
+
+    // 先确保在首页
+    await miniProgram.switchTab('/pages/index/index');
+    await new Promise(resolve => setTimeout(resolve, 1000));
+
+    let page = await miniProgram.currentPage();
+    console.log('导航测试 - 首页:', page.path);
+
+    // 切换到搜索
+    await miniProgram.switchTab('/pages/search/search');
+    await new Promise(resolve => setTimeout(resolve, 1000));
+    page = await miniProgram.currentPage();
+    console.log('导航测试 - 搜索:', page.path);
+    expect(page.path).toBe('pages/search/search');
+
+    // 切换到我的课程
+    await miniProgram.switchTab('/pages/my-courses/my-courses');
+    await new Promise(resolve => setTimeout(resolve, 1000));
+    page = await miniProgram.currentPage();
+    console.log('导航测试 - 我的课程:', page.path);
+    expect(page.path).toBe('pages/my-courses/my-courses');
+
+    // 切换到个人中心
+    await miniProgram.switchTab('/pages/profile/profile');
+    await new Promise(resolve => setTimeout(resolve, 1000));
+    page = await miniProgram.currentPage();
+    console.log('导航测试 - 个人中心:', page.path);
+    expect(page.path).toBe('pages/profile/profile');
+
+    // 返回首页
+    await miniProgram.switchTab('/pages/index/index');
+    await new Promise(resolve => setTimeout(resolve, 1000));
+    page = await miniProgram.currentPage();
+    expect(page.path).toBe('pages/index/index');
+  });
+});
@@ -4,7 +4,15 @@
  "description": "",
  "main": "main.js",
  "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1"
+    "test": "node e2e/run-tests.js",
+    "test:smoke": "node e2e/run-tests.js --smoke",
+    "test:journeys": "node e2e/run-tests.js --journeys",
+    "test:all": "node e2e/run-tests.js --close",
+    "test:profile": "node e2e/run-tests.js --profile",
+    "test:booking": "node e2e/run-tests.js --booking",
+    "test:watch": "node e2e/run-tests.js --watch",
+    "test:quick": "jest --config e2e/jest.config.js --verbose --forceExit",
+    "test:quick:smoke": "jest --config e2e/jest.config.js --testPathPattern='smoke/' --verbose --forceExit"
  },
  "keywords": [],
  "author": "",
@@ -14,5 +22,11 @@
    "@dcloudio/uni-ui": "^1.5.12",
    "crypto-js": "^4.2.0",
    "luch-request": "^3.1.1"
+  },
+  "devDependencies": {
+    "@types/jest": "^29.5.0",
+    "jest": "^29.7.0",
+    "jest-html-reporter": "^4.4.0",
+    "miniprogram-automator": "^0.12.1"
  }
 }
@@ -0,0 +1,68 @@
+#!/bin/sh
+# 小程序冒烟测试 —— 预提交钩子
+# 
+# 安装方式（二选一）：
+# 
+# 1. 使用 Husky（推荐）：
+#    npx husky add .husky/pre-commit "sh scripts/pre-commit-miniapp-test.sh"
+#
+# 2. 手动复制到 .git/hooks/：
+#    cp scripts/pre-commit-miniapp-test.sh .git/hooks/pre-commit
+#    chmod +x .git/hooks/pre-commit
+#
+# 注意：此钩子会在本地 IDE 已开启时运行冒烟测试。
+# 未检测到 IDE 运行时自动跳过（不会阻塞提交）。
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+PROJECT_DIR="$(cd "$SCRIPT_DIR/.." && pwd)"
+
+echo ""
+echo "  🔍 小程序冒烟测试 (Pre-commit)"
+echo "  ─────────────────────────────"
+
+# 仅检查小程序相关文件的变更
+CHANGED_FILES=$(git diff --cached --name-only --diff-filter=ACM | grep -E "^gym-manage-uniapp/(pages|e2e)/" || true)
+
+if [ -z "$CHANGED_FILES" ]; then
+    echo "  ⏭ 无小程序页面/测试文件变更，跳过测试"
+    exit 0
+fi
+
+echo "  📝 检测到小程序相关变更:"
+echo "$CHANGED_FILES" | while read -r f; do echo "      • $f"; done
+echo ""
+
+# 检查 IDE 是否运行
+IDE_RUNNING=$(powershell.exe -Command "
+    try {
+        \$(Get-Process -Name '微信开发者工具' -ErrorAction Stop).Count;
+        Write-Output 'yes'
+    } catch {
+        Write-Output 'no'
+    }
+" 2>/dev/null || echo "no")
+
+if [ "$IDE_RUNNING" != "yes" ]; then
+    echo "  ⚠ 微信开发者工具未运行，跳过小程序测试"
+    echo "    快测方式（IDE 已运行时）：npm test"
+    exit 0
+fi
+
+echo "  🚀 运行冒烟测试..."
+
+# 切换到 uniapp 目录运行
+cd "$PROJECT_DIR"
+npm run test:quick:smoke 2>&1
+
+if [ $? -eq 0 ]; then
+    echo ""
+    echo "  ✅ 冒烟测试通过"
+    exit 0
+else
+    echo ""
+    echo "  ❌ 冒烟测试失败！"
+    echo "    请修复后再提交，或使用 git commit --no-verify 跳过"
+    exit 1
+fi
@@ -3,7 +3,7 @@ const Request = luchRequest.default || luchRequest
 const { generateSignatureHeaders } = require('./signature')
 const store = require('../store/index')

-const BASE_URL = 'http://192.168.101.5:8084/api'
+const BASE_URL = 'http://192.168.110.64:8084/api'

 const http = new Request({
  baseURL: BASE_URL,