From 4708a1f98e890f734790c539698143f5c3ead451 Mon Sep 17 00:00:00 2001
From: API Changelog Bot <changelog@hulalv.com>
Date: Tue, 2 Jun 2026 13:05:49 +0800
Subject: [PATCH] =?UTF-8?q?docs(changelog-v2):=20=E8=AE=A2=E5=8D=95?=
 =?UTF-8?q?=E6=9C=8D=E5=8A=A1=E6=A0=87=E5=87=86=E9=80=80=E8=B4=B9=E8=AF=B4?=
 =?UTF-8?q?=E6=98=8E=E4=BF=AE=E5=A4=8D=20(#3354/PR#3355)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../02_3354_订单服务标准-退费说明修复.md      | 58 +++++++++++++++++++
 1 file changed, 58 insertions(+)
 create mode 100644 changelogs-v2/2026-06/02_3354_订单服务标准-退费说明修复.md

diff --git a/changelogs-v2/2026-06/02_3354_订单服务标准-退费说明修复.md b/changelogs-v2/2026-06/02_3354_订单服务标准-退费说明修复.md
new file mode 100644
index 0000000..78c60bb
--- /dev/null
+++ b/changelogs-v2/2026-06/02_3354_订单服务标准-退费说明修复.md
@@ -0,0 +1,58 @@
+# 订单详情「服务标准」Tab 退费说明（refundNotes）修复——现可正确返回数据
+
+- **端类型**：管理后台
+- **变更类型**：缺陷修复（接口结构不变，仅恢复数据流）
+- **日期**：2026-06-02
+- **Issue**：[#3354](https://git.1814.love:8443/wx/HL/issues/3354)
+- **PR**：[#3355](https://git.1814.love:8443/wx/HL/pulls/3355)
+- **Commit**：[db61c2d](https://git.1814.love:8443/wx/HL/commit/db61c2da1193be0e0954dacdfd8f154e3ba5d912)
+- **后端负责人**：wx
+
+---
+
+## ① 背景
+
+订单详情「服务标准」Tab 接口（`GET /v3/admin/order/{id}/service-standard`，#3340 已上线的聚合结构）中，`refundNotes`（退费说明）字段此前一直返回空数组，即使绑定资源已配置退费说明。
+
+根因是**资源退费说明根本存不进库**：资源服务自定义的字段自动填充处理器只填一期命名字段（createdAt/updatedAt），漏填二期命名字段（createTime），导致退费说明保存接口报错（create_time 不能为空），全表 0 条存活记录 → 下单冻快照时节点 `refundNote` 恒 null → 服务标准 Tab 退费说明永远为空。
+
+本次修复后端自动填充处理器，退费说明可正常保存并随订单快照冻结。
+
+---
+
+## ② 变更清单
+
+**接口结构无任何变化**（`refundNotes` 字段在 #3340 已定义）。修复后行为：
+
+| 接口 | 方法 | 路径 | 变更内容 |
+|------|------|------|----------|
+| 订单服务标准 | GET | `/v3/admin/order/{id}/service-standard` | `refundNotes` 现对「绑定了退费说明的 SCENIC/ACTIVITY 行程节点」正确返回数据（修复前恒为空） |
+
+`refundNotes[]` 结构（不变，复述）：
+
+```
+refundNotes: [
+  {
+    sourceName,          // 来源点位名称，如「呼和诺尔草原旅游区」
+    intro,               // 退费说明备注
+    items: [
+      { title, amount, unitLabel, settleScope, settleScopeLabel, remark, effectiveFrom, effectiveTo }
+    ]
+  }
+]
+```
+
+测试服实测（订单 2061673442020651009）：`refundNotes` = 呼和诺尔草原旅游区 → [成人未参加 ¥44 /人（按人）, 整团未到 ¥100 /团（按团）]，`settleScopeLabel` 字典中文已正确解析。
+
+---
+
+## ③ 前端动作
+
+**无需改动**。#3340 前端已对接 `refundNotes` 结构，仅需知悉：之前看到的退费说明为空是后端缺陷，现已修复，对已配置退费说明的资源会正常返回。
+
+---
+
+## ④ 备注
+
+- 同一 Tab 的「出团注意事项」（`notices`）能否有数据，取决于**产品是否配置了「服务标准模板」**（产品域 Step5 补充信息配置项）。当前测试库暂无产品配置该模板，故 `notices` 仍为空；这属于数据配置，非接口缺陷，与本次修复无关。
+- 「行程」（`itinerary`）一直正常。