From cfdade1d9af64ba12d67c6531b1bd6ecdaa4de70 Mon Sep 17 00:00:00 2001 From: API Changelog Bot Date: Mon, 13 Apr 2026 10:27:46 +0800 Subject: [PATCH] =?UTF-8?q?feat:=20=E4=BA=A7=E5=93=81=E5=88=97=E8=A1=A8?= =?UTF-8?q?=E5=AD=97=E6=AE=B5=E8=A1=A5=E5=85=A8=20+=20=E5=AD=97=E5=85=B8?= =?UTF-8?q?=E5=AE=8C=E6=95=B4=E6=B8=85=E5=8D=95=20+=20=E5=AD=97=E6=AE=B5?= =?UTF-8?q?=E5=90=8D=E5=8F=98=E6=9B=B4=E9=80=9A=E7=9F=A5?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Opus 4.6 (1M context) --- ...026-04-13_product-v2_dict_and_field_fix.md | 87 +++++++++++++++++++ 1 file changed, 87 insertions(+) create mode 100644 changelogs/2026-04/2026-04-13_product-v2_dict_and_field_fix.md diff --git a/changelogs/2026-04/2026-04-13_product-v2_dict_and_field_fix.md b/changelogs/2026-04/2026-04-13_product-v2_dict_and_field_fix.md new file mode 100644 index 0000000..855f246 --- /dev/null +++ b/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\ | **产品季节（新增，如["summer","autumn"]）** | +| **tags** | List\ | **产品标签（新增，如["亲子","研学"]）** | +| **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 | **规格** |