API Changelog Bot 402e9a0444 docs(changelog-v2): 房务去询房中顶层态进度条4步+异常红标+我的接单去询房中 (#4389 )

PR #4389 工单 #4380。进度条 6→4 步, Progress 加 exception/exceptionLabel 红标字段,
我的接单去询房中 tab + 异常筛选改 todo 驱动并集, houseStatus 不再返 IN_INQUIRY。
已部署测试服双实例 health UP + API 实测通过。

2026-06-25 12:14:52 +08:00

4.5 KiB

原始文件 Blame 文件历史

房务去「询房中」顶层态 — 进度条 6→4 步 + 异常红标 + 我的接单去询房中

变更类型：♻️ 重构（后端，房务管家前端需配合渲染）端类型：管理后台（房务管家·订单详情进度条 / 我的接单 / 日历）日期：2026-06-25 ｜工单：#4380 ｜ PR：#4389 ｜服务：hl-order-service-v3（双实例已部署 health UP，测试服 API 实测全通过）

背景

房务管家进度条原 6 步（待配房 / 配房中 / 询房中 / 待最终确认 / 已完成 / 异常）两处口径不对：

配房和询房本就一间间一起干，把「询房中」单拎成流程节点（还排在配房中之后）不合理。
异常是任意时刻可发生的旁支，不是「已完成」的下一站，放线性流程条里语义就错。

本单把房务内部模型拉回与对外 4 态一致：询房降级为房间级动作（只在待办露出，订单维持配房中），异常移出线性流程条、改为当前步红标 + 待办/我的接单处置。修订 #4255/#4257/#4261/#4239「4 步改 6 步拆询房中」口径。

接口 / 响应结构变化（前端需改）

1. 订单详情进度条 `GET /admin/house/orders/{orderId}` → `data.progress`

currentStep 取值 1-6 → 1-4（待配房→配房中→待最终确认→已完成）。
steps 数组 6 节点 → 4 节点（去掉「询房中」「异常」两节点）。
houseStatus 不再返 IN_INQUIRY（存量数据已迁移成 CLAIMING）。剩 5 态：PENDING_CLAIM/CLAIMING/PENDING_FINALIZE/CONFIRMED/EXCEPTION。
新增 2 字段：
- progress.exception（Boolean）：是否处异常态。
- progress.exceptionLabel（String）：异常态返「异常」，否则 null。
- 异常不占线性节点，前端在当前步（异常态时 currentStep=2 配房中）叠加红色「异常」标。

2. 我的接单 `GET /v3/admin/order/grab-pool/my-claims/hotel`（+ stats）

stats.inInquiry 废弃，恒返 0（向后兼容，前端去掉「询房中」tab）。
stats.inProgress 口径 CLAIMING+IN_INQUIRY → = CLAIMING。
status 入参去掉 inInquiry（仍传 inInquiry 会兼容映射到 claiming，不报错）。
异常筛选 status=exception + stats.exception 改为「待办驱动并集」口径：
- = house_status=EXCEPTION（客户退改/取消转异常）∪ 有 OPEN 异常类待办（询价超时 / 酒店拒单 / 换酒店 / 退款）的订单。
- 即拒单/超时的订单现在也会进异常筛选（它们 house_status 维持 CLAIMING、但挂着异常类待办）。与日历异常桶、列表行内 exceptionCount 角标三处同源。

3. 询房降级为房间级

详情/日历不再有「询房中」整团态。那一天「待回询价」靠该天的 inquiry(PENDING) 记录派生展示。
日历「询房中」桶语义改房间级（读 PENDING 询房记录，不读 house_status）。

4. 日历「异常」桶 = 待办驱动

日历异常点不再等价于 house_status=EXCEPTION，而是「有 OPEN 异常类待办」（含超时/拒单）。这是「异常处置=待办露出」的预期行为。

5. `houseStatus` 全链路不再返 `IN_INQUIRY`

前端若有硬编码判断 houseStatus === 'IN_INQUIRY' 的分支，请清理。

后端行为变化（前端无需改，知悉即可）

房务发询价 / 酒店回复：不再改订单态（维持配房中），询价记录照常落库。
询价超时(4h) / 酒店拒单：不再把整单翻异常，改生成待办（询价超时待办 / 换酒店待办）在待办列表处置，订单维持配房中。顺带治掉「一间房酒店慢回复/拒单连累整单异常」。
仍会让订单进「异常」的只剩真·整单级：客户退改 / 订单取消 / 超占。
换酒店不再改 house_status（本就发生在配房中），换完自动 RESOLVE 换酒店待办。

前端待办（房务管家，mmg）

订单详情进度条按 4 步渲染；异常态在当前步叠红色异常标（用新 progress.exception / exceptionLabel）。
我的接单去掉「询房中」tab；异常 tab 保留（现含拒单/超时单）。
日历 / 详情的「询房中」改房间级显示（那天待回询价），不再当整团态。
清理硬编码 IN_INQUIRY 判断。

注：DB 列 order_hotel_requirement.house_status 的 COMMENT 仍写 6 态（Flyway 已冻结不改原文件，仅文字陈旧，不影响逻辑）。

4.5 KiB 原始文件 Blame 文件历史 Unescape Escape