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