outsource/HaniBlindBox
3
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
71cd3b514b
HaniBlindBox/.kiro/specs/order-system-migration/tasks.md
zpc b89723b88c 阶段5-订单系统
2026-01-02 22:30:21 +08:00

15 KiB
Raw Blame History

Implementation Plan: 订单系统迁移

Overview

本任务列表将PHP订单系统迁移到.NET 8，按照接口优先级逐个迁移。每迁移一个接口前，需要先查看PHP代码了解详细业务逻辑；迁移完成后，需要在API接口文档.md中标记迁移状态。

Tasks

  • 1. 基础设施准备

    • 1.1 创建订单相关的DTO和Request/Response模型
      • 在HoneyBox.Model/Models/Order目录下创建相关模型
      • 包括OrderMoneyRequest、OrderBuyRequest、OrderListDto、OrderDetailDto等
      • 包括WarehouseIndexRequest、WarehouseItemDto、SendRequest、RecoveryResultDto等
      • Requirements: 1.1-18.4
    • 1.2 创建服务接口定义
      • 在HoneyBox.Core/Interfaces目录下创建IOrderService、IWarehouseService接口
      • Requirements: 1.1-18.4
    • 1.3 创建数据库实体模型（如果尚未存在）
      • 确认Order、OrderList、Delivery、Recovery等实体存在
      • 配置EF Core映射
      • Requirements: 1.1-18.4
    • 1.4 注册服务到DI容器
      • 在ServiceModule.cs中注册OrderService、WarehouseService
      • Requirements: 1.1-18.4

  • 2. 一番赏订单金额计算服务实现

    • 2.1 查看PHP代码了解一番赏订单金额计算业务逻辑
      • 阅读server/php/app/api/controller/Order.php中的ordermoney方法
      • 理解优惠券抵扣、余额抵扣、积分抵扣、哈尼券抵扣逻辑
      • 理解商品扩展配置对支付方式的影响
      • Requirements: 1.1-1.6
    • 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

  • 3. 一番赏订单创建服务实现

    • 3.1 查看PHP代码了解一番赏订单创建业务逻辑
      • 阅读server/php/app/api/controller/Order.php中的orderbuy方法
      • 理解订单创建、库存扣减、资产扣减、微信支付调用逻辑
      • Requirements: 2.1-2.6
    • 3.2 实现OrderService - 一番赏订单创建
      • 实现CreateOrderAsync方法
      • 实现库存验证和扣减逻辑
      • 实现用户资产扣减逻辑
      • 实现订单记录创建
      • 实现微信支付参数生成（调用现有WechatService）
      • Requirements: 2.1-2.6
    • * 3.3 编写订单创建属性测试
      • Property 2: 订单创建数据完整性
      • Validates: Requirements 2.1, 2.2

  • 4. 无限赏订单服务实现

    • 4.1 查看PHP代码了解无限赏订单业务逻辑
      • 阅读server/php/app/api/controller/Order.php中的infinite_ordermoney、infinite_orderbuy方法
      • 理解无限赏特有的业务逻辑
      • Requirements: 3.1-3.3, 4.1-4.3
    • 4.2 实现OrderService - 无限赏订单金额计算
      • 实现CalculateInfiniteOrderMoneyAsync方法
      • Requirements: 3.1-3.3
    • 4.3 实现OrderService - 无限赏订单创建
      • 实现CreateInfiniteOrderAsync方法
      • Requirements: 4.1-4.3

  • 5. 商城订单金额计算服务实现

    • 5.1 查看PHP代码了解商城订单业务逻辑
      • 阅读server/php/app/api/controller/Order.php中的mall_ordermoney方法
      • 理解商城订单特有的业务逻辑
      • Requirements: 5.1-5.3
    • 5.2 实现OrderService - 商城订单金额计算
      • 实现CalculateMallOrderMoneyAsync方法
      • Requirements: 5.1-5.3

  • 6. Checkpoint - 订单计算和创建服务测试验证

    • 确保订单金额计算、订单创建服务测试通过
    • 如有问题请询问用户

  • 7. 订单查询服务实现

    • 7.1 查看PHP代码了解订单查询业务逻辑
      • 阅读server/php/app/api/controller/Order.php中的order_list、order_detail方法
      • 理解订单列表查询、订单详情查询逻辑
      • Requirements: 6.1-6.4, 7.1-7.3
    • 7.2 实现OrderService - 订单列表查询
      • 实现GetOrderListAsync方法
      • 实现分页逻辑
      • Requirements: 6.1-6.4
    • 7.3 实现OrderService - 订单详情查询
      • 实现GetOrderDetailAsync方法
      • 实现订单权限验证
      • Requirements: 7.1-7.3
    • * 7.4 编写订单列表属性测试
      • Property 5: 订单列表分页正确性
      • Validates: Requirements 6.1, 6.3, 6.4

  • 8. 抽奖结果查询服务实现

    • 8.1 查看PHP代码了解抽奖结果查询业务逻辑
      • 阅读server/php/app/api/controller/Order.php中的prizeorderlog、infinite_prizeorderlog方法
      • 理解抽奖结果查询逻辑
      • Requirements: 8.1-8.3, 9.1-9.2
    • 8.2 实现OrderService - 一番赏抽奖结果查询
      • 实现GetPrizeOrderLogAsync方法
      • Requirements: 8.1-8.3
    • 8.3 实现OrderService - 无限赏抽奖结果查询
      • 实现GetInfinitePrizeOrderLogAsync方法
      • Requirements: 9.1-9.2

  • 9. Checkpoint - 订单查询服务测试验证

    • 确保订单列表、订单详情、抽奖结果查询服务测试通过
    • 如有问题请询问用户

  • 10. 仓库首页服务实现

    • 10.1 查看PHP代码了解仓库首页业务逻辑
      • 阅读server/php/app/api/controller/Warehouse.php中的warehouse_index方法
      • 理解仓库物品查询、状态筛选逻辑
      • Requirements: 10.1-10.3
    • 10.2 实现WarehouseService - 仓库首页查询
      • 实现GetWarehouseIndexAsync方法
      • 实现状态筛选逻辑
      • 实现分页逻辑
      • Requirements: 10.1-10.3

  • 11. 奖品回收服务实现

    • 11.1 查看PHP代码了解奖品回收业务逻辑
      • 阅读server/php/app/api/controller/Warehouse.php中的warehouse_recovery方法
      • 理解回收金额计算、余额增加、状态更新逻辑
      • Requirements: 11.1-11.5
    • 11.2 实现WarehouseService - 奖品回收
      • 实现RecoveryPrizesAsync方法
      • 实现回收金额计算
      • 实现用户余额增加
      • 实现奖品状态更新
      • Requirements: 11.1-11.5
    • * 11.3 编写奖品回收属性测试
      • Property 3: 仓库物品状态一致性
      • Validates: Requirements 11.2, 11.3

  • 12. 奖品发货服务实现

    • 12.1 查看PHP代码了解奖品发货业务逻辑
      • 阅读server/php/app/api/controller/Warehouse.php中的warehouse_send、warehouse_send_confirm方法
      • 理解发货申请、确认发货逻辑
      • Requirements: 12.1-12.5, 13.1-13.2
    • 12.2 实现WarehouseService - 奖品发货申请
      • 实现SendPrizesAsync方法
      • 实现地址信息验证
      • 实现发货记录创建
      • 实现奖品状态更新
      • Requirements: 12.1-12.5
    • 12.3 实现WarehouseService - 确认发货
      • 实现ConfirmSendAsync方法
      • Requirements: 13.1-13.2
    • * 12.4 编写发货服务属性测试
      • Property 4: 发货记录完整性
      • Validates: Requirements 12.1, 12.2, 12.3, 12.4

  • 13. 发货和回收记录查询服务实现

    • 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
    • 13.2 实现WarehouseService - 发货记录查询
      • 实现GetSendRecordsAsync方法
      • Requirements: 14.1-14.3
    • 13.3 实现WarehouseService - 发货记录详情
      • 实现GetSendRecordDetailAsync方法
      • Requirements: 15.1-15.3
    • 13.4 实现WarehouseService - 回收记录查询
      • 实现GetRecoveryRecordsAsync方法
      • Requirements: 16.1-16.2

  • 14. 物流信息查询服务实现

    • 14.1 查看PHP代码了解物流查询业务逻辑
      • 阅读server/php/app/api/controller/Warehouse.php中的warehouse_order_logistics方法
      • 理解物流信息查询逻辑
      • Requirements: 17.1-17.3
    • 14.2 实现WarehouseService - 物流信息查询
      • 实现GetLogisticsAsync方法
      • Requirements: 17.1-17.3

  • 15. Checkpoint - 仓库服务测试验证

    • 确保所有仓库服务测试通过
    • 如有问题请询问用户

  • 16. 控制器实现 - OrderController

    • 16.1 实现一番赏订单金额计算接口 POST /ordermoney
      • 调用OrderService.CalculateOrderMoneyAsync
      • 更新API接口文档标记迁移状态
      • Requirements: 1.1-1.6
    • 16.2 实现一番赏订单创建接口 POST /orderbuy
      • 调用OrderService.CreateOrderAsync
      • 更新API接口文档标记迁移状态
      • Requirements: 2.1-2.6
    • 16.3 实现无限赏订单金额计算接口 POST /infinite_ordermoney
      • 调用OrderService.CalculateInfiniteOrderMoneyAsync
      • 更新API接口文档标记迁移状态
      • Requirements: 3.1-3.3
    • 16.4 实现无限赏订单创建接口 POST /infinite_orderbuy
      • 调用OrderService.CreateInfiniteOrderAsync
      • 更新API接口文档标记迁移状态
      • Requirements: 4.1-4.3
    • 16.5 实现商城订单金额计算接口 POST /mall_ordermoney
      • 调用OrderService.CalculateMallOrderMoneyAsync
      • 更新API接口文档标记迁移状态
      • Requirements: 5.1-5.3
    • 16.6 实现订单列表接口 POST /order_list
      • 调用OrderService.GetOrderListAsync
      • 更新API接口文档标记迁移状态
      • Requirements: 6.1-6.4
    • 16.7 实现订单详情接口 POST /order_detail
      • 调用OrderService.GetOrderDetailAsync
      • 更新API接口文档标记迁移状态
      • Requirements: 7.1-7.3
    • 16.8 实现一番赏抽奖结果接口 POST /prizeorderlog
      • 调用OrderService.GetPrizeOrderLogAsync
      • 更新API接口文档标记迁移状态
      • Requirements: 8.1-8.3
    • 16.9 实现无限赏抽奖结果接口 POST /infinite_prizeorderlog
      • 调用OrderService.GetInfinitePrizeOrderLogAsync
      • 更新API接口文档标记迁移状态
      • Requirements: 9.1-9.2

  • 17. 控制器实现 - WarehouseController

    • 17.1 实现仓库首页接口 POST /warehouse_index
      • 调用WarehouseService.GetWarehouseIndexAsync
      • 更新API接口文档标记迁移状态
      • Requirements: 10.1-10.3
    • 17.2 实现奖品回收接口 POST /warehouse_recovery
      • 调用WarehouseService.RecoveryPrizesAsync
      • 更新API接口文档标记迁移状态
      • Requirements: 11.1-11.5
    • 17.3 实现奖品发货接口 POST /warehouse_send
      • 调用WarehouseService.SendPrizesAsync
      • 更新API接口文档标记迁移状态
      • Requirements: 12.1-12.5
    • 17.4 实现确认发货接口 POST /warehouse_send_confirm
      • 调用WarehouseService.ConfirmSendAsync
      • 更新API接口文档标记迁移状态
      • Requirements: 13.1-13.2
    • 17.5 实现发货记录接口 POST /warehouse_send_record
      • 调用WarehouseService.GetSendRecordsAsync
      • 更新API接口文档标记迁移状态
      • Requirements: 14.1-14.3
    • 17.6 实现发货记录详情接口 POST /warehouse_send_record_detail
      • 调用WarehouseService.GetSendRecordDetailAsync
      • 更新API接口文档标记迁移状态
      • Requirements: 15.1-15.3
    • 17.7 实现回收记录接口 POST /warehouse_recovery_record
      • 调用WarehouseService.GetRecoveryRecordsAsync
      • 更新API接口文档标记迁移状态
      • Requirements: 16.1-16.2
    • 17.8 实现物流信息接口 POST /warehouse_order_logistics
      • 调用WarehouseService.GetLogisticsAsync
      • 更新API接口文档标记迁移状态
      • Requirements: 17.1-17.3

  • 18. Checkpoint - 控制器测试验证

    • 确保所有控制器接口可正常访问
    • 使用Postman或HTTP文件测试各接口
    • 如有问题请询问用户

  • 19. API响应格式验证

    • 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

  • 20. 集成测试

    • 20.1 编写订单金额计算集成测试
      • 测试完整的订单金额计算流程
      • 测试各种抵扣组合
      • Requirements: 1.1-1.6
    • 20.2 编写订单创建集成测试
      • 测试订单创建流程
      • 测试库存扣减
      • Note: 部分测试因InMemory数据库不支持事务而被跳过
      • Requirements: 2.1-2.6
    • 20.3 编写仓库功能集成测试
      • 测试奖品回收流程
      • 测试奖品发货流程
      • Note: 部分测试因InMemory数据库不支持事务和ExecuteUpdate而被跳过
      • Requirements: 10.1-17.3

  • 21. 文档更新和最终验证

    • 21.1 更新API接口文档
      • 确认所有迁移接口都已标记
      • 记录新接口地址
      • Requirements: 18.1-18.4
    • 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 ✅