tangweijie/fujian_water_biz_doc
1
0
Fork 0
Code Issues Pull Requests 12 Actions Packages Projects Releases 1 Wiki Activity
fujian_water_biz_doc/docs/guides/REV004_CURRENT_TRUTH_MATRIX.md
tangweijie 9ca67674a3 Refresh REV004 current truth matrix after redink merge 
This updates the current-truth matrix to reflect that REDINK_RECORD is now
an independent formal-table object on the mainline, and refreshes the merge
anchors plus blocker note accordingly.

Constraint: Matrix must match verified mainline truth after PR #79 and docs redink evidence merge
Rejected: Leave REDINK_RECORD as not independent in the matrix | now factually incorrect after mainline merge
Confidence: high
Scope-risk: narrow
Reversibility: clean
Directive: Refresh this matrix only after verified mainline merges so it remains an operator-grade truth artifact
Tested: Cross-checked against origin/develop merge d8596af... and origin/main merge 57763c6...
Not-tested: No document export/render pipeline executed for this matrix refresh
2026-04-17 17:04:02 +08:00

6.0 KiB
Raw Blame History

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 已独立 biz_redink_record / biz_redink_record_detail 已接线 主链路完成（执行链路受外部依赖阻塞补证）

二、已独立对象明细

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

  • DDL：sql/rev004/REV004_redink_formal_tables_deploy.sql
  • 表：biz_redink_record、biz_redink_record_detail
  • 当前判断：
    • REDINK_RECORD 成功执行结果已落结果型 formal 主从表
    • get/page 已接入 formal-first
    • 保留 legacy operat_log 兼容轨迹
    • 真实 live execute smoke 仍受 business-bank-server 无可用实例阻塞，已在 evidence 中记录精确异常

四、当前最适合的后续优先级

  1. prestorage process / attachments strict formal-first 收口
  2. 对外联调版“对象 → 表 → 接口 → 真值口径”说明
  3. 待 business-bank-server 可用后补 redink live execute 完整 smoke

五、证据锚点

  • backend 已合入：
    • PR #77 -> 9462f3a12728b83bfe31e0b74c526f4256f5b361（writtenoff）
    • PR #78 -> 1964c7823291cd4972c72c50ffcad154f3a74b4c（price-diff）
    • PR #79 -> d8596af47479ef28664b83200d86f7770c8b9bd4（redink）
  • docs 已合入：
    • b5efa3b2480b1a0b8a00b728ac434f833787b6b4（前一轮矩阵基线）
    • c741164fa48dd79f4c43ffb15e3b093933dc642c（price-diff evidence）
    • 57763c634e0e6733d0861051f6b78c5dcdb9022f（redink 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
    • docs/evidence/rev004-redink-formal-table-dev-db-apply-2026-04-17.md
  • formal-table 状态矩阵：docs/guides/REV004_FORMAL_TABLE_STATUS_MATRIX.md