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