fetch(add): 订单管理-企业设备

2026-01-29 15:43:45 +08:00
parent 1812b7a6c4
commit 841cf0442b
58 changed files with 8948 additions and 1164 deletions
--- a/openspec/changes/add-package-management-system/specs/package-series-management/spec.md
+++ b/openspec/changes/add-package-management-system/specs/package-series-management/spec.md
@@ -0,0 +1,116 @@
+# 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无权访问错误