feat: 通知前端category+currentStep新增+Step1字段删除
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
这个提交包含在:
父节点
10882cb7a2
当前提交
d356531f00
@ -0,0 +1,61 @@
|
||||
# 接口变更记录 — 2026-04-13
|
||||
|
||||
> **变更类型**:新增字段
|
||||
|
||||
---
|
||||
|
||||
## 一、新增 category 字段(产品分类)
|
||||
|
||||
### 影响接口
|
||||
|
||||
| 接口 | 方法 | 字段 |
|
||||
|------|------|------|
|
||||
| Step1保存 | POST `/admin/product/item/basic` | 请求参数新增 `category` |
|
||||
| 产品详情 | GET `/admin/product/item/{id}` | 响应新增 `category` |
|
||||
| 产品列表 | GET `/admin/product/item/list` | 响应新增 `category` |
|
||||
|
||||
### 字段说明
|
||||
|
||||
- **字段名**:`category`
|
||||
- **字典**:`product_category`
|
||||
- **值**:family=亲子游, honeymoon=蜜月旅行, photography=摄影之旅, experience=深度体验, driving=自驾越野
|
||||
|
||||
### 前端注意
|
||||
|
||||
Step1页面的"产品类型"选择器(亲子游/蜜月旅行...)应该绑定 `category` 字段,不是 `productType`。
|
||||
|
||||
- `productType`:CORE/GROUP/CUSTOM(产品类型,创建时选定不可改)
|
||||
- `category`:family/honeymoon/...(产品分类,Step1可编辑)
|
||||
|
||||
详情接口已返回 `category: "family"`,前端回显时匹配这个值。
|
||||
|
||||
---
|
||||
|
||||
## 二、新增 currentStep 字段(步骤进度)
|
||||
|
||||
产品详情接口 `GET /admin/product/item/{id}` 新增 `currentStep` 字段:
|
||||
|
||||
| 值 | 含义 |
|
||||
|----|------|
|
||||
| 1 | 基础信息(仅创建了产品) |
|
||||
| 2 | 行程编排(有行程天数据) |
|
||||
| 3 | 路线与备品(有路线/备品数据) |
|
||||
| 4 | 定价管理(有价格/班期数据) |
|
||||
| 5 | 补充信息(有费用说明数据) |
|
||||
|
||||
前端用这个字段决定步骤导航栏的状态(当前步/已完成/未到)。
|
||||
|
||||
---
|
||||
|
||||
## 三、Step1删除的字段(原型中不存在)
|
||||
|
||||
以下字段已从Step1保存接口删除,前端**不要再传**:
|
||||
|
||||
- ~~seasons~~(季节)
|
||||
- ~~carouselImages~~(轮播图)
|
||||
- ~~isBooking~~(预约产品)
|
||||
- ~~paymentType~~(支付方式)
|
||||
- ~~depositRatio~~(订金比例)
|
||||
- ~~depositAmount~~(订金金额)
|
||||
- ~~balanceDueDays~~(尾款期限)
|
||||
- ~~defaultDailyStock~~(每日库存)
|
||||
正在加载...
x
在新工单中引用
屏蔽一个用户