# 【后端调整·管理后台】资源价格日历「成本价」字段改名为「协议价」（6 类资源，⚠️破坏性字段改名）

> **PR**: #3467 | **关联工单**: #3463
> **服务**: hl-resource-service（价格日历）+ hl-order-service-v3（配房 Feign 契约）| **更新时间**: 2026-06-05
>
> **存放目录**: `changelogs-v2/2026-06/`
> **影响范围**: 管理后台 6 类资源（酒店/景点/活动/车辆/向导/服务）价格日历的「成本价」字段

---

## ⚠️ 关键说明（破坏性变更，前端必须同步改）

资源价格日历里维护的「成本价」实质是跟供应商签的**协议结算价**，本次统一口径，把 6 类资源价格日历的 **字段名 `costPrice` → `protocolPrice`**（DB 列 `cost_price` → `protocol_price` 同步改）。

**这是破坏性变更**：接口请求/响应的 JSON key 从 `costPrice` 变成 `protocolPrice`。**前端 6 类资源价格日历页面（设置/查询/展示）必须同步把 `costPrice` 改成 `protocolPrice`，否则设置价格传不进、查询取价为 undefined。**

已部署测试服并 API 实测通过（写 `protocolPrice` → 查回 `protocolPrice`，旧 `costPrice` 已彻底消失）。

---

## 1. 字段改名（6 类资源全部）

| 资源 | 接口前缀 | 原字段 | 新字段 |
|---|---|---|---|
| 酒店（房型） | `/admin/hotel/room-type/{id}/prices` | `costPrice` | `protocolPrice` |
| 景点 | `/admin/scenic/.../prices` | `costPrice` | `protocolPrice` |
| 活动 | `/admin/activity/.../prices` | `costPrice` | `protocolPrice` |
| 车辆 | `/admin/vehicle/.../prices` | `costPrice` | `protocolPrice` |
| 向导 | `/admin/staff/.../prices` | `costPrice` | `protocolPrice` |
| 服务 | `/admin/service/.../prices` | `costPrice` | `protocolPrice` |

涉及的接口：① 批量设置价格日历（PUT，请求体 `costPrice`→`protocolPrice`）② 查询价格日历（GET，响应每日 VO 的 `costPrice`→`protocolPrice`）。

## 2. 展示文案变化

- **酒店/景点/活动/服务**：标签「成本价」→「协议价」（Swagger / 校验提示 / 错误码消息）
- **车辆**：文案仍叫「日租价」（保留，仅 JSON 字段名变 `protocolPrice`）
- **向导**：文案仍叫「日薪」（保留，仅 JSON 字段名变 `protocolPrice`）

## 3. 未变（不影响前端）

- 字段类型不变（仍 BigDecimal，元）；接口路径不变；其余字段（status/stock/stockUsed/remark/date）不变
- 挂牌价 `basePrice` 字段不动（本次不涉及）
- 内部价格查询接口（产品报价用）字段名 `price` 不变，product 侧无影响

## 4. 请求/响应示例（以酒店房型为例）

设置（PUT `/admin/hotel/room-type/{roomTypeId}/prices`）：

```json
{
  "startDate": "2026-07-01",
  "endDate": "2026-07-31",
  "protocolPrice": 580.00,
  "status": "AVAILABLE",
  "stock": 10
}
```

查询（GET `/admin/hotel/room-type/{roomTypeId}/prices?year=2026&month=7`）响应每日项：

```json
{
  "date": "2026-07-01",
  "protocolPrice": 580.00,
  "status": "AVAILABLE",
  "stock": 10,
  "stockUsed": 0,
  "remark": null
}
```

---

## 5. 关联 / 联系人

- **本次 PR**：#3467（Closes #3463）
- **后端负责人**：@wx
- **前端对接（管理后台）**：mmg —— 6 类资源价格日历页面 `costPrice` → `protocolPrice` 全量替换