docs(house): 补充房务全量复测与前端接入总览

这个提交包含在:
API Changelog Bot
2026-07-14 23:58:36 +08:00
父节点 5954565ec5
当前提交 2b37f6124b
共修改 2 个文件,包含 181 行新增和 3 行删除
@@ -1,5 +1,7 @@
# 【行为变更·管理后台】订单调整保留配房与房务驳回定制师待办(#4907)
> 2026-07-14 最终状态:#4907 后端链路已完成并关闭;最终全量复测与前端接入总览见 `57_房务全量API复测与前端最终接入核对-管理后台.md`。前端页面验收属于独立交付,不作为后端工单关单门禁。
> 服务:`hl-order-service-v3`
>
> 生效分支:`dev-v3`
@@ -60,7 +62,7 @@ GET /v3/admin/order/todos?scope=mine&status=OPEN&page=1&pageSize=20
- `REQUIREMENT_ADJUSTED` 与同一需求的 `PENDING_ARRANGE` 后端已互斥,`stats.PENDING_ARRANGE` 同口径排除。
- 前端禁止根据 `houseStatus=CLAIMING` 自行补“刚抢单待配房”。
- `HOTEL_REPLY_TIMEOUT`、`UNREAD_CHAT` 可与返工标签并存,不能因为互斥普通新抢标签而一并隐藏。
- 当前未完成阻塞项仍是 §1 的目标晚次选择和“调整”入口;该页面未验收前 Issue #4907 保持 OPEN。
- §1 的目标晚次选择和“调整”入口属于前端实现清单;前端完成后独立验收,不再用于控制后端 Issue #4907 状态。
### 0.4 首页、待办列表、订单详情必须保持一致
@@ -77,7 +79,7 @@ GET /v3/admin/order/todos?scope=mine&status=OPEN&page=1&pageSize=20
- `HOTEL_REPLY_TIMEOUT`、`UNREAD_CHAT` 等独立提醒可以与返工主标签共存,但不得自行拼接同需求的 `PENDING_ARRANGE`。
- 调整配房只能提交目标 `dayNumber`,不得自行提交或计算 `stayDate`;入住日期由后端根据当前行程晚次推导。
Issue #4907 的前端关闭证据必须包含同一订单在“房务首页、待办列表、订单详情”三处的刷新后截图,并能证明标签、数量和当前业务状态一致。缺少任一页面截图,或详情仍无“调整”入口,Issue 保持 OPEN。
前端独立验收建议包含同一订单在“房务首页、待办列表、订单详情”三处的刷新后截图,并证明标签、数量和当前业务状态一致;该证据用于前端交付验收,不反向重开已完成的后端 Issue。
## 1. 订单调整后的房务口径
@@ -241,7 +243,7 @@ Content-Type: application/json
11. 需求变更返工订单只展示 `需求变更重配` 主标签,不得再从 `CLAIMING` 自行补出 `刚抢单待配房`;询房超时、未读消息等独立标签照常展示。
12. 每条已有配房均提供“调整”入口,可选择当前有效晚次并同时修改酒店、房型、房间数和库存口径;改期后从 6 月 1 日调整到当前第 1 晚 6 月 5 日时提交 `dayNumber=1`。
13. 同一返工订单在房务首页、待办列表、订单详情三处的主标签、数量和当前状态一致;动作成功后均使用重新请求的数据,不使用本地旧缓存补标签。
14. 前端提交单条配房调整时只提交 `dayNumber`,不得提交 `stayDate`;关闭 #4907 前提供三处页面刷新后的同订单截图。
14. 前端提交单条配房调整时只提交 `dayNumber`,不得提交 `stayDate`;完成前端适配时提供三处页面刷新后的同订单截图。
## 5. 后端验证证据