Files
gym-manage/gym-manage-uniapp/e2e/helpers/automator.js
T
zhangxiang 015cb0dc78 完成自动化测试套件实施(W1-W11)
W1-W3: 基线修复与测试基础设施搭建
- 修复 Jenkins JDK 21 兼容性,统一 E2E 目录,修复 storageState 冲突
- 搭建后端测试基类 BaseContractTest + Testcontainers PostgreSQL
- 创建 TestDataFactory 链式构造,完善 Vitest 基座与 Playwright fixtures
- 建立 docker-compose.test.yml 与测试数据隔离方案

W4-W5: 单元测试补齐(阶段 2)
- 补齐 gym-member/gym-groupCourse/gym-checkIn/gym-payment 核心模块单元测试
- 补齐 gym-coach/manage-sys 模块单元测试
- 前端 utils/composables/stores 单元测试,37 文件 502 项测试
- JaCoCo 覆盖率门禁从 30% 调整至 55%,21 模块全部通过

W6-W7: 集成与契约测试(阶段 3)
- Repository 集成测试:会员/团课/签到/支付关键表,Testcontainers 100% 通过
- Handler 集成测试:WebTestClient 覆盖正向/异常/权限路径
- 网关集成测试:JWT/RBAC/签名/限流/重试
- Flyway 迁移测试:验证迁移脚本可重复执行
- OpenAPI 契约测试:覆盖 ≥80% P0 接口,202 项契约测试 0 失败
- 跨模块契约测试:会员-支付-团课数据一致性

W8-W9: E2E 与用户旅程测试(阶段 4)
- 管理员 Web 核心流程 E2E:用户/角色/菜单/字典/配置
- 小程序会员端核心页面 E2E:购卡/预约/签到
- 5 条 P0 用户旅程全链路自动化,60 条 journey 测试 0 失败

W10: 变异测试与质量门禁(阶段 5)
- 后端 PIT 配置:pitest-maven 1.19.1 + JUnit 5,覆盖率阈值 55%/变异阈值 45%
- P0 模块基线:manage-sys 48%,gym-member 30%,gym-payment 36%
- 前端 StrykerJS 配置:utils/stores 变异测试,dateFormat.ts 70.83%
- Jenkins 质量门禁:JaCoCo/PIT/E2E 统一检查,不达标阻断构建

W11: 持续运行与改进(阶段 6)
- 测试指标收集脚本 scripts/collect-test-metrics.py + HTML 看板生成器
- Flaky Test 治理 SOP:检测→隔离→根因分析→修复→验证闭环
- 测试资产定期评审流程:月度/季度/事件驱动三级机制
- 快速参考指南 docs/testing/quick-reference.md
- 累计 10 份测试文档,7 个里程碑全部达成
2026-08-02 08:28:37 +08:00

141 lines
3.9 KiB
JavaScript

const automator = require('miniprogram-automator');
const path = require('path');
const { resolveWechatDevtoolsCli } = require('./cli-resolver');
const PROJECT_PATH = path.resolve(__dirname, '../../unpackage/dist/dev/mp-weixin');
const CLI_PATH = resolveWechatDevtoolsCli() || 'D:\\wechat-dev-tools\\cli.bat';
const DEVTOOL_PORT = process.env.WECHAT_DEVTOOLS_PORT ? Number(process.env.WECHAT_DEVTOOLS_PORT) : 45869;
/**
* 启动微信小程序
* @returns {Promise<MiniProgram>}
*/
async function launchMiniProgram() {
console.log('[automator] 启动小程序...');
const miniProgram = await automator.launch({
projectPath: PROJECT_PATH,
cliPath: CLI_PATH,
port: DEVTOOL_PORT
});
console.log('[automator] 小程序已启动');
return miniProgram;
}
/**
* 连接已在运行的小程序
*/
async function connectMiniProgram() {
return automator.connect({ port: DEVTOOL_PORT });
}
/**
* 模拟微信登录流程
* 通过调用 wx.login 获取 code,触发后端登录
* @param {MiniProgram} miniProgram
* @returns {Promise<void>}
*/
async function loginAsMember(miniProgram) {
console.log('[automator] 执行会员登录流程...');
try {
// 调用微信登录接口
await miniProgram.callWxMethod('login', {});
} catch (err) {
console.warn('[automator] wx.login 调用异常(可能已在模拟器中自动完成):', err.message);
}
// 等待登录完成并跳转到首页
await miniProgram.waitFor(1000);
}
/**
* 等待当前页面 URL 匹配指定模式
* @param {MiniProgram} miniProgram
* @param {string} urlPattern - 页面路径模式
* @param {number} timeout - 超时时间(ms)
* @returns {Promise<Page>}
*/
async function waitForPage(miniProgram, urlPattern, timeout = 30000) {
const startTime = Date.now();
while (Date.now() - startTime < timeout) {
try {
const page = await miniProgram.currentPage();
if (page && page.path && page.path.includes(urlPattern)) {
console.log(`[automator] 页面已加载: ${page.path}`);
return page;
}
} catch (e) {
// 页面尚未准备好,继续等待
}
await miniProgram.waitFor(500);
}
throw new Error(`等待页面 "${urlPattern}" 超时 (${timeout}ms)`);
}
/**
* 截图保存
* @param {MiniProgram} miniProgram
* @param {string} name - 截图名称
* @returns {Promise<string>} 截图文件路径
*/
async function screenshot(miniProgram, name) {
const screenshotsDir = path.resolve(__dirname, '../screenshots');
const fs = require('fs');
if (!fs.existsSync(screenshotsDir)) {
fs.mkdirSync(screenshotsDir, { recursive: true });
}
const timestamp = Date.now();
const safeName = name.replace(/[^a-zA-Z0-9_-]/g, '_');
const filePath = path.join(screenshotsDir, `${timestamp}_${safeName}.png`);
await miniProgram.screenshot({ path: filePath });
console.log(`[automator] 截图已保存: ${filePath}`);
return filePath;
}
/**
* 通过 TabBar 切换页面
* @param {MiniProgram} miniProgram
* @param {number} index - TabBar 索引 (0:首页, 1:课程, 2:我的课程, 3:我的)
* @returns {Promise<void>}
*/
async function switchTab(miniProgram, index) {
console.log(`[automator] 切换到 TabBar 索引: ${index}`);
await miniProgram.callWxMethod('switchTab', { url: getTabBarUrl(index) });
await miniProgram.waitFor(1000);
}
/**
* 获取 TabBar 页面 URL
*/
function getTabBarUrl(index) {
const tabs = [
'/pages/index/index',
'/pages/search/search',
'/pages/my-courses/my-courses',
'/pages/profile/profile'
];
return tabs[index] || tabs[0];
}
/**
* 生成唯一测试数据标识
*/
function generateTestId() {
return `e2e_${Date.now()}_${Math.random().toString(36).substring(2, 8)}`;
}
module.exports = {
launchMiniProgram,
connectMiniProgram,
loginAsMember,
waitForPage,
screenshot,
switchTab,
getTabBarUrl,
generateTestId,
PROJECT_PATH,
CLI_PATH,
DEVTOOL_PORT
};