diff --git a/changelogs-v2/2026-06/20_房务+定制师提房需求+站内信聊天_前端对接总览-管理后台.md b/changelogs-v2/2026-06/20_房务+定制师提房需求+站内信聊天_前端对接总览-管理后台.md index 8eaa76b..f779ebc 100644 --- a/changelogs-v2/2026-06/20_房务+定制师提房需求+站内信聊天_前端对接总览-管理后台.md +++ b/changelogs-v2/2026-06/20_房务+定制师提房需求+站内信聊天_前端对接总览-管理后台.md @@ -199,7 +199,17 @@ curl -k -X PUT "https://api.test.1814.love:9443/v3/admin/order/60001/hotel-requi | requirementVersion | Integer | 需求版本(>1 时 UI 标"已修订") | | createTime | LocalDateTime | 创建时间 | -> **我的接单** `GET .../my-claims/hotel` 响应为 `{list, total, stats}`,`stats={inProgress,pendingConfirm,confirmed,exception}`;行 VO 同样含 `consultantId` + `unreadMessageCount`(聊天未读红点,见模块三)。 +> **我的接单** `GET .../my-claims/hotel` 响应为 `{list, total, stats}`,`stats={inProgress,pendingConfirm,confirmed,exception}`;行 VO 同样含 `totalAmount`(#4123 新增,String,与抢单池同口径)+ `consultantId` + `unreadMessageCount`(聊天未读红点,见模块三)。 +> **stats 空态说明**:`pendingConfirm`(待确认=PENDING_FINALIZE) / `exception`(异常=EXCEPTION) 计数随真实数据出,库里这两态 0 行时即为 0(空态,非 bug,**勿隐藏 tab**),订单走到配房全确认 / 拒单超时即出数。 +> **productType 筛选与徽标**:`productType` 跨服务字段不下推 SQL(当页内存精筛),故筛选时 `total` 仍是池总数(= 待抢徽标语义=池内总数),筛 productType 时前端弱化该徽标即可。 + +**转单 `POST /v3/admin/order/hotel-requirements/{requirementId}/transfer`** 请求体 `HouseTransferReqVO`: + +| Key | 类型 | 必填 | 说明 | +|---|---|---|---| +| toUserId | Long(串) | ✅ | 接收人房务 ID(admin_id) | +| reason | String | ✅ | 原因(普通房务 ≥1 字 / 超管 ≥10 字,1~200) | +| skipUpperLimit | Boolean | 否 | 跳过 30 单上限(仅超管有效,默认 false) | ## 2.3 候选酒店 `GET /v3/admin/hotel-candidates`