one-pipe-system/openspec/changes/update-package-allocation-expiry-base-override/specs/shop-series-grant-packages/spec.md

ADDED Requirements

Requirement: Series Grant Package Expiry Base Visibility

The series grant package list and package edit context SHALL display the package allocation's default expiry base, override expiry base, and effective expiry base using the Chinese name fields returned by the backend.

Scenario: Display expiry bases in series grant package list

• GIVEN 用户进入代理系列授权套餐列表
• WHEN 已授权套餐记录返回默认、覆盖和最终生效条件字段
• THEN 页面 MUST display the default expiry base name, override expiry base name, and effective expiry base name for the package allocation

Scenario: Display expiry bases in package edit context

• GIVEN 用户打开代理系列授权中已授权套餐的编辑弹框
• WHEN 套餐分配数据加载完成
• THEN 页面 MUST display the default expiry base name, override expiry base name, and effective expiry base name
• AND 页面 MUST display 仅影响后续新订单，不影响已购买套餐

Requirement: Series Grant Package Expiry Base Editing

The series grant package edit context SHALL provide 跟随套餐默认, 购买即生效, and 实名即生效 options, then update the corresponding package allocation record through the package allocation expiry-base API.

Scenario: Edit override from series grant package list

• GIVEN 用户正在代理系列授权套餐列表编辑已授权套餐
• WHEN 用户选择生效条件并保存
• THEN 系统 MUST use the corresponding package allocation record ID to call PATCH /api/admin/shop-package-allocations/{id}/expiry-base
• AND 选择“跟随套餐默认”时请求 MUST explicitly contain expiry_base_override: null

Scenario: Refresh effective value after editing

• WHEN 代理系列授权套餐的生效条件更新成功
• THEN 页面 MUST refresh the relevant package allocation data
• AND 页面 MUST display the latest backend returned effective expiry base name