fix: 代理系列授权店铺

openspec/changes/update-series-grant-package-edit-cost-price-consistency/specs/shop-series-grant-packages/spec.md

@@ -0,0 +1,45 @@
+## ADDED Requirements
+
+### Requirement: 编辑授权套餐弹窗必须回填当前成本价
+
+系统 SHALL 在编辑代理系列授权中的已授权套餐时，使用当前套餐记录中的成本价作为编辑弹窗的初始值。
+
+#### Scenario: 从套餐列表页编辑时回填列表中的成本价
+
+- **GIVEN** 用户进入代理系列授权套餐列表页
+- **AND** 某条已授权套餐记录的 `package_id` 为 `10`
+- **AND** 该记录当前 `cost_price` 为 `1234` 分
+- **WHEN** 用户点击该记录的“编辑”操作
+- **THEN** 系统打开编辑弹窗
+- **AND** 成本价输入框显示 `12.34` 元
+- **AND** 该回填值来自当前列表行数据而不是表单默认值
+
+#### Scenario: 编辑弹窗回填不依赖可选套餐列表预加载
+
+- **GIVEN** 用户进入代理系列授权中的套餐编辑入口
+- **AND** 当前页面尚未预先加载 `availablePackages`
+- **AND** 被编辑套餐记录当前 `cost_price` 为 `2560` 分
+- **WHEN** 用户打开编辑弹窗
+- **THEN** 系统仍然显示成本价输入框初始值为 `25.60` 元
+- **AND** 系统不得因为 `availablePackages` 为空而将初始值退回为 `0`
+
+### Requirement: 编辑授权套餐时必须提交用户修改后的成本价
+
+系统 SHALL 在保存代理系列授权中的已授权套餐时，将用户当前输入的成本价按“元转分”写入请求体。
+
+#### Scenario: 保存编辑后的成本价时按元转分提交
+
+- **GIVEN** 用户正在编辑 `package_id` 为 `10` 的已授权套餐
+- **AND** 编辑弹窗中的成本价初始值为 `12.34` 元
+- **WHEN** 用户将成本价修改为 `15.80` 元并点击保存
+- **THEN** 系统调用 `PUT /api/admin/shop-series-grants/{id}/packages`
+- **AND** 请求体中的 `packages[0].package_id` 为 `10`
+- **AND** 请求体中的 `packages[0].cost_price` 为 `1580`
+
+#### Scenario: 未清空输入时保存不得提交默认零值
+
+- **GIVEN** 用户正在编辑一条已有成本价的授权套餐
+- **AND** 成本价输入框中存在通过表单校验的非零值
+- **WHEN** 用户点击保存
+- **THEN** 系统提交的 `packages[0].cost_price` 必须等于当前输入值换算后的分值
+- **AND** 系统不得提交表单初始化默认值 `0`