docs(v3): HOUSE 配房写主链真机修复 changelog (#3115/PR#3117)

changelogs-v2/2026-05/27_3115_HOUSE配房写主链真机修复-提交改价定稿_PR3117.md

@@ -0,0 +1,37 @@
+# 二期 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` 暂为空（另行评估是否补端点）。