diff --git a/changelogs-v2/2026-06/05_3463_资源价格日历成本价改名协议价-管理后台.md b/changelogs-v2/2026-06/05_3463_资源价格日历成本价改名协议价-管理后台.md new file mode 100644 index 0000000..6038283 --- /dev/null +++ b/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` 全量替换