Files
junhong_cmp_fiber/openspec/changes/add-legacy-approval-trigger/proposal.md
2026-08-18 16:15:46 +08:00

1.6 KiB
Raw Blame History

Why

七月迭代上线前已创建且仍待审批的退款申请、员工线下代充值申请未关联通用审批实例,无法进入企业微信审批流。需要由管理员按单主动补发,同时避免同一业务重复创建审批单。

What Changes

  • 为待审批且尚未关联审批实例的历史退款申请新增主动发起企业微信审批接口。
  • 为待审批、线下支付且尚未关联审批实例的历史代理充值申请新增主动发起企业微信审批接口。
  • 主动发起时复用原业务创建人作为企业微信审批发起人;原创建人不可用或审批场景不可用时不创建审批实例。
  • 在同一事务创建通用审批实例、企业微信上下文、提交 Outbox 并回填业务记录的 approval_instance_id,以该唯一关联保证成功创建后不可再次发起。
  • 仅在业务保持待审批状态时允许主动发起;已关联审批实例、非线下充值或非待审批记录均拒绝。

Capabilities

New Capabilities

  • 无。

Modified Capabilities

  • order-refund-exchange: 退款申请可对历史待审批且未关联审批实例的记录主动创建一次企业微信审批。
  • agent-funds-commission: 历史待审批线下代理充值申请可主动创建一次企业微信审批。

Impact

  • 路由、退款与代理充值 Handler/Service以及审批创建 Application 用例。
  • 新增两个后台 API 并同步 OpenAPI 文档生成入口。
  • 复用现有通用审批、企业微信审批上下文、Outbox、审计和既有 approval_instance_id 唯一索引;不新增外部依赖或数据库表结构。