65 行
3.4 KiB
Markdown
65 行
3.4 KiB
Markdown
# 【说明补齐·管理后台】资源服务标准字段 service_standard（景区/游玩项目/服务/酒店）
|
||
|
||
> PR: 无（字段此前已落地，本次补齐说明） 服务: hl-resource-service | 更新时间: 2026-06-03
|
||
> 存放目录: changelogs-v2/2026-06/ 影响范围: 管理后台「资源管理 / 景区·游玩项目·服务·酒店」（编辑表单新增字段）
|
||
|
||
## ⚠️ 关键说明
|
||
|
||
前端反馈资源上新增的「服务标准」字段 `serviceStandard` 没有同步说明，本文补齐，含字段位置、请求示例、字段去向。
|
||
|
||
- `serviceStandard` 是**点位级服务标准**，配置在资源本体上（String，最长 10000 字，可空）。
|
||
- 下游（订单 / 小程序行程节点、产品 Step5 服务标准 tab 节点预览）**实时按 resourceId 拉取展示，不冻快照**，资源改了已引用处同步更新。
|
||
- 编辑接口是**字段级 PATCH**：请求体只传 `serviceStandard` 即可单独更新该字段，其它字段为 null 时跳过、不受影响。
|
||
|
||
## 1. 字段背景
|
||
|
||
为支持订单/小程序行程节点、产品 Step5 服务标准 tab 展示「每个点位的服务标准」，在 4 类资源上增加了 `serviceStandard` 字段，由运营在资源编辑页维护。
|
||
|
||
## 2. 字段所在接口
|
||
|
||
`serviceStandard` 已在以下 4 类资源的创建 / 编辑请求体与详情 / 列表响应里：
|
||
|
||
| # | 资源 | 创建 | 编辑（字段级 PATCH） |
|
||
|---|------|------|------|
|
||
| 1 | 景区 Scenic | POST `/admin/scenic/spot` | PUT `/admin/scenic/spot/{scenicId}` |
|
||
| 2 | 游玩项目 Activity | POST `/admin/activity/item` | PUT `/admin/activity/item/{activityId}` |
|
||
| 3 | 服务 ServiceItem | POST `/admin/service/item` | PUT `/admin/service/item/{serviceId}` |
|
||
| 4 | 酒店 Hotel | POST `/admin/hotel/item` | PUT `/admin/hotel/item/{hotelId}` |
|
||
|
||
字段约束：`@Size(max=10000)`，可空。
|
||
|
||
## 3. 详细用法与示例
|
||
|
||
### 3.1 单独更新某资源的服务标准（PATCH）
|
||
|
||
编辑接口逐字段判空，只传 `serviceStandard` 即可，不影响其它字段。以景区为例（测试服实测）：
|
||
|
||
```bash
|
||
curl -X PUT -H "Authorization: Bearer <admin-token>" -H "Content-Type: application/json" \
|
||
-d '{"serviceStandard": "景区内提供免费讲解、母婴室、医疗点；请听从工作人员安排，注意草原防火。"}' \
|
||
"https://api.test.1814.love:9443/admin/scenic/spot/3001000000000000010"
|
||
```
|
||
|
||
响应：
|
||
|
||
```json
|
||
{ "code": 200, "data": { "...": "...", "serviceStandard": "景区内提供免费讲解、母婴室、医疗点；请听从工作人员安排，注意草原防火。" } }
|
||
```
|
||
|
||
游玩项目 / 服务 / 酒店同理，把路径换成对应资源即可（详见接口表）。
|
||
|
||
### 3.2 详情回显
|
||
|
||
资源详情 / 列表响应里都带 `serviceStandard` 字段，编辑页回填即可（未配置为 null）。
|
||
|
||
## 4. 字段去向（配了之后哪里展示）
|
||
|
||
- 订单 / 小程序行程节点：按节点 resourceId 实时取资源 `serviceStandard` 展示（点位级服务标准）。
|
||
- 产品编辑 Step5 服务标准 tab：`GET /admin/product/item/{id}/service-standard-preview` 的 `nodes[].serviceStandard` 即来自此字段（详见《产品 Step5 服务标准 tab 只读预览》）。
|
||
|
||
## 5. 前端动作
|
||
|
||
1. 在景区 / 游玩项目 / 服务 / 酒店的编辑表单加 `serviceStandard`（服务标准，多行文本，≤10000 字）输入项。
|
||
2. 创建 / 编辑提交时带上该字段；详情回显读 `serviceStandard` 回填。
|
||
3. 可空，无破坏性变更，按需接入。
|