Răsfoiți Sursa

📝 docs(prd): update mini payment refund flow documentation

- add detailed modification locations for each story
- update scope validation from 4 to 5 stories
- refine mini app frontend key points with specific file paths
- add story 4 for mini app payment page and flow integration
- update story numbering for all subsequent stories
yourname 1 lună în urmă
părinte
comite
8132c5a7c2
1 a modificat fișierele cu 36 adăugiri și 8 ștergeri
  1. 36 8
      docs/prd/epic-011-mini-payment-refund-flow.md

+ 36 - 8
docs/prd/epic-011-mini-payment-refund-flow.md

@@ -72,6 +72,9 @@
 ## Stories
 
 1. **Story 1:** 完善支付回调处理逻辑 - 确保支付回调正确更新订单状态,支持多租户隔离
+   - **修改位置:**
+     - `packages/mini-payment-mt/src/services/payment.mt.service.ts` - 修复TODO注释,实现订单状态更新
+     - `packages/mini-payment-mt/src/routes/payment/callback.mt.ts` - 支付回调接口
    - **验收标准:**
      - 支付回调接口正确处理微信支付通知
      - 订单状态从"待支付"正确更新为"已支付"(支付状态从0更新为2)
@@ -81,6 +84,10 @@
      - 修复支付模块中的TODO:更新订单状态
 
 2. **Story 2:** 实现订单取消功能 - 支持已支付订单的取消和退款流程
+   - **修改位置:**
+     - `packages/orders-module-mt/src/services/order.mt.service.ts` - 添加cancelOrder方法
+     - `packages/orders-module-mt/src/routes/user/orders.mt.ts` - 添加取消订单API
+     - `mini/src/pages/order-detail/index.tsx` - 集成取消订单UI
    - **验收标准:**
      - 在订单详情页面添加取消订单按钮
      - 取消订单时验证订单状态(仅允许取消"待支付"和"已支付"订单)
@@ -90,6 +97,10 @@
      - 在OrderMtService中添加cancelOrder方法
 
 3. **Story 3:** 集成微信支付退款功能 - 调用微信支付SDK实现退款
+   - **修改位置:**
+     - `packages/mini-payment-mt/src/services/payment.mt.service.ts` - 添加refund方法
+     - `packages/mini-payment-mt/src/routes/payment/create.mt.ts` - 添加退款API
+     - `packages/mini-payment-mt/src/entities/payment.mt.entity.ts` - 可能扩展退款相关字段
    - **验收标准:**
      - 在PaymentMtService中添加退款功能
      - 集成微信支付退款SDK
@@ -99,11 +110,28 @@
      - 退款金额、退款流水号等字段正确记录
      - 支持部分退款和全额退款
 
-4. **Story 4:** 优化订单状态流转和退款记录 - 完善订单状态管理和退款跟踪
+4. **Story 4:** Mini小程序前端支付页面和流程集成 - 创建支付页面并集成支付流程
+   - **修改位置:**
+     - `mini/src/pages/payment/index.tsx` - 创建支付页面
+     - `mini/src/pages/order-submit/index.tsx` - 集成支付页面跳转
+     - `mini/src/pages/order-list/index.tsx` - 集成"去支付"按钮功能
+     - `mini/src/pages/order-detail/index.tsx` - 集成取消订单功能
+   - **验收标准:**
+     - 创建完整的支付页面,支持微信支付调用
+     - 订单提交页面成功跳转到支付页面
+     - 订单列表页面的"去支付"按钮正常工作
+     - 订单详情页面支持取消订单操作
+     - 支付成功/失败有相应的页面跳转和提示
+     - 复用现有的支付工具函数库
+
+5. **Story 5:** 优化订单状态流转和退款记录 - 完善订单状态管理和退款跟踪
+   - **修改位置:**
+     - `packages/orders-module-mt/src/entities/order.mt.entity.ts` - 完善状态字段
+     - `packages/orders-module-mt/src/services/order.mt.service.ts` - 优化状态流转逻辑
+     - `packages/orders-module-mt/src/entities/order-refund.mt.entity.ts` - 完善退款记录实体
    - **验收标准:**
      - 实现完整的订单状态机
      - 完善退款记录实体,跟踪退款历史
-     - 在订单详情中显示退款状态和记录
      - 支持退款失败的重试机制
      - 添加退款操作的审计日志
 
@@ -289,7 +317,7 @@ class OrderDetailPage {
 ## Validation Checklist
 
 ### Scope Validation
-- [x] Epic可以在4个故事内完成
+- [x] Epic可以在5个故事内完成
 - [x] 不需要架构文档
 - [x] 增强遵循现有模式
 - [x] 集成复杂度可控
@@ -321,10 +349,10 @@ class OrderDetailPage {
 - 每个故事必须包括验证现有功能保持完整的验证
 - 特别注意:支付模块中已有TODO需要更新订单状态,需要实现
 - **Mini小程序前端关键点:**
-  - 订单提交页面(已存在)需要集成支付页面跳转
-  - 订单列表页面(已存在)的"去支付"按钮需要集成支付功能
-  - 需要创建支付页面(`/pages/payment/index.tsx`)
-  - 订单详情页面(已存在)需要集成取消订单功能
-  - 复用现有的支付工具函数库(`/utils/payment.ts`)
+  - 订单提交页面(`mini/src/pages/order-submit/index.tsx`)需要集成支付页面跳转
+  - 订单列表页面(`mini/src/pages/order-list/index.tsx`)的"去支付"按钮需要集成支付功能
+  - 需要创建支付页面(`mini/src/pages/payment/index.tsx`)
+  - 订单详情页面(`mini/src/pages/order-detail/index.tsx`)需要集成取消订单功能
+  - 复用现有的支付工具函数库(`mini/src/utils/payment.ts`)
 
 该史诗应在保持系统完整性的同时交付完整的支付退款流程功能。"