docs(house): 明确返工标签与配房晚次调整交接
这个提交包含在:
父节点
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`
|
||||
|
||||
|
||||
正在加载...
x
在新工单中引用
屏蔽一个用户