From eddc646c0885bb5dbd9c68a4c8afbaf667d7a848 Mon Sep 17 00:00:00 2001
From: wx <wx@1814.love>
Date: Thu, 28 May 2026 13:44:35 +0800
Subject: [PATCH] =?UTF-8?q?docs(changelog-v2):=20=E6=88=BF=E5=8A=A1?=
 =?UTF-8?q?=E7=AE=A1=E5=AE=B6=E9=85=8D=E6=88=BF/=E9=85=92=E5=BA=97/?=
 =?UTF-8?q?=E5=91=98=E5=B7=A5/=E5=9F=8E=E5=B8=82=E6=8E=A5=E9=80=9A?=
 =?UTF-8?q?=E7=9C=9F=E5=AE=9E=E6=95=B0=E6=8D=AE+=E6=88=BF=E9=97=B4?=
 =?UTF-8?q?=E5=88=86=E9=85=8D=E5=86=99=E7=AB=AF=E7=82=B9=20(#3152/#3153/#3?=
 =?UTF-8?q?154/#3176/#3178)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 ...˜å·¥åŸŽå¸‚真实化+房间分é…�写端点_PR3152-3154-3176-3178.md | 87 +++++++++++++++++++
 1 file changed, 87 insertions(+)
 create mode 100644 changelogs-v2/2026-05/28_HOUSE批�_房务管家�房酒店员工城市真实化+房间分�写端点_PR3152-3154-3176-3178.md

diff --git a/changelogs-v2/2026-05/28_HOUSE批�_房务管家�房酒店员工城市真实化+房间分�写端点_PR3152-3154-3176-3178.md b/changelogs-v2/2026-05/28_HOUSE批�_房务管家�房酒店员工城市真实化+房间分�写端点_PR3152-3154-3176-3178.md
new file mode 100644
index 0000000..343f09e
--- /dev/null
+++ b/changelogs-v2/2026-05/28_HOUSE批�_房务管家�房酒店员工城市真实化+房间分�写端点_PR3152-3154-3176-3178.md
@@ -0,0 +1,87 @@
+# 二期 v3 房务管家：�房/酒店/员工/城市等接�接通真实数� + 新增房间分�写端点
+
+> **�务**: hl-order-service-v3（+ resource / user-service 内部接�）
+> **PR**: #3152�#3153�#3154�#3176�#3178
+> **Issue**: #3148�#3149�#3150�#3156�#3172�#3177
+> **日期**: 2026-05-28
+> **影�**: 🟡 房务管家（HOUSE）一批此�返空/null/桩的接�已接通真实数�；新增"房间分�写"端点；�已测试��实例部署 + 真机验�
+
+---
+
+## ⚠� 总览（�端 mmg 必读）
+
+房务管家相关接�此�多处因�赖未�地而返「空列表 / null 字段 / ���。现已跨 order-v3 / resource / user-service 三�务接通真实逻辑并真机验�。**接�路径�字段结构���**，�是**字段从空/���为真实值**，�端��此把对应 UI 由"空状�"切到真实渲染。�项如下。
+
+---
+
+## 1. 新增：房间分�写端点（§2.5）— PR #3152
+
+此��有 `GET .../rooms`（按家庭分组查），**没有写入端点**，导致�日 `assignments` �空。现补：
+
+```
+POST /v3/admin/order/assignments/{assignmentId}/rooms
+```
+- 幂等 + 分布���护（���交安全）
+- 请求体：
+```jsonc
+{
+  "rooms": [
+    {
+      "roomGroupNo": "F1",         // 家庭/房间组�
+      "travelerCount": 2,           // 该房入�人数
+      "travelerNames": "张三,�四",  // 入�人姓�(逗�分隔)
+      "bedType": "double",          // 床型
+      "remark": "�选备注"
+    }
+  ]
+}
+```
+- 返回 `{ successCount, items:[{id, roomGroupNo, bedType, travelerCount}] }`
+- 写入� `GET /v3/admin/order/orders/{orderId}/rooms` 的�日 `assignments` ��空（�床型/人数明细）
+
+---
+
+## 2. 酒店列表 / 详情接通真实数�（§6.1 / §6.2）— PR #3153
+
+`GET /v3/admin/house/hotels`（列表）与 `GET /v3/admin/house/hotels/{hotelId}`（详情 4 Tab）此�走 Fallback 返空，现接 resource 真实主数�：
+
+- **§6.1 列表**：返真实酒店（测试库 39 家），字段 `city/cityName/level/settleType/paymentMode/protoPrice/roomTypes/status` 等�全
+  - `settleType` 字典 `hotel_settle_type`：`cash` 现付 / `sign` 签� / `company` 公�付款
+  - `paymentMode` 字典 `hotel_payment_mode`：`prepay` 预付款 / `cash` 现结 / `monthly` 月结
+- **§6.2 详情**：`basic`（基础信�）/ `roomTypes`（房型，� `protoPrice` + `facilities` 设施数组）/ `priceCalendar30d`（未� 30 天价格日历）/ `recentCheckLog`（核房记录）四 Tab �返真实数�
+
+> 注：测试库酒店主数�已回填（结算/付款/�议价/房型价格），便于�调；正�环境以 resource 实际维护的数�为准。
+
+---
+
+## 3. 转�候选员工接通（§6.6）— PR #3154 + #3178
+
+`GET /v3/admin/house/staff` 此� user-service 无对应接�返空，现接通：
+
+- user-service 新增房务员工接�，按**房务角色**筛选：`house_keeper`(房务) / `house_lead`(房务组长)
+- 返回 `{ list:[{ userId, name, avatar, online, superAdmin, activeCount }], total }`
+- **`activeCount`（在跟订�数）�径**（#3178 修正）：为该员工**当���有的活跃�房需求数**（精确�径），��是历� CLAIM 次数近似 —— 转�选人时的负载/上�判断更准确
+
+---
+
+## 4. 行程城市接通（§1.5 / §2.0）— PR #3176
+
+此� `cities` / `days[].city` �为 null。现按�天酒店�查城市接通：
+
+- **§1.5 我的接�** `GET /v3/admin/order/grab-pool/my-claims/hotel`：列表项 `cities` 返该�**行程去�城市数组**（如 `["呼伦�尔市","兴安盟"]`）
+- **§2.0 订�详情** `GET /admin/house/orders/{orderId}`：`requirement.current.days[].city` �行程日历 `itinerary[].cityCode/cityName` 返**中文城市�**
+- 数�缺失（酒店未维护城市 / 查询�级）时该字段如实 null，�报错
+
+---
+
+## 5. 转�接收人姓�真实化（§1.3）— PR #3178
+
+转��归属人姓�（`claimer_name`，体现在我的接� / 详情归属人）此�为�� `user-{id}`，现解�为**真实员工姓�**（�房务员工接��查；查�到时退回 `user-{id}` 兜底，�影�转��功）。
+
+---
+
+## 验�
+
+以上全部已�并 dev-v3 + 测试��实例滚动部署，并�真机（真 admin token，过网关 9443/本地 8080）验�：房间分�写→查 assignments �空�酒店列表/详情字段�全�员工列表真实�cities/city 中文城市�转�� claimer_name 为真�。无接�路径/字段结构�更，�端按上述把对应 UI 从空�切真实渲染��。
+
+如需任一接�的完整�应样例，或字段有疑问，回我��。