docs(changelog): 资源价格日历成本价改名协议价(6类资源,破坏性字段改名) #3463

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

changelogs-v2/2026-06/05_3463_资源价格日历成本价改名协议价-管理后台.md

@@ -0,0 +1,79 @@
+# 【后端调整·管理后台】资源价格日历「成本价」字段改名为「协议价」（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` 全量替换