# 资源「服务标准」字段（service_standard）—— 说明补齐（景区/游玩项目/服务/酒店）

- **端类型**：管理后台
- **变更类型**：说明补齐（字段此前已存在，未同步给前端）
- **日期**：2026-06-03
- **后端负责人**：wx

---

## ① 背景

前端反馈：资源（景区/游玩项目/服务/酒店）上新增的**「服务标准」字段 `serviceStandard`** 一直没有同步说明。本文补齐。

该字段是**点位级服务标准**：配置在资源本体上，下游（订单详情/小程序节点、以及产品编辑 Step5「服务标准」tab 的节点预览）**实时按 resourceId 拉取展示，不冻快照**——资源上改了，已引用的产品/订单同步更新。

---

## ② 涉及资源与接口

`serviceStandard`（String，最长 10000 字）已在以下 4 类资源的**创建/编辑请求体**与**详情/列表响应**中：

| 资源 | 创建 | 编辑 | 详情/列表(响应含 serviceStandard) |
|------|------|------|------|
| 景区 Scenic | `POST /admin/scenic/spot` | `PUT /admin/scenic/spot/{scenicId}` | `GET /admin/scenic/spot/{scenicId}`、`GET /admin/scenic/spots` |
| 游玩项目 Activity | `POST /admin/activity/item` | `PUT /admin/activity/item/{activityId}` | 活动详情/列表 |
| 服务 ServiceItem | `POST /admin/service/item` | `PUT /admin/service/item/{serviceId}` | 服务详情/列表 |
| 酒店 Hotel | `POST /admin/hotel/...` 创建 | `PUT /admin/hotel/...` 编辑 | 酒店详情/列表 |

- 编辑接口为**字段级 PATCH**：请求体只传 `serviceStandard` 即可单独更新该字段，不影响其它字段（其它字段为 null 时跳过）。
- 字段约束：`@Size(max=10000)`；可空。

---

## ③ 下游消费（字段去向）

- 订单详情 / 小程序行程节点：按节点 resourceId 实时取资源 `serviceStandard` 展示（点位级服务标准）。
- 产品编辑 Step5「服务标准」tab 只读预览：`GET /admin/product/item/{id}/service-standard-preview` 的 `nodes[].serviceStandard` 即来自此字段（见 6-03《产品 Step5 服务标准 tab 只读预览接口》）。

---

## ④ 测试服实测

在景区(呼和诺尔草原旅游区)/游玩项目(漂流)/服务项 各写入一条 `serviceStandard` 后，产品 Step5 预览接口 `nodes[].serviceStandard` 三类节点均正确返回该值。

## ⑤ 前端动作

- 在景区/游玩项目/服务/酒店的**编辑表单**加 `serviceStandard`（服务标准）输入项，按需接入创建/编辑请求与详情回显。
- 无破坏性变更，可空，按需接入。