huang
677d6239ce
All checks were successful
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 7m33s
- 删除 model/commission.go 中与 constants 包冲突的旧常量（值=1/2） - 所有服务层改用 constants.CommissionStatusReleased（值=3）写入和查询 - 数据库迁移：status 1→3（已发放），2→4（已失效） - 修复佣金明细列表接口，通过 JOIN 关联返回 order_no、iccid、virtual_no、order_created_at - 新增 seller_shop_id / seller_shop_name 销售来源字段 - 统计接口过滤条件从精确匹配改为排除无效（NOT IN 4,99） - 更新 OpenAPI 文档及 commission-record-query spec
4.5 KiB
4.5 KiB
0. 测试准备
- 0.1 查询数据库中现有佣金记录的状态分布：
SELECT status, COUNT(*) FROM tb_commission_record GROUP BY status - 0.2 确认现有状态值与常量定义的映射关系
1. 数据库迁移
- 1.1 创建迁移文件：将
tb_commission_record.status从旧值迁移到新值（1→3, 2→4） - 1.2 在测试环境执行迁移并验证：
SELECT status, COUNT(*) FROM tb_commission_record GROUP BY status - 1.3 备份生产数据后执行迁移
2. 删除冲突常量
- 2.1 删除
internal/model/commission.go中的旧常量定义（第 40-46 行） - 2.2 更新
internal/model/commission.go中CommissionRecord.Status字段的 GORM 注释：1-已入账 2-已失效→1-已冻结 2-解冻中 3-已发放 4-已失效
3. 替换常量引用
-
3.1 修改
internal/service/commission_calculation/service.go中的 4 处常量引用- 3.1.1 第 151 行：
model.CommissionStatusReleased→constants.CommissionStatusReleased - 3.1.2 第 216 行：
model.CommissionStatusReleased→constants.CommissionStatusReleased - 3.1.3 第 517 行：
model.CommissionStatusReleased→constants.CommissionStatusReleased - 3.1.4 第 659 行：
model.CommissionStatusReleased→constants.CommissionStatusReleased
- 3.1.1 第 151 行：
-
3.2 修改
internal/service/refund/service.go中的 1 处常量引用- 3.2.1 第 344 行：
model.CommissionStatusReleased→constants.CommissionStatusReleased
- 3.2.1 第 344 行：
-
3.3 修改
internal/service/recharge/service.go中的 1 处常量引用- 3.3.1 第 664 行：
model.CommissionStatusReleased→constants.CommissionStatusReleased
- 3.3.1 第 664 行：
-
3.4 修改
internal/service/shop_commission/service.go中的 2 处常量引用- 3.4.1 第 767 行：
model.CommissionStatusReleased→constants.CommissionStatusReleased - 3.4.2 第 749 行：
model.CommissionStatusInvalid→constants.CommissionStatusInvalid
- 3.4.1 第 767 行：
-
3.5 修改
internal/store/postgres/commission_record_store.go中的 2 处统计查询过滤条件（注意：语义变更，不是简单替换常量）- 3.5.1
GetStats（第 123 行）：Where("status = ?", model.CommissionStatusReleased)→Where("status NOT IN (?)", []int{constants.CommissionStatusInvalid, constants.CommissionStatusPendingReview}) - 3.5.2
GetDailyStats（第 169 行）：同上，改为排除 status=4 和 status=99
- 3.5.1
4. 修复 commission-records 接口关联查询
-
4.1 修改
internal/store/postgres/commission_record_store.go的ListByShopID方法- 4.1.1 添加 LEFT JOIN 关联查询（订单表、卡表、设备表）
- 4.1.2 实现 ICCID 过滤条件（模糊查询）
- 4.1.3 实现 OrderNo 过滤条件（精确查询）
- 4.1.4 实现 DeviceNo 过滤条件（模糊查询，通过 device_id JOIN device 表）
-
4.2 修改
internal/service/shop_commission/service.go的ListShopCommissionRecords方法- 4.2.1 从查询结果中提取关联的 order_no、order_created_at
- 4.2.2 从查询结果中提取关联的 iccid
- 4.2.3 从查询结果中提取关联的 virtual_no
- 4.2.4 从查询结果中提取关联的 seller_shop_id
5. DTO 增强
-
5.1 修改
internal/model/dto/shop_commission_dto.go的ShopCommissionRecordItem结构体- 5.1.1 新增
SellerShopID uint字段 - 5.1.2 新增
SellerShopName string字段
- 5.1.1 新增
-
5.2 更新
ShopCommissionRecordItem的 JSON 标签和 description
6. Service 层填充销售店铺信息
- 6.1 修改
internal/service/shop_commission/service.go的ListShopCommissionRecords方法- 6.1.1 批量查询销售店铺信息
- 6.1.2 填充
SellerShopID和SellerShopName字段
7. 文档更新
- 7.1 更新
cmd/api/docs.go添加新字段说明（如有必要） - 7.2 更新
cmd/gendocs/main.go如有必要 - 7.3 更新 API 文档注释
8. 验证测试
- 8.1 运行
lsp_diagnostics检查所有修改文件的语法错误 - 8.2 构建项目确认编译通过：
go build ./... - 8.3 调用
GET /api/admin/shops/:shop_id/commission-records接口验证返回数据- 8.3.1 确认 OrderNo 有值
- 8.3.2 确认 ICCID 有值（单卡订单）
- 8.3.3 确认 VirtualNo 有值（设备订单）
- 8.3.4 确认 SellerShopID 和 SellerShopName 有值
- 8.3.5 确认状态名称正确（status=3 显示"已发放"）
- 8.4 调用
GET /api/admin/shops/:shop_id/commission-stats验证统计接口正常