# Capability: 店铺返佣梯度管理

**❌ CAPABILITY REMOVED** - 此 capability 已完全废弃

## Purpose

本 capability 定义代理如何为套餐系列分配配置和管理梯度返佣，包括添加、查询、更新和删除梯度配置。

**废弃原因**: 整个店铺返佣梯度管理 capability 被废弃。梯度返佣功能与一次性梯度佣金功能重复，且梯度返佣从未实现实际的佣金计算逻辑。系统简化为只支持基础返佣（成本价差）和一次性佣金两种机制。

**迁移指引**:
- 使用一次性佣金的梯度模式 (OneTimeCommissionConfig.type = "tiered") 替代
- 一次性佣金支持按销售数量 (tier_type = "sales_count") 或销售金额 (tier_type = "sales_amount") 设置梯度
- 一次性佣金每张卡/设备只触发一次，达到阈值后自动发放
- 删除所有梯度佣金配置相关的 API 端点：
  - `POST /api/shop-series-allocations/:id/tiers` (添加梯度配置)
  - `GET /api/shop-series-allocations/:id/tiers` (查询梯度配置)
  - `PUT /api/shop-series-commission-tiers/:id` (更新梯度配置)
  - `DELETE /api/shop-series-commission-tiers/:id` (删除梯度配置)

---

## REMOVED Requirements

### Requirement: 配置梯度佣金

**❌ REMOVED**

系统 SHALL 允许代理为套餐系列分配配置梯度佣金。每个梯度包含：梯度类型（销量/销售额）、周期类型（月度/季度/年度）、阈值、达标后的返佣配置（返佣模式和返佣值）。

#### Scenario: 添加销量梯度佣金
- **WHEN** 代理为分配添加梯度：类型=销量，周期=月度，阈值=100，返佣模式=百分比，返佣值=300（30%）
- **THEN** 系统创建梯度配置，当下级月销量达到 100 时，返佣提升到 30%

#### Scenario: 添加销售额梯度佣金
- **WHEN** 代理添加梯度：类型=销售额，周期=季度，阈值=100000分，返佣模式=固定，返佣值=3000分（30元）
- **THEN** 系统创建梯度配置，当下级季度销售额达到 1000 元时，返佣提升到固定 30 元

#### Scenario: 添加多个梯度档位
- **WHEN** 代理为同一分配添加多个梯度（如：100件=30%，200件=40%，500件=50%）
- **THEN** 系统创建多个梯度记录，支持阶梯提升

---

### Requirement: 查询梯度佣金配置

**❌ REMOVED**

系统 SHALL 提供梯度佣金配置的查询功能，按分配 ID 查询，返回结果按阈值升序排列。

#### Scenario: 查询分配的梯度配置
- **WHEN** 代理查询指定分配的梯度配置
- **THEN** 系统返回该分配下的所有梯度配置，按阈值升序排列

#### Scenario: 分配无梯度配置
- **WHEN** 代理查询一个没有配置梯度的分配
- **THEN** 系统返回空列表

---

### Requirement: 更新梯度佣金配置

**❌ REMOVED**

系统 SHALL 允许代理更新梯度配置的阈值和返佣配置。

#### Scenario: 更新梯度阈值
- **WHEN** 代理将梯度阈值从 100 改为 150
- **THEN** 系统更新梯度记录

#### Scenario: 更新梯度返佣配置
- **WHEN** 代理将返佣配置从百分比300（30%）改为百分比400（40%）
- **THEN** 系统更新梯度记录

---

### Requirement: 删除梯度佣金配置

**❌ REMOVED**

系统 SHALL 允许代理删除梯度配置。

#### Scenario: 删除梯度配置
- **WHEN** 代理删除指定的梯度配置
- **THEN** 系统软删除该梯度记录