30_4782_房务配房价格快照与询房酒店名-修改接口-管理后台

状态：frontend-todo
后端工单：wx/HL#4782
影响端：管理后台 hl-ui-v2.1 房务/订单详情
关联文档：docs/order-v3/api/API-SPEC-HOUSE-V1.1.html v1.1.9

背景

房务配房时，协议价、结算价、成交价都需要按“配房当时”冻结到订单配房表。后续资源价格日历变化不能反向改历史订单。

同时，房务在配房弹窗里改协议价/结算价时，不能默认同步到资源价格日历，必须由房务显式选择是否同步。

前端改动点

1. 配房提交/替换要传价格快照

接口：POST /v3/admin/order/hotel-requirements/{requirementId}/assignments

items[] 新增/明确字段：

{
  "protoPrice": "320.00",
  "settlementPrice": "300.00",
  "sellPrice": "340.00",
  "syncProtocolPrice": false,
  "syncSettlementPrice": false
}

protoPrice：协议价快照。
settlementPrice：结算价快照。
sellPrice：售价/成交价快照。
syncProtocolPrice：是否把本次 protoPrice 写回资源价格日历。
syncSettlementPrice：是否把本次 settlementPrice 写回资源价格日历。

2. 修改单条配房也要支持同步选择

接口：PUT /v3/admin/order/assignments/{assignmentId}

请求体同样支持：

{
  "protoPrice": "330.00",
  "settlementPrice": "310.00",
  "sellPrice": "350.00",
  "syncProtocolPrice": false,
  "syncSettlementPrice": true,
  "remark": "酒店周末加价 20"
}

前端交互要求：

房务改了协议价时，弹出是否同步到资源价格日历，结果写入 syncProtocolPrice。
房务改了结算价时，弹出是否同步到资源价格日历，结果写入 syncSettlementPrice。
默认不同步，不能静默写回资源。
sellPrice 不参与资源价格日历写回。

3. 选酒店列表需要展示并携带结算价

resource 候选/库存返回里会带 settlementPrice。前端选中房型加入已选列表时，需要保留：

协议价：protocolPrice/protoPrice
结算价：settlementPrice
成交价：sellPrice

提交配房时把这些快照一起传给 order-v3。

4. 清空配房必须二次确认

接口：DELETE /v3/admin/order/hotel-requirements/{requirementId}/assignments

前端清空前必须连续两次确认：

第一次说明：将清空当前需求下全部已配房信息，不释放抢单人。
第二次说明：清空后需要重新配房/重新最终确认，已扣库存会释放。

任一确认取消都不能调用接口。接口成功后刷新订单详情，状态会回退到配房中/待配房，不应继续显示最终确认。

5. 询房复制话术必须带酒店名

前端自拼 messageBody 时必须带酒店名，推荐格式：

@张经理 伯爵大酒店 2026-07-24 入住 1 晚, 需要 1 间标间, 请问还有房吗? 方便报个价

没有联系人时不要生成孤立 @。

后端 preview 兜底模板也会自动带酒店名，并兼容旧文案补酒店名；但前端仍应按新格式拼，避免复制框首屏缺酒店名。

6. Internal 配房快照响应新增价格字段

接口：GET /v3/internal/house/orders/{orderId}/assignments

items[] 新增：

{
  "protoPrice": "320.00",
  "settlementPrice": "300.00",
  "sellPrice": "340.00",
  "confirmStatus": "CONFIRMED"
}

下游读取订单配房酒店信息时，以这些字段作为订单当时快照，不要重新按当前资源价格日历推断历史价格。

3.5 KiB 原始文件 Blame 文件历史 Unescape Escape