docs: 更新4907房务最终确认契约与验证证据

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

@@ -1,6 +1,6 @@
 # 【行为变更·管理后台】订单调整保留配房与房务驳回定制师待办（#4907）
 
-> 2026-07-14 最终状态：#4907 后端链路已完成并关闭；最终全量复测与前端接入总览见 `57_房务全量API复测与前端最终接入核对-管理后台.md`。前端页面验收属于独立交付，不作为后端工单关单门禁。
+> 2026-07-16 最终后端状态：零配房最终确认动作契约已由 PR #5014 补齐并合入 `dev-v3`。最新代码、部署、网关 API、DB/库存和日志证据均通过；前端页面实现属于独立交付，不作为后端工单关单门禁。
 
 > 服务：`hl-order-service-v3`
 >
@@ -8,9 +8,9 @@
 >
 > 接口结构：新增“单条配房晚次与资源原子调整”接口；其余沿用订单调整、房务详情、最终确认和房务驳回现有接口
 >
-> 后端状态：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
+> 后端状态：既有 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) 与最新 PR [#5014](https://git.1814.love:8443/wx/HL/pulls/5014) 均已合并；最终验证基线 `dev-v3@d54435af7`，测试环境部署任务 `86d9bf11` 成功，`8086/8186` 双实例 UP
 >
-> 联调证据：2026-07-12 最终网关四场景探针通过，覆盖连续改需求、跨晚次原子移动、最终确认、供应商驳回、订单取消、库存迁移与库存不足补偿；报告 `D:/work2/HL-v3/.tmp/house-adjustment-flow-probe-20260712-212622.json` 为 `ok=true`
+> 联调证据：2026-07-16 部署后重新使用隔离订单执行接口面、缺口流程、订单日志和调整闭环四组探针，全部通过；最终调整报告 `D:/work2/HL-v3/.tmp/house-adjustment-flow-probe-20260716-184129.json` 为 `ok=true`
 
 ## 0. 2026-07-12 追加：返工标签唯一口径与前端未完成项
 
@@ -202,6 +202,29 @@ POST /admin/house/assignments/requirements/{requirementId}/finalize
 
 前端收到该错误后保留当前配房数据，提示房务逐日处理；不得清空页面状态或隐藏超出新行程的旧配房。
 
+### 2.1 零配房动作契约
+
+详情接口与最终确认写接口现已使用同一业务口径：
+
+- 当前生效需求由当前房务持有。
+- `houseStatus=CLAIMING`。
+- 没有任何配房记录。
+- 没有未闭环询房。
+
+满足以上条件时，房务详情返回：
+
+```json
+{
+  "actions": {
+    "canFinalize": {
+      "enabled": true
+    }
+  }
+}
+```
+
+以下场景仍保持禁用：存在部分配房、存在未闭环询房、非当前持有人、非当前生效需求或需求已经完成。最终确认成功后必须重新加载详情和待办；后端会关闭相关待办且不会创建配房或变更库存。
+
 ## 3. 房务驳回后的定制师待办
 
 ```http
@@ -247,10 +270,14 @@ Content-Type: application/json
 
 ## 5. 后端验证证据
 
-- PR：`wx/HL#4910/#4911/#4913/#4915/#4925/#4926/#4928/#4931`
+- PR：`wx/HL#4910/#4911/#4913/#4915/#4925/#4926/#4928/#4931/#5014`
-- 最新测试环境部署任务：`eb216570`，`8086/8186` 双实例均 UP
+- 最终验证基线：`dev-v3@d54435af7`
-- 定向测试：276 项通过；模块全量 5523 项仅复现 clean baseline 的 3 失败 + 2 错误，无新增回归
+- 模块全量：5609 项测试，0 failure，0 error，15 skipped，`BUILD SUCCESS`
-- 最终网关全流程报告：`D:/work2/HL-v3/.tmp/house-adjustment-flow-probe-20260712-212622.json`，四场景全部 `ok=true`
+- 最新测试环境部署任务：`86d9bf11`，`8086/8186` 双实例均 UP
-- 实测通过：增晚、减晚、人数变化、连续调整新旧待办替代、改期+增晚同次提交、酒店/房型/房间数替换、入住日期对齐、人工清空、零配房最终确认、供应商驳回、订单取消、库存成功迁移、库存不足整单回滚
+- 网关接口面：68/68 通过，报告 `D:/work2/HL-v3/.tmp/house-api-surface-probe-20260716-182908.json`
-- 返工标签：`REQUIREMENT_ADJUSTED` 压制同需求 `PENDING_ARRANGE`；最终确认、供应商驳回、订单取消后统计均从 1 回到 0
+- 缺口流程：3/3 通过，报告 `D:/work2/HL-v3/.tmp/house-api-gap-flow-probe-20260716-183121.json`
+- 订单日志：3/3 通过，报告 `D:/work2/HL-v3/.tmp/house-order-log-flow-probe-20260716-183224.json`
+- 调整闭环：4/4 通过，报告 `D:/work2/HL-v3/.tmp/house-adjustment-flow-probe-20260716-184129.json`
+- 实测通过：增晚、减晚、人数变化、连续调整新旧待办替代、改期+增晚、跨晚次原子调整、酒店/房型/房间数替换、入住日期对齐、人工清空、零配房最终确认、供应商驳回、订单取消、库存成功迁移、库存不足整单回滚
+- 返工标签：`REQUIREMENT_ADJUSTED` 压制同需求 `PENDING_ARRANGE`；最终确认、供应商驳回、订单取消后返工待办均正确关闭