From ba5801313989995b05056a201dbe615fb5efe39b Mon Sep 17 00:00:00 2001 From: tangweijie <877588133@qq.com> Date: Fri, 17 Apr 2026 15:43:50 +0800 Subject: [PATCH] Refresh REV004 current truth matrix after price-diff merge This updates the REV004 current-truth matrix to reflect that PRICE_DIFF_ADJUST is now an independent formal-table object on the mainline, and refreshes the merge/evidence anchors accordingly. Constraint: Matrix must match current backend develop and docs main truth after PR #78 / docs evidence merge Rejected: Keep the earlier matrix unchanged | it now incorrectly reports PRICE_DIFF_ADJUST as not independent Confidence: high Scope-risk: narrow Reversibility: clean Directive: Continue refreshing this matrix only after verified mainline merges, not from feature-branch intent alone Tested: Cross-checked against origin/develop merge commit 1964c782... and origin/main merge commit c741164... Not-tested: No document export/render pipeline executed for this matrix refresh --- docs/guides/REV004_CURRENT_TRUTH_MATRIX.md | 107 +++++++++++++++++++++ 1 file changed, 107 insertions(+) create mode 100644 docs/guides/REV004_CURRENT_TRUTH_MATRIX.md diff --git a/docs/guides/REV004_CURRENT_TRUTH_MATRIX.md b/docs/guides/REV004_CURRENT_TRUTH_MATRIX.md new file mode 100644 index 0000000..7f6ecb2 --- /dev/null +++ b/docs/guides/REV004_CURRENT_TRUTH_MATRIX.md @@ -0,0 +1,107 @@ +# REV004 当前主线真值矩阵 + +## 主线基线 +- backend：`sw-system-cloud/develop @ 9462f3a12728b83bfe31e0b74c526f4256f5b361` +- docs：`fujian_water_biz_doc/main @ b5efa3b2480b1a0b8a00b728ac434f833787b6b4` +- 生成时间：`2026-04-17 15:00 +08:00` + +## 一、对象总览 + +| 对象 | objectType / 专属域 | formal-table 状态 | 主表 / 明细表 | 主接口状态 | strict formal-first 状态 | +|---|---|---|---|---|---| +| 预存调整 | prestorage | 已独立 | `biz_prestorage_adjust` / `biz_prestorage_adjust_detail` | 已接线 | 部分完成 | +| 坏账调整 | `BAD_DEBT_RECORD` | 已独立 | `biz_bad_debt_adjust` / `biz_bad_debt_adjust_detail` | 已接线 | 主链路完成 | +| 已销调整/核销 | `WRITTENOFF_ADJUST` | 已独立 | `biz_writtenoff_adjust` / `biz_writtenoff_adjust_detail` | 已接线 | 主链路完成 | +| 违约金减免 | `LATE_FEE_REDUCE` | 已独立 | `biz_latefee_reduce` / `biz_latefee_reduce_detail` | 已接线 | 主链路完成 | +| 分账调整 | `SPLIT_ADJUST` | 已独立 | `biz_split_adjust` / `biz_split_adjust_detail` | 已接线 | 专属接口完成 | +| 价差调整 | `PRICE_DIFF_ADJUST` | 已独立 | `biz_price_diff_adjust` / `biz_price_diff_adjust_detail` | 已接线 | 主链路完成 | +| 红冲记录 | `REDINK_RECORD` | 未独立 | 无 | 兼容接口 | 未完成 | + +## 二、已独立对象明细 + +### 1. 价差调整 `PRICE_DIFF_ADJUST` +- DDL：`sql/rev004/REV004_price_diff_formal_tables_deploy.sql` +- 表：`biz_price_diff_adjust`、`biz_price_diff_adjust_detail` +- 接口： + - `POST /admin-api/business/accounting-adjust/unsold-price-diff-submit` + - `POST /admin-api/business/accounting-adjust/unsold-price-diff-batch-submit` + - `POST /admin-api/business/accounting-adjust/approve` + - `POST /admin-api/business/accounting-adjust/reject` + - `GET /admin-api/business/accounting-adjust/get` + - `GET /admin-api/business/accounting-adjust/page` +- 当前判断： + - submit / approve / reject / get / page 已形成 formal-table 主链路 + - 仍保留 legacy `operat_log` 兼容轨迹 + - 当前按最小 formal-table 模式恢复，尚未一比一回归旧系统 `PM_PRICE_RECORDS / DETAILS` 全字段语义 + +### 2. 预存调整（退款 / 转账） +- DDL：`sql/rev004/REV004_prestorage_formal_tables_deploy.sql` +- 表：`biz_prestorage_adjust`、`biz_prestorage_adjust_detail` +- 接口： + - `POST /admin-api/business/accounting-adjust/prestorage-submit` + - `POST /admin-api/business/accounting-adjust/prestorage-revoke` + - `GET /admin-api/business/accounting-adjust/prestorage-process` + - `GET /admin-api/business/accounting-adjust/prestorage-attachments` + - `GET /admin-api/business/accounting-adjust/prestorage-page` + - `GET /admin-api/business/accounting-adjust/prestorage-detail` +- 当前判断： + - submit / revoke / page / detail 已是 formal-table 主链路 + - `process / attachments` 仍保留 legacy / unified fallback + +### 3. 坏账调整 +- DDL：`sql/rev004/REV004_bad_debt_formal_tables_deploy.sql` +- 表：`biz_bad_debt_adjust`、`biz_bad_debt_adjust_detail` +- 接线口径：统一 `accounting-adjust` submit / approve / reject / page / detail +- 当前判断：主链路已 formal-first + +### 4. 已销调整 / 核销 +- DDL：`sql/rev004/REV004_writtenoff_formal_tables_deploy.sql` +- 表：`biz_writtenoff_adjust`、`biz_writtenoff_adjust_detail` +- 接口： + - `POST /admin-api/business/accounting-adjust/sold-submit` + - `POST /admin-api/business/accounting-adjust/approve` + - `POST /admin-api/business/accounting-adjust/reject` + - `GET /admin-api/business/accounting-adjust/get` + - `GET /admin-api/business/accounting-adjust/page` +- 当前判断：主链路已 formal-first，且已补事务边界 / fail-fast + +### 5. 违约金减免 +- DDL：`sql/rev004/REV004_latefee_formal_tables_deploy.sql` +- 表：`biz_latefee_reduce`、`biz_latefee_reduce_detail` +- 接口： + - `POST /admin-api/business/accounting-adjust/unsold-late-fee-reduce-submit` + - `POST /admin-api/business/accounting-adjust/unsold-late-fee-reduce-batch-submit` +- 当前判断：formal-table 主链路已建立 + +### 6. 分账调整 +- 表：`biz_split_adjust`、`biz_split_adjust_detail` +- 专属接口： + - `POST /business/split-adjust/submit` + - `GET /business/split-adjust/page` + - `GET /business/split-adjust/detail` + - `GET /business/split-adjust/result` +- 当前判断：已独立为专属对象域 +- 备注：`sql/rev004/` 目录下当前未看到单独 split deploy 脚本，说明库结构来源可能更早或另有维护路径 + +## 三、未独立对象 + +### 1. 红冲记录 `REDINK_RECORD` +- 当前未见独立 formal-table 主线 +- 仍属于兼容口径对象 + +## 四、当前最适合的后续优先级 +1. prestorage `process / attachments` strict formal-first 收口 +2. `REDINK_RECORD` 是否 formal-table 化 +3. 统一补一版“对象 → 表 → 接口 → 真值口径”对外联调说明 + +## 五、证据锚点 +- backend 已合入： + - PR #77 -> `9462f3a12728b83bfe31e0b74c526f4256f5b361`（writtenoff） + - PR #78 -> `1964c7823291cd4972c72c50ffcad154f3a74b4c`（price-diff） +- docs 已合入： + - `b5efa3b2480b1a0b8a00b728ac434f833787b6b4`（前一轮矩阵基线） + - `c741164fa48dd79f4c43ffb15e3b093933dc642c`（price-diff evidence） +- fresh smoke evidence： + - `docs/evidence/rev004-writtenoff-formal-table-dev-db-apply-2026-04-17.md` + - `docs/evidence/rev004-price-diff-formal-table-dev-db-apply-2026-04-17.md` +- formal-table 状态矩阵：`docs/guides/REV004_FORMAL_TABLE_STATUS_MATRIX.md`