# 二期 v3 HOUSE 房务：配房写主链真机阻断修复（提交 / 改价 / 最终确认）

> **服务**: hl-order-service-v3
> **PR**: #3117
> **Issue**: #3115
> **日期**: 2026-05-27
> **影响**: 🟡 配房三个核心写接口（提交配房 / 改单条配房 / 最终确认）此前真机一律失败，现已修复并测试服真机验证通过。**接口路径与出入参字段无任何变化**，前端无需改代码，可正常联调配房写流程。

---

## 背景

真机 API 测试（真 admin token 经网关 + 真实订单数据）发现配房「提交 → 改价 → 最终确认」三个写接口此前 100% 失败（单测 mock 能过、真机全挂），现修复。

## 受影响接口（仅"从报错变为可用"，契约不变）

### 1. `POST /v3/admin/order/hotel-requirements/{requirementId}/assignments`（§2.2 提交配房）
- 之前：当所选酒店在 resource 无协议价时，返回 `400 字段【proto_price】未填写`，配房无法落库。
- 现在：正常 200 落库。协议价/结算方式/付款模式/酒店名在主数据缺失（H04 接通前）时存 NULL，待回填，**不影响提交**。
- 出参结构不变：`{ successCount, failCount, items:[{dayNumber, familyIndex, assignmentId, arrange}] }`。

### 2. `PUT /v3/admin/order/assignments/{id}`（§2.3 改单条配房）
- 之前：返回 `500`（服务器内部错误，乐观锁拦截器缺失）。
- 现在：正常 200，`sellPrice` 改后 `totalCost` 自动重算、`version` 自增。

### 3. `POST /admin/house/assignments/requirements/{requirementId}/finalize`（§2.7 最终确认）
- 之前：闸口校验通过后仍返回 `400 字段【operator_name】未填写`，需求卡在 PROCESSING 无法定稿。
- 现在：正常 200，需求推进到 `DONE`，返回 `{ newStatus:"DONE", finalizedAt }`。

## 真机验证（测试服双实例已部署）

完整链路 claim → 提交配房(3 晚) → 改价 → 询房发起/回填 → 最终确认 → 删配房 全部 200 通过；need/requirement 正确流转到 DONE。

## 不在本次范围（仍为占位，依赖后续工单，前端先按空处理）

- §2.1 候选源、§2.0 订单详情聚合 order 子对象、§6.1 酒店列表、§6.6 staff 列表：依赖 H04(product-v2/OrderService Feign) / resource 主数据 / H07(user-service)，暂为空/占位。
- §2.5 房间分配「写」入口（家庭维度 assignRooms）当前无对外端点，§2.5 GET 的逐日 `assignments` 暂为空（另行评估是否补端点）。
