feat: 新增代理分配套餐上架状态（shelf_status）功能

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

openspec/specs/agent-available-packages/spec.md

@@ -8,7 +8,7 @@
 
 ### Requirement: 代理查询可售套餐列表
 
-系统 SHALL 通过统一的套餐列表接口（`/api/admin/packages`）为代理用户自动过滤可售套餐。代理用户查询时，系统 MUST 只返回被分配的套餐，响应 MUST 包含成本价、利润空间、返佣信息等代理专属字段。
+系统 SHALL 通过统一的套餐列表接口（`/api/admin/packages`）为代理用户自动过滤可售套餐。代理用户查询时，系统 MUST 只返回被分配的套餐，响应 MUST 包含成本价、利润空间、返佣信息等代理专属字段。**响应中的 `shelf_status` 字段 MUST 返回代理自己分配记录的值（`allocation.shelf_status`），而非套餐的全局值（`package.shelf_status`）。**
 
 #### Scenario: 代理查询自动过滤为已分配套餐
 - **WHEN** 代理用户调用 `GET /api/admin/packages`
@@ -16,7 +16,7 @@
 
 #### Scenario: 平台用户查询返回所有套餐
 - **WHEN** 平台用户调用 `GET /api/admin/packages`
-- **THEN** 系统返回所有套餐（不应用代理权限过滤）
+- **THEN** 系统返回所有套餐（不应用代理权限过滤），shelf_status 返回 `tb_package.shelf_status`
 
 #### Scenario: 响应包含代理专属字段
 - **WHEN** 代理用户查询套餐列表
@@ -30,19 +30,25 @@
 - **WHEN** 代理指定套餐系列 ID 筛选
 - **THEN** 系统只返回该系列下已分配的套餐
 
-#### Scenario: 只返回启用且上架的套餐
-- **WHEN** 代理查询可售套餐
-- **THEN** 系统只返回 status=1（启用）且 shelf_status=1（上架）的套餐
+#### Scenario: 代理查询时 shelf_status 返回分配记录的值
+- **GIVEN** `tb_package.shelf_status=1`（平台上架），代理自己的 `allocation.shelf_status=2`（代理下架）
+- **WHEN** 代理调用 `GET /api/admin/packages`
+- **THEN** 响应中该套餐的 `shelf_status=2`（返回代理自己的状态）
+
+#### Scenario: 代理查询时不按 package.shelf_status 过滤
+- **GIVEN** `tb_package.shelf_status=2`（平台下架），但代理的 `allocation.shelf_status=1`（代理上架）
+- **WHEN** 代理调用 `GET /api/admin/packages`
+- **THEN** 该套餐仍出现在结果中（代理侧状态独立），shelf_status 返回 1
 
 ---
 
 ### Requirement: 代理查询可售套餐详情
 
-系统 SHALL 通过统一的套餐详情接口（`/api/admin/packages/:id`）为代理用户返回套餐详细信息，包含完整的价格信息。
+系统 SHALL 通过统一的套餐详情接口（`/api/admin/packages/:id`）为代理用户返回套餐详细信息，包含完整的价格信息。**响应中的 `shelf_status` MUST 返回代理自己分配记录的值。**
 
 #### Scenario: 代理查询已分配套餐详情
 - **WHEN** 代理查询一个已被分配的套餐详情
-- **THEN** 系统返回套餐完整信息，包含：成本价、建议售价、利润空间、价格来源（系列分配）
+- **THEN** 系统返回套餐完整信息，包含：cost_price（成本价）、建议售价、利润空间、价格来源，以及代理自己的 shelf_status
 
 #### Scenario: 代理查询未分配的套餐
 - **WHEN** 代理查询一个未被分配的套餐详情