# 接口变更记录 — 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~~（每日库存）

---

## 四、前端Step1页面需要去掉的UI组件

以下字段**后端已删除**，前端传了也会被忽略，请去掉对应的UI组件：

| UI组件 | 对应字段 | 原因 |
|--------|---------|------|
| 支付类型（全款支付/订金+尾款） | ~~paymentType~~ | 原型Step1没有 |
| 订金设置（固定金额/比例） | ~~depositRatio/depositAmount~~ | 原型Step1没有 |
| 尾款须在出发前N天付清 | ~~balanceDueDays~~ | 尾款时间固定为行程第一天 |
| 每日库存默认值 | ~~defaultDailyStock~~ | 原型Step1没有 |
| 是否预约产品 | ~~isBooking~~ | 原型Step1没有 |
