one-pipe-system/openspec/changes/update-package-management-api/tasks.md

Implementation Tasks

1. 类型定义更新

• 1.1 更新 PackageSeriesResponse - 新增一次性佣金字段
• 1.2 新增 SeriesOneTimeCommissionConfig 类型定义
• 1.3 新增 OneTimeCommissionTier 类型定义
• 1.4 更新 CreatePackageSeriesRequest - 新增一次性佣金配置参数
• 1.5 更新 UpdatePackageSeriesRequest - 新增一次性佣金配置参数
• 1.6 更新 PackageSeriesQueryParams - 新增 enable_one_time_commission 筛选参数
• 1.7 重构 ShopSeriesAllocationResponse - 替换为新的字段结构
• 1.8 重构 CreateShopSeriesAllocationRequest - 更新为新的请求结构
• 1.9 重构 UpdateShopSeriesAllocationRequest - 更新为新的请求结构
• 1.10 更新 ShopPackageAllocationResponse - 新增系列关联和分配者字段
• 1.11 更新 ShopPackageAllocationQueryParams - 新增筛选参数
• 1.12 移除废弃的类型定义 (BaseCommissionConfig, 旧版 OneTimeCommissionConfig 等)

2. 套餐系列管理页面适配

• 2.1 更新套餐系列列表 - 显示一次性佣金启用状态
• 2.2 更新套餐系列表单 - 新增一次性佣金配置区块
• 2.3 实现一次性佣金配置表单组件 (固定模式)
• 2.4 实现一次性佣金配置表单组件 (梯度模式)
• 2.5 实现强制充值配置表单组件
• 2.6 实现时效配置表单组件 (永久/固定日期/相对时长)
• 2.7 添加一次性佣金配置的表单验证逻辑
• 2.8 更新套餐系列详情展示 - 显示完整的一次性佣金配置

3. 系列分配管理页面适配

• 3.1 更新系列分配列表 - 适配新的响应字段结构
• 3.2 移除基础返佣配置表单（旧版）
• 3.3 实现新的系列分配表单 - 强制充值配置
• 3.4 实现新的系列分配表单 - 一次性佣金配置
• 3.5 更新系列分配详情展示 - 显示所有新字段
• 3.6 更新系列分配编辑表单 - 支持修改所有可选字段
• 3.7 添加表单验证逻辑 - 确保必填字段和逻辑一致性

4. 单套餐分配页面适配

• 4.1 更新单套餐分配列表 - 显示系列信息和分配者信息
• 4.2 更新列表筛选条件 - 新增系列分配ID和分配者店铺ID筛选
• 4.3 更新单套餐分配详情展示 - 显示所有新字段
• 4.4 移除列表中的"计算成本价"字段显示（已废弃）

5. 测试与验证

• 5.1 测试套餐系列的创建 - 包含一次性佣金配置（固定模式）
• 5.2 测试套餐系列的创建 - 包含一次性佣金配置（梯度模式）
• 5.3 测试套餐系列的编辑 - 修改一次性佣金配置
• 5.4 测试系列分配的创建 - 使用新的字段结构
• 5.5 测试系列分配的编辑 - 修改强制充值和一次性佣金参数
• 5.6 测试单套餐分配 - 验证系列关联字段正确显示
• 5.7 测试单套餐分配筛选 - 验证新增筛选参数工作正常
• 5.8 回归测试 - 确保所有现有功能仍然正常工作

6. 文档与清理

• 6.1 更新类型定义文件的注释 - 标注新增/修改的字段
• 6.2 删除废弃的类型定义和相关代码
• 6.3 更新相关组件的注释文档
• 6.4 记录API变更影响和迁移说明（如需要）