117 lines
3.3 KiB
Markdown
117 lines
3.3 KiB
Markdown
# Package Series Management Specification
|
||
|
||
## ADDED Requirements
|
||
|
||
### Requirement: 套餐系列列表查询
|
||
|
||
系统 SHALL 提供套餐系列列表查询功能，支持分页和条件筛选。
|
||
|
||
#### Scenario: 查询所有套餐系列
|
||
|
||
- **WHEN** 用户访问套餐系列管理页面
|
||
- **THEN** 系统显示套餐系列列表，包含系列名称、系列编码、描述、状态、创建时间、更新时间
|
||
- **AND** 支持按系列名称模糊搜索
|
||
- **AND** 支持按状态筛选（启用/禁用）
|
||
- **AND** 支持分页，每页最多100条记录
|
||
|
||
#### Scenario: 空列表处理
|
||
|
||
- **WHEN** 没有符合条件的套餐系列
|
||
- **THEN** 系统显示空状态提示
|
||
|
||
### Requirement: 创建套餐系列
|
||
|
||
系统 SHALL 允许管理员创建新的套餐系列。
|
||
|
||
#### Scenario: 成功创建套餐系列
|
||
|
||
- **WHEN** 用户填写系列编码、系列名称（必填）
|
||
- **AND** 可选填写描述（最大500字符）
|
||
- **AND** 提交表单
|
||
- **THEN** 系统创建套餐系列，默认状态为启用
|
||
- **AND** 返回创建的套餐系列详情
|
||
|
||
#### Scenario: 系列编码重复
|
||
|
||
- **WHEN** 用户使用已存在的系列编码创建套餐系列
|
||
- **THEN** 系统返回错误提示"系列编码已存在"
|
||
|
||
#### Scenario: 验证系列名称长度
|
||
|
||
- **WHEN** 系列名称长度小于1或大于255个字符
|
||
- **THEN** 系统返回验证错误
|
||
|
||
### 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** 系统返回401未认证错误
|
||
|
||
#### Scenario: 无权限用户访问
|
||
|
||
- **WHEN** 已登录但无权限的用户访问套餐系列管理接口
|
||
- **THEN** 系统返回403无权访问错误
|