3.4 KiB
3.4 KiB
【说明补齐·管理后台】资源服务标准字段 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 即可,不影响其它字段。以景区为例(测试服实测):
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"
响应:
{ "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. 前端动作
- 在景区 / 游玩项目 / 服务 / 酒店的编辑表单加
serviceStandard(服务标准,多行文本,≤10000 字)输入项。 - 创建 / 编辑提交时带上该字段;详情回显读
serviceStandard回填。 - 可空,无破坏性变更,按需接入。