huang
61155952a7
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>
2.6 KiB
2.6 KiB
ADDED Requirements
Requirement: 分配记录独立上下架
系统 SHALL 在 tb_shop_package_allocation 表新增 shelf_status 字段（1-上架, 2-下架），允许代理独立控制自己分配到的套餐在客户侧的可见性，不影响其他代理和平台的同一套餐状态。
Scenario: 新建分配记录默认上架
- WHEN 平台或上级代理为某店铺创建套餐分配记录
- THEN
allocation.shelf_status默认为 1（上架）
Scenario: 代理下架自己的套餐
- GIVEN 代理A拥有套餐P的分配记录，shelf_status=1
- WHEN 代理A调用
PATCH /api/admin/packages/:id/shelf，传入 shelf_status=2 - THEN 系统更新代理A的
allocation.shelf_status=2，套餐P在代理A的客户侧不可见 - AND 代理B的同一套餐分配记录 shelf_status 不受影响
- AND
tb_package.shelf_status不受影响
Scenario: 代理上架自己的套餐
- GIVEN 代理A的分配记录 shelf_status=2
- WHEN 代理A调用
PATCH /api/admin/packages/:id/shelf，传入 shelf_status=1 - THEN 系统更新代理A的
allocation.shelf_status=1
Scenario: 代理上架已被全局禁用的套餐
- GIVEN
tb_package.status=2（套餐全局禁用），代理A的 allocation.shelf_status=2 - WHEN 代理A尝试将 shelf_status 设置为1（上架）
- THEN 系统返回错误 "套餐已禁用，无法上架"
Scenario: 调用者无分配记录时无法操作
- GIVEN 代理A没有套餐P的分配记录
- WHEN 代理A调用
PATCH /api/admin/packages/:id/shelf（套餐ID为P） - THEN 系统返回错误 "该套餐未分配给您，无法操作上下架"
Requirement: 分配记录 status 修改需所有者校验
系统 MUST 验证调用者是分配记录的创建者（allocator），才允许修改该记录的 status（启用/禁用）。
Scenario: 平台用户修改任意分配记录的 status
- GIVEN 平台用户调用
PUT /api/admin/shop-package-allocations/:id/status - WHEN 分配记录存在
- THEN 允许修改，不限制 allocator
Scenario: 代理修改自己创建的分配记录的 status
- GIVEN 代理A创建了"代理A→代理B"的分配记录（allocator_shop_id = A的shop_id）
- WHEN 代理A调用修改该记录的 status
- THEN 允许修改
Scenario: 代理修改别人分配给自己的记录的 status
- GIVEN 平台或代理A创建了"→代理B"的分配记录（allocator_shop_id != B的shop_id）
- WHEN 代理B调用修改该记录的 status
- THEN 系统返回错误 "无权限操作该资源或资源不存在"