# 【说明补齐·管理后台】资源服务标准字段 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. 可空，无破坏性变更，按需接入。