docs(scratch): 五票人工验收通过，状态与勾选落档

yeg

2026-09-17 89d1addecbf2f8e5446a6236a4b1ec57d26e0bc2

docs(scratch): 五票人工验收通过，状态与勾选落档

用户于 2026-09-17 宣布 5 票人工验收通过：五张 ticket 的 Status 由 ready-for-human 改为
「已验收 —— 2026-09-17 用户人工验收通过」，各票最后一项「页面级人工验收」勾上，
spec 的 Status 同步更新。验收步骤与开发库样本见 spec 的「人工验收」一节。

 .scratch/merchant-capability-visibility/issues/01-onboarding-completion-checks.md

@@ -6,14 +6,14 @@

Blocked by: None

Status: ready-for-human —— 代码侧交付完成，待两端页面人工验收
Status: 已验收 —— 2026-09-17 用户人工验收通过（步骤见 [spec](../spec.md) 的「人工验收」）

- [x] `view()` 返回新增字段，含 `bank` 与 `merchantNormal` 的当前核实结果与可读原因；两项都为真时不制造噪音（页面上不多出一行「已核实」）。
- [x] `stages` 仍恰好是 basic/wechat/appId/realname/delay/settlement 六项，`complete()` 判定与 `application.status` 的写入逻辑不变。
- [x] 文案用第二、三轮定的词汇：通道商户状态异常时写「斗拱子商户状态异常（<值>），请联系汇付或后台处理」，**不写「待办理」**——「待办理」只用于进件阶段。
- [x] `reason` 里那句「请刷新进度核实各项能力，并按待办理项补齐缺失能力」不再出现在六项全绿的情况下。
- [x] 不回归：`MerchantExistingOnboardingTests` 里 `onboardingStatus(...).get("stages")` 的列表相等断言仍通过。
- [ ] 页面级人工验收（见「验收」）。
- [x] 页面级人工验收（见「验收」）。

## 验收


 .scratch/merchant-capability-visibility/issues/02-merchant-payment-readiness-endpoint.md

@@ -11,14 +11,14 @@

Blocked by: None

Status: ready-for-human —— 代码侧交付完成，待两端页面人工验收
Status: 已验收 —— 2026-09-17 用户人工验收通过（步骤见 [spec](../spec.md) 的「人工验收」）

- [x] 未进件／待审核／已驳回的商户也能调用：判定为不可收款并给出对应原因（复用既有原因链，不新造文案）。
- [x] 已 approved 且快照正常的商户返回 `ready=true`，`verifiedAt` 为 `capability_verified_at`。
- [x] 快照从未核实（`unknown`）时返回不可收款与「待确认」原因，且**不查通道**。
- [x] 权限：只返回当前 principal 的商户与门店的判定；跨商户、跨门店不可见。
- [x] 新端点补进 `rencaika_merchant/docs/项目接口对接说明.md`。
- [ ] 页面级人工验收。
- [x] 页面级人工验收。

## 验收


 .scratch/merchant-capability-visibility/issues/03-manual-capability-verify-with-cooldown.md

@@ -10,7 +10,7 @@

Blocked by: 02

Status: ready-for-human —— 代码侧交付完成，待两端页面人工验收
Status: 已验收 —— 2026-09-17 用户人工验收通过（步骤见 [spec](../spec.md) 的「人工验收」）

- [x] 冷却期内第二次调用不产生通道查询（用 mock 通道的调用次数断言）。
- [x] 查询失败（通道异常、结果未知）同样节流，失败信息按既有失败路径写 `capability_response_code`／`capability_response_message`，快照其余列不被覆盖。
@@ -20,7 +20,7 @@
- [x] 测试沿用 `MerchantPaymentReadinessServiceTests` 风格（`@SpringBootTest` + mock 通道 + 直接造 `merchant_stat`）。
- [x] 迁移只追加、不改已执行迁移；跑测试用 `scripts/run-server-tests.ps1`。
- [x] 新端点补进 `rencaika_merchant/docs/项目接口对接说明.md`。
- [ ] 页面级人工验收。
- [x] 页面级人工验收。

## 验收


 .scratch/merchant-capability-visibility/issues/04-onboarding-page-shows-completion-checks.md

@@ -8,13 +8,13 @@

Blocked by: 01

Status: ready-for-human —— 代码侧交付完成，待两端页面人工验收
Status: 已验收 —— 2026-09-17 用户人工验收通过（步骤见 [spec](../spec.md) 的「人工验收」）

- [x] 进件页能显示 `bank`／`merchantNormal` 未核实或异常的原因，文案不含「待办理」（「待办理」只用于六项进件阶段）。
- [x] `stages` 仍渲染六项，渲染逻辑保持通用循环，不硬编码阶段名（现有仅 `realname` 例外）。
- [x] approved 时页面行为与现在一致（标题「商户进件已完成」、不出现刷新按钮）。
- [x] `services/settlement.uts` 里的 `SettlementOnboarding` 类型与映射补上新字段。
- [ ] 页面级人工验收。
- [x] 页面级人工验收。

## 验收


 .scratch/merchant-capability-visibility/issues/05-merchant-center-payment-capability-page.md

@@ -11,13 +11,13 @@

Blocked by: 02, 03

Status: ready-for-human —— 代码侧交付完成，待两端页面人工验收
Status: 已验收 —— 2026-09-17 用户人工验收通过（步骤见 [spec](../spec.md) 的「人工验收」）

- [x] 商户中心出现「收款能力」入口，可进入新页面。
- [x] `ready=true` 时显示可收款与最近核实时间；`ready=false` 时显示原因与最近核实时间。
- [x] 快照从未核实时显示待确认原因，且「立即核实」可点。
- [x] 冷却中按钮禁用并显示下次可核实时间；冷却结束自动恢复可点。
- [ ] 页面验收：把测试库 `merchant_stat` 改成非 `NORMAL`，页面与「扫码下单被拒」的文案一致；改回 `NORMAL` 并核实后恢复可收款。
- [x] 页面验收：把测试库 `merchant_stat` 改成非 `NORMAL`，页面与「扫码下单被拒」的文案一致；改回 `NORMAL` 并核实后恢复可收款。

## Comments


 .scratch/merchant-capability-visibility/spec.md

@@ -1,6 +1,6 @@
# 商户端可见「我现在能不能收款」

Status: ready-for-agent
Status: 已验收 —— 2026-09-17 用户宣布人工验收通过（验收步骤与样本见下方「人工验收」；票 01–05 均已验收）
更新日期：2026-09-17
规格来源：本会话 grilling 已确认的决策，以及只读代码核查（`MerchantOnboardingProgressService`、`MerchantPaymentReadinessService`、`MerchantPaymentCapabilityScheduler`、两端页面）。
相关留档：[汇付控台关闭商户后我们这边会怎样](../merchant-closure-impact/issues/huifu-merchant-closure-impact.md)（结论证据不变，其中「遗留一／遗留二」由本规格落实）。