diff --git a/changelogs/2026-04/2026-04-13_product-v2_list_add_tierCount.md b/changelogs/2026-04/2026-04-13_product-v2_list_add_tierCount.md index 93be62e..90cb910 100644 --- a/changelogs/2026-04/2026-04-13_product-v2_list_add_tierCount.md +++ b/changelogs/2026-04/2026-04-13_product-v2_list_add_tierCount.md @@ -61,3 +61,24 @@ ## 同步修复:分页问题已修复 之前产品列表 `total` 返回0、一次返回全部数据的问题已修复(PR #325)。现在分页正常:`total` 返回正确总数,`records` 只返回当前页数据。 + +--- + +## 补充说明:创建产品 vs Step1 基础信息 + +这是**两个接口**,使用场景不同: + +| 接口 | 方法 | 路径 | 用途 | +|------|------|------|------| +| 创建产品 | POST | `/admin/product/item` | 弹窗中填最少信息(名称+类型+产品线+天数),快速创建草稿拿到productId | +| Step1保存 | PUT | `/admin/product/item/{id}/basic` | 进入编辑页后,保存全部基础信息(37个字段) | + +**前端使用流程**: +1. 点「新建产品」→ 弹窗填4个字段 → 调 `POST /admin/product/item` → 拿到 `productId` +2. 自动跳转到编辑页 Step1 → 填写完整信息 → 调 `PUT /admin/product/item/{id}/basic` + +两个接口的请求体不同: +- 创建:`ProductSaveReqVO`(name, productType, lineId, tripDays) +- Step1:`ProductBasicSaveReqVO`(37个字段,含version乐观锁) + +**不需要调两次保存同样的信息**——创建只是"开个头"拿ID,Step1才是真正保存基础信息。