## ADDED Requirements

### Requirement: 创建套餐系列

系统 SHALL 允许平台管理员创建套餐系列，包含系列编码、系列名称、描述信息。系列编码 MUST 全局唯一（排除已删除记录）。新创建的套餐系列默认为启用状态。

#### Scenario: 成功创建套餐系列
- **WHEN** 管理员提交有效的套餐系列信息（系列编码、系列名称）
- **THEN** 系统创建套餐系列记录，返回创建的套餐系列详情，状态为启用(1)

#### Scenario: 系列编码重复
- **WHEN** 管理员提交的系列编码已存在（未删除）
- **THEN** 系统返回错误 "系列编码已存在"

#### Scenario: 缺少必填字段
- **WHEN** 管理员未提供系列编码或系列名称
- **THEN** 系统返回参数验证错误

---

### Requirement: 查询套餐系列列表

系统 SHALL 提供套餐系列列表查询功能，支持按系列名称模糊搜索、按状态筛选。结果 MUST 分页返回，按创建时间倒序排列。

#### Scenario: 查询所有套餐系列
- **WHEN** 管理员请求套餐系列列表，不带筛选条件
- **THEN** 系统返回所有未删除的套餐系列，分页显示

#### Scenario: 按名称搜索
- **WHEN** 管理员提供系列名称关键字
- **THEN** 系统返回名称包含该关键字的套餐系列

#### Scenario: 按状态筛选
- **WHEN** 管理员指定状态筛选（启用/禁用）
- **THEN** 系统只返回匹配状态的套餐系列

---

### Requirement: 查询套餐系列详情

系统 SHALL 允许管理员查询单个套餐系列的详细信息。

#### Scenario: 查询存在的套餐系列
- **WHEN** 管理员请求指定 ID 的套餐系列详情
- **THEN** 系统返回该套餐系列的完整信息

#### Scenario: 查询不存在的套餐系列
- **WHEN** 管理员请求不存在或已删除的套餐系列 ID
- **THEN** 系统返回 "套餐系列不存在" 错误

---

### Requirement: 更新套餐系列

系统 SHALL 允许管理员更新套餐系列的基本信息（系列名称、描述）。系列编码创建后 MUST NOT 允许修改。

#### Scenario: 成功更新套餐系列
- **WHEN** 管理员提交有效的更新信息
- **THEN** 系统更新套餐系列记录，返回更新后的详情

#### Scenario: 尝试修改系列编码
- **WHEN** 管理员尝试修改系列编码
- **THEN** 系统忽略系列编码字段，不进行修改

#### Scenario: 更新不存在的套餐系列
- **WHEN** 管理员更新不存在的套餐系列
- **THEN** 系统返回 "套餐系列不存在" 错误

---

### Requirement: 删除套餐系列

系统 SHALL 允许管理员删除套餐系列（软删除）。

#### Scenario: 成功删除套餐系列
- **WHEN** 管理员删除指定的套餐系列
- **THEN** 系统软删除该记录，后续查询不再返回

#### Scenario: 删除不存在的套餐系列
- **WHEN** 管理员删除不存在的套餐系列
- **THEN** 系统返回 "套餐系列不存在" 错误

---

### Requirement: 启用/禁用套餐系列

系统 SHALL 允许管理员切换套餐系列的启用状态。

#### Scenario: 启用套餐系列
- **WHEN** 管理员将禁用的套餐系列设置为启用
- **THEN** 系统更新状态为启用(1)

#### Scenario: 禁用套餐系列
- **WHEN** 管理员将启用的套餐系列设置为禁用
- **THEN** 系统更新状态为禁用(2)

#### Scenario: 状态未变化
- **WHEN** 管理员设置的状态与当前状态相同
- **THEN** 系统正常返回成功，不产生错误

---

### Requirement: 套餐系列一次性佣金规则配置

系统 SHALL 在套餐系列层面配置一次性佣金的完整规则，包括触发条件、阈值、金额/梯度、时效、强充配置。梯度配置（`commission_type=tiered`）中每个档位 MUST 支持通过 `operator` 字段设置阈值比较运算符（`>`、`>=`、`<`、`<=`），默认值为 `>=`。

#### Scenario: 配置首充规则

- **WHEN** 创建或更新套餐系列
- **AND** 设置一次性佣金规则：`trigger_type = first_recharge`，`threshold = 10000`（100元），`commission_amount = 2000`（20元）
- **THEN** 系统保存该规则配置

#### Scenario: 配置累计充值规则

- **WHEN** 创建或更新套餐系列
- **AND** 设置一次性佣金规则：`trigger_type = accumulated_recharge`，`threshold = 20000`（200元），`commission_amount = 4000`（40元）
- **THEN** 系统保存该规则配置

#### Scenario: 配置梯度规则（含 operator）

- **WHEN** 创建或更新套餐系列，`commission_type = tiered`
- **AND** 梯度配置包含 `operator` 字段：`[{operator: ">=" , dimension: "sales_count", stat_scope: "self", threshold: 100, amount: 1000}, {operator: "<", dimension: "sales_count", stat_scope: "self", threshold: 50, amount: 500}]`
- **THEN** 系统保存完整梯度配置（含 operator）
- **AND** 查询详情时响应中 `tiers` 包含 `operator` 字段

#### Scenario: 配置梯度规则（不传 operator，向后兼容）

- **WHEN** 创建或更新套餐系列，`commission_type = tiered`
- **AND** 梯度配置未提供 `operator` 字段：`[{dimension: "sales_count", stat_scope: "self", threshold: 100, amount: 1000}]`
- **THEN** 系统保存梯度配置，`operator` 存储为空值（计算引擎 fallback 到 `>=`）
- **AND** 查询详情时响应中 `tiers` 的 `operator` 字段不出现（omitempty）

#### Scenario: 查询系列详情包含规则

- **WHEN** 查询套餐系列详情
- **THEN** 返回完整的一次性佣金规则配置，梯度档位包含 `operator`、`dimension`、`stat_scope`、`threshold`、`amount`