2026-04-18 房型封面null修复(PR #825) + 主题卡片去链接类型(PR #829)

changelogs/2026-04/2026-04-18_home-screen2-remove-card-link.md

@@ -0,0 +1,110 @@
+# 小程序首页第二屏 - 主题卡片去掉"链接类型"字段
+
+- **日期**: 2026-04-18
+- **PR**: [#829](https://git.1814.love:8443/wx/HL/pulls/829) (Closes #828)
+- **类型**: 契约变更（减字段）
+- **状态**: 已合并到 dev + 测试环境部署中
+
+> 本次改动紧随同日的 [#823 首页第二屏 v2](./2026-04-18_home-screen2-v2.md)。v2 设计的"卡片链接跳转"能力产品决定取消，卡片回归纯展示。
+
+---
+
+## 受影响接口
+
+### 管理端
+- `PUT /admin/home-config/brand-story`（保存品牌故事）
+- `GET /admin/home-config/brand-story`（查询品牌故事）
+
+### 小程序端
+- `GET /mp/home-config/screen2`（首页第二屏聚合）
+
+## 删除字段（每张卡片 `cards[i]`）
+
+| 字段 | 类型 | 原含义 |
+|---|---|---|
+| ~~`linkType`~~ | String | 链接类型（NONE/PRODUCT/PRODUCT_LINE/ARTICLE/URL/MINI_PAGE） |
+| ~~`linkTarget`~~ | String | 链接目标（产品/产品线 ID / URL / 小程序页面路径） |
+| ~~`linkTargetType`~~ | String | 响应回填的产品类型（CORE/GROUP） |
+
+## 保留字段（每张卡片 `cards[i]`）
+
+| 字段 | 类型 | 说明 |
+|---|---|---|
+| `title` | String | 卡片标题（必填，≤100 字符） |
+| `subtitle` | String | 卡片副标题（可选，≤200 字符） |
+| `coverUrl` | String | 封面图 URL（必填，https CDN 直链，≤500 字符） |
+
+## 请求示例（PUT /admin/home-config/brand-story）
+
+```json
+{
+  "title": "每一条线路，我们都亲自走过。",
+  "subtitle": null,
+  "description": "整个呼伦贝尔...",
+  "coverUrl": "https://cdn.hulalv.com/home/brand.jpg",
+  "cards": [
+    {
+      "title": "季节之旅",
+      "subtitle": "夏·秋·冬三季体验",
+      "coverUrl": "https://cdn.hulalv.com/cards/1.jpg"
+    },
+    {
+      "title": "亲子研学",
+      "subtitle": "边玩边学·深度体验",
+      "coverUrl": "https://cdn.hulalv.com/cards/2.jpg"
+    }
+  ],
+  "publish": true
+}
+```
+
+## 响应示例（GET /mp/home-config/screen2）
+
+```json
+{
+  "code": 200,
+  "data": {
+    "brandStory": {
+      "title": "每一条线路，我们都亲自走过。",
+      "description": "...",
+      "coverUrl": "https://cdn.hulalv.com/home/brand.jpg"
+    },
+    "cards": [
+      {
+        "title": "季节之旅",
+        "subtitle": "夏·秋·冬三季体验",
+        "coverUrl": "https://cdn.hulalv.com/cards/1.jpg"
+      }
+    ]
+  }
+}
+```
+
+## 前端 Action
+
+### 管理端（必改）
+1. 移除卡片编辑区底部"链接类型 *"下拉框组件
+2. 移除卡片编辑区"链接目标"相关组件（如产品选择器 / URL 输入框 / 小程序页面选择）
+3. 请求体中 `cards[i]` 不再传 `linkType` / `linkTarget`
+
+### 小程序端（必改）
+1. 主题卡片点击事件去除（卡片不再支持跳转）
+2. 如果之前读了 `cards[i].linkType` / `.linkTarget` / `.linkTargetType` 的逻辑，一并删除
+
+## 向后兼容说明
+
+- DB 存量数据中的 JSON 字段 `linkType/linkTarget/linkTargetType` 不删，反序列化时被后端 `@JsonIgnoreProperties(ignoreUnknown=true)` 安全忽略
+- 前端如果旧请求仍传了这三个字段，后端也会被 `@JsonIgnoreProperties(ignoreUnknown=true)` 忽略（不会 400）
+- 但**不推荐继续传**，清理前端代码更彻底
+
+## 校验规则变化
+
+| 字段 | 变化 |
+|---|---|
+| `cards[i].linkType` | 原 `@NotBlank + @Pattern(NONE/PRODUCT/PRODUCT_LINE/ARTICLE/URL/MINI_PAGE)` → **字段删除** |
+| `cards[i].linkTarget` | 原 `@Length(max=500)` → **字段删除** |
+| `cards` 数组 | 保留 `@Size(max=2)` |
+
+## 回归验证
+
+部署后调 `GET /mp/home-config/screen2`，确认 `data.cards[i]` 只包含 title / subtitle / coverUrl 即可。

changelogs/2026-04/2026-04-18_mp-hotel-room-cover-fix.md

@@ -0,0 +1,52 @@
+# 小程序住宿详情 - 房型封面图 null 问题修复
+
+- **日期**: 2026-04-18
+- **PR**: [#825](https://git.1814.love:8443/wx/HL/pulls/825) (Closes #824)
+- **类型**: BUG FIX
+- **状态**: 已合并到 dev + 测试环境部署中
+
+---
+
+## 影响接口
+
+- `GET /mp/hotel/{hotelId}` (C 端住宿详情)
+
+## 现象
+
+调用住宿详情返回的 `roomTypes` 数组中，**每个房型的 `coverUrl` 都是 null**（其他字段正常）。
+
+```json
+{
+  "code": 200,
+  "data": {
+    "hotelId": "2023714929877450753",
+    "roomTypes": [
+      {
+        "roomTypeId": "...",
+        "name": "豪华大床房",
+        "coverUrl": null,    // 错误：应为 https://.../cover.jpg
+        "bannerUrls": [],    // 错误：应为图片 URL 数组
+        "videoUrl": null     // 错误：应为视频 URL
+      }
+    ]
+  }
+}
+```
+
+## 根因（仅供参考，前端无需关注）
+
+`RoomTypeService.listRoomTypes` 手动补救 `coverUrl` 时用 String 类型的 `coverMaterialId` 去查 `Map<Long, String>`，Java `HashMap.get` 不做类型转换导致永远返回 null。`banner/video` 的 materialId 同样未纳入批量查询。
+
+## 修复后行为
+
+- `roomTypes[i].coverUrl`：有封面素材时返回 https CDN URL
+- `roomTypes[i].bannerUrls`：有横幅素材时返回 URL 数组（无素材的条目已 filter）
+- `roomTypes[i].videoUrl`：有视频素材时返回 URL
+
+## 前端 Action
+
+**无需改代码**。后端修复后直接生效。
+
+## 回归验证
+
+测试环境部署完成后，调用 `GET /mp/hotel/{任一已上架酒店ID}` 检查 `roomTypes[0].coverUrl` 非 null 即可。