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 个里程碑全部达成
141 lines
3.9 KiB
JavaScript
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
|
|
};
|