# Implementation Tasks

## 1. Type Definitions Update

- [x] 1.1 更新 `ShopSeriesAllocationResponse` 接口,移除旧字段,添加新的佣金字段
- [x] 1.2 创建 `BaseCommissionConfig` 类型定义 (mode, value)
- [x] 1.3 创建 `TierCommissionConfig` 类型定义 (period_type, tier_type, tiers)
- [x] 1.4 创建 `TierEntry` 类型定义 (threshold, mode, value)
- [x] 1.5 更新 `CreateShopSeriesAllocationRequest` 接口以支持新的佣金字段
- [x] 1.6 更新 `UpdateShopSeriesAllocationRequest` 接口以支持新的佣金字段
- [x] 1.7 更新分页响应类型,从 `items` 改为 `list`,添加 `total_pages`

## 2. API Service Layer Update

- [x] 2.1 更新 `getShopSeriesAllocations` 方法以处理新的响应结构 (list 而非 items)
- [x] 2.2 更新 `createShopSeriesAllocation` 方法以发送新的佣金配置
- [x] 2.3 更新 `updateShopSeriesAllocation` 方法以发送新的佣金配置
- [x] 2.4 确保所有API方法正确处理新的类型定义

## 3. Frontend Page Refactoring

- [x] 3.1 移除旧的定价模式相关代码 (pricing_mode, pricing_value)
- [x] 3.2 移除旧的一次性佣金配置相关代码
- [x] 3.3 更新表格列定义,移除 `calculated_cost_price` 等旧列
- [x] 3.4 添加基础佣金配置表单字段 (mode: fixed/percent, value)
- [x] 3.5 添加梯度返佣开关字段 (enable_tier_commission)
- [x] 3.6 添加梯度返佣配置表单 (period_type, tier_type, tiers数组)
- [x] 3.7 实现梯度档位的动态添加/删除功能
- [x] 3.8 更新表格列以显示新的佣金信息 (base_commission)
- [x] 3.9 更新表单验证规则以适配新的字段要求
- [x] 3.10 更新数据列表获取逻辑,从 `res.data.items` 改为 `res.data.list`
- [x] 3.11 更新 `showDialog` 函数以正确填充新的佣金字段
- [x] 3.12 更新 `handleDialogClosed` 函数以重置新的佣金字段
- [x] 3.13 更新 `handleSubmit` 函数以正确提交新的佣金配置

## 4. UI/UX Enhancement

- [x] 4.1 设计并实现基础佣金配置UI (单选模式 + 数值输入)
- [x] 4.2 设计并实现梯度返佣配置UI (周期类型、梯度类型、档位列表)
- [x] 4.3 添加梯度档位的表单验证 (阈值递增、必填字段等)
- [x] 4.4 优化对话框布局以容纳新增的配置项
- [x] 4.5 添加梯度返佣的帮助提示或说明文档链接

## 5. Data Migration Support

- [x] 5.1 与后端确认数据迁移方案和时间表
- [x] 5.2 准备回退方案(如果部署失败)
- [x] 5.3 准备测试数据以验证迁移正确性

## 6. Testing and Validation

- [x] 6.1 测试基础佣金配置的创建和编辑
- [x] 6.2 测试梯度返佣的创建和编辑
- [x] 6.3 测试档位添加/删除功能
- [x] 6.4 测试表单验证规则
- [x] 6.5 测试数据列表的显示和分页
- [x] 6.6 测试状态切换功能
- [x] 6.7 测试删除功能
- [x] 6.8 验证与后端API的集成
