feat: 产品列表字段补全 + 字典完整清单 + 字段名变更通知

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

changelogs/2026-04/2026-04-13_product-v2_dict_and_field_fix.md

@@ -0,0 +1,87 @@
+# 接口变更记录 — 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 | **规格** |