fetch(modify):修改原来的bug

openspec/changes/update-series-allocation-commission/design.md

@@ -2,12 +2,14 @@
 
 ## Context
 
-当前系统使用简单的定价模式(pricing_mode/pricing_value)和一次性佣金(one_time_commission_*)来管理套餐系列分配。随着业务发展,需要更复杂的佣金系统:
+当前系统使用简单的定价模式(pricing*mode/pricing_value)和一次性佣金(one_time_commission*\*)来管理套餐系列分配。随着业务发展,需要更复杂的佣金系统:
+
 - 支持基础返佣(固定金额或百分比)
 - 支持梯度返佣(根据销量或销售额分档返佣)
 - 更清晰的数据模型和API接口
 
 **背景约束**:
+
 - 前后端需要同步部署(Breaking Change)
 - 需要数据迁移方案
 - 影响现有的套餐系列分配功能
@@ -15,12 +17,14 @@
 ## Goals / Non-Goals
 
 **Goals**:
+
 - 实现新的佣金配置模型,支持基础返佣和梯度返佣
 - 提供清晰的UI界面让用户配置复杂的返佣规则
 - 保证数据一致性和类型安全
 - 提供良好的用户体验(表单验证、错误提示)
 
 **Non-Goals**:
+
 - 不处理历史数据的完整性验证(由后端负责)
 - 不实现佣金计算逻辑(由后端负责)
 - 不处理佣金结算流程(属于其他模块)
@@ -32,11 +36,13 @@
 **决策**: 采用嵌套对象结构表示佣金配置
 
 **理由**:
+
 - `base_commission: { mode, value }` - 清晰表达基础返佣的两个维度
 - `tier_config: { period_type, tier_type, tiers[] }` - 梯度配置与基础配置分离,可选性强
 - `tiers: [{ threshold, mode, value }]` - 每个档位都有独立的返佣模式和值
 
 **替代方案考虑**:
+
 - ❌ 平铺所有字段 - 会导致字段过多,语义不清晰
 - ❌ 使用JSON字符串存储配置 - 失去类型安全,不利于表单编辑
 
@@ -45,6 +51,7 @@
 **决策**: 使用渐进式表单设计
 
 **表单结构**:
+
 ```
 1. 基础返佣配置 (必填)
    - 返佣模式: 单选 (固定金额/百分比)
@@ -63,11 +70,13 @@
 ```
 
 **理由**:
+
 - 渐进式设计降低初始复杂度
 - 只有启用梯度返佣时才显示相关配置
 - 动态档位列表提供灵活性
 
 **替代方案考虑**:
+
 - ❌ 全部平铺展示 - 对不需要梯度返佣的用户造成困扰
 - ❌ 使用向导模式 - 增加操作步骤,不适合编辑场景
 
@@ -76,7 +85,9 @@
 **决策**: 分层验证 + 条件验证
 
 **验证规则**:
+
 1. 基础返佣配置:
+
    - mode: 必选
    - value: 必填,>= 0
 
@@ -91,6 +102,7 @@
    - 档位阈值必须递增
 
 **实现方式**:
+
 - 使用 Element Plus 的表单验证
 - 自定义validator处理档位阈值递增验证
 - 使用 computed 动态生成验证规则
@@ -100,11 +112,13 @@
 **决策**: 统一使用 `list` 字段名,添加适配层
 
 **理由**:
+
 - 后端统一规范使用 `list` 而非 `items`
 - 添加 `total_pages` 字段提供更完整的分页信息
 - 保持前端代码与后端规范一致
 
 **迁移策略**:
+
 ```typescript
 // Before
 const res = await getShopSeriesAllocations(params)
@@ -122,6 +136,7 @@ allocationList.value = res.data.list || []
 **风险**: 前后端必须同时部署,否则会出现接口不兼容
 
 **缓解措施**:
+
 - 与后端团队协调部署窗口
 - 准备回退方案(前端代码分支)
 - 在测试环境充分验证
@@ -131,6 +146,7 @@ allocationList.value = res.data.list || []
 **风险**: 梯度返佣配置较复杂,用户可能不理解
 
 **缓解措施**:
+
 - 提供清晰的字段说明
 - 添加示例或帮助文档链接
 - 使用默认值简化初次配置
@@ -140,6 +156,7 @@ allocationList.value = res.data.list || []
 **风险**: 旧数据无法完全转换为新模型
 
 **缓解措施**:
+
 - 要求后端提供数据迁移脚本和验证
 - 在迁移后检查数据完整性
 - 保留旧数据备份
@@ -147,22 +164,26 @@ allocationList.value = res.data.list || []
 ## Migration Plan
 
 ### Phase 1: 准备阶段
+
 1. 与后端确认API变更细节和时间表
 2. 在开发环境实现前端变更
 3. 与后端在测试环境联调
 
 ### Phase 2: 测试阶段
+
 1. 功能测试: 创建、编辑、删除、列表展示
 2. 集成测试: 与后端API集成
 3. 用户验收测试: 业务人员验证
 
 ### Phase 3: 部署阶段
+
 1. 准备回退方案
 2. 与后端协调部署窗口
 3. 同步部署前后端
 4. 验证生产环境功能
 
 ### Phase 4: 监控阶段
+
 1. 监控API错误率
 2. 收集用户反馈
 3. 修复遗留问题
@@ -170,6 +191,7 @@ allocationList.value = res.data.list || []
 ### Rollback Plan
 
 如果部署后发现严重问题:
+
 1. 前端回退到上一版本
 2. 后端回退API(如果可能)
 3. 通知用户暂时不可用
@@ -178,12 +200,15 @@ allocationList.value = res.data.list || []
 ## Open Questions
 
 1. **Q**: 梯度返佣的档位数量是否有上限?
+
    - **A**: 待后端确认,前端可以先不限制或设置合理上限(如10个)
 
 2. **Q**: 返佣值的单位和精度如何处理?
+
    - **A**: 固定金额使用"分"为单位,百分比使用千分比(如200=20%),待后端确认
 
 3. **Q**: 是否需要在列表页显示梯度返佣信息?
+
    - **A**: 暂时只显示基础返佣,梯度信息在详情或编辑时查看
 
 4. **Q**: 旧数据如何映射到新模型?

openspec/changes/update-series-allocation-commission/proposal.md

@@ -3,6 +3,7 @@
 ## Why
 
 当前套餐系列分配使用简单的定价模式(固定加价/百分比加价)和一次性佣金配置,不支持复杂的返佣规则。新的业务需求要求支持:
+
 - 基础返佣配置(固定金额或百分比)
 - 梯度返佣系统(根据销量或销售额分档返佣)
 - 更灵活的佣金计算模型
@@ -32,12 +33,14 @@
 ## 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`
 

openspec/changes/update-series-allocation-commission/specs/package-series-allocation/spec.md

@@ -129,15 +129,17 @@
 **Reason**: 旧的定价模式 (pricing_mode, pricing_value) 已被新的佣金模型替代
 
 **Migration**: 旧数据通过后端迁移脚本转换为基础返佣配置:
+
 - pricing_mode="fixed" → base_commission.mode="fixed"
 - pricing_mode="percentage" → base_commission.mode="percent"
 - pricing_value → base_commission.value (需要单位转换)
 
 ### Requirement: 一次性佣金配置
 
-**Reason**: 一次性佣金配置 (one_time_commission_*) 已被梯度返佣系统替代
+**Reason**: 一次性佣金配置 (one*time_commission*\*) 已被梯度返佣系统替代
 
 **Migration**: 旧的一次性佣金通过以下方式迁移:
+
 - 如果设置了一次性佣金,转换为单档位的梯度返佣
 - trigger → tier_type mapping (first_activation → sales_count, cumulative_recharge → sales_amount)
 - threshold → tiers[0].threshold
@@ -165,7 +167,7 @@
 
 - **WHEN** base_commission.mode = "percent"
 - **THEN** base_commission.value 表示返佣百分比的千分比 (如200表示20%)
-- **AND** 每笔交易返佣 = 交易金额 * (value / 1000)
+- **AND** 每笔交易返佣 = 交易金额 \* (value / 1000)
 
 ### Requirement: 梯度返佣配置