csxj2026/junhong_cmp_fiber

Files

构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 4m35s

Details

新增功能：
- 店铺佣金查询：店铺佣金统计、店铺佣金记录列表、店铺提现记录
- 佣金提现审批：提现申请列表、审批通过、审批拒绝
- 提现配置管理：配置列表、新增配置、获取当前生效配置
- 企业管理：企业列表、创建、更新、删除、获取详情
- 企业卡授权：授权列表、批量授权、批量取消授权、统计
- 客户账号管理：账号列表、创建、更新状态、重置密码
- 我的佣金：佣金统计、佣金记录、提现申请、提现记录

数据库变更：
- 扩展 tb_commission_withdrawal_request 新增提现单号等字段
- 扩展 tb_account 新增 is_primary 字段
- 扩展 tb_commission_record 新增 shop_id、balance_after
- 扩展 tb_commission_withdrawal_setting 新增每日提现次数限制
- 扩展 tb_iot_card、tb_device 新增 shop_id 冗余字段
- 新建 tb_enterprise_card_authorization 企业卡授权表
- 新建 tb_asset_allocation_record 资产分配记录表
- 数据迁移：owner_type 枚举值 agent 统一为 shop

测试：
- 新增 7 个单元测试文件覆盖各服务
- 修复集成测试 Redis 依赖问题

2026-01-21 18:20:44 +08:00

2.5 KiB

Raw Permalink Blame History

Change: 代理商佣金查询模块

Why

平台需要查看和管理代理商（店铺）的佣金信息，包括：

代理商列表及其佣金汇总（总佣金、已提现、未提现、冻结中、可提现）
查看某代理商的佣金提现记录
查看某代理商的佣金入账明细

这是账号管理-代理商(店铺)管理模块的核心功能。

What Changes

新增 API 接口

方法	路径	说明
GET	`/api/admin/shops/commission-summary`	代理商佣金列表（含汇总信息）
GET	`/api/admin/shops/:shop_id/withdrawal-requests`	代理商提现记录
GET	`/api/admin/shops/:shop_id/commission-records`	代理商佣金明细

技术实现

新增 Handler：internal/handler/admin/shop_commission.go
新增 Service：internal/service/shop_commission/service.go
新增 DTO：internal/model/dto/shop_commission_dto.go
扩展 Store：internal/store/postgres/wallet_store.go（新增佣金汇总查询方法）

业务逻辑

佣金汇总计算：

total_commission：总佣金 = Wallet.balance + Wallet.frozen_balance + 已提现金额
withdrawn_commission：已提现 = CommissionWithdrawalRequest(status=2) 总金额
unwithdraw_commission：未提现 = 总佣金 - 已提现
frozen_commission：冻结中 = Wallet.frozen_balance
withdrawing_commission：提现中 = CommissionWithdrawalRequest(status=1) 总金额
available_commission：可提现 = Wallet.balance - 提现中

店铺层级路径：

格式：上上级_上级_本身（最多两层上级）
不包含平台

Impact

影响的规范

新增 Capability：shop-commission-query

影响的代码

新增文件（约 400 行）：

internal/handler/admin/shop_commission.go（~100 行）
internal/service/shop_commission/service.go（~200 行）
internal/model/dto/shop_commission_dto.go（~100 行）

修改文件（约 50 行）：

internal/store/postgres/wallet_store.go（新增方法）
internal/bootstrap/ 相关文件（注册组件）

兼容性

✅ 向后兼容：新增 API，不影响现有功能

Dependencies

依赖提案：add-commission-model-changes
依赖现有模型：Shop、Account、Wallet、CommissionRecord、CommissionWithdrawalRequest

Testing Strategy

单元测试：佣金汇总计算逻辑
集成测试：API 端点测试
数据权限测试：代理商只能看到自己+下级店铺数据

2.5 KiB Raw Permalink Blame History Unescape Escape