HaniBlindBox/.kiro/specs/miniprogram-api-migration/tasks.md
2026-01-03 14:47:28 +08:00

7.3 KiB
Raw Blame History

Implementation Plan: 小程序 API 迁移

Overview

本实施计划将 honey_box 小程序的 API 请求从旧的 PHP 后端迁移到新的 .NET 8 后端。采用最小改动原则,主要更新环境配置和需要变更的 API 路径。

Tasks

  • 1. 更新环境配置文件

    • 1.1 更新 env.js 中的测试环境配置
      • 确认测试环境 API 地址为 http://localhost:5238
      • 确认图片资源地址配置正确
      • Requirements: 1.1, 1.2
    • 1.2 更新 env.js 中的生产环境配置
      • 配置生产环境 API 地址
      • 保留旧配置作为备份便于回滚
      • Requirements: 1.3, 1.4
  • 2. 更新首页商品列表 API 路径

    • 2.1 更新 pages/shouye/index.vue 中的商品列表接口
      • goods 路径更新为 goods_list
      • 验证请求参数和响应格式兼容
      • Requirements: 2.1, 5.1
  • 3. 更新一番赏详情页 API 路径

    • 3.1 更新 pages/shouye/detail.vue 中的商品详情接口
      • goodsdetail 路径更新为 goods_detail
      • Requirements: 2.2, 5.2
    • 3.2 更新 pages/shouye/detail.vue 中的中奖记录接口
      • shang_log 路径更新为 goods_prize_logs
      • Requirements: 2.3, 6.3
  • 4. Checkpoint - 验证核心功能

    • 在测试环境验证首页商品列表加载
    • 验证一番赏详情页功能
    • 验证中奖记录显示
    • 确保所有测试通过,如有问题请询问用户
  • 5. 更新无限赏相关 API 路径

    • 5.1 检查 pages/shouye/detail_wuxian.vue 中的接口
      • 验证 infinite_goodsdetail 接口兼容性
      • 验证 infinite_shang_log 接口兼容性
      • Requirements: 5.3, 6.4
    • 5.2 检查 pages/other/prize_draw.vue 中的接口
      • 验证 infinite_prizerecords 接口兼容性
      • Requirements: 6.5
  • 6. 更新连击赏和擂台赏 API 路径

    • 6.1 检查 package/index/lian-ji.vue 中的接口
      • 验证 infinite_goodsdetail2 接口兼容性
      • Requirements: 5.4
    • 6.2 检查 package/index/leitai.vue 中的接口
      • 验证相关接口兼容性
      • Requirements: 5.5
  • 7. 验证用户认证接口

    • 7.1 检查 pages/user/login.vue 中的登录接口
      • 验证 login 微信登录接口
      • 验证 mobileLogin 手机号登录接口
      • 验证 v2/account/sendSms 验证码接口
      • Requirements: 4.1, 4.2, 4.3
    • 7.2 检查 pages/user/index.vue 中的用户接口
      • 验证 user 获取用户信息接口
      • Requirements: 4.4
    • 7.3 检查 pages/user/change.vue 中的更新接口
      • 验证 update_userinfo 更新用户信息接口
      • Requirements: 4.5
  • 8. Checkpoint - 验证用户功能

    • 验证微信登录流程
    • 验证手机号登录流程
    • 验证用户信息获取和更新
    • 确保所有测试通过,如有问题请询问用户
  • 9. 验证订单相关接口

    • 9.1 检查订单金额计算接口
      • 验证 ordermoney 一番赏订单金额
      • 验证 infinite_ordermoney 无限赏订单金额
      • 验证 mall_ordermoney 商城订单金额
      • Requirements: 5.5, 5.6, 5.7
    • 9.2 检查订单创建接口
      • 验证 orderbuy 一番赏订单创建
      • 验证 infinite_orderbuy 无限赏订单创建
      • Requirements: 5.8, 5.9
    • 9.3 检查订单列表和详情接口
      • 验证 order_list 订单列表
      • 验证 order_detail 订单详情
      • Requirements: 5.10, 5.11
  • 10. 验证抽奖结果接口

    • 10.1 检查抽奖结果接口
      • 验证 prizeorderlog 一番赏抽奖结果
      • 验证 infinite_prizeorderlog 无限赏抽奖结果
      • Requirements: 6.1, 6.2
    • 10.2 检查道具卡接口
      • 验证 item_card_chou 道具卡抽奖
      • 验证 item_card_list 道具卡列表
      • Requirements: 6.6, 13.10
  • 11. 验证仓库和发货接口

    • 11.1 检查仓库接口
      • 验证 warehouse_index 仓库列表
      • 验证 warehouse_recovery 回收奖品
      • 验证 warehouse_send 申请发货
      • Requirements: 7.1, 7.2, 7.3
    • 11.2 检查发货记录接口
      • 验证 warehouse_send_record 发货记录
      • 验证 warehouse_send_record_detail 发货详情
      • 验证 warehouse_order_logistics 物流信息
      • Requirements: 7.5, 7.6, 7.8
  • 12. Checkpoint - 验证订单和仓库功能

    • 验证订单创建和支付流程
    • 验证抽奖结果显示
    • 验证仓库管理功能
    • 确保所有测试通过,如有问题请询问用户
  • 13. 验证收货地址接口

    • 13.1 检查 common/server/userAddress.js 中的接口
      • 验证 addAddress 添加地址
      • 验证 updateAddress 更新地址
      • 验证 getAddressList 地址列表
      • 验证 getDefaultAddress 默认地址
      • 验证 deleteAddress 删除地址
      • Requirements: 8.1, 8.2, 8.3, 8.4, 8.6
  • 14. 验证财务和优惠券接口

    • 14.1 检查财务接口
      • 验证 profitMoney 资金明细
      • 验证 profitIntegral 积分明细
      • 验证 profitPay 支付明细
      • Requirements: 9.1, 9.2, 9.3
    • 14.2 检查优惠券接口
      • 验证 coupon_list 优惠券列表
      • 验证 coupon_detail 优惠券详情
      • 验证 coupon_ling 领取优惠券
      • 验证 coupon_share 分享优惠券
      • 验证 coupon_synthesis 合成优惠券
      • Requirements: 9.4, 9.5, 9.6, 9.7, 9.8
  • 15. 验证福利和签到接口

    • 15.1 检查福利屋接口
      • 验证 welfare_house_listfuliwu 福利列表
      • 验证 fuliwu_detail 福利详情
      • 验证 fuliwu_participants 参与者列表
      • Requirements: 10.1, 10.2, 10.3
    • 15.2 检查签到接口
      • 验证 sign_infosign 签到信息
      • 验证签到功能
      • Requirements: 10.7, 10.8
  • 16. 验证任务和权益接口

    • 16.1 检查任务接口
      • 验证 task_list 任务列表
      • 验证 ling_task 领取任务奖励
      • Requirements: 11.1, 11.2
    • 16.2 检查权益接口
      • 验证 quan_yi 权益信息
      • 验证 quan_yi_ling 领取权益
      • Requirements: 11.3, 11.4
  • 17. 验证钻石商城接口

    • 17.1 检查 common/server/mall.js 中的接口
      • 验证 get_diamond_list 钻石商品列表
      • 验证 createOrderProducts 创建钻石订单
      • 验证 get_diamond_order_log 钻石订单状态
      • Requirements: 12.1, 12.2, 12.3
  • 18. 验证其他功能接口

    • 18.1 检查配置接口
      • 验证 config 全局配置
      • 验证 getPlatformConfig 平台配置
      • Requirements: 13.1, 13.2
    • 18.2 检查其他接口
      • 验证 danyegetDanye 单页内容
      • 验证 getFloatBall 悬浮球
      • 验证 addCollectlistCollect 收藏功能
      • 验证 withdrawwithdraw_log 提现功能
      • Requirements: 13.4, 13.5, 13.6, 13.7, 13.8, 13.9
  • 19. Final Checkpoint - 全面功能验证

    • 在测试环境完成所有核心功能的验证
    • 记录发现的任何问题
    • 确认回滚机制可用
    • 确保所有测试通过,如有问题请询问用户

Notes

  • 任务按照功能模块划分,便于逐步验证
  • 每个 Checkpoint 是验证点,确保前面的功能正常后再继续
  • 大部分 API 路径新后端已兼容,主要是验证工作
  • 仅有少数几个路径需要更新goods、goodsdetail、shang_log 等)
  • 保留旧配置便于快速回滚