# Change: 财务-我的账号模块（代理商端）

## Why

代理商需要查看和管理自己的佣金：
1. 查看佣金概览（总佣金、已提现、未提现、冻结、可提现）
2. 发起佣金提现申请
3. 查看我的提现记录
4. 查看我的佣金入账明细

这是代理商用户的自助功能模块。

## What Changes

### 新增 API 接口

| 方法 | 路径 | 说明 |
|------|------|------|
| GET | `/api/admin/my/commission-summary` | 我的佣金概览 |
| POST | `/api/admin/my/withdrawal-requests` | 发起提现 |
| GET | `/api/admin/my/withdrawal-requests` | 我的提现记录 |
| GET | `/api/admin/my/commission-records` | 我的佣金明细 |

### 技术实现

- 新增 Handler：`internal/handler/admin/my_commission.go`
- 新增 Service：`internal/service/my_commission/service.go`
- 新增 DTO：`internal/model/dto/my_commission_dto.go`

### 业务逻辑

**发起提现**：
1. 从当前用户上下文获取 `shop_id` 和 `account_id`
2. 获取当前生效的提现配置
3. 验证：
   - 提现金额 >= 最低提现金额
   - 可提现余额 >= 提现金额
   - 今日提现次数 < 每日提现次数限制
4. 计算手续费和实际到账金额
5. 创建提现申请记录
6. 冻结店铺佣金钱包中对应金额
7. 记录钱包交易流水

## Impact

### 影响的规范
- **新增 Capability**：`my-commission`

### 影响的代码

**新增文件**（约 300 行）：
- `internal/handler/admin/my_commission.go`（~80 行）
- `internal/service/my_commission/service.go`（~150 行）
- `internal/model/dto/my_commission_dto.go`（~70 行）

### 兼容性
- ✅ 向后兼容：新增 API

## Dependencies

- 依赖提案：
  - `add-commission-model-changes`
  - `add-commission-withdrawal-approval`（共享提现记录查询）
  - `add-commission-withdrawal-settings`（获取提现配置）
- 依赖现有模型：`Wallet`、`CommissionWithdrawalRequest`、`CommissionRecord`

## Testing Strategy

1. **单元测试**：提现校验逻辑
2. **集成测试**：完整提现流程
3. **边界测试**：最低金额、次数限制、余额不足