docs(changelog-v2): 房务管家 #4237 进度条6态+留言计数 已部署验证版字段契约

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
这个提交包含在:
API Changelog Bot 2026-06-22 17:00:48 +08:00
父节点 ee75e0ca36
当前提交 3d4e3967e7

查看文件

@ -28,11 +28,14 @@ wx 评审房务管家发现多处「前端渲染不全 / 交互缺门控」。**
**后端已就绪**`requirement.current.days[].segments[]` = `{roomCategory, roomCount, budget, remark(段备注), candidates:[{hotelId, hotelName, remark(候选备注)}]}`(房务侧 RequirementSnapshot,#4128 起完整;配房行程的 DayDetail 同样含 segments / hotels **后端已就绪**`requirement.current.days[].segments[]` = `{roomCategory, roomCount, budget, remark(段备注), candidates:[{hotelId, hotelName, remark(候选备注)}]}`(房务侧 RequirementSnapshot,#4128 起完整;配房行程的 DayDetail 同样含 segments / hotels
**前端**:按完整段×候选渲染——每段 `房型 · X间 · ¥预算 · 候选(择一)酒店A(候选备注..) / 酒店B(候选备注..) · 段备注`,对齐 admin 侧(#4220)。内部留言「定制师需求」与配房行程行都补全。 **前端**:按完整段×候选渲染——每段 `房型 · X间 · ¥预算 · 候选(择一)酒店A(候选备注..) / 酒店B(候选备注..) · 段备注`,对齐 admin 侧(#4220)。内部留言「定制师需求」与配房行程行都补全。
## 4-5. 进度条 6 态 + 内部留言计数(后端 PR #4239 处理中 ## 4-5. 进度条 6 态 + 内部留言计数(✅ PR #4239 已合并部署测试服 + API 实测验证,可接
- **进度条**:原 4 步硬编码「接单/配房中/待最终确认/已最终确认」+ 待配房单误显「配房中」。后端改为由房务侧 6 态驱动,标签校正为「待配房 / 配房中 / 待最终确认 / 已确认」,并新增 `progress.houseStatus` + `progress.houseStatusLabel`(权威态,含 询房中 / 异常)。 - **进度条**:原 4 步硬编码「接单/配房中/待最终确认/已最终确认」+ 待配房单误显「配房中」。后端已改由房务侧 6 态驱动,字段契约:
- **内部留言计数**`tabCounts.messageCount` 由恒 0 改为计入定制师需求(=1 - `progress.steps[].label` 校正为固定 4 步「待配房 / 配房中 / 待最终确认 / 已确认」,`completed` 按是否越过该步。
- ⏳ 这两项字段契约 **以「后端 #4239 合并部署测试服并验证后的更新版 changelog」为准**,先勿据此联调。 - `progress.currentStep`:待配房=1 / 配房中(含询房中)=2 / 待最终确认=3 / 已确认=4。
- **新增** `progress.houseStatus`6 态枚举 name`PENDING_CLAIM`/`CLAIMING`/`IN_INQUIRY`/`PENDING_FINALIZE`/`CONFIRMED`/`EXCEPTION`+ `progress.houseStatusLabel`(中文,含 4 步未单列的 **询房中 / 异常**)。**前端进度条按这两个权威字段渲染,别再用旧硬标签**。
- 实测(抢单池单 `GET /admin/house/orders/{id}``houseStatus=PENDING_CLAIM, houseStatusLabel=待配房, currentStep=1, steps[0].completed=false`
- **内部留言计数**`tabCounts.messageCount` 由恒 0 改为计入定制师需求(=1。实测 `messageCount=1`
--- ---