# 订单详情「服务标准」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`）一直正常。
