From bd14ac0d07b1738c82a56f065fda5d20f8bed72f Mon Sep 17 00:00:00 2001 From: API Changelog Bot Date: Fri, 19 Jun 2026 19:58:22 +0800 Subject: [PATCH] =?UTF-8?q?docs(changelog-v2):=20=E6=88=BF=E5=8A=A1?= =?UTF-8?q?=E5=8E=9F=E5=9E=8B=E5=AF=B9=E9=BD=90=20=E9=85=8D=E6=88=BF?= =?UTF-8?q?=E5=80=99=E9=80=89=E9=85=92=E5=BA=97=E6=A0=87=E7=AD=BE(#4070)?= =?UTF-8?q?=20+=20=E4=BB=B7=E6=A0=BC=E6=97=A5=E5=8E=86=E5=BA=95=E4=BB=B7?= =?UTF-8?q?=E5=8D=A0=E4=BD=8D(#4071)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...-配房候选酒店标签+价格日历底价字段-管理后台.md | 73 +++++++++++++++++++ 1 file changed, 73 insertions(+) create mode 100644 changelogs-v2/2026-06/19_4070_4071_房务原型对齐-配房候选酒店标签+价格日历底价字段-管理后台.md diff --git a/changelogs-v2/2026-06/19_4070_4071_房务原型对齐-配房候选酒店标签+价格日历底价字段-管理后台.md b/changelogs-v2/2026-06/19_4070_4071_房务原型对齐-配房候选酒店标签+价格日历底价字段-管理后台.md new file mode 100644 index 0000000..34d3899 --- /dev/null +++ b/changelogs-v2/2026-06/19_4070_4071_房务原型对齐-配房候选酒店标签+价格日历底价字段-管理后台.md @@ -0,0 +1,73 @@ +# 房务原型对齐 — 配房候选项酒店运营标签 + 价格日历底价字段 — 修改接口 — 管理后台 + +> 变更类型：✨ 响应字段新增（候选项 tags）+ 🔧 字段占位预留（价格日历 floorPrice） +> 端类型：管理后台（房务管家 · 配房选酒店 / 酒店管理 · 价格日历） +> 日期：2026-06-19 +> 服务：hl-order-service-v3 + hl-resource-service +> PR：https://git.1814.love:8443/wx/HL/pulls/4081 （Closes #4070）、https://git.1814.love:8443/wx/HL/pulls/4078 （Closes #4071） + +--- + +## ⚠️ 关键说明（给前端，2 处） + +### 1. 配房候选项返回酒店「运营标签」(#4070) + +配房选酒店候选接口 `GET /v3/admin/hotel-candidates` 的每个候选项**新增 `tags` 字段**（`List`，酒店运营标签名列表，如「草原景观」「网红」「性价比高」）。 + +- 标签数据来自**现有酒店标签库**——资源管理 · 酒店管理本就有的打标签能力（`/admin/hotel` 系列标签接口），不是新机制。 +- 前端在配房候选项渲染标签 chip；**无标签的酒店返空数组 `[]`（不返 null）**。 +- 给酒店打/改标签仍走现有 `PUT /admin/hotel/item/{hotelId}/tags`、`/admin/hotel/tags` 等接口；本次只是把酒店**已打的标签**透传到配房候选项展示。 + +### 2. 价格日历新增「底价」字段(#4071) + +房型价格日历 `GET / PUT /admin/hotel/room-type/{roomTypeId}/prices` 每天**新增 `floorPrice`（底价）字段**（字符串金额，如 `"260.00"`）。 + +- **占位预留，当前不接任何业务逻辑**——可读可写可存，但暂不参与任何计算/校验。 +- 前端**当前不用**（后续真正接入时再单独通知）；GET 默认返 `null`，PUT 可不传。 + +--- + +## 1. 配房候选项 tags（#4070，响应结构新增） + +**`GET /v3/admin/hotel-candidates`**（路径/入参不变，仅响应每个候选项新增字段） + +| 新增字段 | 类型 | 说明 | +|---|---|---| +| tags | List<String> | 酒店运营标签名列表（来自酒店标签库；无标签返 `[]`） | + +候选项其余字段（protoPrice 协议价、isPoolMatch 池内标记、todayAvailable 可用房等）不变。 + +--- + +## 2. 价格日历 floorPrice（#4071，字段占位） + +**`GET / PUT /admin/hotel/room-type/{roomTypeId}/prices`**（路径/结构不变，每天日历项新增字段） + +| 新增字段 | 类型 | 说明 | +|---|---|---| +| floorPrice | String（金额，ToString 序列化） | 底价（占位预留，暂不用）；GET 返出、PUT 可填入库 | + +```bash +# GET 月度价格日历（每天含 floorPrice，默认 null） +curl -k "https://api.test.1814.love:9443/admin/hotel/room-type/{roomTypeId}/prices?year=2026&month=6" \ + -H "Authorization: Bearer " +``` + +响应片段（已测试服实测）： + +```json +{ "date": "2026-06-15", "protocolPrice": "320.00", "floorPrice": "260.00", + "status": "AVAILABLE", "stock": 5, "stockUsed": 0, "remark": null } +``` + +--- + +## 测试 + +- **#4071** 已在测试服 9443 实测：GET 每天返 `floorPrice` 字段（默认 null）、PUT 写 `260.00` 回读为字符串 `"260.00"`（金额 String 序列化正确）、DELETE 还原。Flyway `V20260619_002` 已应用。 +- **#4070** 候选端点已部署可达；`tags` 透传由单测覆盖（resource 37 / order-v3 候选 40 全绿）+ 同一取标签方法 `getTagsByHotelIds` 在 admin 酒店列表实证返真标签。 + +## 备注 + +- 网关无需改（`/v3/admin/hotel-candidates`、`/admin/hotel/**` 路由已覆盖）。 +- via 房务管家 v2.0 原型对齐 batch（预付款先不做；月度对账/酒店富表单/配房改价 另立工单 #4072-#4074）。