From 45b074eac4df01b337a56d3db91d54aa2f496177 Mon Sep 17 00:00:00 2001
From: API Changelog Bot <changelog@hulalv.com>
Date: Thu, 4 Jun 2026 13:46:44 +0800
Subject: [PATCH] =?UTF-8?q?fix(=E5=AE=A1=E8=AE=A1followup):=20=E9=80=80?=
 =?UTF-8?q?=E6=AC=BE=20actualAmount=20=E5=AD=97=E6=AE=B5=E8=AF=AD=E4=B9=89?=
 =?UTF-8?q?=E8=B0=83=E6=95=B4=E9=80=9A=E7=9F=A5=E5=89=8D=E7=AB=AF(PR=20#34?=
 =?UTF-8?q?46)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

APPROVED/APPEAL_APPROVED/REFUNDING/REFUNDED 返回应退/实退额(确认弹窗可预填),其余置 null。
---
 ...45_退款实退额字段+审计followup-管理后台.md | 52 +++++++++++++++++++
 1 file changed, 52 insertions(+)
 create mode 100644 changelogs-v2/2026-06/04_3445_退款实退额字段+审计followup-管理后台.md

diff --git a/changelogs-v2/2026-06/04_3445_退款实退额字段+审计followup-管理后台.md b/changelogs-v2/2026-06/04_3445_退款实退额字段+审计followup-管理后台.md
new file mode 100644
index 0000000..4d89803
--- /dev/null
+++ b/changelogs-v2/2026-06/04_3445_退款实退额字段+审计followup-管理后台.md
@@ -0,0 +1,52 @@
+# 【后端调整·管理后台】退款详情/列表 actualAmount 字段语义调整（审计 followup）
+
+> **PR**: #3446 | **关联工单**: #3445
+> **服务**: hl-order-service-v2（退款）| **更新时间**: 2026-06-04
+>
+> **存放目录**: `changelogs-v2/2026-06/`
+> **影响范围**: 管理后台「退款申请」详情 + 列表的 `actualAmount`（实退/应退额）字段
+
+---
+
+## ⚠️ 关键说明
+
+本批为代码审计 followup 修复，绝大多数为后端内部纠错（无前端影响）。**前端唯一需知**：退款 VO 的 `actualAmount` 字段返回规则调整。
+
+---
+
+## 1. actualAmount 返回规则调整
+
+### 原行为
+退款详情/列表 VO 仅在 `REFUNDED`（已退款）状态返回 `actualAmount`，其余状态一律返回 `null`。导致管理端「确认实退」弹窗在 `APPROVED`（已审批待执行）状态下拿不到应退额、无法预填。
+
+### 新行为
+按"是否已确定应退/会退款"分组：
+
+| 状态 | actualAmount |
+|---|---|
+| `APPROVED`（已审批）/ `APPEAL_APPROVED`（申诉通过）/ `REFUNDING`（退款中）/ `REFUNDED`（已退款）| **返回金额**（应退/实退额）|
+| `PENDING` / `APPEALING` / `REJECTED` / `APPEAL_REJECTED` / `CANCELLED` | `null`（未确定或不退款）|
+
+### 前端动作
+- 「确认实退」弹窗可用 `APPROVED`/`APPEAL_APPROVED`/`REFUNDING` 状态下的 `actualAmount` 预填金额。
+- 字段语义：在未到账状态它表示"应退额"，到账后（`REFUNDED`）表示"实退额"；展示文案可按状态区分（如未到账标"应退"、到账标"实退"）。
+- 接口路径/结构未变，仅 `actualAmount` 在更多状态下有值。
+
+---
+
+## 2. 其他（无前端影响，仅备案）
+
+本批同时处理了一批后端技术债与规范修复，**均不改变接口契约**，前端无需关注：
+- 退款 failReason 回填改走 PaymentService 封装（分层规范）；资源退费说明存在性校验抽 Checker（分层规范）。
+- 景区/活动/服务的新建/编辑接口内部把字典翻译（label）的远程调用移出数据库事务（性能，响应结构不变）。
+- 收费=否时旧价格日历保留不清理（按产品决策，防误删）。
+- 图标库 SVG 安全校验加固（更严格地拒绝危险 SVG，正常图标不受影响）。
+- 备品计费口径归一、错误码/常量去重、死代码清理等。
+
+---
+
+## 3. 关联 / 联系人
+
+- **本次 PR**：#3446（Closes #3445）
+- **后端负责人**：@wx
+- **前端对接（管理后台）**：mmg