docs(changelog-v2): 订单服务标准退费说明修复 (#3354/PR#3355)

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`）一直正常。