docs: 补充说明创建产品 vs Step1 基础信息的关系
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
这个提交包含在:
父节点
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才是真正保存基础信息。
|
||||
|
||||
正在加载...
x
在新工单中引用
屏蔽一个用户