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