Parcourir la source

📝 docs(payment): update wechat payment refund integration plan

- 修改PaymentMtService任务描述,从"添加refund方法"改为"实现退款方法"
- 移除退款签名验证和回调处理路由相关子任务
- 新增退款实时返回结果处理任务,包括同步结果处理和订单状态更新
- 调整测试任务,移除单元测试和回调测试,保留API集成测试
- 更新文件位置说明,明确退款实时处理和回调处理代码位置
yourname il y a 1 mois
Parent
commit
53ccc8bd2b
1 fichiers modifiés avec 8 ajouts et 12 suppressions
  1. 8 12
      docs/stories/011.003.wechat-payment-refund-integration.story.md

+ 8 - 12
docs/stories/011.003.wechat-payment-refund-integration.story.md

@@ -18,15 +18,13 @@ Draft
 7. 支持部分退款和全额退款
 
 ## Tasks / Subtasks
-- [ ] 在PaymentMtService中添加refund方法 (AC: 1, 2, 3)
+- [ ] 在PaymentMtService中实现退款方法 (AC: 1, 2, 3)
   - [ ] 实现退款请求构建逻辑 `packages/mini-payment-mt/src/services/payment.mt.service.ts:240-265`
   - [ ] 集成微信支付退款SDK调用 `packages/mini-payment-mt/src/services/payment.mt.service.ts:250-258`
-  - [ ] 实现退款签名和参数验证 `packages/mini-payment-mt/src/services/payment.mt.service.ts:244-249`
-  - [ ] 添加退款回调处理逻辑 `packages/mini-payment-mt/src/services/payment.mt.service.ts:182-185`
-- [ ] 在payment.mt.routes.ts中添加退款API端点 (AC: 1, 4)
-  - [ ] 创建退款API路由 `packages/mini-payment-mt/src/routes/payment/refund.mt.ts` (新文件)
-  - [ ] 实现退款请求验证 `packages/mini-payment-mt/src/routes/payment/refund.mt.ts:15-30`
-  - [ ] 添加退款回调处理路由 `packages/mini-payment-mt/src/routes/payment/refund-callback.mt.ts` (新文件)
+- [ ] 处理退款实时返回结果 (AC: 4, 5)
+  - [ ] 处理退款API同步返回结果 `packages/mini-payment-mt/src/services/payment.mt.service.ts:250-258`
+  - [ ] 根据退款结果立即更新订单状态 `packages/orders-module-mt/src/services/order.mt.service.ts:218-226`
+  - [ ] 验证现有退款回调处理逻辑(可选) `packages/mini-payment-mt/src/services/payment.mt.service.ts:295-298`
 - [ ] 扩展payment.mt.entity.ts中的退款相关字段 (AC: 5, 6)
   - [ ] 添加退款状态字段 `packages/mini-payment-mt/src/entities/payment.mt.entity.ts:45-48`
   - [ ] 添加退款流水号字段 `packages/mini-payment-mt/src/entities/payment.mt.entity.ts:49-52`
@@ -37,9 +35,7 @@ Draft
   - [ ] 处理退款成功/失败状态 `packages/orders-module-mt/src/services/order.mt.service.ts:218-226`
   - [ ] 更新订单和退款记录状态 `packages/orders-module-mt/src/services/order.mt.service.ts:229-235`
 - [ ] 实现退款测试 (AC: 1-7)
-  - [ ] 编写退款功能单元测试 `packages/mini-payment-mt/tests/integration/payment-refund.integration.test.ts` (新文件)
-  - [ ] 编写退款API集成测试 `packages/mini-payment-mt/tests/integration/payment-refund.integration.test.ts:30-60`
-  - [ ] 编写退款回调集成测试 `packages/mini-payment-mt/tests/integration/payment-refund.integration.test.ts:65-95`
+  - [ ] 编写退款API集成测试 `packages/mini-payment-mt/tests/integration/payment-refund.integration.test.ts:30-60` (新文件)
   - [ ] 验证多租户退款数据隔离 `packages/mini-payment-mt/tests/integration/payment-refund.integration.test.ts:100-130`
 
 ## Dev Notes
@@ -108,8 +104,8 @@ Draft
 
 ### File Locations
 - **退款服务实现**: `packages/mini-payment-mt/src/services/payment.mt.service.ts:240-265` (添加refund方法)
-- **退款API路由**: `packages/mini-payment-mt/src/routes/payment/refund.mt.ts` (需要创建)
-- **退款回调路由**: `packages/mini-payment-mt/src/routes/payment/refund-callback.mt.ts` (需要创建)
+- **退款实时处理**: `packages/mini-payment-mt/src/services/payment.mt.service.ts:250-258` (退款API同步返回)
+- **退款回调处理**: `packages/mini-payment-mt/src/services/payment.mt.service.ts:295-298` (现有退款回调处理,可选)
 - **退款类型定义**: `packages/mini-payment-mt/src/entities/payment.types.ts:1-42` (需要扩展退款相关类型)
 - **退款实体字段**: `packages/mini-payment-mt/src/entities/payment.mt.entity.ts:45-60` (需要添加退款相关字段)
 - **退款测试**: `packages/mini-payment-mt/tests/integration/payment-refund.integration.test.ts` (需要创建)