136 lines
5.1 KiB
Markdown
136 lines
5.1 KiB
Markdown
# Special Check Family Asset Liability Detail Redesign Backend Implementation Plan
|
|
|
|
> **For agentic workers:** REQUIRED: Use superpowers:subagent-driven-development (if subagents available) or superpowers:executing-plans to implement this plan. Steps use checkbox (`- [ ]`) syntax for tracking.
|
|
|
|
**Goal:** 在不改动专项核查详情接口契约的前提下，确认现有后端返回仍能完整支撑展开区改版，并补足回归验证与后端记录。
|
|
|
|
**Architecture:** 本次设计明确“不新增后端字段、不调整控制器、服务和 Mapper 口径”。后端实施只围绕现有 `summary + incomeDetail + assetDetail + debtDetail` 结构做回归锁定：通过增强服务层和 SQL 结构测试，确认前端改版所需的总额、风险等级和原始条目字段已完整存在；若测试通过，则不修改生产代码。
|
|
|
|
**Tech Stack:** Java 21, Spring Boot 3, MyBatis XML, Maven, JUnit 5
|
|
|
|
---
|
|
|
|
## File Map
|
|
|
|
- Modify: `ccdi-project/src/test/java/com/ruoyi/ccdi/project/service/impl/CcdiProjectSpecialCheckServiceImplTest.java`
|
|
- 锁定详情 `summary` 与前端改版所需字段的一致性
|
|
- Modify: `ccdi-project/src/test/java/com/ruoyi/ccdi/project/mapper/CcdiProjectSpecialCheckMapperDetailSqlTest.java`
|
|
- 锁定明细 SQL 继续返回前端聚合所需原始字段
|
|
- Create: `docs/reports/implementation/2026-03-25-special-check-family-asset-liability-detail-redesign-backend-record.md`
|
|
- 记录本次后端为零生产代码改动的边界
|
|
- Create: `docs/tests/records/2026-03-25-special-check-family-asset-liability-detail-redesign-backend-verification.md`
|
|
- 记录后端回归验证结果
|
|
|
|
### Task 1: 锁定后端详情契约回归
|
|
|
|
**Files:**
|
|
- Modify: `ccdi-project/src/test/java/com/ruoyi/ccdi/project/service/impl/CcdiProjectSpecialCheckServiceImplTest.java`
|
|
- Modify: `ccdi-project/src/test/java/com/ruoyi/ccdi/project/mapper/CcdiProjectSpecialCheckMapperDetailSqlTest.java`
|
|
|
|
- [ ] **Step 1: Write the failing test**
|
|
|
|
在现有测试基础上补充以下断言：
|
|
|
|
- `summary` 中的 `totalIncome / totalDebt / totalAsset / riskLevelCode / riskLevelName` 可直接复用到前端改版
|
|
- SQL 继续返回 `asset_main_type / asset_sub_type / current_value`
|
|
- SQL 继续返回 `debt_main_type / debt_sub_type / principal_balance`
|
|
- 不引入新的后端聚合字段，不依赖额外 VO
|
|
|
|
- [ ] **Step 2: Run test to verify it fails**
|
|
|
|
Run:
|
|
|
|
```bash
|
|
mvn test -pl ccdi-project -Dtest=CcdiProjectSpecialCheckServiceImplTest,CcdiProjectSpecialCheckMapperDetailSqlTest
|
|
```
|
|
|
|
Expected:
|
|
|
|
- `FAIL`
|
|
- 原因是新增回归断言尚未补齐
|
|
|
|
- [ ] **Step 3: Write minimal implementation**
|
|
|
|
只修改测试，不动生产代码：
|
|
|
|
- 在服务层测试中补充 `summary` 字段复用断言
|
|
- 在 Mapper SQL 测试中补充类型字段与金额字段断言
|
|
- 明确当前接口足以支撑前端按类型聚合与风险结论展示
|
|
|
|
- [ ] **Step 4: Run test to verify it passes**
|
|
|
|
Run:
|
|
|
|
```bash
|
|
mvn test -pl ccdi-project -Dtest=CcdiProjectSpecialCheckServiceImplTest,CcdiProjectSpecialCheckMapperDetailSqlTest
|
|
```
|
|
|
|
Expected:
|
|
|
|
- `PASS`
|
|
|
|
- [ ] **Step 5: Commit**
|
|
|
|
```bash
|
|
git add ccdi-project/src/test/java/com/ruoyi/ccdi/project/service/impl/CcdiProjectSpecialCheckServiceImplTest.java ccdi-project/src/test/java/com/ruoyi/ccdi/project/mapper/CcdiProjectSpecialCheckMapperDetailSqlTest.java
|
|
git commit -m "补充专项核查展开区后端回归测试"
|
|
```
|
|
|
|
### Task 2: 完成后端验证与记录
|
|
|
|
**Files:**
|
|
- Create: `docs/reports/implementation/2026-03-25-special-check-family-asset-liability-detail-redesign-backend-record.md`
|
|
- Create: `docs/tests/records/2026-03-25-special-check-family-asset-liability-detail-redesign-backend-verification.md`
|
|
|
|
- [ ] **Step 1: Write the failing test**
|
|
|
|
这里不新增代码断言，先整理验证目标：
|
|
|
|
- 后端生产代码零变更
|
|
- 详情契约继续满足前端改版输入要求
|
|
- 聚焦专项核查详情相关测试，不扩大到无关模块
|
|
|
|
- [ ] **Step 2: Run test to verify it fails**
|
|
|
|
Run:
|
|
|
|
```bash
|
|
mvn test -pl ccdi-project -Dtest=CcdiProjectSpecialCheckServiceImplTest,CcdiProjectSpecialCheckMapperDetailSqlTest,CcdiProjectSpecialCheckControllerTest
|
|
```
|
|
|
|
Expected:
|
|
|
|
- 在测试与文档未补齐前，至少一项为 `FAIL` 或文档缺失
|
|
|
|
- [ ] **Step 3: Write minimal implementation**
|
|
|
|
补齐两份文档：
|
|
|
|
- 后端实施记录写清：
|
|
- 本次不修改控制器、服务、Mapper、VO
|
|
- 仅增强回归测试，确认接口可继续支撑前端改版
|
|
- 后端验证记录写清：
|
|
- 运行命令
|
|
- 通过结果
|
|
- “零生产代码改动”的核对结论
|
|
|
|
- [ ] **Step 4: Run test to verify it passes**
|
|
|
|
Run:
|
|
|
|
```bash
|
|
mvn test -pl ccdi-project -Dtest=CcdiProjectSpecialCheckServiceImplTest,CcdiProjectSpecialCheckMapperDetailSqlTest,CcdiProjectSpecialCheckControllerTest
|
|
```
|
|
|
|
Expected:
|
|
|
|
- `PASS`
|
|
- 工作区内无 `ccdi-project/src/main` 生产代码改动
|
|
|
|
- [ ] **Step 5: Commit**
|
|
|
|
```bash
|
|
git add docs/reports/implementation/2026-03-25-special-check-family-asset-liability-detail-redesign-backend-record.md docs/tests/records/2026-03-25-special-check-family-asset-liability-detail-redesign-backend-verification.md
|
|
git commit -m "补充专项核查展开区后端验证记录"
|
|
```
|