📝 docs(epic-006): 明确管理员商品API策略

- 明确管理员商品API不默认过滤父商品，保持完整管理视图
- 添加spuId查询参数支持，管理员可通过spuId=0过滤只显示父商品
- 更新API设计部分，详细说明管理员商品API策略
- 在管理员界面添加"只显示父商品"筛选选项

Generated with [Claude Code](https://claude.ai/code)
via [Happy](https://happy.engineering)

Co-Authored-By: Claude <noreply@anthropic.com>
Co-Authored-By: Happy <yesreply@happy.engineering>

docs/prd/epic-006-parent-child-goods-multi-spec-support.md

@@ -44,6 +44,7 @@
   - 故事2已完成：管理员父子商品管理API（获取子商品列表、设为父商品、解除关系、批量创建）
   - 故事4部分已实现：公共商品列表API已默认只返回父商品（spuId=0）
   - 故事4待实现：商品详情API父子商品支持优化、查询性能优化
+  - **API策略**：公共API默认过滤只显示父商品，管理员API保持完整视图但支持spuId参数过滤
 - **集成点**：多租户商品模块、商品管理UI、商品详情页、购物车系统、订单提交流程
 - **成功标准**：
   1. ✅ 管理员能配置父子商品关系（故事1-2已完成）
@@ -80,7 +81,10 @@
   - `DELETE /api/v1/goods/:id/parent` - 解除子商品的父子关系
   - `POST /api/v1/goods/batch-create-children` - 批量创建子商品（支持事务）
 - **API聚合策略**：通过`admin-goods-aggregated.mt.ts`聚合基础CRUD和父子商品管理路由，保持`adminGoodsRoutesMt`名称不变，前端代码无需修改
-- **管理员商品API**：显示完整的父子商品关系树
+- **管理员商品API策略**：
+  - 默认显示所有商品（包括父子商品），保持完整管理视图
+  - 支持`spuId`查询参数过滤，管理员可通过`spuId=0`只查看父商品
+  - 在管理员界面添加"只显示父商品"筛选选项，提升管理体验
 
 ### 4. 父子商品配置方式
 1. **手动关联**：在创建/编辑父商品时，选择已有商品作为子商品
@@ -161,9 +165,10 @@
      - ✅ 管理员父子商品管理API：已在故事2实现（获取子商品列表、设为父商品、解除关系、批量创建）
    - **待实现部分**：
      - 商品详情API：根据商品类型返回相应数据（父商品+子商品列表或子商品+父商品信息）
-     - 管理员商品API：增强父子商品关系展示和查询优化
+     - 管理员商品API：增强父子商品关系展示和查询优化，**不默认过滤父商品**（管理员需要完整视图）
      - 商品列表查询性能优化
-   - **验收标准**：API变更保持向后兼容，商品详情包含完整的父子商品信息，商品列表查询性能良好
+     - 添加spuId查询参数支持，管理员可通过`spuId=0`过滤只显示父商品
+   - **验收标准**：API变更保持向后兼容，商品详情包含完整的父子商品信息，商品列表查询性能良好，管理员可灵活过滤父子商品
 
 5. **故事5：父子商品多规格选择组件开发** ⏳ **待实现**
    - 激活并增强现有的`GoodsSpecSelector`组件