docs(changelog): 通知前端 — tier-compare 加 district / 班期 maxRooms 脱钩 / 团期库存模型重构(3 项,均测试服验证通过)

2026-05-29 17:48:30 +08:00
@@ -0,0 +1,46 @@
+# 【小程序】档位对比 /mp/product/{id}/tier-compare 住宿项新增「区/县」district 字段
+
+> **类型**: 后端出参新增字段(feat,向后兼容)
+> **服务**: hl-product-service-v2 + hl-resource-service
+> **日期**: 2026-05-29
+> **影响范围**: 小程序端 `GET /mp/product/{id}/tier-compare` 每个住宿项
+> **归属**: 后端已改(PR #3259 → dev,已同步 dev-v3)
+> **状态**: 已部署测试服并验证通过
+> **关联工单**: 无(直接报 BUG)
+
+---
+
+## 一、变更点
+
+档位对比接口的住宿项此前只返回城市 `city`,现在**同时返回区/县 `district`**,与 `city` 并列。
+
+```json
+{
+  "code": 200,
+  "data": {
+    "tiers": [
+      {
+        "tierSeq": 2,
+        "tierName": "豪华",
+        "hotels": [
+          {
+            "dayNumber": 1,
+            "hotelName": "海拉尔首旅京伦酒店",
+            "city": "呼伦贝尔市",
+            "district": "海拉尔区"
+          }
+        ]
+      }
+    ]
+  }
+}
+```
+
+## 二、前端处理
+
+- `hotels[].district` 为新增字段(区/县),前端可在城市后展示完整地址层级。
+- 当住宿项无关联酒店资源(仅快照)时,`city`/`district` 均为 `null`(与原 `city` 行为一致),前端做空值兜底即可。
+
+## 三、测试服实测
+
+产品 2043696… 豪华档住宿项返回 `city=呼伦贝尔市, district=海拉尔区/额尔古纳市/阿尔山市`,城市+区县均正确。