# Package Management Specification

## ADDED Requirements

### Requirement: 套餐列表查询

系统 SHALL 提供套餐列表查询功能，支持分页和多条件筛选。

#### Scenario: 查询所有套餐

- **WHEN** 用户访问套餐管理页面
- **THEN** 系统显示套餐列表，包含套餐编码、套餐名称、系列ID、套餐类型、流量、价格、状态、上架状态等
- **AND** 支持按套餐名称模糊搜索
- **AND** 支持按系列ID筛选
- **AND** 支持按状态筛选（启用/禁用）
- **AND** 支持按上架状态筛选（上架/下架）
- **AND** 支持按套餐类型筛选（formal/addon）
- **AND** 支持分页，每页最多100条记录

#### Scenario: 多条件组合查询

- **WHEN** 用户同时使用多个筛选条件
- **THEN** 系统返回满足所有条件的套餐列表

### Requirement: 创建套餐

系统 SHALL 允许管理员创建新的套餐。

#### Scenario: 成功创建套餐

- **WHEN** 用户填写必填字段（套餐编码、套餐名称、套餐类型、套餐时长、套餐价格）
- **AND** 可选填写系列ID、流量信息、成本价、建议售价等
- **AND** 提交表单
- **THEN** 系统创建套餐，默认状态为启用，默认上架状态为下架
- **AND** 返回创建的套餐详情

#### Scenario: 套餐编码唯一性验证

- **WHEN** 用户使用已存在的套餐编码创建套餐
- **THEN** 系统返回错误提示"套餐编码已存在"

#### Scenario: 验证套餐时长范围

- **WHEN** 套餐时长小于1个月或大于120个月
- **THEN** 系统返回验证错误"套餐时长必须在1-120个月之间"

#### Scenario: 流量类型与流量额度关系

- **WHEN** 流量类型为真流量（real）
- **THEN** 真流量额度（real_data_mb）必须大于0
- **AND** 总流量额度（data_amount_mb）等于真流量额度

- **WHEN** 流量类型为虚流量（virtual）
- **THEN** 虚流量额度（virtual_data_mb）必须大于0
- **AND** 真流量额度和虚流量额度之和等于总流量额度

### Requirement: 查看套餐详情

系统 SHALL 允许用户查看单个套餐的详细信息。

#### Scenario: 查询存在的套餐

- **WHEN** 用户通过套餐ID查询详情
- **THEN** 系统返回该套餐的完整信息，包括所有字段

#### Scenario: 查询不存在的套餐

- **WHEN** 用户查询不存在的套餐ID
- **THEN** 系统返回404错误

### Requirement: 更新套餐

系统 SHALL 允许管理员更新套餐信息。

#### Scenario: 成功更新套餐

- **WHEN** 用户修改套餐的可变字段（名称、时长、价格、流量等）
- **AND** 提交更新
- **THEN** 系统更新套餐信息
- **AND** 返回更新后的套餐详情

#### Scenario: 套餐编码不可修改

- **WHEN** 用户尝试修改套餐编码
- **THEN** 系统忽略该字段，不允许修改

### Requirement: 删除套餐

系统 SHALL 允许管理员删除套餐。

#### Scenario: 成功删除套餐

- **WHEN** 用户删除未被使用的套餐
- **THEN** 系统删除该套餐
- **AND** 返回成功状态

#### Scenario: 删除被分配的套餐

- **WHEN** 用户删除已被分配给代理商的套餐
- **THEN** 系统返回错误提示"该套餐已被分配，无法删除"

### Requirement: 套餐状态管理

系统 SHALL 支持套餐启用/禁用状态管理。

#### Scenario: 启用套餐

- **WHEN** 用户将禁用状态的套餐切换为启用
- **THEN** 系统更新状态为启用（status=1）

#### Scenario: 禁用套餐

- **WHEN** 用户将启用状态的套餐切换为禁用
- **THEN** 系统更新状态为禁用（status=2）
- **AND** 该套餐将不可用于新的分配或充值

### Requirement: 套餐上架状态管理

系统 SHALL 支持套餐上架/下架状态管理。

#### Scenario: 上架套餐

- **WHEN** 用户将下架状态的套餐切换为上架
- **THEN** 系统更新上架状态为上架（shelf_status=1）
- **AND** 该套餐将对代理商可见

#### Scenario: 下架套餐

- **WHEN** 用户将上架状态的套餐切换为下架
- **THEN** 系统更新上架状态为下架（shelf_status=2）
- **AND** 该套餐将对代理商不可见

### Requirement: 套餐类型支持

系统 SHALL 支持两种套餐类型。

#### Scenario: 正式套餐

- **WHEN** 创建套餐类型为 formal 的套餐
- **THEN** 系统记录为正式套餐

#### Scenario: 附加套餐

- **WHEN** 创建套餐类型为 addon 的套餐
- **THEN** 系统记录为附加套餐

### Requirement: 权限控制

系统 SHALL 对套餐管理功能实施权限控制。

#### Scenario: 未认证用户访问

- **WHEN** 未登录用户访问套餐管理接口
- **THEN** 系统返回401未认证错误

#### Scenario: 无权限用户访问

- **WHEN** 已登录但无权限的用户访问套餐管理接口
- **THEN** 系统返回403无权访问错误