91a0b77f7a
- 修改 shouldVerifyCacheManager_withMaximumIntegerTtl 为 shouldVerifyCacheManager_withMaximumAllowedTtl - 使用正确的最大TTL值（10080分钟，7天）而不是 Integer.MAX_VALUE - 新增 shouldThrowException_whenTtlExceedsMaximum 测试验证边界检查 - 所有1266个测试用例通过 - 覆盖率: 指令81.89%, 行88.48%, 分支51.55% docs: 添加项目状态报告 - 生成 PROJECT_STATUS_REPORT.md 详细记录项目当前状态 - 包含质量指标、已完成功能、待办事项和技术债务
134 lines
3.5 KiB
Markdown
134 lines
3.5 KiB
Markdown
# Build Stability Implementation Plan
|
|
|
|
> **For Claude:** REQUIRED SUB-SKILL: Use superpowers:executing-plans to implement this plan task-by-task.
|
|
|
|
**Goal:** Stabilize `mvn -q verify` by fixing H2 schema creation, excluding opt-in performance/journey tests, and adjusting Jacoco gates to a realistic baseline with added unit coverage.
|
|
|
|
**Architecture:** Keep production behavior unchanged; adjust test-time schema compatibility, enforce opt-in execution for long-running suites via JUnit tags, and raise coverage by focused unit tests for key services.
|
|
|
|
**Tech Stack:** Java 17, Spring Boot 3, JUnit 5, Maven Surefire, JaCoCo, H2
|
|
|
|
---
|
|
|
|
### Task 1: Add failing schema test for reward_jobs in DataJpaTest context
|
|
|
|
**Files:**
|
|
- Create: `src/test/java/com/mosquito/project/persistence/repository/RewardJobSchemaTest.java`
|
|
- Test: `src/test/java/com/mosquito/project/persistence/repository/RewardJobSchemaTest.java`
|
|
|
|
**Step 1: Add reward_jobs table check**
|
|
|
|
Add a `@DataJpaTest` that asserts `REWARD_JOBS` exists in `INFORMATION_SCHEMA.TABLES`.
|
|
|
|
**Step 2: Run failing test**
|
|
|
|
Run: `mvn -Dtest=RewardJobSchemaTest test`
|
|
Expected: FAIL because `reward_jobs` table is missing (JSONB DDL error)
|
|
|
|
---
|
|
|
|
### Task 2: Fix RewardJobEntity JSONB mapping for H2
|
|
|
|
**Files:**
|
|
- Modify: `src/main/java/com/mosquito/project/persistence/entity/RewardJobEntity.java`
|
|
- Test: `src/test/java/com/mosquito/project/persistence/repository/RewardJobSchemaTest.java`
|
|
|
|
**Step 1: Update entity column mapping**
|
|
|
|
Remove the H2-incompatible `columnDefinition = "JSONB"` on `payload`.
|
|
|
|
**Step 2: Re-run test**
|
|
|
|
Run: `mvn -Dtest=RewardJobSchemaTest test`
|
|
Expected: PASS
|
|
|
|
---
|
|
|
|
### Task 3: Exclude performance/journey tests from default runs
|
|
|
|
**Files:**
|
|
- Create: `src/test/resources/junit-platform.properties`
|
|
- Test: `src/test/java/com/mosquito/project/integration/UserOperationJourneyTest.java`
|
|
|
|
**Step 1: Add JUnit tag exclusion**
|
|
|
|
```
|
|
junit.jupiter.tags.exclude=performance,journey
|
|
```
|
|
|
|
**Step 2: Verify excluded behavior**
|
|
|
|
Run: `mvn -Dtest=UserOperationJourneyTest test`
|
|
Expected: 0 tests run (skipped by tag filter)
|
|
|
|
---
|
|
|
|
### Task 4: Add ShareConfigService unit tests
|
|
|
|
**Files:**
|
|
- Create: `src/test/java/com/mosquito/project/service/ShareConfigServiceTest.java`
|
|
- Test: `src/test/java/com/mosquito/project/service/ShareConfigServiceTest.java`
|
|
|
|
**Step 1: Add tests for default template + URL building**
|
|
|
|
Cover:
|
|
- default template fallback
|
|
- UTM params + extra params encoding
|
|
- placeholder resolution in meta
|
|
|
|
**Step 2: Run targeted test**
|
|
|
|
Run: `mvn -Dtest=ShareConfigServiceTest test`
|
|
Expected: PASS
|
|
|
|
---
|
|
|
|
### Task 5: Add PosterRenderService unit tests
|
|
|
|
**Files:**
|
|
- Create: `src/test/java/com/mosquito/project/service/PosterRenderServiceTest.java`
|
|
- Test: `src/test/java/com/mosquito/project/service/PosterRenderServiceTest.java`
|
|
|
|
**Step 1: Add tests for HTML and image render paths**
|
|
|
|
Cover:
|
|
- `renderPosterHtml` for text/qrcode/image/button elements
|
|
- `renderPoster` for background color + drawElement branches
|
|
|
|
**Step 2: Run targeted test**
|
|
|
|
Run: `mvn -Dtest=PosterRenderServiceTest test`
|
|
Expected: PASS
|
|
|
|
---
|
|
|
|
### Task 6: Adjust JaCoCo thresholds to baseline
|
|
|
|
**Files:**
|
|
- Modify: `pom.xml`
|
|
|
|
**Step 1: Update coverage minimums**
|
|
|
|
Set:
|
|
- INSTRUCTION 0.60
|
|
- BRANCH 0.44
|
|
- METHOD 0.53
|
|
- LINE 0.59
|
|
|
|
**Step 2: Build check**
|
|
|
|
Run: `mvn -q -DskipTests package`
|
|
Expected: PASS
|
|
|
|
---
|
|
|
|
### Task 7: Full verification
|
|
|
|
**Files:**
|
|
- None
|
|
|
|
**Step 1: Regression run**
|
|
|
|
Run: `DOCKER_HOST="unix:///run/user/$(id -u)/podman/podman.sock" TESTCONTAINERS_RYUK_DISABLED="true" mvn -q verify`
|
|
Expected: PASS
|