# 房务列表补 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 站内信接入房务。
