docs(v2): 服务标准模板与产品关联说明 + 私人定制统一实时引用(PR #3375)

changelogs-v2/2026-06/03_服务标准模板与产品关联说明-管理后台.md

@@ -0,0 +1,47 @@
+# 服务标准模板与产品的关联方式（产品编辑 Step5 补充信息）——说明补齐
+
+- **端类型**：管理后台
+- **变更类型**：说明补齐（既有功能，此前未同步给前端）+ 行为统一（私人定制不再冻结快照）
+- **日期**：2026-06-03
+- **PR**：[#3375](https://git.1814.love:8443/wx/HL/pulls/3375)（行为统一部分）
+- **后端负责人**：wx
+
+---
+
+## ① 背景
+
+前端反馈：**「服务标准模板怎么和产品关联」一直没有收到说明**。本文补齐这块的完整接口契约，供产品编辑 Step5「补充信息」里做「服务标准」相关 UI（绑定模板）使用。
+
+服务标准模板（出团服务说明书）是一份**统一维护的全局模板库**；产品通过**纯引用一个模板 ID** 与之关联，不复制模板内容。
+
+---
+
+## ② 关联机制（产品 ←→ 服务标准模板）
+
+| 步骤 | 接口 | 方法 | 路径 | 说明 |
+|------|------|------|------|------|
+| 取模板下拉 | 启用模板下拉 | GET | `/admin/product/service-standard-template/enabled` | 返回 `[{id, name}]`，仅 status=ENABLED |
+| 取模板详情(预览) | 模板详情 | GET | `/admin/product/service-standard-template/{id}` | 返回 `{id,name,intro,applicableScope,sections:[{title,items:[{title,content,remark,color,contactName,phone}]}]}` |
+| 取模板分页 | 模板分页 | GET | `/admin/product/service-standard-template/page?page=&pageSize=` | 列表页不下钻 sections（为 null），仅主表字段 |
+| **保存绑定** | Step5 补充信息保存 | PUT | `/admin/product/item/{id}/supplement` | 请求体字段 **`serviceStandardTemplateId`**（Long，可空）即为产品绑定的服务标准模板 ID |
+
+- **绑定即"纯引用"**：产品只存 `serviceStandardTemplateId`，不存模板正文。
+- **回显**：产品详情/Step5 读取接口返回的 `serviceStandardTemplateId` 即当前绑定，前端据此回填下拉选中项；未绑定为 null。
+
+---
+
+## ③ 展示语义（统一实时引用，私人定制不再冻快照）
+
+- **所有产品类型**（含 CORE/GROUP/CUSTOM 私人定制）C 端/订单详情的服务标准，**统一按 `serviceStandardTemplateId` 实时查模板展示**。
+- 模板内容被运营修改后，**已绑定的产品实时跟随**（含私人定制）。
+- 此前私人定制产品在「完成设计」时会冻结一份快照（`service_standard_snapshot`），**现已废除**（PR #3375）：私人定制与普通产品行为一致，统一实时引用。**此为后端内部数据来源变化，接口结构不变，前端无需改动**。
+
+---
+
+## ④ 前端动作
+
+- 在产品编辑 Step5「补充信息」做服务标准模板的**绑定 UI**：用 `/enabled` 拉下拉、选中后把 `serviceStandardTemplateId` 随 `PUT /{id}/supplement` 提交；可用 `/{id}` 拉模板详情做选中预览。
+- 回显：读 Step5 数据里的 `serviceStandardTemplateId` 回填。
+- 无破坏性变更，按需接入即可。
+
+> 说明：产品编辑页「服务标准」tab 中**只读展示行程节点服务标准/退费说明**的能力为独立后端需求，正在设计，待后端接口就绪后另发 changelog。