docs(changelog-v2): 房务管家订单详情/抢单池 渲染缺口+抢单门控 (#4237)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

changelogs-v2/2026-06/22_4237_房务管家订单详情抢单池_渲染缺口+抢单门控_房务前端.md

@@ -0,0 +1,40 @@
+# 房务管家（订单详情 / 抢单池）渲染缺口 + 抢单门控（#4237，后端 PR #4239）
+
+> 变更类型：🐛 后端数据已齐全 → 前端渲染对齐 + 交互门控
+> 端类型：房务管家（housekeeper）前端（订单详情弹窗 + 抢单池列表）
+> 日期：2026-06-22
+> 工单：#4237 ｜ 服务：hl-order-service-v3（数据已就绪）
+
+---
+
+## 总览
+
+wx 评审房务管家发现多处「前端渲染不全 / 交互缺门控」。**后端数据基本都齐全**（段×候选完整结构、productName、claim 信息），下列 1-3 项前端按完整结构渲染即可，**可立即接**。另有进度条 6 态 + 留言计数两项后端在改（PR #4239，合并部署后出字段更新版）。
+
+## 1. 抢单前隐藏「联系定制师 / 给定制师留言」（可立即接）
+
+**规则**：抢单后才能和定制师聊天（聊天 = 留言）。订单还在抢单池（未被本房务抢单）时，**不显示**「联系定制师」「给定制师留言」入口（订单详情顶部两个按钮 + 内部留言区的「给定制师留言」）。
+
+**前端**：按订单详情的 `claim.isMine`（未抢单为 false）门控——未抢单 → 隐藏/禁用这些入口；抢单后 → 显示。
+
+## 2. 抢单池列表补「产品名」（可立即接）
+
+**现状**：列表只显挡位名（如"舒适·N晚"），无产品名。后端 pool VO 已含 `productName`（如"测试核心产品-单档-固定比例"）。
+**前端**：列表行补显 `productName`（产品名 + 挡位，别只显挡位名）。
+
+## 3.「定制师需求」按完整段×候选结构渲染（可立即接）
+
+**现状**：① 内部留言 tab 的「定制师需求」② 配房行程行 —— 都只显 `第N晚 · X间 · 房型 · ¥价 · 备注` 的简化视图，**漏候选酒店 + 各候选备注 + 段备注**（例：DAY1 实有候选 呼伦贝尔香格里拉(备注777555) / 海拉尔嘉世豪(备注77777222)，现只显一个备注、无酒店）。
+**后端已就绪**：`requirement.current.days[].segments[]` = `{roomCategory, roomCount, budget, remark(段备注), candidates:[{hotelId, hotelName, remark(候选备注)}]}`（房务侧 RequirementSnapshot，#4128 起完整；配房行程的 DayDetail 同样含 segments / hotels）。
+**前端**：按完整段×候选渲染——每段 `房型 · X间 · ¥预算 · 候选(择一)：酒店A(候选备注..) / 酒店B(候选备注..) · 段备注`，对齐 admin 侧（#4220）。内部留言「定制师需求」与配房行程行都补全。
+
+## 4-5. 进度条 6 态 + 内部留言计数（后端 PR #4239 处理中）
+
+- **进度条**：原 4 步硬编码「接单/配房中/待最终确认/已最终确认」+ 待配房单误显「配房中」。后端改为由房务侧 6 态驱动，标签校正为「待配房 / 配房中 / 待最终确认 / 已确认」，并新增 `progress.houseStatus` + `progress.houseStatusLabel`（权威态，含 询房中 / 异常）。
+- **内部留言计数**：`tabCounts.messageCount` 由恒 0 改为计入定制师需求（=1）。
+- ⏳ 这两项字段契约 **以「后端 #4239 合并部署测试服并验证后的更新版 changelog」为准**，先勿据此联调。
+
+---
+
+## 说明（非 bug）
+- 抢单池列表「呼伦贝尔市」= 后端按候选酒店 hotelId 解析中文城市去重回填（#3172），非已下线的手填城市字段。是否保留待产品定。