docs(accounting): record unsold water option no-db evidence

This commit is contained in:
tangweijie 2026-06-19 12:18:51 +08:00
parent fe0822ad51
commit c852eb21c3

View File

@ -0,0 +1,37 @@
# REV-004 未销水量调整预算选项无库变更验证记录
## 变更范围
- 未销按水量调整正式提交新增 `updateAccumulated``updateBaseCode` 两个选项字段。
- `unsold-adjust-submit` 控制器映射、统一提交 VO、核心账务调整 VO 均已透传上述字段。
- `updateBaseCode=true` 时,正式水量调整要求传入 `currentReading`,并将其写入营业账本次抄码。
- `updateBaseCode=false` 或未传时,即使传入 `currentReading`,也不写入营业账本次抄码。
- `updateAccumulated=true` 时,按 `调整后水量 - 调整前水量` 调整营业账累计水量;`false` 或未传时不调整累计水量。
- 操作日志记录 `updateAccumulated``updateBaseCode`,字段类型为 YES_OR_NO。
## 未纳入本轮范围
- 本轮按用户要求仅实现不需要数据库结构变更的功能。
- 价差调整选项正式持久化、价差明细表新增字段、SQL 迁移仍保留为后续 DB 相关任务。
## 验证命令
```bash
mvn -pl sw-business/sw-business-server -am \
-Dtest=UnsoldTrialPreviewServiceImplTest,AccountingAdjustActionControllerTest#createUnsoldAdjust_shouldReturnWrappedSuccess,AccountingAdjustProcessServiceImplTest#createUnsoldAdjust_shouldPassWaterOptionFlagsToUnifiedChargeService,ChargeServiceAccountingAdjustTest \
-Dsurefire.failIfNoSpecifiedTests=false test
```
## 验证结果
- `AccountingAdjustActionControllerTest#createUnsoldAdjust_shouldReturnWrappedSuccess`: 1 test, 0 failures, 0 errors.
- `AccountingAdjustProcessServiceImplTest#createUnsoldAdjust_shouldPassWaterOptionFlagsToUnifiedChargeService`: 1 test, 0 failures, 0 errors.
- `ChargeServiceAccountingAdjustTest`: 27 tests, 0 failures, 0 errors.
- `UnsoldTrialPreviewServiceImplTest`: 12 tests, 0 failures, 0 errors.
- Maven reactor: 41 tests, 0 failures, 0 errors, `BUILD SUCCESS`.
## 风险与兼容说明
- `currentReading` 不再单独触发底码写入;调用方必须显式传 `updateBaseCode=true` 才会更新本次抄码。
- 未传 checkbox 时按默认 false 处理,避免预算页选项未确认时误写正式字段。
- 本轮未放宽已收费、已开票、已结账、缺少抄表依据、缺少附件等既有水量调整校验。