From e21f97ab92908917b7715fa01f415aa77c51531d Mon Sep 17 00:00:00 2001
From: API Changelog Bot <changelog@hulalv.com>
Date: Tue, 30 Jun 2026 09:57:03 +0800
Subject: [PATCH] =?UTF-8?q?docs(changelog-v2):=20=E9=A2=84=E7=AE=97/?=
 =?UTF-8?q?=E6=99=9A=E6=94=B9=E6=96=B9=E6=A1=88=E6=88=BF=E8=B4=B9=E5=90=88?=
 =?UTF-8?q?=E8=AE=A1(1600)=20+=20=E6=88=BF=E5=8A=A1=E5=88=97=E8=A1=A8?=
 =?UTF-8?q?=E8=A1=A5houseStatusLabel=20+=20roomTypeSummary=E7=BF=BB?=
 =?UTF-8?q?=E4=B8=AD=E6=96=87(PR=20#4659/#4658)=E5=89=8D=E7=AB=AF=E5=AF=B9?=
 =?UTF-8?q?=E6=8E=A5?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 ...�列表补houseStatusLabel_房型摘要翻中文_前端对接-管理后台.md | 32 +++++++++++++++++++
 1 file changed, 32 insertions(+)
 create mode 100644 changelogs-v2/2026-06/55_4659_用房需求预算晚改为方案房费合计_房务列表补houseStatusLabel_房型摘要翻中文_前端对接-管理后台.md

diff --git a/changelogs-v2/2026-06/55_4659_用房需求预算晚改为方案房费合计_房务列表补houseStatusLabel_房型摘要翻中文_前端对接-管理后台.md b/changelogs-v2/2026-06/55_4659_用房需求预算晚改为方案房费合计_房务列表补houseStatusLabel_房型摘要翻中文_前端对接-管理后台.md
new file mode 100644
index 0000000..4964754
--- /dev/null
+++ b/changelogs-v2/2026-06/55_4659_用房需求预算晚改为方案房费合计_房务列表补houseStatusLabel_房型摘要翻中文_前端对接-管理后台.md
@@ -0,0 +1,32 @@
+# 用房需求「预算/晚」改为方案当晚房费合计 + 房务列表补 houseStatusLabel + 房型摘要翻中文
+
+> 模块：订单详情 / 房务管家列表（管理后台）
+> 类型：后端口径修正 + additive 字段（已合并 dev-v3 + 部署测试服 + API 实测闭环）
+> 日期：2026-06-30
+> 关联：PR #4659（预算口径）、#4658（houseStatusLabel / 房型摘要）
+
+## 1. 「预算/晚」口径修正（方案多房型行求和）
+工单 #4645 候选升级为「方案」(一个方案=1酒店+多条房型行)后，段级 `budget`（预算/晚）口径修正：
+
+- **新口径**：`segment.budget` = 该段**各候选(方案)当晚总价的最大值**，单方案当晚总价 = **Σ(行协议价 × 行间数)**。
+- 例（测试服实测）：方案 = 嘉世豪[标准间 ¥380×2间 + 豪华大床房 ¥420×2间] → `budget = 380×2 + 420×2 = **1600.00**`。
+- 旧口径曾误为「段内单间最高协议价」(显示 420)，现已改对。
+- 仍是「后端按协议价反查覆盖、前端传值不作数」；某房型行无协议价日历则该行不计入。
+
+**前端**：订单详情/房务详情的「预算/晚」直接渲染该值即可，注意数值口径已变为**整晚房费合计**（会比旧值大），无需改代码。
+
+## 2. 房务列表补 `houseStatusLabel`（additive）
+`GET /v3/admin/order/grab-pool/my-claims/hotel` 与 `/all-claims/hotel` 列表项**新增 `houseStatusLabel`**（中文状态 label，与订单详情/工作台字段名对齐）。
+
+- `houseStatus` 字段**保持现状**（历史返中文 label，前端在用，未变，兼容）。
+- 新增 `houseStatusLabel`（中文，单源 HouseStateEnum）——**前端建议统一改用 `houseStatusLabel`**（与详情 `progress.houseStatusLabel`、工作台同名），便于一致渲染/后续平滑迁移。
+- 实测：my-claims 返回 `houseStatus=配房中` + `houseStatusLabel=配房中`。
+
+## 3. 订单详情行程 `roomTypeSummary` 翻中文
+`GET /v3/admin/order/{id}/itinerary` → `hotelGroup.requirement.roomTypeSummary` 由英文 code 改为中文 label：
+
+- 旧：`STANDARD×6 / DELUXE×6`；新：`标间×6 / 豪华房×6`。
+- 前端直接渲染该字符串即可，无需改代码。
+
+## 备注（无前端影响，仅知悉）
+同批后端还修了：房务写口角色门前置到幂等/锁之前（非房务角色越权调写口直接 808090/808091，不再占用幂等窗口）；订单送签/打印行程的跨域调用改走中立契约（架构门禁清零）。均为内部加固，不改任何对外契约。