From 28a435aeb431500f1e18a9b925f0590bf6403e5b Mon Sep 17 00:00:00 2001
From: yeg <1347747024@qq.com>
Date: 星期五, 18 九月 2026 16:26:27 +0800
Subject: [PATCH] docs(scratch): 更正「历史进件重提补图」的可执行条件

---
 .scratch/merchant-individual-onboarding/issues/01-settlement-card-front-not-persisted.md |   18 +++++++++++++++++-
 1 files changed, 17 insertions(+), 1 deletions(-)

diff --git a/.scratch/merchant-individual-onboarding/issues/01-settlement-card-front-not-persisted.md b/.scratch/merchant-individual-onboarding/issues/01-settlement-card-front-not-persisted.md
index d6ff729..672361a 100644
--- a/.scratch/merchant-individual-onboarding/issues/01-settlement-card-front-not-persisted.md
+++ b/.scratch/merchant-individual-onboarding/issues/01-settlement-card-front-not-persisted.md
@@ -76,7 +76,23 @@
      - `resubmittingSuppliesTheMissingSettlementCardFront` —— 覆盖重提补齐;
      - `resubmittingDoesNotOverwriteAnExistingSettlementCardFront` —— 覆盖"不覆盖已有值"。
      三条都先在旧实现下确认变红(且只红对应的那一条),再修回变绿。
-  4. 历史数据仍是 NULL,需要商户在进件页重新提交一次来补(重提不新建进件、不动汇付商户号与银行卡)。
+  4. 历史数据仍是 NULL。注意「让商户重提一次」这句话需要限定条件——见下一条更正。
+- 2026-09-18(更正「怎么补历史数据」):上面两次都写了「让商户重新提交一次」,但**多数已提交的进件
+  根本没有重提入口**,这句话不能照做。
+  商户端回到进件表单只有三条路(`rencaika_merchant/pages/merchant/merchant.uvue:98`、
+  `pages/merchant-onboarding-pending/merchant-onboarding-pending.uvue:51,166-176`):
+  1. `status = unsubmitted`(从没提交过);
+  2. `status = rejected`(驳回后显示「重新提交」按钮)——注意被驳回的进件不在 `active` 查询范围内,
+     重提会**新建**一条进件;
+  3. 进度里的 `retryable = true`(「延迟入账」这一步明确失败)且 `refreshable = false`,App 自动
+     把商户送回表单。
+  实测 454(已通过)、456(待审核)、449(待审核/对公)都是 `retryable = false`、状态是
+  pending/approved,App 只会停在「审核中/已完成」页——没有按钮也没有自动跳转,**商户补不了**。
+  后台也补不了:「刷新进度」只推进通道步骤,`supplyMissingOnboardingMaterials` 的调用点只有
+  `submitOnboarding:147` 一处(已核)。库里也补不了:这一列从来没落过值,当时的图片文件虽然还在
+  服务器 `/uploads/` 下,但没有任何记录能定位到是哪一张。
+  → 结论:这几条历史记录要显示图片,只能等一次自然重提(条件 2 或 3),或者另做补图入口;
+  代码层面已保证**新提交的进件一定有值**,所以这不会继续产生新的空记录。
 - 2026-09-18(支付链路,补充):**对公主体那一半也修了**,而且不需要新列。
   报告只覆盖了个人主体,但「结算银行卡卡号面」这一格在企业进件的详情里同样是空的。原因不是同一个
   字段写漏,而是**取值取错了半边**:`V143` 的注释写明这一列是「结算凭证图」——**对公=开户许可证、

--
Gitblit v1.7.1