From d356531f00cbf844913c6b94c667b1e7cc7028db Mon Sep 17 00:00:00 2001 From: API Changelog Bot Date: Mon, 13 Apr 2026 16:17:45 +0800 Subject: [PATCH] =?UTF-8?q?feat:=20=E9=80=9A=E7=9F=A5=E5=89=8D=E7=AB=AFcat?= =?UTF-8?q?egory+currentStep=E6=96=B0=E5=A2=9E+Step1=E5=AD=97=E6=AE=B5?= =?UTF-8?q?=E5=88=A0=E9=99=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Opus 4.6 (1M context) --- ...6-04-13_product-v2_category_currentStep.md | 61 +++++++++++++++++++ 1 file changed, 61 insertions(+) create mode 100644 changelogs/2026-04/2026-04-13_product-v2_category_currentStep.md diff --git a/changelogs/2026-04/2026-04-13_product-v2_category_currentStep.md b/changelogs/2026-04/2026-04-13_product-v2_category_currentStep.md new file mode 100644 index 0000000..07b3197 --- /dev/null +++ b/changelogs/2026-04/2026-04-13_product-v2_category_currentStep.md @@ -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~~（每日库存）