diff --git a/changelogs-v2/2026-06/25_4389_房务去询房中顶层态-进度条4步异常红标-修改接口-管理后台.md b/changelogs-v2/2026-06/25_4389_房务去询房中顶层态-进度条4步异常红标-修改接口-管理后台.md new file mode 100644 index 0000000..9449c3b --- /dev/null +++ b/changelogs-v2/2026-06/25_4389_房务去询房中顶层态-进度条4步异常红标-修改接口-管理后台.md @@ -0,0 +1,63 @@ +# 房务去「询房中」顶层态 — 进度条 6→4 步 + 异常红标 + 我的接单去询房中 + +> 变更类型:♻️ 重构(后端,**房务管家前端需配合渲染**) +> 端类型:管理后台(房务管家·订单详情进度条 / 我的接单 / 日历) +> 日期:2026-06-25 | 工单:#4380 | PR:#4389 | 服务:hl-order-service-v3(双实例已部署 health UP,**测试服 API 实测全通过**) + +--- + +## 背景 +房务管家进度条原 6 步(待配房 / 配房中 / **询房中** / 待最终确认 / 已完成 / **异常**)两处口径不对: +1. 配房和询房本就**一间间一起干**,把「询房中」单拎成流程节点(还排在配房中之后)不合理。 +2. 异常是**任意时刻可发生的旁支**,不是「已完成」的下一站,放线性流程条里语义就错。 + +本单把房务内部模型拉回与**对外 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) +1. 订单详情进度条按 **4 步**渲染;异常态在当前步叠**红色异常标**(用新 `progress.exception` / `exceptionLabel`)。 +2. 我的接单**去掉「询房中」tab**;异常 tab 保留(现含拒单/超时单)。 +3. 日历 / 详情的「询房中」改**房间级**显示(那天待回询价),不再当整团态。 +4. 清理硬编码 `IN_INQUIRY` 判断。 + +> 注:DB 列 `order_hotel_requirement.house_status` 的 COMMENT 仍写 6 态(Flyway 已冻结不改原文件,仅文字陈旧,不影响逻辑)。