# Capability: 店铺返佣梯度管理

## Purpose

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

## Requirements

### Requirement: 配置梯度佣金

系统 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: 查询梯度佣金配置

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

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

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

---

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

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

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

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

---

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

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

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