fix: DINING_RECOMMEND独立节点类型(最终版)

这个提交包含在:
API Changelog Bot 2026-03-25 16:13:52 +08:00
父节点 65a7a7a8cf
当前提交 8bd6a10f2b

查看文件

@ -1,24 +1,22 @@
# 行程节点支持推荐餐厅列表(独立节点 # 新增节点类型 DINING_RECOMMEND推荐餐厅
> 创建行程节点时,可附带推荐餐厅列表。**每个餐厅会创建为独立的 RESTAURANT 类型节点**,排在当前节点后面,在行程时间线中独立展示 > 新增行程节点类型 `DINING_RECOMMEND`,一个节点存一组推荐餐厅列表,在行程时间线中作为一个卡片展示多个餐厅
--- ---
## 变更接口 ## 使用方式
| 接口 | 说明 | ### 创建推荐餐厅节点
|------|------|
| `POST /admin/product/item/{productId}/day/{dayNumber}/node` | 创建节点 |
| `PUT /admin/product/node/{nodeId}` | 更新节点 |
## 新增字段 ```
POST /admin/product/item/{productId}/day/{dayNumber}/node
### 请求新增 `recommendedRestaurants` ```
```json ```json
{ {
"nodeType": "SCENIC", "nodeType": "DINING_RECOMMEND",
"nodeName": "呼伦湖", "nodeName": "午餐推荐",
"startTime": "12:00",
"recommendedRestaurants": [ "recommendedRestaurants": [
{ {
"restaurantId": "123456", "restaurantId": "123456",
@ -26,32 +24,46 @@
"coverUrl": "https://oss.xxx.com/cover.jpg", "coverUrl": "https://oss.xxx.com/cover.jpg",
"mealType": "午餐", "mealType": "午餐",
"priceInfo": "人均80元" "priceInfo": "人均80元"
},
{
"restaurantId": "789012",
"restaurantName": "藏式火锅",
"coverUrl": "https://oss.xxx.com/cover2.jpg",
"mealType": "午餐",
"priceInfo": "人均120元"
} }
] ]
} }
``` ```
### 更新推荐餐厅
```
PUT /admin/product/node/{nodeId}
```
`recommendedRestaurants` 即可整体替换餐厅列表。
### 查询返回
`GET /admin/product/item/{productId}/day/{dayNumber}/nodes` 返回的 ItineraryNodeVO 中:
- `nodeType` = `"DINING_RECOMMEND"`
- `recommendedRestaurants` = 餐厅列表数组
| 字段 | 类型 | 说明 | | 字段 | 类型 | 说明 |
|------|------|------| |------|------|------|
| recommendedRestaurants | Array | 推荐餐厅列表,最多10个选填 | | recommendedRestaurants[].restaurantId | String | 餐厅ID |
| recommendedRestaurants[].restaurantId | String | 餐厅ID来自资源服务 |
| recommendedRestaurants[].restaurantName | String | 餐厅名称 | | recommendedRestaurants[].restaurantName | String | 餐厅名称 |
| recommendedRestaurants[].coverUrl | String | 封面图URL | | recommendedRestaurants[].coverUrl | String | 封面图 |
| recommendedRestaurants[].mealType | String | 餐次:早餐/午餐/晚餐 | | recommendedRestaurants[].mealType | String | 餐次 |
| recommendedRestaurants[].priceInfo | String | 价格信息 | | recommendedRestaurants[].priceInfo | String | 价格信息 |
### 行为说明 **其他节点类型此字段为 null。**
传入 `recommendedRestaurants` 后,每个餐厅自动创建为**独立的 RESTAURANT 类型节点** ## 节点类型汇总11种
- `nodeType` = "RESTAURANT"
- `resourceType` = "RESTAURANT"
- `resourceId` = 餐厅ID
- `nodeName` = 餐厅名称
- `description` = 餐次mealType
- `images` = [coverUrl]
- `sortOrder` = 紧跟在当前节点后面
查询行程节点列表时,推荐餐厅作为独立节点返回,**不嵌套在其他节点内**。 TRANSPORT / SCENIC / RESTAURANT / ACTIVITY / PHOTOGRAPHY / HOTEL / FREE / CUSTOM / SERVICE / NOTE / **DINING_RECOMMEND**
## 涉及服务 ## 涉及服务