From 9ac2e9f68ea564ee27ddd287f0d6e4a4302cd980 Mon Sep 17 00:00:00 2001
From: tangweijie <877588133@qq.com>
Date: Fri, 17 Apr 2026 17:33:40 +0800
Subject: [PATCH] Add REV004 final mainline delivery summary

This adds a one-page summary of the current REV004 mainline delivery state,
including merged backend/docs commits, object truth status, evidence anchors,
and remaining external blockers.

Constraint: Summary must reflect verified mainline truth only, not feature-branch intent
Rejected: Scatter this information across multiple historical evidence files | too costly for frontline consumers to reconstruct delivery status
Confidence: high
Scope-risk: narrow
Reversibility: clean
Directive: Keep this summary as the top-level operator handoff page and refresh only after meaningful mainline state changes
Tested: Cross-checked against origin/develop and origin/main latest merge commits plus existing evidence set
Not-tested: No document export/render pipeline executed for this summary
---
 .../REV004_FINAL_MAINLINE_DELIVERY_SUMMARY.md | 99 +++++++++++++++++++
 1 file changed, 99 insertions(+)
 create mode 100644 docs/guides/REV004_FINAL_MAINLINE_DELIVERY_SUMMARY.md

diff --git a/docs/guides/REV004_FINAL_MAINLINE_DELIVERY_SUMMARY.md b/docs/guides/REV004_FINAL_MAINLINE_DELIVERY_SUMMARY.md
new file mode 100644
index 0000000..9a69765
--- /dev/null
+++ b/docs/guides/REV004_FINAL_MAINLINE_DELIVERY_SUMMARY.md
@@ -0,0 +1,99 @@
+# REV004 最终主线验收 / 联调交付总表
+
+## 1. 当前主线基线
+### backend
+- repo：`emsoft-IF/sw-system-cloud`
+- branch：`develop`
+- latest merge：`ea159faa3bae2b7491d4e60cbe79e392e77e7345`
+
+### docs
+- repo：`tangweijie/fujian_water_biz_doc`
+- branch：`main`
+- latest merge：`415b4cee1303f51c7a3aeb0a58722873e852452c`
+
+---
+
+## 2. 已完成的 REV004 主对象真值恢复
+| 对象 | objectType / 域 | 主表 | 当前主线状态 | 备注 |
+|---|---|---|---|---|
+| 预存调整 | prestorage | `biz_prestorage_adjust` / `biz_prestorage_adjust_detail` | 已完成 | process/attachments 也已 strict formal-first 收口 |
+| 坏账调整 | `BAD_DEBT_RECORD` | `biz_bad_debt_adjust` / `biz_bad_debt_adjust_detail` | 已完成 | formal-first |
+| 已销调整 / 核销 | `WRITTENOFF_ADJUST` | `biz_writtenoff_adjust` / `biz_writtenoff_adjust_detail` | 已完成 | formal-first |
+| 违约金减免 | `LATE_FEE_REDUCE` | `biz_latefee_reduce` / `biz_latefee_reduce_detail` | 已完成 | formal-first |
+| 分账调整 | `SPLIT_ADJUST` | `biz_split_adjust` / `biz_split_adjust_detail` | 已完成 | 专属对象域 |
+| 价差调整 | `PRICE_DIFF_ADJUST` | `biz_price_diff_adjust` / `biz_price_diff_adjust_detail` | 已完成 | formal-first |
+| 红冲记录 | `REDINK_RECORD` | `biz_redink_record` / `biz_redink_record_detail` | 已完成 | 结果型 formal-table；live execute 仍有外部依赖补证 |
+
+---
+
+## 3. 本轮已合入主线的 PR / merge sha
+### backend develop
+- PR #77：writtenoff formal-table
+  - merge sha：`9462f3a12728b83bfe31e0b74c526f4256f5b361`
+- PR #78：price-diff formal-table
+  - merge sha：`1964c7823291cd4972c72c50ffcad154f3a74b4c`
+- PR #79：redink formal-table
+  - merge sha：`d8596af47479ef28664b83200d86f7770c8b9bd4`
+- PR #80：prestorage process/attachments strict formal-first
+  - merge sha：`ea159faa3bae2b7491d4e60cbe79e392e77e7345`
+
+### docs main
+- price-diff evidence merge：`c741164fa48dd79f4c43ffb15e3b093933dc642c`
+- current truth matrix（含 price-diff）merge：`692ac419f6fab7da63e90e74e06d200e427580fa`
+- redink evidence merge：`57763c634e0e6733d0861051f6b78c5dcdb9022f`
+- current truth matrix（含 redink）merge：`89737608b356dcc3dd40e40d90cf9064059ca467`
+- prestorage strict formal-first evidence merge：`415b4cee1303f51c7a3aeb0a58722873e852452c`
+
+---
+
+## 4. 已有 evidence 文档
+- `docs/evidence/rev004-prestorage-formal-table-dev-db-apply-2026-04-16.md`
+- `docs/evidence/rev004-bad-debt-formal-table-dev-db-apply-2026-04-17.md`
+- `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`
+- `docs/evidence/rev004-prestorage-strict-formal-first-2026-04-17.md`
+
+---
+
+## 5. 当前仍需说明的残留点
+### 5.1 redink
+- formal-table 已落主线
+- compile / targeted tests / DDL / query smoke 已完成
+- 但 live execute 端到端补证仍被外部依赖阻塞：
+  - `business-bank-server` 无可用实例
+  - 已有精确 blocker evidence
+
+### 5.2 其他对象
+- 当前主线里最明显未独立 formal-table 的核心对象已经大幅减少
+- 如果继续扩展，下一步更适合做：
+  - 对外联调说明收口
+  - 或处理外部依赖类 blocker 补证
+
+---
+
+## 6. 给联调方的可直接口径
+### 对前端
+当前 REV004 主线可按独立对象化口径使用：
+- prestorage
+- bad debt
+- writtenoff
+- late fee reduce
+- split adjust
+- price diff
+- redink
+
+其中：
+- prestorage 的 `process / attachments` 已 formal-first
+- redink 已独立，但 live execute 的外部依赖补证未完成
+
+### 对测试
+优先参考对应 evidence 文档回归：
+- 表结构是否存在
+- DDL 是否幂等
+- compile / targeted tests 是否通过
+- fresh smoke 是否通过
+- cleanup 是否完成
+
+### 对产品 / 管理
+REV004 本轮已基本完成主对象 formal-table 恢复与主线收口；后续重点已从“建模缺失”转向“外部依赖补证 + 联调说明完善”。