2.5 KiB
2.5 KiB
二期 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暂为空（另行评估是否补端点）。