one-pipe-system/openspec/changes/update-series-allocation-commission/tasks.md

Implementation Tasks

1. Type Definitions Update

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

2. API Service Layer Update

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

3. Frontend Page Refactoring

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

4. UI/UX Enhancement

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

5. Data Migration Support

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

6. Testing and Validation

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