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

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 服务标准 tabGET /admin/product/item/{id}/service-standard-previewnodes[].serviceStandard 即来自此字段(详见《产品 Step5 服务标准 tab 只读预览》)。

5. 前端动作

  1. 在景区 / 游玩项目 / 服务 / 酒店的编辑表单加 serviceStandard服务标准,多行文本,≤10000 字)输入项。
  2. 创建 / 编辑提交时带上该字段;详情回显读 serviceStandard 回填。
  3. 可空,无破坏性变更,按需接入。