break
b063617153
All checks were successful
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 9m35s
28 lines
2.0 KiB
Markdown
28 lines
2.0 KiB
Markdown
## Why
|
|
|
|
退款申请已经冻结退款方式、客户收款信息和客户凭证，但企业微信审批快照与可映射字段未包含这些材料，审批人无法判断具体退款路径，客户收款信息退款还可能因模板无字段可选而提交失败。模板或提交异常修复后也缺少业务级安全恢复入口，导致在途退款无法继续审批。
|
|
|
|
## What Changes
|
|
|
|
- 所有新建和重提退款审批材料新增退款方式，并按固定中文名称展示原路退款、客户收款信息退款、退回资产钱包或退回代理主钱包。
|
|
- 仅客户收款信息退款在企业微信材料中提交多行客户收款信息与客户凭证附件；其他退款方式不要求或伪造收款材料。
|
|
- 扩展企业微信退款场景字段白名单与表单构建规则：退款方式始终必须映射，客户收款信息和凭证按退款方式条件必需，缺失时明确指出需配置的控件。
|
|
- 为提交失败、结果未知或已有企业微信审批单号但本地未确认的退款申请新增原审批恢复入口，复用最新审批尝试、原审批实例和稳定提交事实。
|
|
- 对本变更上线前已失败且请求快照缺少新增材料的原审批实例，从其关联的不可变退款审批尝试补齐缺失键后恢复；不得从退款主表取值、覆盖已有快照或创建第二张审批单。
|
|
- 退款列表与详情返回审批提交状态、可恢复标记、安全失败摘要和最近恢复时间。
|
|
|
|
## Capabilities
|
|
|
|
### New Capabilities
|
|
|
|
无。
|
|
|
|
### Modified Capabilities
|
|
|
|
- `order-refund-exchange`: 补齐企业微信退款审批方式与条件收款材料，并增加原审批实例的受控恢复、状态展示和权限行为。
|
|
|
|
## Impact
|
|
|
|
- 影响退款审批快照构建、退款审批尝试读取、企业微信业务字段白名单、条件映射校验、表单构建、通用审批恢复接缝、退款查询投影、Handler、路由和 OpenAPI。
|
|
- 复用现有退款审批尝试、通用审批实例、企业微信上下文、Outbox、Asynq 与审计事实；不新增第三方依赖或数据库迁移。
|