338 lines
15 KiB
Markdown
338 lines
15 KiB
Markdown
# Implementation Plan: 订单系统迁移
|
||
|
||
## Overview
|
||
|
||
本任务列表将PHP订单系统迁移到.NET 8，按照接口优先级逐个迁移。每迁移一个接口前，需要先查看PHP代码了解详细业务逻辑；迁移完成后，需要在API接口文档.md中标记迁移状态。
|
||
|
||
## Tasks
|
||
|
||
- [x] 1. 基础设施准备
|
||
- [x] 1.1 创建订单相关的DTO和Request/Response模型
|
||
- 在HoneyBox.Model/Models/Order目录下创建相关模型
|
||
- 包括OrderMoneyRequest、OrderBuyRequest、OrderListDto、OrderDetailDto等
|
||
- 包括WarehouseIndexRequest、WarehouseItemDto、SendRequest、RecoveryResultDto等
|
||
- _Requirements: 1.1-18.4_
|
||
- [x] 1.2 创建服务接口定义
|
||
- 在HoneyBox.Core/Interfaces目录下创建IOrderService、IWarehouseService接口
|
||
- _Requirements: 1.1-18.4_
|
||
- [x] 1.3 创建数据库实体模型（如果尚未存在）
|
||
- 确认Order、OrderList、Delivery、Recovery等实体存在
|
||
- 配置EF Core映射
|
||
- _Requirements: 1.1-18.4_
|
||
- [x] 1.4 注册服务到DI容器
|
||
- 在ServiceModule.cs中注册OrderService、WarehouseService
|
||
- _Requirements: 1.1-18.4_
|
||
|
||
- [x] 2. 一番赏订单金额计算服务实现
|
||
- [x] 2.1 查看PHP代码了解一番赏订单金额计算业务逻辑
|
||
- 阅读server/php/app/api/controller/Order.php中的ordermoney方法
|
||
- 理解优惠券抵扣、余额抵扣、积分抵扣、哈尼券抵扣逻辑
|
||
- 理解商品扩展配置对支付方式的影响
|
||
- _Requirements: 1.1-1.6_
|
||
- [x] 2.2 实现OrderService - 一番赏订单金额计算
|
||
- 实现CalculateOrderMoneyAsync方法
|
||
- 实现优惠券验证和抵扣逻辑
|
||
- 实现余额、积分、哈尼券抵扣逻辑
|
||
- 实现购买限制验证
|
||
- _Requirements: 1.1-1.6_
|
||
- [ ]* 2.3 编写订单金额计算属性测试
|
||
- **Property 1: 订单金额计算正确性**
|
||
- **Validates: Requirements 1.1, 1.2, 1.3, 1.4, 1.5**
|
||
|
||
- [x] 3. 一番赏订单创建服务实现
|
||
- [x] 3.1 查看PHP代码了解一番赏订单创建业务逻辑
|
||
- 阅读server/php/app/api/controller/Order.php中的orderbuy方法
|
||
- 理解订单创建、库存扣减、资产扣减、微信支付调用逻辑
|
||
- _Requirements: 2.1-2.6_
|
||
- [x] 3.2 实现OrderService - 一番赏订单创建
|
||
- 实现CreateOrderAsync方法
|
||
- 实现库存验证和扣减逻辑
|
||
- 实现用户资产扣减逻辑
|
||
- 实现订单记录创建
|
||
- 实现微信支付参数生成（调用现有WechatService）
|
||
- _Requirements: 2.1-2.6_
|
||
- [ ]* 3.3 编写订单创建属性测试
|
||
- **Property 2: 订单创建数据完整性**
|
||
- **Validates: Requirements 2.1, 2.2**
|
||
|
||
- [x] 4. 无限赏订单服务实现
|
||
- [x] 4.1 查看PHP代码了解无限赏订单业务逻辑
|
||
- 阅读server/php/app/api/controller/Order.php中的infinite_ordermoney、infinite_orderbuy方法
|
||
- 理解无限赏特有的业务逻辑
|
||
- _Requirements: 3.1-3.3, 4.1-4.3_
|
||
- [x] 4.2 实现OrderService - 无限赏订单金额计算
|
||
- 实现CalculateInfiniteOrderMoneyAsync方法
|
||
- _Requirements: 3.1-3.3_
|
||
- [x] 4.3 实现OrderService - 无限赏订单创建
|
||
- 实现CreateInfiniteOrderAsync方法
|
||
- _Requirements: 4.1-4.3_
|
||
|
||
- [x] 5. 商城订单金额计算服务实现
|
||
- [x] 5.1 查看PHP代码了解商城订单业务逻辑
|
||
- 阅读server/php/app/api/controller/Order.php中的mall_ordermoney方法
|
||
- 理解商城订单特有的业务逻辑
|
||
- _Requirements: 5.1-5.3_
|
||
- [x] 5.2 实现OrderService - 商城订单金额计算
|
||
- 实现CalculateMallOrderMoneyAsync方法
|
||
- _Requirements: 5.1-5.3_
|
||
|
||
- [x] 6. Checkpoint - 订单计算和创建服务测试验证
|
||
- 确保订单金额计算、订单创建服务测试通过
|
||
- 如有问题请询问用户
|
||
|
||
- [x] 7. 订单查询服务实现
|
||
- [x] 7.1 查看PHP代码了解订单查询业务逻辑
|
||
- 阅读server/php/app/api/controller/Order.php中的order_list、order_detail方法
|
||
- 理解订单列表查询、订单详情查询逻辑
|
||
- _Requirements: 6.1-6.4, 7.1-7.3_
|
||
- [x] 7.2 实现OrderService - 订单列表查询
|
||
- 实现GetOrderListAsync方法
|
||
- 实现分页逻辑
|
||
- _Requirements: 6.1-6.4_
|
||
- [x] 7.3 实现OrderService - 订单详情查询
|
||
- 实现GetOrderDetailAsync方法
|
||
- 实现订单权限验证
|
||
- _Requirements: 7.1-7.3_
|
||
- [ ]* 7.4 编写订单列表属性测试
|
||
- **Property 5: 订单列表分页正确性**
|
||
- **Validates: Requirements 6.1, 6.3, 6.4**
|
||
|
||
- [x] 8. 抽奖结果查询服务实现
|
||
- [x] 8.1 查看PHP代码了解抽奖结果查询业务逻辑
|
||
- 阅读server/php/app/api/controller/Order.php中的prizeorderlog、infinite_prizeorderlog方法
|
||
- 理解抽奖结果查询逻辑
|
||
- _Requirements: 8.1-8.3, 9.1-9.2_
|
||
- [x] 8.2 实现OrderService - 一番赏抽奖结果查询
|
||
- 实现GetPrizeOrderLogAsync方法
|
||
- _Requirements: 8.1-8.3_
|
||
- [x] 8.3 实现OrderService - 无限赏抽奖结果查询
|
||
- 实现GetInfinitePrizeOrderLogAsync方法
|
||
- _Requirements: 9.1-9.2_
|
||
|
||
- [x] 9. Checkpoint - 订单查询服务测试验证
|
||
- 确保订单列表、订单详情、抽奖结果查询服务测试通过
|
||
- 如有问题请询问用户
|
||
|
||
- [x] 10. 仓库首页服务实现
|
||
- [x] 10.1 查看PHP代码了解仓库首页业务逻辑
|
||
- 阅读server/php/app/api/controller/Warehouse.php中的warehouse_index方法
|
||
- 理解仓库物品查询、状态筛选逻辑
|
||
- _Requirements: 10.1-10.3_
|
||
- [x] 10.2 实现WarehouseService - 仓库首页查询
|
||
- 实现GetWarehouseIndexAsync方法
|
||
- 实现状态筛选逻辑
|
||
- 实现分页逻辑
|
||
- _Requirements: 10.1-10.3_
|
||
|
||
- [x] 11. 奖品回收服务实现
|
||
- [x] 11.1 查看PHP代码了解奖品回收业务逻辑
|
||
- 阅读server/php/app/api/controller/Warehouse.php中的warehouse_recovery方法
|
||
- 理解回收金额计算、余额增加、状态更新逻辑
|
||
- _Requirements: 11.1-11.5_
|
||
- [x] 11.2 实现WarehouseService - 奖品回收
|
||
- 实现RecoveryPrizesAsync方法
|
||
- 实现回收金额计算
|
||
- 实现用户余额增加
|
||
- 实现奖品状态更新
|
||
- _Requirements: 11.1-11.5_
|
||
- [ ]* 11.3 编写奖品回收属性测试
|
||
- **Property 3: 仓库物品状态一致性**
|
||
- **Validates: Requirements 11.2, 11.3**
|
||
|
||
- [x] 12. 奖品发货服务实现
|
||
- [x] 12.1 查看PHP代码了解奖品发货业务逻辑
|
||
- 阅读server/php/app/api/controller/Warehouse.php中的warehouse_send、warehouse_send_confirm方法
|
||
- 理解发货申请、确认发货逻辑
|
||
- _Requirements: 12.1-12.5, 13.1-13.2_
|
||
- [x] 12.2 实现WarehouseService - 奖品发货申请
|
||
- 实现SendPrizesAsync方法
|
||
- 实现地址信息验证
|
||
- 实现发货记录创建
|
||
- 实现奖品状态更新
|
||
- _Requirements: 12.1-12.5_
|
||
- [x] 12.3 实现WarehouseService - 确认发货
|
||
- 实现ConfirmSendAsync方法
|
||
- _Requirements: 13.1-13.2_
|
||
- [ ]* 12.4 编写发货服务属性测试
|
||
- **Property 4: 发货记录完整性**
|
||
- **Validates: Requirements 12.1, 12.2, 12.3, 12.4**
|
||
|
||
- [x] 13. 发货和回收记录查询服务实现
|
||
- [x] 13.1 查看PHP代码了解记录查询业务逻辑
|
||
- 阅读server/php/app/api/controller/Warehouse.php中的warehouse_send_record、warehouse_send_record_detail、warehouse_recovery_record方法
|
||
- 理解记录查询逻辑
|
||
- _Requirements: 14.1-14.3, 15.1-15.3, 16.1-16.2_
|
||
- [x] 13.2 实现WarehouseService - 发货记录查询
|
||
- 实现GetSendRecordsAsync方法
|
||
- _Requirements: 14.1-14.3_
|
||
- [x] 13.3 实现WarehouseService - 发货记录详情
|
||
- 实现GetSendRecordDetailAsync方法
|
||
- _Requirements: 15.1-15.3_
|
||
- [x] 13.4 实现WarehouseService - 回收记录查询
|
||
- 实现GetRecoveryRecordsAsync方法
|
||
- _Requirements: 16.1-16.2_
|
||
|
||
- [x] 14. 物流信息查询服务实现
|
||
- [x] 14.1 查看PHP代码了解物流查询业务逻辑
|
||
- 阅读server/php/app/api/controller/Warehouse.php中的warehouse_order_logistics方法
|
||
- 理解物流信息查询逻辑
|
||
- _Requirements: 17.1-17.3_
|
||
- [x] 14.2 实现WarehouseService - 物流信息查询
|
||
- 实现GetLogisticsAsync方法
|
||
- _Requirements: 17.1-17.3_
|
||
|
||
- [x] 15. Checkpoint - 仓库服务测试验证
|
||
- 确保所有仓库服务测试通过
|
||
- 如有问题请询问用户
|
||
|
||
- [x] 16. 控制器实现 - OrderController
|
||
- [x] 16.1 实现一番赏订单金额计算接口 POST /ordermoney
|
||
- 调用OrderService.CalculateOrderMoneyAsync
|
||
- 更新API接口文档标记迁移状态
|
||
- _Requirements: 1.1-1.6_
|
||
- [x] 16.2 实现一番赏订单创建接口 POST /orderbuy
|
||
- 调用OrderService.CreateOrderAsync
|
||
- 更新API接口文档标记迁移状态
|
||
- _Requirements: 2.1-2.6_
|
||
- [x] 16.3 实现无限赏订单金额计算接口 POST /infinite_ordermoney
|
||
- 调用OrderService.CalculateInfiniteOrderMoneyAsync
|
||
- 更新API接口文档标记迁移状态
|
||
- _Requirements: 3.1-3.3_
|
||
- [x] 16.4 实现无限赏订单创建接口 POST /infinite_orderbuy
|
||
- 调用OrderService.CreateInfiniteOrderAsync
|
||
- 更新API接口文档标记迁移状态
|
||
- _Requirements: 4.1-4.3_
|
||
- [x] 16.5 实现商城订单金额计算接口 POST /mall_ordermoney
|
||
- 调用OrderService.CalculateMallOrderMoneyAsync
|
||
- 更新API接口文档标记迁移状态
|
||
- _Requirements: 5.1-5.3_
|
||
- [x] 16.6 实现订单列表接口 POST /order_list
|
||
- 调用OrderService.GetOrderListAsync
|
||
- 更新API接口文档标记迁移状态
|
||
- _Requirements: 6.1-6.4_
|
||
- [x] 16.7 实现订单详情接口 POST /order_detail
|
||
- 调用OrderService.GetOrderDetailAsync
|
||
- 更新API接口文档标记迁移状态
|
||
- _Requirements: 7.1-7.3_
|
||
- [x] 16.8 实现一番赏抽奖结果接口 POST /prizeorderlog
|
||
- 调用OrderService.GetPrizeOrderLogAsync
|
||
- 更新API接口文档标记迁移状态
|
||
- _Requirements: 8.1-8.3_
|
||
- [x] 16.9 实现无限赏抽奖结果接口 POST /infinite_prizeorderlog
|
||
- 调用OrderService.GetInfinitePrizeOrderLogAsync
|
||
- 更新API接口文档标记迁移状态
|
||
- _Requirements: 9.1-9.2_
|
||
|
||
- [x] 17. 控制器实现 - WarehouseController
|
||
- [x] 17.1 实现仓库首页接口 POST /warehouse_index
|
||
- 调用WarehouseService.GetWarehouseIndexAsync
|
||
- 更新API接口文档标记迁移状态
|
||
- _Requirements: 10.1-10.3_
|
||
- [x] 17.2 实现奖品回收接口 POST /warehouse_recovery
|
||
- 调用WarehouseService.RecoveryPrizesAsync
|
||
- 更新API接口文档标记迁移状态
|
||
- _Requirements: 11.1-11.5_
|
||
- [x] 17.3 实现奖品发货接口 POST /warehouse_send
|
||
- 调用WarehouseService.SendPrizesAsync
|
||
- 更新API接口文档标记迁移状态
|
||
- _Requirements: 12.1-12.5_
|
||
- [x] 17.4 实现确认发货接口 POST /warehouse_send_confirm
|
||
- 调用WarehouseService.ConfirmSendAsync
|
||
- 更新API接口文档标记迁移状态
|
||
- _Requirements: 13.1-13.2_
|
||
- [x] 17.5 实现发货记录接口 POST /warehouse_send_record
|
||
- 调用WarehouseService.GetSendRecordsAsync
|
||
- 更新API接口文档标记迁移状态
|
||
- _Requirements: 14.1-14.3_
|
||
- [x] 17.6 实现发货记录详情接口 POST /warehouse_send_record_detail
|
||
- 调用WarehouseService.GetSendRecordDetailAsync
|
||
- 更新API接口文档标记迁移状态
|
||
- _Requirements: 15.1-15.3_
|
||
- [x] 17.7 实现回收记录接口 POST /warehouse_recovery_record
|
||
- 调用WarehouseService.GetRecoveryRecordsAsync
|
||
- 更新API接口文档标记迁移状态
|
||
- _Requirements: 16.1-16.2_
|
||
- [x] 17.8 实现物流信息接口 POST /warehouse_order_logistics
|
||
- 调用WarehouseService.GetLogisticsAsync
|
||
- 更新API接口文档标记迁移状态
|
||
- _Requirements: 17.1-17.3_
|
||
|
||
- [x] 18. Checkpoint - 控制器测试验证
|
||
- 确保所有控制器接口可正常访问
|
||
- 使用Postman或HTTP文件测试各接口
|
||
- 如有问题请询问用户
|
||
|
||
- [x] 19. API响应格式验证
|
||
- [x] 19.1 验证所有接口响应格式
|
||
- 确保status、msg、data结构一致
|
||
- 确保字段命名与PHP API一致（snake_case）
|
||
- _Requirements: 18.1-18.4_
|
||
- [ ]* 19.2 编写API格式属性测试
|
||
- **Property 6: API响应格式一致性**
|
||
- **Validates: Requirements 18.1-18.4**
|
||
|
||
- [x] 20. 集成测试
|
||
- [x] 20.1 编写订单金额计算集成测试
|
||
- 测试完整的订单金额计算流程
|
||
- 测试各种抵扣组合
|
||
- _Requirements: 1.1-1.6_
|
||
- [x] 20.2 编写订单创建集成测试
|
||
- 测试订单创建流程
|
||
- 测试库存扣减
|
||
- Note: 部分测试因InMemory数据库不支持事务而被跳过
|
||
- _Requirements: 2.1-2.6_
|
||
- [x] 20.3 编写仓库功能集成测试
|
||
- 测试奖品回收流程
|
||
- 测试奖品发货流程
|
||
- Note: 部分测试因InMemory数据库不支持事务和ExecuteUpdate而被跳过
|
||
- _Requirements: 10.1-17.3_
|
||
|
||
- [x] 21. 文档更新和最终验证
|
||
- [x] 21.1 更新API接口文档
|
||
- 确认所有迁移接口都已标记
|
||
- 记录新接口地址
|
||
- _Requirements: 18.1-18.4_
|
||
- [x] 21.2 创建HTTP测试文件
|
||
- 在HoneyBox.Api目录下创建order-system.http测试文件
|
||
- 包含所有订单系统相关接口的测试请求
|
||
|
||
- [ ] 22. Final Checkpoint - 完整功能验证
|
||
- 确保所有测试通过
|
||
- 确保API文档已更新
|
||
- 确保与前端兼容性
|
||
- 如有问题请询问用户
|
||
|
||
## Notes
|
||
|
||
- Tasks marked with `*` are optional and can be skipped for faster MVP
|
||
- Each task references specific requirements for traceability
|
||
- Checkpoints ensure incremental validation
|
||
- Property tests validate universal correctness properties
|
||
- Unit tests validate specific examples and edge cases
|
||
- 每迁移完成一个接口，都需要在docs/API接口文档.md中标记迁移状态和新接口地址
|
||
- 迁移前必须先查看PHP代码了解详细业务逻辑，确保功能一致性
|
||
- 订单系统涉及支付，需要特别注意数据一致性和事务处理
|
||
- 仓库系统涉及用户资产变更，需要确保金额计算准确
|
||
|
||
## 接口迁移清单
|
||
|
||
| 序号 | PHP接口 | 新接口地址 | 状态 |
|
||
|------|---------|-----------|------|
|
||
| 1 | POST /ordermoney | POST /api/ordermoney | ✅ |
|
||
| 2 | POST /orderbuy | POST /api/orderbuy | ✅ |
|
||
| 3 | POST /infinite_ordermoney | POST /api/infinite_ordermoney | ✅ |
|
||
| 4 | POST /infinite_orderbuy | POST /api/infinite_orderbuy | ✅ |
|
||
| 5 | POST /mall_ordermoney | POST /api/mall_ordermoney | ✅ |
|
||
| 6 | POST /order_list | POST /api/order_list | ✅ |
|
||
| 7 | POST /order_detail | POST /api/order_detail | ✅ |
|
||
| 8 | POST /prizeorderlog | POST /api/prizeorderlog | ✅ |
|
||
| 9 | POST /infinite_prizeorderlog | POST /api/infinite_prizeorderlog | ✅ |
|
||
| 10 | POST /warehouse_index | POST /api/warehouse_index | ✅ |
|
||
| 11 | POST /warehouse_recovery | POST /api/warehouse_recovery | ✅ |
|
||
| 12 | POST /warehouse_send | POST /api/warehouse_send | ✅ |
|
||
| 13 | POST /warehouse_send_confirm | POST /api/warehouse_send_confirm | ✅ |
|
||
| 14 | POST /warehouse_send_record | POST /api/warehouse_send_record | ✅ |
|
||
| 15 | POST /warehouse_send_record_detail | POST /api/warehouse_send_record_detail | ✅ |
|
||
| 16 | POST /warehouse_recovery_record | POST /api/warehouse_recovery_record | ✅ |
|
||
| 17 | POST /warehouse_order_logistics | POST /api/warehouse_order_logistics | ✅ |
|