Merge PR #7: refresh REV004 current truth matrix\n\nConstraint: Keep the matrix aligned with verified mainline merges only\nConfidence: high\nScope-risk: narrow\nDirective: Refresh this matrix again after future mainline formal-table merges so it remains a reliable operator artifact\nTested: PR #7 content cross-checked against backend develop 1964c782... and docs main c741164...\nNot-tested: No document export/render pipeline executed at merge time

2026-04-17 15:45:14 +08:00 · 2026-04-17 15:45:14 +08:00 · 692ac419f6
commit 692ac419f6
parent c741164fa4 ba58013139
1 changed files with 107 additions and 0 deletions
--- a/docs/guides/REV004_CURRENT_TRUTH_MATRIX.md
+++ 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`