【新增接口·管理后台】产品 Step5 服务标准 tab 只读预览

PR: #3377 服务: hl-product-service-v2 | 更新时间: 2026-06-03 存放目录: changelogs-v2/2026-06/ 影响范围: 管理后台「产品编辑 / Step5 补充信息 / 服务标准 tab」

⚠️ 关键说明

Step5 补充信息新增「服务标准」tab，一个接口返三块，均只读、实时拉取不冻快照：

当前绑定模板内容
各行程节点的服务标准（来自资源 service_standard）
各行程节点的退费说明（来自资源退费说明）

模板的绑定（写）走 Step5 保存的 serviceStandardTemplateId（见同期《服务标准模板与产品的关联方式》），本接口只负责 tab 内的只读预览展示。

1. 接口背景

运营在 Step5 绑定模板后，希望一屏看到：当前模板内容、以及各行程节点从资源实时带出的服务标准与退费说明，而不必跳到资源页或下单后才看到。

2. 接口清单

#	方法	路径	变更类型	鉴权
1	GET	`/admin/product/item/{id}/service-standard-preview`	新增	admin token，产品数据权限（与产品详情同口径）

3. 请求示例

curl -H "Authorization: Bearer <admin-token>" \
  "https://api.test.1814.love:9443/admin/product/item/2056944461216100353/service-standard-preview"

4. 响应结构与字段说明

{
  "templateId": Long,            // 当前绑定模板 ID，未绑定为 null
  "template": { ... },           // 绑定模板完整内容，结构同模板详情接口，未绑定为 null
  "nodes": [ ... ]               // 行程节点服务标准+退费说明，仅含有内容的节点，皆空节点不返回
}

nodes[] 字段：

字段	类型	说明
dayNumber	Integer	第几天
nodeName	String	节点名称（如「呼和诺尔草原旅游区」）
nodeType	String	节点类型：SCENIC / ACTIVITY / HOTEL / RESTAURANT / SERVICE ...
serviceStandard	String	节点服务标准（来自资源），无则 null
refundNote	Object	退费说明，无则 null

refundNote 结构：

字段	类型	说明
intro	String	退费说明备注
items[].title	String	条目标题（如「成人未参加」）
items[].amount	BigDecimal	退费金额
items[].unitLabel	String	单位文案（如「/人」「/团」）
items[].settleScope	String	结算范围枚举：PER_PERSON / PER_TEAM
items[].settleScopeLabel	String	结算范围中文（按人 / 按团）
items[].remark	String	备注，可空
items[].effectiveFrom / effectiveTo	Date	生效区间，可空

5. 真实响应示例（测试服 dev-v3，产品 2056944461216100353）

{
  "code": 200,
  "data": {
    "templateId": null,
    "template": null,
    "nodes": [
      {
        "dayNumber": 1,
        "nodeName": "巴音温泉",
        "nodeType": "SERVICE",
        "serviceStandard": "提供24小时管家服务，含接送站、行程咨询、紧急联络。",
        "refundNote": null
      },
      {
        "dayNumber": 2,
        "nodeName": "呼和诺尔草原旅游区",
        "nodeType": "SCENIC",
        "serviceStandard": "景区内提供免费讲解、母婴室、医疗点；请听从工作人员安排，注意草原防火。",
        "refundNote": {
          "intro": "退费为旅游项目门票退费",
          "items": [
            { "title": "成人未参加", "amount": 44.0, "unitLabel": "/人", "settleScope": "PER_PERSON", "settleScopeLabel": "按人", "remark": "凭票根", "effectiveFrom": null, "effectiveTo": null },
            { "title": "整团未到", "amount": 100.0, "unitLabel": "/团", "settleScope": "PER_TEAM", "settleScopeLabel": "按团", "remark": null, "effectiveFrom": null, "effectiveTo": null }
          ]
        }
      },
      {
        "dayNumber": 2,
        "nodeName": "黄河湿地漂流",
        "nodeType": "ACTIVITY",
        "serviceStandard": "漂流配备专业教练与救生装备，全程安全护航；12岁以下需成人陪同。",
        "refundNote": null
      }
    ]
  }
}

说明：示例中节点 serviceStandard 为测试服联调写入的样例数据。若资源未配置 service_standard，该字段返回 null（详见《资源服务标准字段》一文，运营在资源上配置后即自动带出）。

6. 测试服实测（dev-v3）

12 个产品调用全部 code=200。模板块、退费说明块用真数据验证通过；节点服务标准块在景区 / 游玩项目 / 服务各配一条 service_standard 后，三类节点均正确返回上方示例值。

7. 前端动作

进入 Step5 服务标准 tab 调本接口。
渲染三块：template 模板内容、nodes[].serviceStandard 节点服务标准、nodes[].refundNote 节点退费说明，均只读。
template / serviceStandard / refundNote 均可能为 null，按需隐藏对应区块。
绑定（写）走 supplement 的 serviceStandardTemplateId，预览（读）走本接口，两者配合。

5.1 KiB 原始文件 永久链接 Blame 文件历史 Unescape Escape