33 lines
1.9 KiB
Markdown
33 lines
1.9 KiB
Markdown
# Change: 支持套餐分配生效条件覆盖
|
|
|
|
## Why
|
|
|
|
代理套餐分配目前只能使用套餐本身的默认生效条件，运营无法针对某个店铺套餐授权选择购买即生效或实名即生效。分配页也无法区分套餐默认值、分配覆盖值和最终实际生效值，容易误解后续订单的生效规则。
|
|
|
|
## What Changes
|
|
|
|
- 在套餐授权/分配和已分配套餐编辑入口增加“生效条件”单选：跟随套餐默认、购买即生效、实名即生效。
|
|
- 新建分配时调用 `POST /api/admin/shop-package-allocations`，明确传递 `expiry_base_override`；选择“跟随套餐默认”时 MUST 显式传递 `null`，不得省略字段。
|
|
- 已分配套餐修改生效条件时调用 `PATCH /api/admin/shop-package-allocations/{id}/expiry-base`，请求体为 `expiry_base_override:null|from_purchase|from_realname`。
|
|
- 在分配详情、编辑弹框和代理系列授权套餐列表展示后端返回的默认生效条件、覆盖生效条件和最终生效条件的中文名称。
|
|
- 修改弹框提示“仅影响后续新订单，不影响已购买套餐”。
|
|
- 前端不根据默认值和覆盖值自行计算最终生效条件，直接使用后端返回的 `effective_expiry_base` 及其名称字段。
|
|
|
|
## Impact
|
|
|
|
- Affected specs:
|
|
- `shop-package-allocation`
|
|
- `shop-series-grant-packages`
|
|
- Affected code:
|
|
- `src/types/api/packageManagement.ts`
|
|
- 新增或扩展 `src/api/modules` 中的店铺套餐分配服务
|
|
- `src/views/package-management/series-grants/index.vue`
|
|
- `src/views/package-management/series-grants/packages.vue`
|
|
- `src/views/package-management/series-grants/detail.vue`
|
|
- API contracts:
|
|
- `POST /api/admin/shop-package-allocations`
|
|
- `PATCH /api/admin/shop-package-allocations/{id}/expiry-base`
|
|
- Out of scope:
|
|
- 已购买套餐或历史订单的生效条件迁移
|
|
- 前端根据分配字段推导或覆盖实际生效条件
|