Files
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

491 lines
24 KiB
XML
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>3.5.13</version>
<relativePath />
</parent>
<groupId>cn.novalon.gym.manage</groupId>
<artifactId>gym-manage-api</artifactId>
<version>1.0.0</version>
<packaging>pom</packaging>
<name>Gym Manage API</name>
<description>Gym Management System API</description>
<properties>
<java.version>21</java.version>
<maven.compiler.source>21</maven.compiler.source>
<maven.compiler.target>21</maven.compiler.target>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
<spring-boot.version>3.5.13</spring-boot.version>
<spring-cloud.version>2025.0.0</spring-cloud.version>
<lombok.version>1.18.30</lombok.version>
<resilience4j.version>2.3.0</resilience4j.version>
<rxjava.version>3.1.9</rxjava.version>
<h2.version>2.3.232</h2.version>
<poi.version>5.2.5</poi.version>
<allure.version>2.29.0</allure.version>
<aspectj.version>1.9.22</aspectj.version>
</properties>
<modules>
<module>manage-common-test</module>
<module>manage-test-datafactory</module>
<module>manage-sys</module>
<module>manage-gateway</module>
<module>manage-app</module>
<module>manage-common</module>
<module>manage-db</module>
<module>manage-audit</module>
<module>manage-notify</module>
<module>manage-file</module>
<module>gym-member</module>
<module>gym-groupCourse</module>
<module>gym-checkIn</module>
<module>gym-dataCount</module>
<module>gym-auth</module>
<module>gym-payment</module>
<module>gym-coach</module>
<module>gym-coach-config</module>
<module>gym-brand</module>
<module>manage-test-report</module>
</modules>
<dependencyManagement>
<dependencies>
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-dependencies</artifactId>
<version>${spring-cloud.version}</version>
<type>pom</type>
<scope>import</scope>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-webflux</artifactId>
<version>${spring-boot.version}</version>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-aop</artifactId>
<version>${spring-boot.version}</version>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-validation</artifactId>
<version>${spring-boot.version}</version>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-actuator</artifactId>
<version>${spring-boot.version}</version>
</dependency>
<dependency>
<groupId>org.springframework.security</groupId>
<artifactId>spring-security-crypto</artifactId>
<version>6.2.4</version>
</dependency>
<dependency>
<groupId>org.springframework.security</groupId>
<artifactId>spring-security-config</artifactId>
<version>6.2.4</version>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-security</artifactId>
<version>${spring-boot.version}</version>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-data-r2dbc</artifactId>
<version>${spring-boot.version}</version>
</dependency>
<dependency>
<groupId>org.postgresql</groupId>
<artifactId>r2dbc-postgresql</artifactId>
<version>1.0.0.RELEASE</version>
</dependency>
<dependency>
<groupId>com.h2database</groupId>
<artifactId>h2</artifactId>
<version>${h2.version}</version>
<scope>test</scope>
</dependency>
<dependency>
<groupId>io.r2dbc</groupId>
<artifactId>r2dbc-h2</artifactId>
<version>1.0.1.RELEASE</version>
<scope>test</scope>
</dependency>
<dependency>
<groupId>com.google.guava</groupId>
<artifactId>guava</artifactId>
<version>33.3.1-jre</version>
</dependency>
<dependency>
<groupId>com.github.ben-manes.caffeine</groupId>
<artifactId>caffeine</artifactId>
<version>3.1.8</version>
</dependency>
<dependency>
<groupId>org.apache.commons</groupId>
<artifactId>commons-lang3</artifactId>
<version>3.17.0</version>
</dependency>
<dependency>
<groupId>org.apache.commons</groupId>
<artifactId>commons-collections4</artifactId>
<version>4.4</version>
</dependency>
<dependency>
<groupId>io.jsonwebtoken</groupId>
<artifactId>jjwt-api</artifactId>
<version>0.11.5</version>
</dependency>
<dependency>
<groupId>io.jsonwebtoken</groupId>
<artifactId>jjwt-impl</artifactId>
<version>0.11.5</version>
<scope>runtime</scope>
</dependency>
<dependency>
<groupId>io.jsonwebtoken</groupId>
<artifactId>jjwt-jackson</artifactId>
<version>0.11.5</version>
<scope>runtime</scope>
</dependency>
<dependency>
<groupId>org.postgresql</groupId>
<artifactId>postgresql</artifactId>
<version>42.7.4</version>
</dependency>
<dependency>
<groupId>org.flywaydb</groupId>
<artifactId>flyway-core</artifactId>
<version>11.0.1</version>
</dependency>
<dependency>
<groupId>org.flywaydb</groupId>
<artifactId>flyway-database-postgresql</artifactId>
<version>11.0.1</version>
</dependency>
<dependency>
<groupId>org.springdoc</groupId>
<artifactId>springdoc-openapi-starter-webflux-ui</artifactId>
<version>2.8.16</version>
</dependency>
<dependency>
<groupId>io.micrometer</groupId>
<artifactId>micrometer-registry-prometheus</artifactId>
<version>1.13.4</version>
</dependency>
<dependency>
<groupId>io.github.resilience4j</groupId>
<artifactId>resilience4j-spring-boot3</artifactId>
<version>${resilience4j.version}</version>
</dependency>
<dependency>
<groupId>io.github.resilience4j</groupId>
<artifactId>resilience4j-spring6</artifactId>
<version>${resilience4j.version}</version>
</dependency>
<dependency>
<groupId>io.github.resilience4j</groupId>
<artifactId>resilience4j-reactor</artifactId>
<version>${resilience4j.version}</version>
</dependency>
<dependency>
<groupId>io.reactivex.rxjava3</groupId>
<artifactId>rxjava</artifactId>
<version>${rxjava.version}</version>
</dependency>
<dependency>
<groupId>org.jacoco</groupId>
<artifactId>jacoco-maven-plugin</artifactId>
<version>0.8.12</version>
</dependency>
<dependency>
<groupId>org.apache.poi</groupId>
<artifactId>poi</artifactId>
<version>${poi.version}</version>
</dependency>
<dependency>
<groupId>org.apache.poi</groupId>
<artifactId>poi-ooxml</artifactId>
<version>${poi.version}</version>
</dependency>
<dependency>
<groupId>org.apache.commons</groupId>
<artifactId>commons-compress</artifactId>
<!-- POI 5.2.5 需要 commons-compress >= 1.25.01.21 会导致
NoSuchMethodError: ZipArchiveOutputStream.putArchiveEntry -->
<version>1.26.0</version>
</dependency>
<dependency>
<groupId>io.qameta.allure</groupId>
<artifactId>allure-junit5</artifactId>
<version>${allure.version}</version>
</dependency>
<dependency>
<groupId>org.aspectj</groupId>
<artifactId>aspectjweaver</artifactId>
<version>${aspectj.version}</version>
</dependency>
<!-- Aliyun OSS SDK -->
<dependency>
<groupId>com.aliyun.oss</groupId>
<artifactId>aliyun-sdk-oss</artifactId>
<version>3.17.4</version>
</dependency>
</dependencies>
</dependencyManagement>
<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-test</artifactId>
<scope>test</scope>
</dependency>
<dependency>
<groupId>io.qameta.allure</groupId>
<artifactId>allure-junit5</artifactId>
<scope>test</scope>
</dependency>
<dependency>
<groupId>org.projectlombok</groupId>
<artifactId>lombok</artifactId>
<optional>true</optional>
</dependency>
<!-- HuTool工具箱-->
<dependency>
<groupId>cn.hutool</groupId>
<artifactId>hutool-all</artifactId>
<version>5.8.38</version>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-data-redis-reactive</artifactId>
</dependency>
</dependencies>
<build>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-compiler-plugin</artifactId>
<version>3.13.0</version>
<configuration>
<source>${java.version}</source>
<target>${java.version}</target>
</configuration>
</plugin>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-surefire-plugin</artifactId>
<version>3.5.2</version>
<configuration>
<!--
argLine 不由 surefire 配置管理,而是由 JaCoCo prepare-agent 的
<propertyName>argLine</propertyName> 自动设置。
PIT 也会读取此 argLine 属性用于 minion 进程。
aspectjweaver 通过 PIT 的 jvmArgs 单独传入。
-->
<systemProperties>
<property>
<name>allure.results.directory</name>
<value>${project.build.directory}/allure-results</value>
</property>
</systemProperties>
</configuration>
</plugin>
<plugin>
<groupId>org.jacoco</groupId>
<artifactId>jacoco-maven-plugin</artifactId>
<version>0.8.12</version>
<executions>
<execution>
<id>prepare-agent</id>
<goals>
<goal>prepare-agent</goal>
</goals>
<!-- 使用默认的 propertyName=argLineSurefire 和 PIT 都会自动读取它 -->
</execution>
<execution>
<id>report</id>
<phase>test</phase>
<goals>
<goal>report</goal>
</goals>
</execution>
<execution>
<id>check</id>
<phase>verify</phase>
<goals>
<goal>check</goal>
</goals>
<configuration>
<rules>
<rule>
<element>BUNDLE</element>
<limits>
<limit>
<counter>INSTRUCTION</counter>
<value>COVEREDRATIO</value>
<minimum>0.55</minimum>
</limit>
</limits>
</rule>
</rules>
<excludes>
<exclude>**/vo/**</exclude>
<exclude>**/dto/**</exclude>
<exclude>**/entity/**</exclude>
<exclude>**/domain/**</exclude>
<exclude>**/enums/**</exclude>
<exclude>**/model/**</exclude>
<exclude>**/config/**</exclude>
<!-- manage-common: 基础设施类(DAO/Handler/异常/常量)通过集成测试覆盖,单元测试难度大 -->
<exclude>**/manage/common/dao/**</exclude>
<exclude>**/manage/common/handler/**</exclude>
<exclude>**/manage/common/exception/**</exclude>
<exclude>**/manage/common/util/RedisUtil</exclude>
<exclude>**/manage/common/util/StatusConstants</exclude>
<exclude>**/manage/common/util/MenuTypeConstants</exclude>
<exclude>**/manage/common/util/FieldConstants</exclude>
<!-- gym-groupCourse: Repository/DAO/Converter/Event/Initializer/Scheduler 通过集成测试覆盖 -->
<exclude>**/manage/groupcourse/converter/**</exclude>
<exclude>**/manage/groupcourse/repository/impl/**</exclude>
<exclude>**/manage/groupcourse/initializer/**</exclude>
<exclude>**/manage/groupcourse/dao/**</exclude>
<exclude>**/manage/groupcourse/scheduler/**</exclude>
<exclude>**/manage/groupcourse/event/**</exclude>
<!-- gym-member: 微信相关服务/Handler 依赖外部 SDK,通过集成测试覆盖 -->
<exclude>**/manage/member/service/impl/WechatAuthServiceImpl</exclude>
<exclude>**/manage/member/service/impl/WechatOfficialServiceImpl</exclude>
<exclude>**/manage/member/service/impl/WechatApiServiceImpl</exclude>
<exclude>**/manage/member/service/impl/RefundApplicationServiceImpl</exclude>
<exclude>**/manage/member/service/impl/MemberStoredCardServiceImpl</exclude>
<exclude>**/manage/member/handler/WechatOfficialEventHandler</exclude>
<exclude>**/manage/member/handler/WechatAuthHandler</exclude>
<exclude>**/manage/member/handler/RefundSagaHandler</exclude>
<exclude>**/manage/member/handler/DistributedLockService</exclude>
<exclude>**/manage/member/handler/MemberCardScheduledHandler</exclude>
<exclude>**/manage/member/handler/MemberStoredCardHandler</exclude>
<exclude>**/manage/member/handler/ExpirationReminderService</exclude>
<exclude>**/manage/member/util/EsSyncUtils</exclude>
<exclude>**/manage/member/service/IMemberStoredCardService$PayResult</exclude>
<!-- manage-file: 文件上传/下载属于基础设施服务,通过集成测试覆盖 -->
<exclude>**/manage/file/handler/**</exclude>
<exclude>**/manage/file/core/service/**</exclude>
<!-- manage-db: DB 转换器/Repository/DAO/查询条件属于基础设施层,通过集成测试覆盖 -->
<exclude>**/manage/db/converter/**</exclude>
<exclude>**/manage/db/entity/query/**</exclude>
<exclude>**/manage/db/repository/**</exclude>
<exclude>**/manage/db/dao/**</exclude>
<!-- gym-dataCount: 数据统计/调度/DAO 依赖数据库聚合查询,通过集成测试覆盖 -->
<exclude>**/manage/datacount/service/**</exclude>
<exclude>**/manage/datacount/scheduler/**</exclude>
<exclude>**/manage/datacount/dao/**</exclude>
<exclude>**/manage/datacount/handler/*</exclude>
<!-- gym-auth: 认证服务实现依赖外部短信/认证 SDK,通过集成测试覆盖 -->
<exclude>**/manage/auth/service/impl/**</exclude>
<!-- manage-app: 应用入口/配置/WebSocket/支付通知属于基础设施,通过集成测试覆盖 -->
<exclude>**/manage/app/**</exclude>
</excludes>
</configuration>
</execution>
</executions>
</plugin>
<plugin>
<groupId>org.sonarsource.scanner.maven</groupId>
<artifactId>sonar-maven-plugin</artifactId>
<version>3.10.0.2594</version>
</plugin>
<plugin>
<groupId>org.pitest</groupId>
<artifactId>pitest-maven</artifactId>
<version>1.19.1</version>
<configuration>
<targetClasses>
<param>cn.novalon.gym.manage.**</param>
</targetClasses>
<targetTests>
<param>cn.novalon.gym.manage.**</param>
</targetTests>
<excludedClasses>
<!-- 基础设施层:通过集成测试覆盖 -->
<param>cn.novalon.gym.manage.common.dao.*</param>
<param>cn.novalon.gym.manage.common.handler.*</param>
<param>cn.novalon.gym.manage.common.exception.*</param>
<param>cn.novalon.gym.manage.common.util.RedisUtil</param>
<param>cn.novalon.gym.manage.common.util.StatusConstants</param>
<param>cn.novalon.gym.manage.common.util.MenuTypeConstants</param>
<param>cn.novalon.gym.manage.common.util.FieldConstants</param>
<!-- 实体/模型/VO/DTO/领域(PIT 使用 Ant 风格 glob** 匹配任意子包) -->
<param>cn.novalon.gym.manage.**.vo.*</param>
<param>cn.novalon.gym.manage.**.dto.*</param>
<param>cn.novalon.gym.manage.**.entity.*</param>
<param>cn.novalon.gym.manage.**.domain.*</param>
<param>cn.novalon.gym.manage.**.model.*</param>
<param>cn.novalon.gym.manage.**.enums.*</param>
<param>cn.novalon.gym.manage.**.config.*</param>
<param>cn.novalon.gym.manage.**.primitive.*</param>
<param>cn.novalon.gym.manage.**.query.*</param>
<param>cn.novalon.gym.manage.**.exception.*</param>
<param>cn.novalon.gym.manage.**.command.*</param>
<param>cn.novalon.gym.manage.**.core.util.*</param>
<!-- 诊断工具类 -->
<param>cn.novalon.gym.manage.sys.handler.auth.PasswordDiagnosticHandler</param>
<!-- 应用入口 -->
<param>cn.novalon.gym.manage.app.*</param>
<param>cn.novalon.gym.manage.**.app.*</param>
</excludedClasses>
<excludedTestClasses>
<param>cn.novalon.gym.manage.app.contract.*</param>
<param>cn.novalon.gym.manage.app.integration.*</param>
<param>cn.novalon.gym.manage.gateway.*</param>
</excludedTestClasses>
<!--
W10 基线:manage-sys 48%gym-member 30%gym-payment 36%。
设置 45% 为可达成阈值,后续迭代逐步提升至 60%+。
-->
<coverageThreshold>55</coverageThreshold>
<mutationThreshold>45</mutationThreshold>
<timestampedReports>false</timestampedReports>
<outputFormats>
<outputFormat>HTML</outputFormat>
<outputFormat>XML</outputFormat>
</outputFormats>
<mutators>
<mutator>DEFAULTS</mutator>
</mutators>
<features>
<feature>+CLASSLIMIT(limit[50])</feature>
</features>
<threads>4</threads>
<!-- 避免继承 surefire 的 @{argLine} 占位符导致 PIT minion 进程失败 -->
<jvmArgs>
<jvmArg>-javaagent:${settings.localRepository}/org/aspectj/aspectjweaver/${aspectj.version}/aspectjweaver-${aspectj.version}.jar</jvmArg>
</jvmArgs>
</configuration>
<dependencies>
<dependency>
<groupId>org.pitest</groupId>
<artifactId>pitest-junit5-plugin</artifactId>
<version>1.2.2</version>
</dependency>
</dependencies>
</plugin>
</plugins>
</build>
</project>