diff --git a/changelogs-v2/2026-06/20_4101_房务列表补consultantId-站内信接入房务-修改接口-管理后台.md b/changelogs-v2/2026-06/20_4101_房务列表补consultantId-站内信接入房务-修改接口-管理后台.md new file mode 100644 index 0000000..100f696 --- /dev/null +++ b/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": , "peerAdminId": } +``` + +--- + +## 字段 + +| 端点 | 新增字段 | 类型 | 说明 | +|---|---|---|---| +| `/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 站内信接入房务。