# 接口变更记录 — 2026-04-13

> **变更类型**：字段补全 + 字典补全
> **在线文档**：
> - 局域网：http://192.168.100.236:8080/doc.html
> - 公网：https://api.test.1814.love:9443/doc.html

---

## 一、产品列表字段补全

管理端产品列表 `GET /admin/product/item/list` 补全了以下字段：

| 字段 | 类型 | 说明 |
|------|------|------|
| productId | Long | 产品ID |
| productNo | String | 产品编号(C260409001) |
| productType | String | 产品类型(CORE/GROUP/CUSTOM) |
| name | String | 产品名称 |
| **subtitle** | String | **副标题（新增）** |
| coverImageUrl | String | 封面图 |
| tripDays | Integer | 行程天数 |
| **tripNights** | Integer | **行程晚数（新增）** |
| **lineId** | Long | **主题ID（新增）** |
| **lineName** | String | **主题名称（新增，关联查询）** |
| status | String | 产品状态 |
| **seasons** | List\<String\> | **产品季节（新增，如["summer","autumn"]）** |
| **tags** | List\<String\> | **产品标签（新增，如["亲子","研学"]）** |
| **tierCount** | Integer | **规格数量（新增，单一=1,多档=N,未配=0）** |
| **startPrice** | BigDecimal | **起步价（新增，最低成人售价）** |
| version | Integer | 版本号 |
| **sortOrder** | Integer | **排序号（新增）** |
| **createdBy** | Long | **创建人ID（字段名从createBy改为createdBy）** |
| **createdByName** | String | **创建人名称（新增）** |
| publishedAt | LocalDateTime | 上架时间 |
| createTime | LocalDateTime | 创建时间 |
| updateTime | LocalDateTime | 更新时间 |

> **注意**：`createBy` 字段名已改为 `createdBy`，前端需要同步修改。

---

## 二、字典值完整清单

### product_type（产品类型）

通过字典接口获取：`GET /admin/dict/data/type/product_type`

| 值 | 中文 | 说明 |
|----|------|------|
| CORE | 核心产品 | 标准旅游产品，用价格日历定价 |
| GROUP | 小蒙马 | 跟团游/亲子营，用班期定价 |
| CUSTOM | 私人定制 | 1对1定制，用价格日历定价 |
| ~~ROUTE~~ | ~~自驾路书~~ | **v2已废弃，不使用** |

### product_status（产品状态）

通过字典接口获取：`GET /admin/dict/data/type/product_status`

| 值 | 中文 | 说明 |
|----|------|------|
| DRAFT | 草稿 | 新创建/编辑中 |
| PENDING_REVIEW | 待审核 | **新增**，提交上架审批中 |
| PUBLISHED | 已上架 | 审批通过，C端可见 |
| UNPUBLISHED | 已下架 | 主动下架或审批下架 |
| REJECTED | 已驳回 | **新增**，审批被驳回 |
| COMPLETED | 已完成 | 私人定制完成设计 |
| ORDERED | 已下单 | **新增**，私人定制已下单 |

### 其他相关字典

| 字典类型 | 获取方式 | 值列表 |
|---------|---------|--------|
| product_node_type | `GET /admin/dict/data/type/product_node_type` | TRANSPORT/SCENIC/RESTAURANT/ACTIVITY/PHOTOGRAPHY/HOTEL/FREE/CUSTOM/SERVICE/NOTE |
| product_grade | `GET /admin/dict/data/type/product_grade` | LIGHT_LUXURY=轻奢, HIGH_END=高档 |
| product_category | `GET /admin/dict/data/type/product_category` | family=亲子游, honeymoon=蜜月, photography=摄影, experience=深度体验, driving=自驾越野 |
| product_approval_status | `GET /admin/dict/data/type/product_approval_status` | NONE/PENDING/PUBLISH_APPROVED/PUBLISH_REJECTED/UNPUBLISH_APPROVED/UNPUBLISH_REJECTED |

---

## 三、名词对照提醒

| 后端字段 | 前端叫法 |
|---------|---------|
| lineId / lineName | **主题** |
| productId / name | **版本** |
| tierSeq / tierName / tierCount | **规格** |
