junhong_cmp_fiber/openspec/changes/archive/2026-03-02-agent-allocation-shelf-status/specs/package-management/spec.md at 86f8d0b64425920bec948a55f0d9b89a2bf2b77c

csxj2026/junhong_cmp_fiber

Files

构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 6m56s

Details

- 新增数据库迁移：为 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>

2026-03-02 15:38:54 +08:00

1.9 KiB

Raw Blame History

MODIFIED Requirements

Requirement: 上架/下架套餐

系统 SHALL 通过 PATCH /api/admin/packages/:id/shelf 接口允许不同角色切换套餐上下架状态。操作目标因调用者角色而不同：平台/超管修改 tb_package.shelf_status（全局状态），代理修改自己的 tb_shop_package_allocation.shelf_status（代理独立状态）。只有启用状态的套餐才能上架。

Scenario: 平台管理员上架启用的套餐

WHEN 平台/超管将启用且下架的套餐设置为上架
THEN 系统更新 tb_package.shelf_status=1

Scenario: 平台管理员尝试上架禁用的套餐

WHEN 平台/超管尝试上架一个 status=2（禁用）的套餐
THEN 系统返回错误 "禁用的套餐不能上架，请先启用"

Scenario: 平台管理员下架套餐

WHEN 平台/超管将上架的套餐设置为下架
THEN 系统更新 tb_package.shelf_status=2，只影响平台自营渠道

Scenario: 代理上架自己分配的套餐

GIVEN 代理拥有该套餐的分配记录，且 tb_package.status=1（启用）
WHEN 代理调用接口设置 shelf_status=1
THEN 系统更新该代理的 allocation.shelf_status=1，不修改 tb_package.shelf_status

Scenario: 代理下架自己分配的套餐

GIVEN 代理拥有该套餐的分配记录，allocation.shelf_status=1
WHEN 代理调用接口设置 shelf_status=2
THEN 系统更新该代理的 allocation.shelf_status=2，不影响其他代理

Scenario: 代理尝试上架全局禁用的套餐

GIVEN tb_package.status=2（禁用）
WHEN 代理尝试将 shelf_status 设置为1
THEN 系统返回错误 "套餐已禁用，无法上架"

Scenario: 代理操作未分配的套餐

GIVEN 代理没有该套餐的分配记录
WHEN 代理调用接口操作该套餐的上下架
THEN 系统返回错误 "该套餐未分配给您，无法操作上下架"

1.9 KiB Raw Blame History Unescape Escape