feat: 实现套餐管理模块，包含套餐系列、双状态管理、废弃模型清理

- 新增套餐系列管理 (CRUD + 状态切换)
- 新增套餐管理 (CRUD + 启用/禁用 + 上架/下架双状态)
- 清理 8 个废弃分佣模型及对应数据库表
- Package 模型新增建议成本价、建议售价、上架状态字段
- 完整的 Store/Service/Handler 三层实现
- 包含单元测试和集成测试
- 归档 add-package-module change
- 新增多个 OpenSpec changes (订单支付、店铺套餐分配、一次性分佣、卡设备系列绑定)

openspec/changes/add-one-time-commission/.openspec.yaml

@@ -0,0 +1,2 @@
+schema: spec-driven
+created: 2026-01-27

openspec/changes/add-one-time-commission/design.md

@@ -0,0 +1,252 @@
+## Context
+
+Phase 4 完成了订单和支付流程，现在需要实现佣金计算。当终端用户购买套餐支付成功后，系统自动计算各级代理的佣金并入账。
+
+**佣金来源**：
+1. **成本价差收入**：每笔订单必触发，售价 - 成本价 = 代理收入
+2. **一次性佣金**：满足触发条件时发放一次，金额从梯度配置获取
+
+**当前 CommissionRecord 模型过于复杂**（包含冻结/解冻字段），需要简化。
+
+## Goals / Non-Goals
+
+**Goals:**
+- 简化 CommissionRecord 模型
+- 实现成本价差收入计算（每笔订单）
+- 实现一次性佣金触发（充值阈值）
+- 佣金直接入账到店铺钱包
+- 提供佣金记录查询和统计
+
+**Non-Goals:**
+- 不实现冻结/解冻机制
+- 不实现长期佣金（号卡专用）
+- 不实现梯度佣金统计（本期只做配置，统计后续优化）
+- 不实现佣金审批流程
+
+## Decisions
+
+### 1. CommissionRecord 模型简化
+
+**决策**：删除冻结相关字段，新增来源和关联字段
+
+```go
+// 简化后的 CommissionRecord
+type CommissionRecord struct {
+    gorm.Model
+    BaseModel
+    ShopID           uint       // 店铺ID（佣金归属）
+    OrderID          uint       // 关联订单ID
+    IotCardID        uint       // 关联卡ID（可空）
+    DeviceID         uint       // 关联设备ID（可空）
+    CommissionSource string     // 佣金来源: cost_diff-成本价差 one_time-一次性佣金 tier_bonus-梯度奖励
+    Amount           int64      // 佣金金额（分）
+    BalanceAfter     int64      // 入账后钱包余额（分）
+    Status           int        // 状态: 1-已入账 2-已失效
+    ReleasedAt       *time.Time // 入账时间
+    Remark           string     // 备注
+}
+```
+
+**删除字段**：
+- `agent_id`（改用 shop_id）
+- `rule_id`（不再关联复杂规则）
+- `commission_type`（改用 commission_source）
+- `unfrozen_at`、冻结相关状态
+
+### 2. 佣金计算流程
+
+**决策**：订单支付成功后异步计算
+
+```
+订单支付成功
+    ↓
+发送异步任务 (Asynq)
+    ↓
+佣金计算任务执行：
+    1. 获取订单信息
+    2. 遍历代理层级（从销售店铺到顶级）
+    3. 每级计算成本价差收入
+    4. 检查一次性佣金触发条件
+    5. 创建 CommissionRecord
+    6. 更新店铺钱包余额
+    7. 更新订单 commission_status
+```
+
+### 3. 成本价差收入计算
+
+**决策**：各级代理按自己的成本价差计算
+
+**计算规则**：
+- 终端销售代理：收入 = 售价 - 自己的成本价
+- 中间层级代理：收入 = 下级的成本价 - 自己的成本价
+
+```go
+func CalculateCostDiffCommission(order *Order) []CommissionRecord {
+    var records []CommissionRecord
+    
+    // 获取销售店铺（终端销售的代理）
+    sellerShop := GetShop(order.SellerShopID)
+    sellerCostPrice := GetCostPrice(sellerShop.ID, order.PackageID)
+    
+    // 终端销售代理的收入 = 售价 - 成本价
+    sellerProfit := order.TotalAmount - sellerCostPrice
+    if sellerProfit > 0 {
+        records = append(records, CommissionRecord{
+            ShopID:           sellerShop.ID,
+            OrderID:          order.ID,
+            CommissionSource: "cost_diff",
+            Amount:           sellerProfit,
+        })
+    }
+    
+    // 遍历上级代理链
+    childCostPrice := sellerCostPrice
+    currentShop := GetShop(sellerShop.ParentID)
+    
+    for currentShop != nil {
+        // 获取当前店铺的成本价
+        myCostPrice := GetCostPrice(currentShop.ID, order.PackageID)
+        
+        // 收入 = 下级成本价 - 自己成本价
+        profit := childCostPrice - myCostPrice
+        if profit > 0 {
+            records = append(records, CommissionRecord{
+                ShopID:           currentShop.ID,
+                OrderID:          order.ID,
+                CommissionSource: "cost_diff",
+                Amount:           profit,
+            })
+        }
+        
+        // 移动到上级
+        childCostPrice = myCostPrice
+        currentShop = GetShop(currentShop.ParentID)
+    }
+    
+    return records
+}
+```
+
+### 4. 一次性佣金触发
+
+**决策**：两种触发类型，每张卡/设备只触发一次
+
+```go
+// 触发类型 A：一次性充值 ≥ 阈值
+func CheckOneTimeRecharge(order *Order, threshold int64) bool {
+    return order.TotalAmount >= threshold
+}
+
+// 触发类型 B：累计充值 ≥ 阈值
+func CheckAccumulatedRecharge(card *IotCard, threshold int64) bool {
+    return card.AccumulatedRecharge >= threshold
+}
+
+// 检查并发放一次性佣金
+func TriggerOneTimeCommission(order *Order, card *IotCard) {
+    if card.FirstCommissionPaid {
+        return // 已发放过
+    }
+    
+    // 获取配置的触发条件和金额
+    tier := GetCommissionTier(card.SeriesAllocationID)
+    
+    // 检查触发条件
+    triggered := false
+    switch tier.TriggerType {
+    case "one_time_recharge":
+        triggered = CheckOneTimeRecharge(order, tier.ThresholdValue)
+    case "accumulated_recharge":
+        triggered = CheckAccumulatedRecharge(card, tier.ThresholdValue)
+    }
+    
+    if triggered {
+        // 发放佣金
+        CreateCommissionRecord(...)
+        // 标记已发放
+        card.FirstCommissionPaid = true
+        UpdateCard(card)
+    }
+}
+```
+
+### 5. 钱包入账
+
+**决策**：直接入账，无冻结期
+
+```go
+func CreditCommission(record *CommissionRecord) error {
+    return Transaction(func(tx *gorm.DB) error {
+        // 1. 获取店铺钱包
+        wallet := GetWallet("shop", record.ShopID)
+        
+        // 2. 增加余额
+        wallet.Balance += record.Amount
+        UpdateWallet(wallet)
+        
+        // 3. 记录余额
+        record.BalanceAfter = wallet.Balance
+        record.Status = 1 // 已入账
+        record.ReleasedAt = time.Now()
+        UpdateCommissionRecord(record)
+        
+        // 4. 创建钱包交易记录
+        CreateWalletTransaction(...)
+        
+        return nil
+    })
+}
+```
+
+### 6. API 设计
+
+```
+# 佣金记录查询
+GET /api/admin/commission-records              佣金记录列表
+GET /api/admin/commission-records/:id          佣金记录详情
+
+# 佣金统计
+GET /api/admin/commission-stats                佣金统计（总收入、各来源占比）
+GET /api/admin/commission-stats/daily          每日佣金统计
+```
+
+## Risks / Trade-offs
+
+### 风险 1：异步计算失败
+
+**风险**：佣金计算任务失败导致佣金未发放
+
+**缓解**：
+- Asynq 自动重试机制
+- 记录任务执行日志
+- 提供手动触发补偿接口
+
+### 风险 2：并发更新钱包余额
+
+**风险**：多笔佣金同时入账导致余额计算错误
+
+**缓解**：
+- 使用数据库事务
+- 钱包更新使用乐观锁或悲观锁
+
+### 风险 3：代理层级变更
+
+**风险**：订单支付后代理层级变更，佣金计算基于哪个时间点？
+
+**缓解**：
+- 佣金计算基于订单支付时的代理关系
+- 订单中可记录销售店铺ID快照
+
+## Open Questions
+
+1. **梯度佣金何时统计？**
+   - 当前设计：本期只做配置，不做实际统计
+   - 待确认：是否需要定时任务统计并发放梯度奖励？
+
+2. **累计充值是否包含当前订单？**
+   - 当前设计：先更新累计充值，再检查触发条件
+   - 待确认：是否正确？
+
+3. **一次性佣金发放给谁？**
+   - 当前设计：发放给卡/设备的直接归属店铺
+   - 待确认：是否需要多级分佣？

openspec/changes/add-one-time-commission/proposal.md

@@ -0,0 +1,77 @@
+## Why
+
+Phase 4 完成了订单与支付流程，现在需要实现一次性佣金计算。当终端用户购买套餐时，各级代理根据成本价差获得收入，并根据配置的触发条件（一次性充值阈值/累计充值阈值）发放一次性佣金。
+
+## What Changes
+
+**CommissionRecord 模型简化：**
+- 移除冻结/解冻相关字段（unfreeze_days, unfrozen_at 等）
+- 移除 rule_id（不再关联复杂规则）
+- 移除 agent_id（改用 shop_id，佣金归属店铺而非个人账号）
+- 保留：shop_id, order_id, amount, status, released_at, balance_after
+- 新增：commission_source（成本价差/一次性佣金/梯度佣金）
+- 新增：iot_card_id/device_id（关联的卡/设备）
+- 新增：remark（备注）
+
+**佣金计算逻辑：**
+
+1. **成本价差收入**（每笔订单必触发）
+   - 终端销售代理：售价 - 自己的成本价 = 收入
+   - 中间层级代理：下级的成本价 - 自己的成本价 = 收入
+   - 各级代理按自己的成本价差计算，确保每级都有利润
+
+2. **一次性佣金**（满足条件触发一次）
+   - 触发类型 A：一次性充值 ≥ 阈值
+   - 触发类型 B：累计充值 ≥ 阈值
+   - 每张卡/设备只触发一次
+   - 佣金金额从 ShopSeriesCommissionTier 获取（支持梯度）
+
+3. **多级分佣**
+   - 订单支付成功后，遍历代理层级
+   - 每级代理计算成本价差收入
+   - 检查一次性佣金触发条件
+
+**新增 API：**
+- 佣金记录列表查询（按店铺/时间/来源筛选）
+- 佣金统计（总收入、各来源占比）
+- 手动触发佣金计算（补偿机制）
+
+**业务规则：**
+- 佣金直接入账到店铺钱包，无冻结期
+- 一次性佣金只发放一次，通过 card.first_commission_paid 标记
+- 累计充值记录在 card.accumulated_recharge
+- 梯度佣金根据配置的时间范围统计销量/销售额
+
+## Capabilities
+
+### New Capabilities
+
+- `commission-calculation`: 佣金计算 - 订单支付后自动计算各级代理的成本价差收入
+- `one-time-commission-trigger`: 一次性佣金触发 - 根据充值阈值触发一次性佣金发放
+- `commission-record-query`: 佣金记录查询 - 查询佣金明细和统计数据
+
+### Modified Capabilities
+
+<!-- 无，CommissionRecord 的修改在 proposal 中说明，不需要单独 spec -->
+
+## Impact
+
+**代码影响：**
+- `internal/model/commission.go` - 简化 CommissionRecord 模型
+- `migrations/` - 修改 tb_commission_record 表结构
+- `internal/handler/admin/` - 新增/修改佣金查询 Handler
+- `internal/service/` - 新增佣金计算 Service
+- `internal/store/postgres/` - 修改 CommissionRecordStore
+- `internal/task/` - 佣金计算异步任务
+
+**API 影响：**
+- 修改 `/api/admin/commission-records/*` 佣金记录查询
+- 新增 `/api/admin/commission-stats` 佣金统计
+
+**数据库影响：**
+- 修改表：`tb_commission_record`（简化字段、新增字段）
+
+**依赖关系：**
+- 依赖 Phase 4（add-order-payment）完成
+- 依赖 Phase 2 的 ShopSeriesCommissionTier 梯度配置
+- 依赖 Phase 3 的卡/设备佣金状态字段

openspec/changes/add-one-time-commission/specs/commission-calculation/spec.md

@@ -0,0 +1,73 @@
+## ADDED Requirements
+
+### Requirement: 订单支付后触发佣金计算
+
+系统 SHALL 在订单支付成功后自动触发佣金计算。计算通过异步任务执行。
+
+#### Scenario: 支付成功触发计算
+- **WHEN** 订单支付状态变为已支付
+- **THEN** 系统发送佣金计算异步任务
+
+#### Scenario: 重复支付不重复计算
+- **WHEN** 订单已计算过佣金（commission_status=2）
+- **THEN** 系统不重复触发计算
+
+---
+
+### Requirement: 成本价差收入计算
+
+系统 SHALL 为代理链上的每一级代理计算成本价差收入。终端销售代理收入 = 售价 - 成本价；中间层级代理收入 = 下级成本价 - 自己成本价。
+
+#### Scenario: 单级代理
+- **WHEN** 一级代理销售套餐，售价 100 元，成本价 80 元
+- **THEN** 一级代理获得 20 元（100 - 80）成本价差收入
+
+#### Scenario: 多级代理
+- **WHEN** 三级代理销售套餐，售价 100 元，各级成本价为：平台 50 → 一级 60 → 二级 70 → 三级 80
+- **THEN** 三级获得 20 元（100 - 80），二级获得 10 元（80 - 70），一级获得 10 元（70 - 60），平台获得 10 元（60 - 50）
+
+#### Scenario: 成本价相同
+- **WHEN** 某级代理成本价等于下级成本价
+- **THEN** 该级代理成本价差收入为 0，不创建佣金记录
+
+---
+
+### Requirement: 佣金直接入账
+
+成本价差收入 SHALL 直接入账到店铺钱包，无冻结期。
+
+#### Scenario: 佣金入账
+- **WHEN** 计算出代理的成本价差收入
+- **THEN** 系统直接增加店铺钱包余额，创建佣金记录和钱包交易记录
+
+#### Scenario: 记录入账后余额
+- **WHEN** 佣金入账
+- **THEN** CommissionRecord.balance_after 记录入账后的钱包余额
+
+---
+
+### Requirement: 更新累计充值金额
+
+订单支付成功后系统 SHALL 更新卡/设备的累计充值金额。
+
+#### Scenario: 单卡订单更新累计充值
+- **WHEN** 单卡订单支付成功，金额 100 元
+- **THEN** IotCard.accumulated_recharge 增加 10000 分
+
+#### Scenario: 设备订单更新累计充值
+- **WHEN** 设备订单支付成功，金额 300 元
+- **THEN** Device.accumulated_recharge 增加 30000 分
+
+---
+
+### Requirement: CommissionRecord 模型简化
+
+系统 MUST 简化 CommissionRecord 模型，移除冻结相关字段。
+
+#### Scenario: 新佣金记录字段
+- **WHEN** 创建佣金记录
+- **THEN** 包含：shop_id, order_id, iot_card_id, device_id, commission_source, amount, balance_after, status, released_at, remark
+
+#### Scenario: 佣金来源类型
+- **WHEN** 创建佣金记录
+- **THEN** commission_source 为以下之一：cost_diff（成本价差）、one_time（一次性佣金）、tier_bonus（梯度奖励）

openspec/changes/add-one-time-commission/specs/commission-record-query/spec.md

@@ -0,0 +1,67 @@
+## ADDED Requirements
+
+### Requirement: 查询佣金记录列表
+
+系统 SHALL 提供佣金记录列表查询，支持按店铺、佣金来源、时间范围、状态筛选。
+
+#### Scenario: 代理查询自己店铺的佣金
+- **WHEN** 代理查询佣金记录列表
+- **THEN** 系统返回该店铺的所有佣金记录
+
+#### Scenario: 按佣金来源筛选
+- **WHEN** 指定 commission_source 为 cost_diff
+- **THEN** 系统只返回成本价差类型的佣金记录
+
+#### Scenario: 按时间范围筛选
+- **WHEN** 指定开始时间和结束时间
+- **THEN** 系统只返回该时间范围内的佣金记录
+
+#### Scenario: 响应包含关联信息
+- **WHEN** 查询佣金记录列表
+- **THEN** 每条记录包含：订单号、卡/设备信息、套餐名称
+
+---
+
+### Requirement: 查询佣金记录详情
+
+系统 SHALL 允许查询单条佣金记录的详细信息。
+
+#### Scenario: 查询佣金详情
+- **WHEN** 代理查询指定佣金记录详情
+- **THEN** 系统返回完整的佣金信息和关联的订单、卡/设备信息
+
+#### Scenario: 查询他人佣金
+- **WHEN** 代理尝试查询其他店铺的佣金记录
+- **THEN** 系统返回 "记录不存在" 错误
+
+---
+
+### Requirement: 佣金统计
+
+系统 SHALL 提供佣金统计功能，包含总收入和各来源占比。
+
+#### Scenario: 查询总收入
+- **WHEN** 代理查询佣金统计
+- **THEN** 系统返回总收入金额（所有已入账佣金之和）
+
+#### Scenario: 各来源占比
+- **WHEN** 代理查询佣金统计
+- **THEN** 系统返回各佣金来源的金额和占比（cost_diff、one_time、tier_bonus）
+
+#### Scenario: 按时间范围统计
+- **WHEN** 指定时间范围查询统计
+- **THEN** 系统只统计该时间范围内的佣金
+
+---
+
+### Requirement: 每日佣金统计
+
+系统 SHALL 提供每日佣金统计查询。
+
+#### Scenario: 查询每日统计
+- **WHEN** 代理查询指定日期范围的每日统计
+- **THEN** 系统返回每天的佣金总额和笔数
+
+#### Scenario: 默认最近30天
+- **WHEN** 代理查询每日统计不指定日期范围
+- **THEN** 系统返回最近 30 天的数据

openspec/changes/add-one-time-commission/specs/one-time-commission-trigger/spec.md

@@ -0,0 +1,69 @@
+## ADDED Requirements
+
+### Requirement: 一次性充值触发佣金
+
+系统 SHALL 支持"一次性充值"触发条件：当单笔订单金额 ≥ 配置阈值时触发一次性佣金。
+
+#### Scenario: 达到一次性充值阈值
+- **WHEN** 订单金额 500 元，配置阈值 300 元，该卡未发放过一次性佣金
+- **THEN** 系统发放一次性佣金，标记卡的 first_commission_paid 为 true
+
+#### Scenario: 未达到阈值
+- **WHEN** 订单金额 200 元，配置阈值 300 元
+- **THEN** 系统不发放一次性佣金
+
+#### Scenario: 已发放过一次性佣金
+- **WHEN** 订单金额 500 元，但卡的 first_commission_paid 已为 true
+- **THEN** 系统不重复发放一次性佣金
+
+---
+
+### Requirement: 累计充值触发佣金
+
+系统 SHALL 支持"累计充值"触发条件：当卡/设备的累计充值金额 ≥ 配置阈值时触发一次性佣金。
+
+#### Scenario: 累计达到阈值
+- **WHEN** 卡之前累计充值 200 元，本次充值 150 元，配置阈值 300 元
+- **THEN** 累计 350 元 ≥ 300 元，系统发放一次性佣金
+
+#### Scenario: 累计未达到阈值
+- **WHEN** 卡之前累计充值 100 元，本次充值 100 元，配置阈值 300 元
+- **THEN** 累计 200 元 < 300 元，系统不发放一次性佣金
+
+---
+
+### Requirement: 一次性佣金只发放一次
+
+每张卡/设备的一次性佣金 SHALL 只发放一次，通过 first_commission_paid 字段控制。
+
+#### Scenario: 首次触发
+- **WHEN** 首次满足触发条件
+- **THEN** 发放佣金，设置 first_commission_paid = true
+
+#### Scenario: 再次满足条件
+- **WHEN** 再次满足触发条件但 first_commission_paid 已为 true
+- **THEN** 不发放佣金
+
+---
+
+### Requirement: 一次性佣金配置获取
+
+一次性佣金的触发条件和金额 SHALL 从 ShopSeriesAllocation 配置获取。
+
+#### Scenario: 获取触发条件和金额
+- **WHEN** 触发一次性佣金检查
+- **THEN** 系统从卡关联的 ShopSeriesAllocation 获取 one_time_commission_trigger（触发类型）、one_time_commission_threshold（阈值）、one_time_commission_amount（金额）
+
+#### Scenario: 无一次性佣金配置
+- **WHEN** 卡关联的系列分配未配置一次性佣金（one_time_commission_amount = 0）
+- **THEN** 不发放一次性佣金
+
+---
+
+### Requirement: 一次性佣金发放对象
+
+一次性佣金 SHALL 发放给卡/设备的直接归属店铺。
+
+#### Scenario: 发放给归属店铺
+- **WHEN** 卡归属店铺 A，触发一次性佣金
+- **THEN** 佣金入账到店铺 A 的钱包

openspec/changes/add-one-time-commission/tasks.md

@@ -0,0 +1,99 @@
+## 1. CommissionRecord 模型简化
+
+- [ ] 1.1 修改 `internal/model/commission.go`，简化 CommissionRecord 结构
+- [ ] 1.2 删除冻结相关字段（unfrozen_at 等）
+- [ ] 1.3 删除 rule_id、agent_id 字段
+- [ ] 1.4 新增 commission_source 字段（varchar: cost_diff, one_time, tier_bonus）
+- [ ] 1.5 新增 iot_card_id、device_id 字段
+- [ ] 1.6 新增 remark 字段
+
+## 2. 数据库迁移
+
+- [ ] 2.1 创建迁移文件，修改 tb_commission_record 表结构
+- [ ] 2.2 删除废弃字段
+- [ ] 2.3 添加新字段
+- [ ] 2.4 添加索引（shop_id, order_id, commission_source, iot_card_id, device_id）
+- [ ] 2.5 本地执行迁移验证
+
+## 3. DTO 更新
+
+- [ ] 3.1 更新 `internal/model/dto/commission.go`，调整 CommissionRecordResponse
+- [ ] 3.2 定义 CommissionRecordListRequest（shop_id, commission_source, start_time, end_time, status）
+- [ ] 3.3 定义 CommissionStatsResponse（total_amount, cost_diff_amount, one_time_amount, tier_bonus_amount）
+- [ ] 3.4 定义 DailyCommissionStatsResponse
+
+## 4. CommissionRecord Store 更新
+
+- [ ] 4.1 更新 `internal/store/postgres/commission_record_store.go`，适配新模型
+- [ ] 4.2 更新 Create 方法
+- [ ] 4.3 更新 List 方法支持新筛选条件
+- [ ] 4.4 实现 GetStats 方法（统计总收入和各来源占比）
+- [ ] 4.5 实现 GetDailyStats 方法（每日统计）
+
+## 5. 佣金计算 Service
+
+- [ ] 5.1 创建 `internal/service/commission_calculation/service.go`
+- [ ] 5.2 实现 CalculateCommission 主方法（协调整体计算流程）
+- [ ] 5.3 实现 CalculateCostDiffCommission 方法（遍历代理层级计算成本价差）
+- [ ] 5.4 实现 CheckAndTriggerOneTimeCommission 方法（检查一次性佣金触发条件）
+- [ ] 5.5 实现 CreditCommission 方法（佣金入账到钱包）
+- [ ] 5.6 实现 UpdateAccumulatedRecharge 方法（更新累计充值金额）
+
+## 6. 异步任务
+
+- [ ] 6.1 创建 `internal/task/commission_calculation.go`，定义佣金计算任务类型
+- [ ] 6.2 实现任务处理函数 HandleCommissionCalculation
+- [ ] 6.3 在 OrderService.WalletPay 中添加任务发送逻辑
+- [ ] 6.4 在支付回调处理中添加任务发送逻辑
+- [ ] 6.5 在 Worker 中注册任务处理器
+
+## 7. 佣金查询 Service
+
+- [ ] 7.1 更新 `internal/service/my_commission/service.go`，适配新模型
+- [ ] 7.2 实现 List 方法
+- [ ] 7.3 实现 Get 方法
+- [ ] 7.4 实现 GetStats 方法
+- [ ] 7.5 实现 GetDailyStats 方法
+
+## 8. Handler 更新
+
+- [ ] 8.1 更新 `internal/handler/admin/my_commission.go`，适配新接口
+- [ ] 8.2 实现 List 接口
+- [ ] 8.3 实现 Get 接口
+- [ ] 8.4 实现 GetStats 接口
+- [ ] 8.5 实现 GetDailyStats 接口
+
+## 9. Bootstrap 注册
+
+- [ ] 9.1 在 services.go 中注册 CommissionCalculationService
+- [ ] 9.2 确认 MyCommissionService 注册正确
+
+## 10. 路由更新
+
+- [ ] 10.1 确认 `/api/admin/my-commission/records` 路由
+- [ ] 10.2 添加 `/api/admin/my-commission/stats` 路由
+- [ ] 10.3 添加 `/api/admin/my-commission/daily-stats` 路由
+
+## 11. 文档生成器更新
+
+- [ ] 11.1 更新 docs.go 和 gendocs/main.go
+- [ ] 11.2 执行文档生成验证
+
+## 12. 测试
+
+- [ ] 12.1 CommissionRecordStore 单元测试
+- [ ] 12.2 CommissionCalculationService 单元测试（覆盖成本价差计算）
+- [ ] 12.3 一次性佣金触发逻辑测试（覆盖各种触发条件）
+- [ ] 12.4 佣金入账事务测试
+- [ ] 12.5 异步任务测试
+- [ ] 12.6 佣金统计 API 集成测试
+- [ ] 12.7 执行 `go test ./...` 确认通过
+
+## 13. 最终验证
+
+- [ ] 13.1 执行 `go build ./...` 确认编译通过
+- [ ] 13.2 启动服务，创建订单并支付
+- [ ] 13.3 验证佣金记录正确创建
+- [ ] 13.4 验证钱包余额正确增加
+- [ ] 13.5 验证一次性佣金触发逻辑
+- [ ] 13.6 验证佣金统计数据正确