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

> **服务**: hl-order-service-v3
> **Issue**: [wx/HL#5176](https://git.1814.love:8443/wx/HL/issues/5176)
> **PR**: [wx/HL#5179](https://git.1814.love:8443/wx/HL/pulls/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[]` 删除重复价格字段，改为双价 |

### 配房提交/修改入参

只提交：

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

不要再提交：

```json
{
  "sellPrice": 688.00
}
```

### 房务详情配房项

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

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

已删除：`sellPrice`。

### 订单行程住宿回配项

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

```json
{
  "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` 未修改，前端适配由管理后台项目单独处理。
