docs(v2): 资源服务标准字段(service_standard)说明补齐(景区/游玩项目/服务/酒店)

changelogs-v2/2026-06/03_资源服务标准字段-管理后台.md

@@ -0,0 +1,48 @@
+# 资源「服务标准」字段（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`（服务标准）输入项，按需接入创建/编辑请求与详情回显。
+- 无破坏性变更，可空，按需接入。