# 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. **前端组件变更**:
   - 表单需要支持基础佣金配置和梯度返佣配置
   - 表格列需要显示新的佣金信息