team/ycc-proxy-server
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
4d5013486c6b1bb45949884bafa734da79f01c0d
ycc-proxy-server/删除推广订单功能计划.md
liangzai 08ff223ff8 v1.0
2025-12-02 19:57:10 +08:00

8.2 KiB
Raw Blame History

删除推广订单功能计划

目标

删除后台以及后端中promotion（推广订单）相关功能，但保留推广数据分析和推广链接管理功能。

功能区分

✅ 需要保留的功能

  1. 推广链接管理

    • 创建推广链接
    • 更新推广链接
    • 删除推广链接
    • 获取推广链接列表
    • 获取推广链接详情
    • 记录链接点击

  2. 推广数据分析

    • 获取推广总统计
    • 获取推广历史记录

❌ 需要删除的功能

  1. 推广订单功能
    • AdminPromotionOrder 模型及相关代码
    • 订单管理中的 IsPromotion 字段
    • 订单创建/更新/删除中的推广订单逻辑
    • 前端订单管理中的推广订单字段

详细删除计划

阶段一：后端代码清理

1.1 删除推广订单模型文件

  • 删除 ycc-proxy-server/app/main/model/adminPromotionOrderModel.go
  • 删除 ycc-proxy-server/app/main/model/adminPromotionOrderModel_gen.go
  • 确认 ycc-proxy-server/deploy/script/gen_models.ps1 中 admin_promotion_order 已被注释（第57行，已确认已注释）

1.2 从 ServiceContext 中移除推广订单模型

  • 从 ycc-proxy-server/app/main/api/internal/svc/servicecontext.go 中删除：
    • AdminPromotionOrderModel 字段声明
    • AdminPromotionOrderModel 初始化代码

1.3 修改订单管理相关逻辑

文件：ycc-proxy-server/app/main/api/internal/logic/admin_order/admincreateorderlogic.go

  • 删除 IsPromotion 字段处理逻辑（第75-87行）
  • 删除 AdminPromotionOrderModel 的引用

文件：ycc-proxy-server/app/main/api/internal/logic/admin_order/adminupdateorderlogic.go

  • 删除推广订单状态处理逻辑（第79-101行）
  • 删除 AdminPromotionOrderModel 的引用

文件：ycc-proxy-server/app/main/api/internal/logic/admin_order/admindeleteorderlogic.go

  • 删除删除推广订单记录的逻辑（第44-51行）
  • 删除 AdminPromotionOrderModel 的引用

文件：ycc-proxy-server/app/main/api/internal/logic/admin_order/admingetorderlistlogic.go

  • 删除 IsPromotion 查询条件（第57-59行）
  • 删除判断是否为推广订单的逻辑（第277-280行）
  • 删除返回结果中的 IsPromotion 字段赋值

文件：ycc-proxy-server/app/main/api/internal/logic/admin_order/admingetorderdetaillogic.go

  • 删除判断是否为推广订单的逻辑（第43-47行）
  • 删除返回结果中的 IsPromotion 字段赋值（第121行）

1.4 修改 API 定义文件

文件：ycc-proxy-server/app/main/api/desc/admin/order.api

  • 从 AdminGetOrderListReq 中删除 IsPromotion 字段（第56行）
  • 从 AdminGetOrderListResp 的 OrderItem 中删除 IsPromotion 字段（第83行）
  • 从 AdminGetOrderDetailResp 中删除 IsPromotion 字段（第105行）
  • 从 AdminCreateOrderReq 中删除 IsPromotion 字段（第119行）
  • 从 AdminUpdateOrderReq 中删除 IsPromotion 字段（第137行）

1.5 修改 Types 定义

文件：ycc-proxy-server/app/main/api/internal/types/types.go

  • 从 AdminGetOrderListReq 中删除 IsPromotion 字段
  • 从 AdminGetOrderListResp 的 OrderItem 中删除 IsPromotion 字段
  • 从 AdminGetOrderDetailResp 中删除 IsPromotion 字段
  • 从 AdminCreateOrderReq 中删除 IsPromotion 字段
  • 从 AdminUpdateOrderResp 中删除 IsPromotion 字段

1.6 重新生成代码

  • 运行 goctl api go -api desc/admin/order.api -dir . -style gozero
  • 检查生成的代码是否正确

阶段二：前端代码清理

2.1 修改订单管理页面

文件：ycc-proxy-admin/apps/web-antd/src/views/order/order/data.ts

  • 删除推广订单列定义（第110-121行）
  • 删除表单中的推广订单字段（第224-225行）

文件：ycc-proxy-admin/apps/web-antd/src/api/order/order.ts

  • 从接口类型定义中删除 is_promotion 字段（第19行）

2.2 检查其他前端文件

  • 搜索前端代码中是否还有其他地方引用了 is_promotion 或 IsPromotion
  • 删除所有相关引用

阶段三：数据库清理（可选）

3.1 数据库表处理

  • 确认是否删除 admin_promotion_order 表
    • 如果保留历史数据，可以保留表但不使用
    • 如果需要完全清理，可以执行删除表的SQL

3.2 数据库迁移脚本（如需要）

  • 创建迁移脚本，删除 admin_promotion_order 表（如果决定删除）

阶段四：验证和测试

4.1 功能验证

  • 验证推广链接管理功能正常
  • 验证推广数据分析功能正常
  • 验证订单创建功能正常（不再有推广订单选项）
  • 验证订单更新功能正常（不再有推广订单选项）
  • 验证订单列表查询功能正常（不再显示推广订单字段）
  • 验证订单详情查看功能正常（不再显示推广订单字段）

4.2 代码检查

  • 运行 go build 确保后端代码编译通过
  • 运行前端构建确保前端代码正常
  • 检查是否有编译错误或警告
  • 检查是否有未使用的导入

注意事项

  1. 保留的功能不受影响

    • 推广链接管理（AdminPromotionLink）完全保留
    • 推广数据分析（AdminPromotionLinkStatsTotal, AdminPromotionLinkStatsHistory）完全保留
    • 记录链接点击功能完全保留

  2. 数据库表处理

    • admin_promotion_order 表可以保留（用于历史数据），但不再使用
    • 或者完全删除该表（需要确认是否有历史数据需要保留）

  3. 代码生成

    • 修改 .api 文件后需要重新生成代码
    • 确保生成的代码与手动修改的代码一致

  4. 向后兼容

    • 如果前端已经部署，需要确保前端和后端同时更新
    • 或者先更新后端，保持向后兼容一段时间

执行顺序建议

  1. 第一步：修改后端 API 定义文件（.api 文件）
  2. 第二步：重新生成后端代码
  3. 第三步：手动修改后端逻辑代码（删除推广订单相关逻辑）
  4. 第四步：修改前端代码
  5. 第五步：测试验证
  6. 第六步：清理数据库（如需要）

文件清单

需要修改的后端文件

  1. ycc-proxy-server/app/main/api/desc/admin/order.api
  2. ycc-proxy-server/app/main/api/internal/types/types.go
  3. ycc-proxy-server/app/main/api/internal/logic/admin_order/admincreateorderlogic.go
  4. ycc-proxy-server/app/main/api/internal/logic/admin_order/adminupdateorderlogic.go
  5. ycc-proxy-server/app/main/api/internal/logic/admin_order/admindeleteorderlogic.go
  6. ycc-proxy-server/app/main/api/internal/logic/admin_order/admingetorderlistlogic.go
  7. ycc-proxy-server/app/main/api/internal/logic/admin_order/admingetorderdetaillogic.go
  8. ycc-proxy-server/app/main/api/internal/svc/servicecontext.go
  9. ycc-proxy-server/app/main/model/vars.go（如需要）

需要删除的后端文件

  1. ycc-proxy-server/app/main/model/adminPromotionOrderModel.go
  2. ycc-proxy-server/app/main/model/adminPromotionOrderModel_gen.go

需要修改的前端文件

  1. ycc-proxy-admin/apps/web-antd/src/views/order/order/data.ts
  2. ycc-proxy-admin/apps/web-antd/src/api/order/order.ts

需要保留的文件（推广链接和数据分析）

  1. ycc-proxy-server/app/main/api/desc/admin/promotion.api ✅
  2. ycc-proxy-server/app/main/api/internal/logic/admin_promotion/* ✅
  3. ycc-proxy-server/app/main/api/internal/handler/admin_promotion/* ✅
  4. ycc-proxy-server/app/main/model/adminPromotionLinkModel* ✅
  5. ycc-proxy-server/app/main/model/adminPromotionLinkStats* ✅
  6. ycc-proxy-server/app/main/api/internal/service/adminPromotionLinkStatsService.go ✅
  7. ycc-proxy-admin/apps/web-antd/src/views/promotion/* ✅
  8. ycc-proxy-admin/apps/web-antd/src/api/promotion/* ✅

完成标志

  • 所有后端代码修改完成
  • 所有前端代码修改完成
  • 代码编译通过
  • 功能测试通过
  • 推广链接管理功能正常
  • 推广数据分析功能正常
  • 订单管理功能正常（无推广订单相关功能）
  • 无编译错误和警告