docs(house): 明确返工标签与配房晚次调整交接

这个提交包含在:
API Changelog Bot 2026-07-12 16:59:02 +08:00
父节点 edcf5a27ca
当前提交 77ba6986b1

查看文件

@ -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`