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

Change: 更新套餐系列分配佣金系统

Why

当前套餐系列分配使用简单的定价模式(固定加价/百分比加价)和一次性佣金配置,不支持复杂的返佣规则。新的业务需求要求支持:

• 基础返佣配置(固定金额或百分比)
• 梯度返佣系统(根据销量或销售额分档返佣)
• 更灵活的佣金计算模型

What Changes

BREAKING - 完全重构套餐系列分配的数据模型和API接口:

• 移除旧的定价字段: pricing_mode, pricing_value, calculated_cost_price
• 移除旧的一次性佣金字段: one_time_commission_trigger, one_time_commission_threshold, one_time_commission_amount
• 新增基础返佣配置: base_commission (包含 mode 和 value)
• 新增梯度返佣开关: enable_tier_commission
• 新增梯度返佣配置: tier_config (可选,当启用梯度返佣时需要)
• 响应数据结构从 items 改为 list (符合后端统一规范)
• 更新所有相关的创建/更新接口以支持新的佣金模型

Impact

• 影响模块: 套餐系列分配 (/package-management/series-assign)
• 受影响文件:
  • src/types/api/packageManagement.ts - TypeScript类型定义
  • src/api/modules/shopSeriesAllocation.ts - API服务层
  • src/views/package-management/series-assign/index.vue - 前端页面
• 数据迁移: 需要后端提供数据迁移方案,将旧的定价数据转换为新的佣金配置
• 向后兼容性: 不兼容,需要前后端同时部署

Breaking Changes

1. API响应结构变更:

   • 列表接口响应从 { items, page, page_size, total } 改为 { list, page, page_size, total, total_pages }
   • 移除 pricing_mode, pricing_value, calculated_cost_price 字段
   • 移除一次性佣金相关字段
   • 新增 base_commission, enable_tier_commission 字段

2. API请求结构变更:

   • 创建/更新接口需要新的 base_commission 对象
   • 支持可选的 enable_tier_commission 和 tier_config

3. 前端组件变更:

   • 表单需要支持基础佣金配置和梯度返佣配置
   • 表格列需要显示新的佣金信息