hl-api-changelog/changelogs-v2/2026-07/88_5176_房务配房彻底移除成交价历史字段-修改接口-前端待处理-管理后台.md

房务配房价格模型收口为协议价与结算价

服务: hl-order-service-v3 Issue: wx/HL#5176 PR: wx/HL#5179 日期: 2026-07-23 影响范围: 管理后台 · 房务配房提交/修改/详情、订单行程住宿回配展示

---

关键变化

房务配房价格只保留两个权威字段：

字段	含义
protoPrice	协议价快照，元/间·晚
settlementPrice	结算价快照，元/间·晚

历史 sellPrice 已从房务请求、响应、持久化、快照和内部契约中删除。订单行程住宿回配对象同时删除为兼容历史展示而重复返回的 unitPrice、plannedCost、protocolPrice；前端不得继续提交、读取或回退这些字段。

本变更仅清理房务配房链路，不影响行程节点、结算票等其他业务域中的同名价格字段。

---

变更接口

接口	方法	路径	变更
提交配房方案	POST	/v3/admin/order/hotel-requirements/{requirementId}/assignments	入参项删除 sellPrice
修改单条配房	PUT	/v3/admin/order/assignments/{assignmentId}	入参删除 sellPrice
房务订单详情	GET	/admin/house/orders/{orderId}	itinerary[].assignments[] 删除 sellPrice
订单行程详情	GET	/v3/admin/order/{orderId}/itinerary	hotelGroup.assignments[] 删除重复价格字段，改为双价

配房提交/修改入参

只提交：

{
  "protoPrice": 588.00,
  "settlementPrice": 688.00
}

不要再提交：

{
  "sellPrice": 688.00
}

房务详情配房项

data.itinerary[].assignments[] 当前价格字段：

{
  "protoPrice": "588.00",
  "settlementPrice": "688.00"
}

已删除：sellPrice。

订单行程住宿回配项

data.hotelGroup.assignments[] 当前价格字段：

{
  "protoPrice": "588.00",
  "settlementPrice": "688.00"
}

已删除：

• sellPrice
• unitPrice
• plannedCost
• protocolPrice

前端价格列直接读取 settlementPrice；需要同时展示成本参考时读取 protoPrice。不要为兼容旧页面在本地重新合成 unitPrice、plannedCost 或 sellPrice。

---

金额口径

• 房务配房、房务详情和订单行程详情均直接返回落库快照，不按当前资源价格日历重算。
• 终止退款住宿单价改为从房务只读契约读取 settlementPrice；对外退款明细字段名仍为 dealPrice。
• 签单住宿成本仍读取 protoPrice。
• 核单住宿计划/实际成本继续按 settlementPrice × roomCount 派生，对外核单字段不在本次删除范围。

---

前端处理

1. 删除所有房务配房请求中的 sellPrice。
2. 房务详情和订单行程住宿价格统一展示 settlementPrice。
3. 协议价展示读取 protoPrice。
4. 删除对 sellPrice、unitPrice、plannedCost、protocolPrice 的兼容读取与回退逻辑。
5. 若接口返回的 protoPrice 或 settlementPrice 为 null，按统一空值样式展示，不用另一字段伪造。

---

后端验证

• 房务提交、修改、详情、历史快照、内部聚合、订单详情、退款和核单定向测试通过。
• 订单详情集成测试确认仅返回 protoPrice、settlementPrice，旧价格字段不存在。
• Flyway 新增迁移，精确删除 house_hotel_assignment.sell_price 与 house_requirement_assignment_snapshot.sell_price；其他业务域同名列不受影响。
• D:/work2/hl-ui 未修改，前端适配由管理后台项目单独处理。