From dfa833cb34b4813032be8c5e205bf220f0489fc5 Mon Sep 17 00:00:00 2001
From: API Changelog Bot <changelog@hulalv.com>
Date: Thu, 28 May 2026 11:45:24 +0800
Subject: [PATCH] =?UTF-8?q?docs(changelog-v2):=20#3147=20=E4=BA=A7?=
 =?UTF-8?q?=E5=93=81=E6=9C=8D=E5=8A=A1=E6=A0=87=E5=87=86=E6=A8=A1=E5=9D=97?=
 =?UTF-8?q?=20=E2=80=94=20=E6=A8=A1=E6=9D=BF/=E6=AF=8F=E6=97=A5=E6=8F=90?=
 =?UTF-8?q?=E9=86=92/=E8=AE=A2=E5=8D=95Tab=20(PR=20#3157)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 ...Š¡æ ‡å‡†æ¨¡å�—-模æ�¿æ€»åˆ™+æ¯�æ—¥æ��醒+订å�•Tab_PR3157.md | 142 ++++++++++++++++++
 1 file changed, 142 insertions(+)
 create mode 100644 changelogs-v2/2026-05/28_3147_产��务标准模�-模�总则+�日�醒+订�Tab_PR3157.md

diff --git a/changelogs-v2/2026-05/28_3147_产��务标准模�-模�总则+�日�醒+订�Tab_PR3157.md b/changelogs-v2/2026-05/28_3147_产��务标准模�-模�总则+�日�醒+订�Tab_PR3157.md
new file mode 100644
index 0000000..c44d270
--- /dev/null
+++ b/changelogs-v2/2026-05/28_3147_产��务标准模�-模�总则+�日�醒+订�Tab_PR3157.md
@@ -0,0 +1,142 @@
+# 二期 v3：产�「�务标准�模� — 模�总则(分组+�目) + �日特别�醒 + 订� Tab 富展示
+
+> **�务**: hl-product-service-v2 + hl-order-service-v3
+> **PR**: #3157（+ hotfix #3163）
+> **Issue**: #3147
+> **日期**: 2026-05-28
+> **影�**: 🟢 新增能力，全部��兼容（旧订� Tab 自动�级，�报错）
+> **状�**: ✅ 测试� 9443 全链路实测通过（模� CRUD → 产�绑定 → 创�冻结 → 订� Tab）
+
+---
+
+## 背景
+
+「出团�务说明书�需�比原� `notice.title + 一段富文本` 更丰富的结构：**多分组**（一�出团注�事项…）+ **编��目**（标题/说明/�系人）+ **�日特别�醒**。本期在产�侧**新建**「�务标准�模�，创�冻结进订�快照，订�/�程�/PDF 读快照展示。
+
+�端需�：① 模�编辑器（分组/�目增删）② 产� Step5 绑定下拉 ③ 行程 Step2 �日「特别�醒�录入 ④ 订�/�程��务标准 Tab 富展示 ⑤ 行程�/签� PDF。
+
+---
+
+## 一�产�侧：�务标准模�管�（新增 admin 接�）
+
+路径�缀 `/admin/product/service-standard-template`（已被现有 `/admin/product/**` 网关路由覆盖）。
+
+### 1. 分页
+```
+GET /admin/product/service-standard-template/page?pageNo=1&pageSize=10&name=&status=
+```
+返回 `PageResult`（`data.records[]` + `data.total`），按 sortOrder/id ��。
+
+### 2. 详情
+```
+GET /admin/product/service-standard-template/{id}
+```
+
+### 3. �存（id 空=新增 / �空=修改）
+```
+POST /admin/product/service-standard-template
+```
+请求体：
+```jsonc
+{
+  "id": null,                       // 修改时传(字符串�传雪花ID)
+  "name": "�原出团�务说明书",       // 必填
+  "intro": "出团�请仔细阅读…",       // 顶部�示语(截图绿色�示�)
+  "applicableScope": "全部跟团客户",  // 适用对象
+  "sections": [                     // 必填:分组+�目
+    {
+      "title": "一�出行�务",         // 分组标题(必填)
+      "items": [
+        { "title": "接�站�务", "content": "�供机场/车站�费接�", "contact": "客� 400-xxx" }
+      ]
+    }
+  ],
+  "isDefault": false,
+  "sortOrder": 0,
+  "status": "ENABLED"               // 留空默认 ENABLED；ENABLED=�用/DISABLED=�用
+}
+```
+返回 `data` = 模�ID（**字符串�传，勿 Number()**）。
+
+### 4. 删除（软删，已绑定产���影�）
+```
+DELETE /admin/product/service-standard-template/{id}
+```
+
+### 5. 下拉（Step5 绑定用，仅�用项，�分页）
+```
+GET /admin/product/service-standard-template/enabled
+```
+返回 `data: [ { "id": "...", "name": "�原出团�务说明书" } ]`（� id+name）。
+
+---
+
+## 二�产� Step5 补充信�：绑定模�（纯引用）
+
+`PUT /admin/product/item/{id}/supplement` 请求体**新增**字段：
+```jsonc
+{ "serviceStandardTemplateId": 2059839696602615809 }  // 字符串�传；解绑传 null
+```
+�存�产�详情回显该 ID；用上�的 `/enabled` 下拉选。
+
+> **�人定制例外**：�人定制(CUSTOM)产�「完�设计�时会把当时模�内容**冻结快照**进产�，之�改模��影�该产�；核心/�蒙马为纯引用（改模��续新订�实时跟�）。�端无需特殊处�，知悉��。
+
+---
+
+## 三�产� Step2 行程：�日「特别�醒�
+
+`PUT /admin/product/item/{id}/itinerary` 的�个 `DayItem` **新增**字段：
+```jsonc
+{
+  "dayNumber": 1,
+  "serviceTips": [                                  // 本日特别�醒(�空)
+    { "title": "本日特别�醒", "content": "今日海拔较高,备好抗高��" }
+  ]
+}
+```
+�存�行程回显该天的 `serviceTips`。
+
+---
+
+## 四�订�详情「�务标准�Tab �应�级
+
+```
+GET /v3/admin/order/{id}/service-standard
+```
+（�程�端� hl-mp BFF ��，结构一致）
+
+`data` **新增** `serviceStandard` + `dayTips` 两�；�留原 `itinerary`�`refundPolicy`；原 `notice` 字段**废弃**（� null，请改用 `serviceStandard`）：
+```jsonc
+{
+  "itinerary": ["Day1 …","Day2 …"],          // �留:行程天纲
+  "notice": null,                            // 废弃,勿�用
+  "refundPolicy": { /* 原结构�留 */ },
+  "serviceStandard": {                       // 新:�务标准总则
+    "intro": "出团�请仔细阅读…",
+    "applicableScope": "全部跟团客户",
+    "sections": [
+      { "title": "一�出行�务",
+        "items": [ { "title": "接�站�务", "content": "…", "contact": "客� 400-xxx" } ] }
+    ]
+  },
+  "dayTips": [                               // 新:�日特别�醒(按天)
+    { "dayNumber": 1, "dayTitle": "Day1 抵达-接机",
+      "tips": [ { "title": "本日特别�醒", "content": "今日海拔较高…" } ] }
+  ]
+}
+```
+
+### ��兼容（��）
+- **本次�级�已下�的旧订�**：`serviceStandard` 返回 `null`�`dayTips` 返回 `[]`（快照里没有新结构，已实测�级�报错）。�端渲染需判空：`serviceStandard` 为 null 时�画总则区，`dayTips` 为空时�画�日�醒。
+- �级��且产�已绑模�/��日�醒的**新订�**�有完整数�（已实测）。
+
+---
+
+## 字段约定
+- 所有雪花 ID（模� id�serviceStandardTemplateId）**按字符串�传，勿 Number()**。
+- `sections` / `serviceTips` / `tips` 为空时分别返回 `[]` 或字段缺�，渲染需判空。
+
+---
+
+## 验�
+测试� 9443 已用真 admin token 全链路实测：模� CRUD/下拉 → 产�绑定 → 行程�日�醒 → 创�冻结快照 → 订� Tab 返回结构化 serviceStandard + dayTips（中文� null）→ 旧订��级�报错。