feat: 接入新参数：套餐分配生效条件选择，资产详情前代后代换货标识

openspec/changes/update-package-allocation-expiry-base-override/specs/shop-package-allocation/spec.md

@@ -2,7 +2,7 @@
 
 ### Requirement: Package Allocation Expiry Base Override Contract
 
-The shop package allocation contract SHALL support an explicit `expiry_base_override` when creating or updating an allocation. The allowed request values MUST be `null`, `from_purchase`, and `from_realname`.
+The shop package allocation contract SHALL support an explicit `expiry_base_override` when creating or updating an allocation. The allowed request values MUST be `null`, `from_purchase`, and `from_activation`. The frontend MUST NOT send `from_realname`.
 
 #### Scenario: Create allocation following the package default
 
@@ -18,11 +18,11 @@ The shop package allocation contract SHALL support an explicit `expiry_base_over
 - **WHEN** 用户创建店铺套餐分配
 - **THEN** 请求 MUST contain `expiry_base_override: "from_purchase"`
 
-#### Scenario: Create allocation with realname activation override
+#### Scenario: Create allocation with activation override
 
-- **GIVEN** 用户在套餐授权/分配弹框选择“实名即生效”
+- **GIVEN** 用户在套餐授权/分配弹框选择“实名激活时生效”
 - **WHEN** 用户创建店铺套餐分配
-- **THEN** 请求 MUST contain `expiry_base_override: "from_realname"`
+- **THEN** 请求 MUST contain `expiry_base_override: "from_activation"`
 
 ### Requirement: Package Allocation Expiry Base Update
 
@@ -31,7 +31,7 @@ The system SHALL update an existing package allocation's expiry-base override th
 #### Scenario: Update allocation expiry base override
 
 - **GIVEN** 用户正在编辑已分配套餐的生效条件
-- **WHEN** 用户选择“购买即生效”或“实名即生效”并保存
+- **WHEN** 用户选择“购买即生效”或“实名激活时生效”并保存
 - **THEN** 系统 MUST call `PATCH /api/admin/shop-package-allocations/{id}/expiry-base`
 - **AND** 请求体 MUST contain the selected `expiry_base_override`
 
@@ -41,6 +41,13 @@ The system SHALL update an existing package allocation's expiry-base override th
 - **WHEN** 用户选择“跟随套餐默认”并保存
 - **THEN** 请求体 MUST explicitly contain `expiry_base_override: null`
 
+#### Scenario: Use activation override enum
+
+- **GIVEN** 用户在已分配套餐编辑弹框选择“实名激活时生效”
+- **WHEN** 用户保存生效条件
+- **THEN** 请求体 MUST contain `expiry_base_override: "from_activation"`
+- **AND** 请求体 MUST NOT contain `expiry_base_override: "from_realname"`
+
 ### Requirement: Package Allocation Expiry Base Resolution Response
 
 The package allocation response SHALL provide `default_expiry_base`, `expiry_base_override`, and `effective_expiry_base`, together with their corresponding Chinese name fields. The frontend MUST render the returned effective value and name without calculating it from other fields.
@@ -59,6 +66,13 @@ The package allocation response SHALL provide `default_expiry_base`, `expiry_bas
 - **THEN** 页面 MUST display the backend returned `effective_expiry_base_name`
 - **AND** 前端 MUST NOT calculate or replace the effective value from the default value and override value
 
+#### Scenario: Display null override as following package default
+
+- **GIVEN** 分配响应的 `expiry_base_override` 为 `null`
+- **WHEN** 页面展示覆盖生效条件
+- **THEN** 页面 MUST use `expiry_base_override_name` when it is returned
+- **AND** 页面 MUST display “跟随套餐默认” when the returned override name is empty or null
+
 ### Requirement: Package Allocation Expiry Base Applies Prospectively
 
 The package allocation expiry-base override SHALL apply only to future new orders. The allocation creation and editing UI MUST inform the user that purchased packages are unaffected.
@@ -72,3 +86,19 @@ The package allocation expiry-base override SHALL apply only to future new order
 
 - **WHEN** 用户创建、更新或恢复套餐分配的生效条件
 - **THEN** 前端 MUST NOT attempt to update existing purchased packages or historical orders
+
+### Requirement: Package Allocation Response Field Contract
+
+All package allocation and package response objects involved in allocation management SHALL preserve the six expiry-base fields returned by the backend: `default_expiry_base`, `default_expiry_base_name`, `expiry_base_override`, `expiry_base_override_name`, `effective_expiry_base`, and `effective_expiry_base_name`.
+
+#### Scenario: Preserve six expiry-base fields in allocation responses
+
+- **WHEN** 前端接收套餐分配创建、更新、详情或列表响应
+- **THEN** 前端类型 MUST support all six expiry-base fields
+- **AND** 页面 MUST use backend-provided `*_name` fields for display
+
+#### Scenario: Preserve six expiry-base fields in package responses
+
+- **WHEN** 前端接收套餐列表、套餐详情、套餐创建或套餐更新响应
+- **THEN** 前端类型 MUST support all six expiry-base fields when returned by the API
+- **AND** 前端 MUST NOT infer allocation effective expiry behavior from package default fields

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

@@ -19,7 +19,7 @@ The series grant package list and package edit context SHALL display the package
 
 ### 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.
+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
 
@@ -28,6 +28,44 @@ The series grant package edit context SHALL provide `跟随套餐默认`, `购
 - **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`
 
+### Requirement: Series Grant Creation Expiry Base Contract
+
+The series grant creation and package addition flows SHALL explicitly send one shared `expiry_base_override` for all newly created package allocations. The allowed values MUST be `null`, `from_purchase`, and `from_activation`.
+
+#### Scenario: Create series grant with shared expiry base override
+
+- **WHEN** 前端调用 `POST /api/admin/shop-series-grants`
+- **THEN** 请求 MUST explicitly contain `expiry_base_override`
+- **AND** the selected value MUST apply to all package allocations created by the initial authorization
+
+#### Scenario: Add packages to existing series grant with shared expiry base override
+
+- **WHEN** 前端调用 `PUT /api/admin/shop-series-grants/{id}/packages` to add packages
+- **THEN** 请求 MUST explicitly contain `expiry_base_override`
+- **AND** the selected value MUST apply only to the newly added package allocations
+- **AND** modifying or deleting existing packages MUST NOT change their historical override values
+
+#### Scenario: Restore default during series grant creation or package addition
+
+- **WHEN** 用户选择“跟随套餐默认”
+- **THEN** 请求 MUST explicitly contain `expiry_base_override: null`
+- **AND** 请求 MUST NOT omit the field to represent the default
+
+### Requirement: Batch Package Allocation Expiry Base Contract
+
+The batch package allocation flow SHALL apply one explicitly selected `expiry_base_override` to all allocations created by the batch request.
+
+#### Scenario: Create batch allocations with shared expiry base
+
+- **WHEN** 前端调用 `POST /api/admin/shop-package-batch-allocations`
+- **THEN** 请求 MUST explicitly contain `expiry_base_override`
+- **AND** all returned `data.allocations[]` items MUST preserve the allocation ID and six expiry-base fields
+
+#### Scenario: Batch allocation follows package default
+
+- **WHEN** 用户在批量分配中选择“跟随套餐默认”
+- **THEN** 请求 MUST explicitly contain `expiry_base_override: null`
+
 #### Scenario: Refresh effective value after editing
 
 - **WHEN** 代理系列授权套餐的生效条件更新成功