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

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

2026-06-05 09:07:13 +08:00

3.3 KiB

原始文件 Blame 文件历史

【后端调整·管理后台】资源价格日历「成本价」字段改名为「协议价」（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）：

{
  "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）响应每日项：

{
  "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 全量替换

3.3 KiB 原始文件 Blame 文件历史 Unescape Escape