yeg
2026-09-18 28a435aeb431500f1e18a9b925f0590bf6403e5b
docs(scratch): 更正「历史进件重提补图」的可执行条件

原文写「让商户重新提交一次」,但实测多数已提交进件没有重提入口:商户端回到进件表单
只有 unsubmitted / rejected / 延迟入账失败(retryable 且 !refreshable) 三条路,而
454(已通过)、456(待审核)、449(待审核/对公) 都不满足;后台刷新与库内回填也都做不到。
把三条入口条件与实测结论补进 issue,避免后续照着做却做不通。
1个文件已修改
18 ■■■■■ 已修改文件
.scratch/merchant-individual-onboarding/issues/01-settlement-card-front-not-persisted.md 18 ●●●●● 补丁 | 查看 | 原始文档 | blame | 历史
.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` 的注释写明这一列是「结算凭证图」——**对公=开户许可证、