docs: 付款履约计划改为金蝶实际付款后同步的口径说明

doc/docs/hcs合同/2026-10-29-履约计划与履约记录四场景业务说明（业务人员版）.md

@@ -56,7 +56,7 @@
 
 | 业务动作 | 计划金额变化 |
 | --- | --- |
-| 付款申请**审批通过** | 对应付款计划的金额 += 本次申请金额 |
+| 付款申请**审批通过** | 对应付款计划的金额 += 本次申请金额（本地记账，**金蝶实际付款后**才同步到合规） |
 | 收款流水**认领完成** | 对应收款计划的金额 += 本次认领分摊金额 |
 
 请注意：
@@ -84,11 +84,11 @@
 
 ```
 付款申请审批通过
-   → 只更新计划金额，不产生履约付款记录
+   → 本地累加计划金额（暂不同步合规），不产生履约付款记录
    → 推送金蝶付款申请
 金蝶完成实际付款
    → 系统回写实付金额
-   → 生成履约付款记录
+   → 计划金额同步到合规 + 生成履约付款记录
 ```
 
 业务要点：
@@ -101,7 +101,7 @@
 | 附件 | 付款场景会把付款附件一并传到合规 |
 | 特批 | 需要特批的付款，特批通过后也不会立刻生成记录，仍要等金蝶实际付款 |
 
-> 常见误区：付款审批通过后就去合规找履约付款记录——此时还没有，属于正常现象，金蝶付款后才会出现。
+> 常见误区：付款审批通过后就去合规找履约付款记录——此时还没有，属于正常现象，金蝶付款后才会出现（付款计划金额的累加同样是金蝶实际付款后才同步到合规）。
 
 ---
 

doc/docs/hcs合同/2026-10-29-履约计划与履约记录四场景实现逻辑（付款-开票-收票-收款）.md

@@ -16,7 +16,7 @@
 合同审批通过
   └─ 建默认履约计划行 → 推合同 C103-1（拿合同 hcs_fd_id）
        └─ 推履约计划 C103-9（拿计划 hcs_exeplan_id + 每行 hcs_stage_fd_id）
-            ├─ 付款：审批通过 → 计划金额累加 → 金蝶实际付款 → C108-1/C108-2
+            ├─ 付款：审批通过 → 计划金额本地累加（不推合规） → 金蝶实际付款 → C103-9 重推 + C108-1/C108-2
             ├─ 收款：认领提交 → 计划金额累加 → C107-1 → C108-1
             ├─ 开票：金蝶开票完成、发票落库 → C111 登记 → 每张发票 C108-1
             └─ 收票：收票单推合规 C109 成功 → 每条结算分摊行 C108-1
@@ -86,7 +86,7 @@ blade_receipt_claim_hcs_record.hcs_claim_record_fd_id  C107-1 认领记录ID（
 | 入口 | 位置 | 门禁 | 说明 |
 | --- | --- | --- | --- |
 | 合同链 | `HcsContractSyncSupport#pushContract` 第⑤步 | `exe-stage.sync-enabled` | 合同起草/更新成功后、特批挂起前同步计划 |
-| 付款链 | `HcsPaymentSyncSupport#pushPayment` 第②步 | `exe-stage.sync-enabled` | 特批门禁通过后，先重推计划，再推履约记录 |
+| 付款链 | `HcsPaymentSyncSupport#pushPayment` 第③步 | `exe-stage.sync-enabled` | **金蝶实际付款门禁通过后**重推计划（审批通过仅本地累加金额不推送），再推履约记录 |
 | 收款链 | `HcsClaimSyncSupport#pushOneContract` 第①步 | `exe-stage.sync-enabled` | 先累加并重推计划，再推 C107-1/C108-1 |
 
 > 合同还没推合规时，计划行只做本地标记/累加，不报错，等合同链首推时一并带上。
@@ -110,13 +110,13 @@ blade_receipt_claim_hcs_record.hcs_claim_record_fd_id  C107-1 认领记录ID（
 
 ```
 付款申请审批通过
-  → hcs_sync_status=unsynced；计划金额 += 申请金额
-  → 即时推送/扫描：先 C103-9 重推计划
-  → 此时 paidAmount=0 → 跳过履约记录（日志“金蝶未实际付款”），整体仍置 synced
+  → hcs_sync_status=unsynced；计划金额本地累加（row_op=update，不推合规）
+  → 即时推送/扫描：paidAmount=0 → 履约计划与履约记录均不推送
+    （提示“金蝶未实际付款”），整体仍置 synced
 
 金蝶实际付款 → A103-2 回写（applyPayApplyResult）
   → paidAmount 首次>0 或金额变化 → hcs_sync_status=unsynced
-  → 扫描付款任务：
+  → 扫描付款任务：先 C103-9 重推累加金额的计划行
        无 hcs_perf_fd_id → C108-1 新建，返回 fdId 立即落库
        有 hcs_perf_fd_id → C108-2 更新（分期付款推进实际金额）
 ```
@@ -261,7 +261,7 @@ sequenceDiagram
 | 任务 | 默认 cron | 内容 |
 | --- | --- | --- |
 | contract | `0 1/5 * * * ?` | C103-1/C103-11 → C103-9 |
-| payment | `0 2/5 * * * ?` | C106 特批 → C103-9 → C108-1/2 |
+| payment | `0 2/5 * * * ?` | C106 特批 →（金蝶实际付款后）C103-9 → C108-1/2 |
 | invoice-application | `0 3/5 * * * ?` | C111 → 履约开票 C108-1 |
 | invoice-receipt | `0 4/5 * * * ?` | C109 → 履约收票 C108-1 |
 | 收款 | 无独立任务 | 认领事务提交后事件驱动 |