From 77ba6986b15be3e4eda46e8d00bf2ce3e3bf9746 Mon Sep 17 00:00:00 2001 From: API Changelog Bot Date: Sun, 12 Jul 2026 16:59:02 +0800 Subject: [PATCH] =?UTF-8?q?docs(house):=20=E6=98=8E=E7=A1=AE=E8=BF=94?= =?UTF-8?q?=E5=B7=A5=E6=A0=87=E7=AD=BE=E4=B8=8E=E9=85=8D=E6=88=BF=E6=99=9A?= =?UTF-8?q?=E6=AC=A1=E8=B0=83=E6=95=B4=E4=BA=A4=E6=8E=A5?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...调整保留配房与房务驳回定制师待办-管理后台.md | 37 +++++++++++++++++-- 1 file changed, 34 insertions(+), 3 deletions(-) diff --git a/changelogs-v2/2026-07/56_4907_订单调整保留配房与房务驳回定制师待办-管理后台.md b/changelogs-v2/2026-07/56_4907_订单调整保留配房与房务驳回定制师待办-管理后台.md index 0494408..e8f9927 100644 --- a/changelogs-v2/2026-07/56_4907_订单调整保留配房与房务驳回定制师待办-管理后台.md +++ b/changelogs-v2/2026-07/56_4907_订单调整保留配房与房务驳回定制师待办-管理后台.md @@ -6,9 +6,37 @@ > > 接口结构：新增“单条配房晚次与资源原子调整”接口；其余沿用订单调整、房务详情、最终确认和房务驳回现有接口 > -> 后端状态：PR [#4915](https://git.1814.love:8443/wx/HL/pulls/4915) 已合并；测试环境部署任务 `b60dccde` 成功，`8086/8186` 双实例 UP +> 后端状态：PR [#4915](https://git.1814.love:8443/wx/HL/pulls/4915)、[#4925](https://git.1814.love:8443/wx/HL/pulls/4925) 已合并；最新测试环境部署任务 `611265ea` 成功，`8086/8186` 双实例 UP > -> 联调证据：2026-07-12 网关三场景探针通过，覆盖跨晚次原子移动、订单改期库存迁移、库存不足补偿和房务驳回待办 +> 联调证据：2026-07-12 网关三场景探针通过，覆盖跨晚次原子移动、订单改期库存迁移、库存不足补偿和房务驳回待办；返工订单待办/工作台标签互斥实测通过 + +## 0. 2026-07-12 追加：返工标签唯一口径与前端未完成项 + +### 0.1 返工订单不能再展示“刚抢单待配房” + +后端已修复待办聚合口径：同一需求存在归属当前房务的 OPEN `REQUIREMENT_ADJUSTED` 时，`需求变更重配` 是主待办，后端不会再为该需求派生 `PENDING_ARRANGE`。 + +- `GET /v3/admin/order/todos`：该订单 `todoTypes[]` 不再包含 `PENDING_ARRANGE`。 +- 按 `todoType=PENDING_ARRANGE` 筛选：返工订单不会进入结果。 +- `GET /admin/profile/dashboard`：对应 `todoCards[].todoType` 为 `REQUIREMENT_ADJUSTED`，文案为“需求变更重配”。 +- `HOTEL_REPLY_TIMEOUT`、`UNREAD_CHAT` 等独立提醒仍可与返工标签共存，前端不得把它们误删。 + +前端必须直接按后端 `todoTypes[]` / `todoCards[].todoType` 渲染，禁止因为 `houseStatus=CLAIMING` 再自行追加“刚抢单待配房”。 + +测试环境订单 `HL20260712140748356` 网关实测结果： + +```json +{ + "todoTypes": ["REQUIREMENT_ADJUSTED", "HOTEL_REPLY_TIMEOUT"], + "pendingArrangeFacetRows": 0, + "dashboardTodoType": "REQUIREMENT_ADJUSTED", + "dashboardTodoLabel": "需求变更重配" +} +``` + +### 0.2 当前页面仍缺“调整配房”入口 + +目前房务详情仍只读展示 `stayDate`，只有“替换/配房/询房”等旧动作，无法把既有配房调整到当前行程的另一个有效晚次。前端需要在每条已有配房旁增加“调整”入口，完整调用下文 §1 的 placement 接口；不能只改页面显示，也不能组合“新增目标晚 + 删除原晚”。 ## 1. 订单调整后的房务口径 @@ -48,7 +76,7 @@ PUT /v3/admin/order/hotel-requirements/{requirementId}/assignments/{assignmentId Content-Type: application/json { - "dayNumber": 5, + "dayNumber": 1, "hotelId": "200001", "roomTypeId": "300001", "roomCategory": "DELUXE", @@ -169,6 +197,8 @@ Content-Type: application/json 8. 零配房订单允许最终确认。 9. 房务驳回后，原定制师能看到“房型需求 · 已打回”待办。 10. 历史需求和旧配房均继续展示，不得只渲染当前需求而丢失历史证据。 +11. 需求变更返工订单只展示 `需求变更重配` 主标签，不得再从 `CLAIMING` 自行补出 `刚抢单待配房`；询房超时、未读消息等独立标签照常展示。 +12. 每条已有配房均提供“调整”入口，可选择当前有效晚次并同时修改酒店、房型、房间数和库存口径；改期后从 6 月 1 日调整到当前第 1 晚 6 月 5 日时提交 `dayNumber=1`。 ## 5. 后端验证证据 @@ -177,4 +207,5 @@ Content-Type: application/json - 模块全量：5499 项；与 clean baseline 相同的既有 5 项失败，无新增回归 - 网关全流程报告：`D:/work2/HL-v3/.tmp/house-adjustment-flow-probe-20260712-024715.json` - 实测通过：增晚、减晚、人数变化、改期+增晚同次提交、酒店/房型/房间数替换、入住日期对齐、人工清空、零配房最终确认、房务驳回待办、库存成功迁移、库存不足整单回滚 +- PR #4925 / 部署任务 `611265ea`：返工订单 `todoTypes=[REQUIREMENT_ADJUSTED,HOTEL_REPLY_TIMEOUT]`，`PENDING_ARRANGE` 筛选 0 行，工作台主标签为 `REQUIREMENT_ADJUSTED`