docs: 补充说明创建产品 vs Step1 基础信息的关系

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
这个提交包含在:
API Changelog Bot 2026-04-13 09:44:51 +08:00
父节点 bcc899394c
当前提交 292b585b27

查看文件

@ -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才是真正保存基础信息。