diff --git a/changelogs/2026-04/2026-04-15_product-v2_room-type-name-and-mq-sync.md b/changelogs/2026-04/2026-04-15_product-v2_room-type-name-and-mq-sync.md new file mode 100644 index 0000000..0784d8f --- /dev/null +++ b/changelogs/2026-04/2026-04-15_product-v2_room-type-name-and-mq-sync.md @@ -0,0 +1,61 @@ +# 产品住宿返回房型名称 + 酒店/房型名称MQ自动同步 + +- **日期**: 2026-04-15 +- **服务**: hl-resource-service, hl-product-service-v2 +- **PR**: #590, #591 +- **类型**: fix + feat + +## 概述 + +修复产品详情中住宿只返回酒店名称、不返回房型名称的问题。同时新增MQ机制,资源服务修改酒店/房型名称后自动同步到产品侧快照。 + +## 已有接口变更 + +### 管理端产品详情 + +``` +GET /admin/product/item/{productId} +``` + +行程天中的住宿项(hotels)新增字段: + +| 字段 | 类型 | 说明 | +|------|------|------| +| `roomTypeName` | String | 房型名称(之前只有roomTypeId没有名称) | + +### 小程序端产品详情 + +``` +GET /mp/product/{productId} +``` + +行程天中的住宿项(itinerary[].hotels[])新增字段: + +| 字段 | 类型 | 说明 | +|------|------|------| +| `roomTypeId` | Long | 房型ID | +| `roomTypeName` | String | 房型名称 | +| `roomCount` | Integer | 房间数 | + +### 小程序端档位对比 + +``` +GET /mp/product/{productId}/tier-compare +``` + +住宿项新增字段: + +| 字段 | 类型 | 说明 | +|------|------|------| +| `roomTypeName` | String | 房型名称 | + +## 行为变更(无需前端改动) + +- 资源服务修改酒店名称 → 产品侧 `hotelName` 快照**自动同步更新** +- 资源服务修改房型名称 → 产品侧 `roomTypeName` 快照**自动同步更新** +- 同步完成后自动清除受影响产品的小程序端缓存 + +## 注意事项 + +- 已保存的产品需要**重新保存行程(Step2)**才会首次填充 `roomTypeName` +- 首次填充后,后续名称变更由MQ自动同步,无需重新保存