docs(changelog-v2): 房务列表补 consultantId 站内信接入房务(#4101)

changelogs-v2/2026-06/20_4101_房务列表补consultantId-站内信接入房务-修改接口-管理后台.md

@@ -0,0 +1,46 @@
+# 房务列表补 consultantId（站内信接入房务·列表卡片开会话）— 修改接口 — 管理后台
+
+> 变更类型：✨ 响应字段新增（房务列表 VO 加 consultantId）
+> 端类型：管理后台（房务管家 · 我的接单 / 抢单池 → 聊天）
+> 日期：2026-06-20
+> 服务：hl-order-service-v3
+> PR：https://git.1814.love:8443/wx/HL/pulls/4102 （Closes #4101）
+
+---
+
+## ⚠️ 关键说明（给前端）
+
+站内信（聊天）接入房务收尾。后端聊天接入已就位（`open` 支持 bizModule=HOUSE、未读红点、会话列表 enrich、配不出走聊天），本次补**房务列表卡片直接开「与定制师会话」**所需的 `consultantId`。
+
+- **我的接单** `GET /v3/admin/order/grab-pool/my-claims/hotel`、**抢单池** `GET /v3/admin/order/grab-pool/hotel-requirements` 的列表项**新增 `consultantId`**（定制师 adminId，字符串雪花）。
+- 之前列表只返 `consultantName`，开会话需要的 `consultantId` 只能进详情才拿得到；现列表卡片即可拿。
+- 前端从列表卡片开会话：
+
+```
+POST /admin/message/chat/open
+{ "bizModule": "HOUSE", "bizId": <orderId>, "peerAdminId": <consultantId> }
+```
+
+---
+
+## 字段
+
+| 端点 | 新增字段 | 类型 | 说明 |
+|---|---|---|---|
+| `/v3/admin/order/grab-pool/my-claims/hotel`（我的接单）| consultantId | String（雪花）| 定制师 adminId（聊天对端 peerAdminId）|
+| `/v3/admin/order/grab-pool/hotel-requirements`（抢单池）| consultantId | String（雪花）| 同上 |
+
+取自 `order_main.consultant_id`（与既有 `consultantName` 同源同行）；列表其余字段不变。
+
+---
+
+## 测试
+
+- 已部署测试服 order-v3 双实例 success；9443 实测两端点 200。
+- `consultantId` 透传由单测覆盖（HouseGrab*Test 47 绿，含 consultantId 断言）+ 与既有 consultantName 同一 JOIN 投影同源。
+- 注：测试环境当前抢单池/我的接单为空，未在真实行上观测到 consultantId 取值；字段为纯增、同源 consultantName 已生产工作。
+
+## 备注
+
+- 网关无需改（`/v3/admin/**` 路由已覆盖）。
+- via 站内信接入房务。