feat: 新增代理分配套餐上架状态(shelf_status)功能
All checks were successful
构建并部署到测试环境(无 SSH) / build-and-deploy (push) Successful in 6m56s

- 新增数据库迁移:为 shop_package_allocation 表添加 shelf_status 字段
- 更新模型/DTO:ShopPackageAllocation 增加 ShelfStatus 字段及相关枚举
- 更新套餐分配 Service:支持上架/下架状态管理逻辑
- 更新套餐 Store/Service:根据 shelf_status 过滤可售套餐
- 更新购买验证 Service:引入上架状态校验逻辑
- 归档 OpenSpec 变更:2026-03-02-agent-allocation-shelf-status
- 同步更新主规范文档:allocation-shelf-status、package-management、purchase-validation

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
2026-03-02 15:38:54 +08:00
parent 8efe79526a
commit 61155952a7
22 changed files with 677 additions and 44 deletions

View File

@@ -24,18 +24,36 @@
### Requirement: 验证套餐状态
创建订单前系统 MUST 验证套餐处于可购买状态。
创建订单前系统 MUST 验证套餐处于可购买状态。**校验逻辑因购买场景而不同**:通过代理渠道购买时检查代理分配记录的 shelf_status通过平台自营渠道购买时检查套餐全局 shelf_status。`Package.status`(启用/禁用)为全局开关,任何场景下都必须检查。
#### Scenario: 套餐启用且上架
- **WHEN** 套餐 status=1 且 shelf_status=1
- **THEN** 验证通过
#### Scenario: 代理渠道 - 套餐启用且代理上架
- **GIVEN** `Package.status=1`(启用),卖家代理的 `allocation.shelf_status=1`(上架)
- **WHEN** 客户通过该代理下单购买套餐
- **THEN** 套餐状态校验通过
#### Scenario: 套餐已禁用
- **WHEN** 套餐 status=2
#### Scenario: 代理渠道 - 套餐已禁用
- **GIVEN** `Package.status=2`(禁用)
- **WHEN** 客户通过任意代理下单购买套餐
- **THEN** 验证失败,返回 "套餐已禁用"
#### Scenario: 套餐已下架
- **WHEN** 套餐 shelf_status=2
#### Scenario: 代理渠道 - 代理已下架套餐
- **GIVEN** `Package.status=1`(启用),卖家代理的 `allocation.shelf_status=2`(代理下架)
- **WHEN** 客户通过该代理下单购买套餐
- **THEN** 验证失败,返回 "套餐已下架"
#### Scenario: 代理渠道 - 平台下架不影响代理销售
- **GIVEN** `Package.status=1`(启用),`Package.shelf_status=2`(平台下架),卖家代理的 `allocation.shelf_status=1`(代理上架)
- **WHEN** 客户通过该代理下单购买套餐
- **THEN** 套餐状态校验通过(平台 shelf_status 不参与代理渠道校验)
#### Scenario: 平台自营渠道 - 套餐启用且平台上架
- **GIVEN** `Package.status=1`(启用),`Package.shelf_status=1`(平台上架)
- **WHEN** 客户通过平台自营渠道下单购买套餐
- **THEN** 套餐状态校验通过
#### Scenario: 平台自营渠道 - 套餐已下架
- **GIVEN** `Package.status=1`(启用),`Package.shelf_status=2`(平台下架)
- **WHEN** 客户通过平台自营渠道下单购买套餐
- **THEN** 验证失败,返回 "套餐已下架"
---