docs(house): 补齐4907前端返工待办交接

changelogs-v2/2026-07/56_4907_订单调整保留配房与房务驳回定制师待办-管理后台.md

@@ -6,9 +6,9 @@
 >
 > 接口结构：新增“单条配房晚次与资源原子调整”接口；其余沿用订单调整、房务详情、最终确认和房务驳回现有接口
 >
-> 后端状态：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
+> 后端状态：PR [#4915](https://git.1814.love:8443/wx/HL/pulls/4915)、[#4925](https://git.1814.love:8443/wx/HL/pulls/4925)、[#4926](https://git.1814.love:8443/wx/HL/pulls/4926)、[#4928](https://git.1814.love:8443/wx/HL/pulls/4928)、[#4931](https://git.1814.love:8443/wx/HL/pulls/4931) 已合并；最新测试环境部署任务 `eb216570` 成功，`8086/8186` 双实例 UP
 >
-> 联调证据：2026-07-12 网关三场景探针通过，覆盖跨晚次原子移动、订单改期库存迁移、库存不足补偿和房务驳回待办；返工订单待办/工作台标签互斥实测通过
+> 联调证据：2026-07-12 最终网关四场景探针通过，覆盖连续改需求、跨晚次原子移动、最终确认、供应商驳回、订单取消、库存迁移与库存不足补偿；报告 `D:/work2/HL-v3/.tmp/house-adjustment-flow-probe-20260712-212622.json` 为 `ok=true`
 
 ## 0. 2026-07-12 追加：返工标签唯一口径与前端未完成项
 
@@ -38,6 +38,30 @@
 
 目前房务详情仍只读展示 `stayDate`，只有“替换/配房/询房”等旧动作，无法把既有配房调整到当前行程的另一个有效晚次。前端需要在每条已有配房旁增加“调整”入口，完整调用下文 §1 的 placement 接口；不能只改页面显示，也不能组合“新增目标晚 + 删除原晚”。
 
+### 0.3 返工待办生命周期与刷新规则
+
+`REQUIREMENT_ADJUSTED` 不是永久状态标签。前端每次业务动作成功后必须重新请求待办和房务详情，不能用旧页面缓存继续展示：
+
+| 业务动作 | 后端结果 | 前端处理 |
+|---|---|---|
+| 同一需求版本重复触发调整事件 | 幂等复用原待办，不新增重复标签 | 保留一条 `需求变更重配` |
+| 连续调整产生新需求版本 | 旧版本返工待办转 `RESOLVED`，只保留当前版本 OPEN 待办 | 刷新后仍只显示一条当前返工标签 |
+| 当前需求最终确认 | 当前 `REQUIREMENT_ADJUSTED` 自动 `RESOLVED` | 从未完成列表和工作台卡片移除 |
+| 房务驳回住宿需求 | 房务返工待办自动 `RESOLVED`，订单侧为原定制师产生 `ASSIGN_ROOM` 待办 | 房务端移除返工标签，不展示定制师待办 |
+| 订单取消 | 房务返工待办自动 `RESOLVED`；有配房时可能产生 `REFUND`，退款成功后该待办可立即变为 `RESOLVED` | 不得假设取消后一定存在 OPEN `REFUND` |
+
+待办接口的当前契约：
+
+```http
+GET /v3/admin/order/todos?scope=mine&status=OPEN&page=1&pageSize=20
+```
+
+- 一订单一行，完整标签来自 `list[].todoTypes[]`；顶层 `todoType/title` 只是主标签兼容字段。
+- `REQUIREMENT_ADJUSTED` 与同一需求的 `PENDING_ARRANGE` 后端已互斥，`stats.PENDING_ARRANGE` 同口径排除。
+- 前端禁止根据 `houseStatus=CLAIMING` 自行补“刚抢单待配房”。
+- `HOTEL_REPLY_TIMEOUT`、`UNREAD_CHAT` 可与返工标签并存，不能因为互斥普通新抢标签而一并隐藏。
+- 当前未完成阻塞项仍是 §1 的目标晚次选择和“调整”入口；该页面未验收前 Issue #4907 保持 OPEN。
+
 ## 1. 订单调整后的房务口径
 
 定制师通过以下接口修改行程天数、出发日期或出行人数：
@@ -202,10 +226,10 @@ Content-Type: application/json
 
 ## 5. 后端验证证据
 
-- PR：`wx/HL#4910`、`wx/HL#4911`、`wx/HL#4913`
+- PR：`wx/HL#4910/#4911/#4913/#4915/#4925/#4926/#4928/#4931`
-- 测试环境部署任务：`440ed4d1`，`8086/8186` 双实例均 UP
+- 最新测试环境部署任务：`eb216570`，`8086/8186` 双实例均 UP
-- 模块全量：5499 项；与 clean baseline 相同的既有 5 项失败，无新增回归
+- 定向测试：276 项通过；模块全量 5523 项仅复现 clean baseline 的 3 失败 + 2 错误，无新增回归
-- 网关全流程报告：`D:/work2/HL-v3/.tmp/house-adjustment-flow-probe-20260712-024715.json`
+- 最终网关全流程报告：`D:/work2/HL-v3/.tmp/house-adjustment-flow-probe-20260712-212622.json`，四场景全部 `ok=true`
-- 实测通过：增晚、减晚、人数变化、改期+增晚同次提交、酒店/房型/房间数替换、入住日期对齐、人工清空、零配房最终确认、房务驳回待办、库存成功迁移、库存不足整单回滚
+- 实测通过：增晚、减晚、人数变化、连续调整新旧待办替代、改期+增晚同次提交、酒店/房型/房间数替换、入住日期对齐、人工清空、零配房最终确认、供应商驳回、订单取消、库存成功迁移、库存不足整单回滚
-- PR #4925 / 部署任务 `611265ea`：返工订单 `todoTypes=[REQUIREMENT_ADJUSTED,HOTEL_REPLY_TIMEOUT]`，`PENDING_ARRANGE` 筛选 0 行，工作台主标签为 `REQUIREMENT_ADJUSTED`
+- 返工标签：`REQUIREMENT_ADJUSTED` 压制同需求 `PENDING_ARRANGE`；最终确认、供应商驳回、订单取消后统计均从 1 回到 0