## ADDED Requirements

### Requirement: 配置梯度佣金

系统 SHALL 允许代理为套餐系列分配配置梯度佣金。每个梯度包含：梯度类型（销量/销售额）、周期类型、阈值、佣金金额。

#### Scenario: 添加销量梯度佣金
- **WHEN** 代理为分配添加梯度：类型=销量，周期=月度，阈值=100，佣金=5000分
- **THEN** 系统创建梯度配置，当下级月销量达到 100 时可获得 50 元佣金

#### Scenario: 添加销售额梯度佣金
- **WHEN** 代理添加梯度：类型=销售额，周期=季度，阈值=100000分，佣金=10000分
- **THEN** 系统创建梯度配置，当下级季度销售额达到 1000 元时可获得 100 元佣金

#### Scenario: 配置自定义周期
- **WHEN** 代理添加梯度，周期类型=自定义，指定开始和结束日期
- **THEN** 系统创建梯度配置，统计指定日期范围内的数据

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

---

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

系统 SHALL 提供梯度佣金配置的查询功能，按分配 ID 查询。

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

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

---

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

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

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

#### Scenario: 更新梯度佣金金额
- **WHEN** 代理将佣金金额从 5000 改为 6000
- **THEN** 系统更新梯度记录

---

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

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

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

---

### Requirement: 梯度佣金周期类型

系统 MUST 支持以下周期类型：
- monthly：月度（当月 1 日至月末）
- quarterly：季度（当季第一天至最后一天）
- yearly：年度（1 月 1 日至 12 月 31 日）
- custom：自定义（指定开始和结束日期）

#### Scenario: 月度周期
- **WHEN** 配置月度周期的梯度
- **THEN** 统计范围为当月 1 日 00:00:00 至月末 23:59:59

#### Scenario: 自定义周期必填日期
- **WHEN** 代理选择自定义周期但未提供开始或结束日期
- **THEN** 系统返回参数验证错误
