docs(v2): 服务标准三篇 changelog 改朴素简洁版(去圈号标题/表格/多余粗体)

2026-06-03 11:51:42 +08:00
@@ -1,48 +1,26 @@
-# 资源「服务标准」字段（service_standard）—— 说明补齐（景区/游玩项目/服务/酒店）
+# 资源服务标准字段 service_standard（景区/游玩项目/服务/酒店）

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

---
+前端反馈资源上新增的服务标准字段 serviceStandard 没收到说明，这里补齐。该字段是点位级服务标准，配置在资源本体上，下游（订单/小程序行程节点、产品 Step5 服务标准 tab 节点预览）实时按 resourceId 拉取展示，不冻快照，资源改了已引用处同步更新。

-## ① 背景
+## 字段位置

-前端反馈：资源（景区/游玩项目/服务/酒店）上新增的**「服务标准」字段 `serviceStandard`** 一直没有同步说明。本文补齐。
+serviceStandard（String，最长 10000 字，可空）已在以下 4 类资源的创建/编辑请求体与详情/列表响应里：

-该字段是**点位级服务标准**：配置在资源本体上，下游（订单详情/小程序节点、以及产品编辑 Step5「服务标准」tab 的节点预览）**实时按 resourceId 拉取展示，不冻快照**——资源上改了，已引用的产品/订单同步更新。
+- 景区：POST /admin/scenic/spot、PUT /admin/scenic/spot/{scenicId}
+- 游玩项目：POST /admin/activity/item、PUT /admin/activity/item/{activityId}
+- 服务：POST /admin/service/item、PUT /admin/service/item/{serviceId}
+- 酒店：POST/PUT /admin/hotel/...

---
+编辑接口是字段级 PATCH：只传 serviceStandard 即可单独更新，不影响其它字段。

-## ② 涉及资源与接口
+## 字段去向

-`serviceStandard`（String，最长 10000 字）已在以下 4 类资源的**创建/编辑请求体**与**详情/列表响应**中：
+- 订单/小程序行程节点：按节点 resourceId 实时取资源 serviceStandard 展示
+- 产品 Step5 服务标准 tab 预览：GET /admin/product/item/{id}/service-standard-preview 的 nodes[].serviceStandard 即来自此字段

-| 资源 | 创建 | 编辑 | 详情/列表(响应含 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`（服务标准）输入项，按需接入创建/编辑请求与详情回显。
- 无破坏性变更，可空，按需接入。
+在景区/游玩项目/服务/酒店的编辑表单加 serviceStandard 输入项，接入创建/编辑与详情回显。可空，无破坏性变更。