break
7891189712
All checks were successful
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 8m52s
- 受控配置新增代理在线自充允许范围（仅微信/仅支付宝/同时支持），读侧与创建侧取允许范围与可用商户池交集，两侧失败关闭 - 新增允许范围查询与修改端点，读限代理与平台账号、写限超级管理员，复用受控配置写服务留痕 - tb_agent_recharge_record 新增交易流水号、线下收款方式三列快照与其他凭证列（成对迁移 000213） - 线下申请校验启用的收款方式字典项与必填交易流水号，交易流水号独立于在线渠道交易号、不参与去重 - 扩展 offline_recharge_approval 场景可映射字段白名单与字典引用保护 - 新增付款凭证识别能力与交易流水号预填接口，识别不落库、日志不记录载荷
44 lines
3.6 KiB
Markdown
44 lines
3.6 KiB
Markdown
## Scope
|
||
|
||
- 迭代编号：`AUG26-017`。
|
||
- 需求出处：
|
||
- `111.md` §25（PRD-008-021 代理自充收款方式可配置）与讨论稿 §2.16 第 3 段：超管维护允许范围、与商户池方式取交集、只读交集、配置不影响已创建未支付单。
|
||
- 讨论稿 §2.16 第 4 段：代理充值记录新增交易流水号字段。
|
||
- `111.md` §17.1（预存款审批字段）与讨论稿 §2.1 第 5 点：预存款审批选择线下收款方式字典项并冻结名称快照；讨论稿 §0.1 已将该子节归入 AUG26-017。
|
||
- 讨论稿 §0 第 4 条与 §2.1 第 3 点：OCR 仅作为交易流水号的预填来源，人工确认值才是业务事实。
|
||
|
||
## Why
|
||
|
||
代理在线自充当前只能由商户池可用性推导可用方式，平台无法收窄代理可选范围；需求方要求超级管理员可配置"仅微信 / 仅支付宝 / 同时支持"，并使代理实际可用方式等于该范围与商户池方式的交集。同时线下预存款审批缺少可维护的公司收款方式与交易流水号，无法按 §17.1 完整留存付款事实。
|
||
|
||
## What Changes
|
||
|
||
- 新增超级管理员可维护的代理在线自充允许方式，取值仅微信、仅支付宝、同时支持三种之一；修改记录操作者、前后值与时间。
|
||
- 代理实际可用线上方式改为"允许范围 ∩ 当前可用商户池支付方式"，查询返回该交集的有序 `wechat`/`alipay` 列表，不返回商户身份、凭证或允许范围本身；代理与平台账号均可查询。
|
||
- 代理以某方式创建在线充值单时校验该方式在交集内；交集为空时查询返回空列表并拒绝创建，不回退任何历史支付配置。配置变更只影响后续新单，已创建未支付单保留其支付方式与商户路由快照。
|
||
- 代理充值记录新增交易流水号，保存该笔充值对应的交易流水号。
|
||
- 线下预存款审批补齐收款方式（引用既有线下收款方式字典并冻结标识、编码、名称快照）、其他凭证与交易流水号，并接入 Gateway 付款凭证识别作为预填能力；识别结果不是资金事实。
|
||
|
||
## Capabilities
|
||
|
||
### New Capabilities
|
||
|
||
无。
|
||
|
||
### Modified Capabilities
|
||
|
||
- `agent-funds-commission`：代理在线充值可用支付方式由"按当前生效支付配置判定"改为"按超级管理员允许范围与可用商户池方式的交集判定"，并新增允许范围维护与审计、交集查询与创建门禁、充值记录交易流水号、线下预存款审批收款方式与其他凭证、付款凭证识别预填，以及线下收款方式字典对代理充值引用的删除与改码保护。
|
||
|
||
## Impact
|
||
|
||
影响代理在线充值可用方式判定与创建门禁、代理充值记录 Schema、线下预存款企业微信审批场景的业务字段白名单与详情映射、受控系统配置注册、Gateway 外部集成、路由与 OpenAPI 文档。不影响 C 端个人客户能力、员工代收款账单建账判据与核销流程、套餐退款与原路退款。
|
||
|
||
## Non-Goals
|
||
|
||
- 不新增代理自助线下转账充值入口；代理商线下充值申请仍由平台账号经办，不改造其创建门禁、状态机或审批实例语义。
|
||
- 不为线下充值引入"驳回后可修改重提"或多审批实例的审批尝试记录模型。
|
||
- 不新建第二份线下收款方式字典，不建设收款账户目录。
|
||
- 不改造员工代收款核销申请的字段与流程，不改动员工账单建账与退款冲销判据。
|
||
- 不实现套餐退款、OCR 之外的第三方契约变更，不新增支付渠道能力。
|
||
- 不实现自动化测试（项目决策为 N/A）。
|