From f7868bdaa5665c70a2e2e86eb3f7a19faa999f01 Mon Sep 17 00:00:00 2001 From: yeg <1347747024@qq.com> Date: 星期二, 15 九月 2026 13:42:39 +0800 Subject: [PATCH] 更新商户进件任务票据 --- /dev/null | 57 ------------------- .scratch/merchant-wechat-onboarding/issues/02-existing-merchant-wechat-activation.md | 38 ++++++++++++ .scratch/merchant-wechat-onboarding/issues/03-new-enterprise-onboarding.md | 37 ++++++++++++ .scratch/merchant-wechat-onboarding/ticket-plan.md | 27 +++++++++ 4 files changed, 102 insertions(+), 57 deletions(-) diff --git a/.scratch/merchant-wechat-onboarding/issues/01-onboarding-wechat-delay-closure.md b/.scratch/merchant-wechat-onboarding/issues/01-onboarding-wechat-delay-closure.md deleted file mode 100644 index b6f7f6f..0000000 --- a/.scratch/merchant-wechat-onboarding/issues/01-onboarding-wechat-delay-closure.md +++ /dev/null @@ -1,57 +0,0 @@ -# 完成企业商户进件、微信支付与延迟入账开通闭环 - -Status: ready-for-agent -规格：[企业商户进件、微信支付与延迟入账开通闭环](../spec.md) - -## 目标 - -使企业商户在商户端一次提交后可完成汇付进件与人才端收款所需能力，并通过商户端和后台手动刷新，在没有回调的本地环境继续推进。微信配置失败仅重试失败步骤；延迟入账和 D1 自动结算必须取得有效的开通结果证据。 - -## 实施范围 - -- 商户端进件、分阶段进度、刷新与局部重试。 -- 进件应用服务、汇付开通与状态查询适配、必要阶段状态及幂等处理。 -- 管理后台对尚未整体通过申请的刷新、阶段结果与脱敏诊断展示。 -- 参考 6666000226048687 的微信场景及 0.70% 费率等公共规则，商户行业和资质按实际情况配置。 -- 恢复既有企业商户 6666000241335656，并使新增企业商户走完整流程。 - -## 实施顺序 - -严格先完成阶段一，再进入阶段二。不得以新商户进件试错代替恢复指定存量商户。 - -### 阶段一：先开通既有商户 - -1. 核实官方接口、场景和状态语义，只读核对 6666000241335656 的本地申请、汇付审核与实际配置。 -2. 仅实现恢复该商户所需的查询、补开、状态同步、局部重试与操作入口，复用原商户号和银行卡。 -3. 使用模拟汇付响应和真实测试库验证上述公共能力；不得调用真实新商户进件接口。 -4. 对指定商户执行缺失能力补开，完成适用实名/授权及人才端绑定，核实延迟入账和自动结算，记录汇付侧成功证据与核验时间。 - -阶段一通过条件：规格中所有必要能力取得有效成功证据。受理成功、处理中、待实名、查询超时或仅本地标记成功均不算通过。未通过时停留在该商户的查询和恢复，不创建新商户绕过。 - -### 阶段二：再完成新商户完整流程 - -5. 阶段一通过后，将已验证的公共能力接入新企业商户“一次进件 + 微信开通”的完整流程，对接商户端与后台。 -6. 先完成模拟测试及页面验收，再开展实际需要的新企业商户联调；失败时查原申请并局部修复，不反复新进件制造测试记录。 -7. 记录完整流程验收及现有资金语义回归结果。 - -## 验收 - -- 满足规格 Testing Decisions 中全部适用验收场景；以外部行为及业务结果判定，不仅验证内部方法。 -- 业务未真正生效或必要能力尚无证据时，不显示全部完成。 -- 复用原商户号和银行卡，仅补齐缺失能力；不处理其他已关闭小微商户。 -- 阶段一成功之前没有真实新进件；留存证据证明先恢复指定商户，再实施和联调新商户完整流程。 -- 普通自动化测试不创建汇付商户；联调不得将创建或关闭重建商户作为失败重试手段。 -- 本次进件不增加定时查询或页面自动轮询；保留已有回调，不修改其他支付补偿任务。 -- 人才端是唯一付款端，商户端仅创建到店订单和核销。 -- 遵守单 checkout 单 Maven、只追加迁移、共享文件最小增量和开发库保护约定。 - -## 边界 - -规格为本 Issue 的权威需求。交易下单、登录、退款和核销实现的范围外问题只读排查并单独交接；不借恢复商户扩大业务范围。真实实名、授权及签约需由适当商户人员完成，不能通过本地改状态代替。 - -## Comments - -- 2026-09-15：用户补充执行顺序：先给 6666000241335656 开通微信并确认成功，再做新商户进件与微信开通。原因是每次新进件会增加控台记录且只能关闭、不能删除；已将阶段切换条件与防止真实测试数据积累的要求写入规格和本 Issue。 - -- 2026-09-15：按用户指定的 to-spec 技能从本会话合成并发布，应用 ready-for-agent 标签。用户已确认以进件服务为主要测试入口，使用真实测试库、模拟汇付响应，并补充接口权限与页面验收。 -- 2026-09-15：此次交付为规格和执行 Issue，尚未实施业务代码或恢复真实商户。未验证的通道字段、状态语义及存量实时情况已明确列为实施前核查任务。 diff --git a/.scratch/merchant-wechat-onboarding/issues/02-existing-merchant-wechat-activation.md b/.scratch/merchant-wechat-onboarding/issues/02-existing-merchant-wechat-activation.md new file mode 100644 index 0000000..fb63837 --- /dev/null +++ b/.scratch/merchant-wechat-onboarding/issues/02-existing-merchant-wechat-activation.md @@ -0,0 +1,38 @@ +# 02 — 完成指定存量商户微信与资金能力开通 + +**What to build:** 复用 6666000241335656 已有商户号，通过商户端和后台刷新、补开与局部重试，完成微信支付、人才端 AppID、适用实名/授权、延迟入账及 D1 自动结算核验，取得汇付侧真实成功证据。 + +Blocked by: None — can start immediately + +Status: ready-for-agent + +- [ ] 先核实官方查询、补开、配置及实名接口和状态语义，只读核对目标商户原申请与实际配置，明确缺项；不能预设卡住原因。 +- [ ] 商户端和后台均能刷新尚未整体通过的申请，展示一致的分阶段进度、最后同步时间、具体原因与下一步；权限与敏感信息展示符合规格。 +- [ ] 基础审核通过后按通道前置要求补齐微信能力，公共配置参考 6666000226048687 的三个场景、0.70% 费率、最低收费 0 元、内扣实收和渠道规则；商户行业与资质按实际情况使用。 +- [ ] 衔接人才端 AppID 配置和实名/授权，必要材料可补充，需要商户本人办理的步骤提供有效指引；办理后通过手动刷新同步结果。 +- [ ] 补齐并核实延迟入账开启、强制延迟关闭、D1 自动批次结算、起结与留存均为 0。已配置正确的能力保持，不能仅凭请求中带参数判定生效。 +- [ ] 基本进件成功后不重建商户或银行卡；失败只重试失败步骤，未知结果先查询，未决申请不重复提交。 +- [ ] 手动刷新与有效回调按一致规则推进；重复点击、并发入口、重复或乱序通知不会重复补开或破坏同次尝试的成功结果。 +- [ ] 缺少必要能力证据时不能显示全部完成；超时保留最后有效状态，查询错误与审核拒绝区分。 +- [ ] 完成模拟集成测试、权限与页面验收，覆盖无回调推进、局部重试、未知结果、幂等、待实名及能力缺失；完成相关资金语义回归。 +- [ ] 使用已交付的操作入口恢复指定商户，记录真实微信能力、人才端绑定、适用实名/授权、延迟和结算结果及核验时间；两端显示与通道一致。 +- [ ] 整个阶段没有真实新商户进件，不操作其他已关闭小微商户，不修改参考商户。 +- [ ] 真实商户仍在审核、待实名、请求未知或缺少生效证据时，保留具体待办，本票不得标完成，03 继续阻塞。 + +**完成演示：** 在商户端或后台手动刷新指定商户，全部必要能力显示已确认，且有可核对的汇付侧证据；商户号与银行卡保持原关联。 + +## 规格与共同约束 + +[完整规格](../spec.md) + +- 查询、补开、实名、资金配置、两端页面及测试都归入对应业务阶段，不再单独拆票。 +- 复用已有进件服务、通道适配与页面，只做完成当前阶段所需的最小整理，不单列预重构。 +- 使用已确认测试边界：进件服务公开操作为主入口，真实测试库、模拟汇付响应，补充接口权限、通道合同与页面验收。 +- 普通自动化测试不得创建真实汇付商户。联调先查询原申请再处理失败，不能通过反复进件或关闭重建制造商户记录。 +- 无进件定时查询或页面自动轮询；保留有效回调。人才端是唯一付款端。 +- 只追加必要迁移，共享文件最小增量；同一 checkout 只运行一个 Maven 构建。交易、登录、退款、核销实现的范围外问题只读记录并交接。 +- 每票验收依据完整规格；下列条件突出该阶段的交付，不删减规格中的其他约束。 + +## Comments + +- 2026-09-15：用户已确认两票拆分与 02 → 03 依赖，按 to-tickets 技能发布，标记 ready-for-agent。发布工单不表示已实施或验收通过。 diff --git a/.scratch/merchant-wechat-onboarding/issues/03-new-enterprise-onboarding.md b/.scratch/merchant-wechat-onboarding/issues/03-new-enterprise-onboarding.md new file mode 100644 index 0000000..b35028b --- /dev/null +++ b/.scratch/merchant-wechat-onboarding/issues/03-new-enterprise-onboarding.md @@ -0,0 +1,37 @@ +# 03 — 完成新企业商户一次进件与微信开通流程 + +**What to build:** 02 真实验收通过后，新企业商户在商户端一次提交主体、实际行业材料和银行卡，即可沿已经验证的公共能力完成基本进件及微信开通；无回调时由两端手动刷新继续办理，失败可局部重试。 + +Blocked by: 02 — 完成指定存量商户微信与资金能力开通。 + +Status: ready-for-agent + +- [ ] 开始本票实现及真实新进件联调之前，核对 02 的真实成功证据；等待实名、接口受理或仅模拟通过不能解除阻塞。 +- [ ] 复用现有企业进件表单和 02 已验证的公共能力，完成实际行业与所需材料校验、开通意图保存及企业基本进件衔接。 +- [ ] 商户可理解适用费率与待补材料，渠道技术参数由平台维护；不复制参考商户独有身份与资质。 +- [ ] 一次提交保存唯一申请关联；基础审核未确认成功前不越过前置条件，确认后继续微信与资金能力办理。 +- [ ] 商户端与后台显示一致的基本审核及后续配置状态，提供刷新、具体失败提示和可执行下一步；普通状态读取保持只读。 +- [ ] 基础审核拒绝与后续开通失败区分处理；基本进件成功后的局部失败保留原商户号和银行卡，未知结果先查，重复提交不产生重复商户。 +- [ ] 新商户同样满足三个微信场景、人才端 AppID、适用实名/授权、延迟非强制及 D1 自动结算等完整开通条件。 +- [ ] 模拟测试覆盖一次提交到全部完成、基础审核拒绝、材料缺失、待实名、步骤失败、超时、并发、权限及能力不全，并完成两端页面验收。 +- [ ] 先完成模拟验证，再对实际需要的新企业进件做真实验收，保留原请求与通道证据；禁止反复创建测试商户排错。 +- [ ] 若没有适合的真实新商户或仍有外部待办，如实记录真实验收未完成，不伪造通过。 +- [ ] 相关回归满足到店消费支付即核销且不延迟、预购核销并完成交易确认后才可结算；不扩大既定业务范围。 + +**完成演示：** 新企业从一次提交到基本审核、微信与资金能力开通形成闭环；无回调时手动刷新也可推进，真实验收发生在 02 成功之后。 + +## 规格与共同约束 + +[完整规格](../spec.md) + +- 查询、补开、实名、资金配置、两端页面及测试都归入对应业务阶段，不再单独拆票。 +- 复用已有进件服务、通道适配与页面，只做完成当前阶段所需的最小整理，不单列预重构。 +- 使用已确认测试边界：进件服务公开操作为主入口，真实测试库、模拟汇付响应，补充接口权限、通道合同与页面验收。 +- 普通自动化测试不得创建真实汇付商户。联调先查询原申请再处理失败，不能通过反复进件或关闭重建制造商户记录。 +- 无进件定时查询或页面自动轮询；保留有效回调。人才端是唯一付款端。 +- 只追加必要迁移，共享文件最小增量；同一 checkout 只运行一个 Maven 构建。交易、登录、退款、核销实现的范围外问题只读记录并交接。 +- 每票验收依据完整规格；下列条件突出该阶段的交付，不删减规格中的其他约束。 + +## Comments + +- 2026-09-15：用户已确认两票拆分与 02 → 03 依赖，按 to-tickets 技能发布，标记 ready-for-agent。发布工单不表示已实施或验收通过。 diff --git a/.scratch/merchant-wechat-onboarding/ticket-plan.md b/.scratch/merchant-wechat-onboarding/ticket-plan.md new file mode 100644 index 0000000..0d51d7d --- /dev/null +++ b/.scratch/merchant-wechat-onboarding/ticket-plan.md @@ -0,0 +1,27 @@ +# 企业商户进件与微信开通：已确认任务拆分 + +状态：用户已确认，两个独立 Issue 已发布。 +日期：2026-09-15。 + +依据：[完整规格](spec.md)。仅保留 02、03 两张执行工单，均直接引用规格。 + +## 工单 + +| 编号 | 任务 | Blocked by | Status | +| --- | --- | --- | --- | +| 02 | [完成指定存量商户微信与资金能力开通](issues/02-existing-merchant-wechat-activation.md) | 无，可先开始 | ready-for-agent | +| 03 | [完成新企业商户一次进件与微信开通流程](issues/03-new-enterprise-onboarding.md) | 02 真实验收成功 | ready-for-agent | + +## 执行规则 + +先执行 02，复用 6666000241335656 的已有商户号，把微信、人才端 AppID、适用实名/授权、延迟入账和 D1 自动结算办妥并取得汇付侧真实证据；再执行 03，接入新增企业商户完整流程。 + +02 仍在审核、待实名、未知或缺证据时，03 不能开始。模拟测试通过、接口受理成功或本地标记成功均不解除阻塞。ready-for-agent 表示工单可由代理承接，不代表没有依赖或已经完成。 + +每个独立 Issue 包含自身验收条件及共同约束。自动化使用模拟汇付响应，不创建真实商户；真实联调失败先核对原申请，不反复新进件制造控台记录。 + +## 确认记录 + +- 2026-09-15：用户要求降低任务粒度，由六票收敛为两个业务阶段。 +- 2026-09-15：用户回复“确认”，批准按两票发布。 +- 2026-09-15：用户同意删除冗余的 01 总任务，两张工单直接引用规格；保留原编号及 02 → 03 的依赖。 -- Gitblit v1.7.1