diff --git a/changelogs/2026-03/2026-03-20_1127_508b792_feat.md b/changelogs/2026-03/2026-03-20_1127_508b792_feat.md new file mode 100644 index 0000000..bc319e1 --- /dev/null +++ b/changelogs/2026-03/2026-03-20_1127_508b792_feat.md @@ -0,0 +1,111 @@ +# 接口变更记录 — 2026-03-20 11:27 + +> **提交** `508b792` · **作者** wx · **时间** 2026-03-20 11:27:32 +0800 +> +> feat: 小程序酒店详情返回房型列表 + 新增房型详情接口 + +## 变更总览 + +- **小程序聚合服务** + - MpHotel (+1) +- **资源服务** + - InternalMpHotel (+1) + +--- + +## 小程序聚合服务 + +### MpHotel + +> 📖 **接口文档**: [http://192.168.100.236:8086/doc.html](http://192.168.100.236:8086/doc.html) → 标签 **「C端 - 酒店接口」** + +### 🆕 `GET` /mp/hotel/room-type/{roomTypeId} — 房型详情 + +> 获取房型完整信息,包含封面、轮播图、视频等素材URL,以及床型、面积、设施等详细信息。 + +**参数** + + - `{roomTypeId}` (`Long`) — 路径参数:房型ID + +**响应** `Result>` + +--- + +## 资源服务 + +### InternalMpHotel + +> 📖 **接口文档**: [http://192.168.100.236:8082/doc.html](http://192.168.100.236:8082/doc.html) → 标签 **「【内部接口】小程序酒店(Feign调用)」** + +### 🆕 `GET` /internal/mp/hotel/room-type/{roomTypeId} — C端房型详情 + +> 【仅限内部Feign调用】供mp-service获取房型完整详情,包含封面、轮播图、视频等素材URL。 + +**关联字典**: +- room_category:房型分类 +- bed_type:床型 +- window_type:窗户类型 +- bathroom_type:卫浴类型 +- room_facility:房间设施 + +**参数** + + - `{roomTypeId}` (`Long`) — 路径参数:房型ID + +**响应** `Result` + +| 字段 | 类型 | 说明 | +| --- | --- | --- | +| `roomTypeId` | `String` | 房型ID | +| `hotelId` | `String` | 所属酒店ID | +| `name` | `String` | 房型名称 | +| `roomCategory` | `String` | 房型分类 | +| `roomArea` | `BigDecimal` | 房间面积(平方米) | +| `bedType` | `String` | 床型 | +| `bedCount` | `Integer` | 床位数量 | +| `bedSize` | `String` | 床尺寸 | +| `maxOccupancy` | `Integer` | 最多入住人数 | +| `floorInfo` | `String` | 楼层信息 | +| `windowType` | `String` | 窗型 | +| `bathroomType` | `String` | 卫浴类型 | +| `roomFacilities` | `String` | 房间设施(JSON) | +| `basePrice` | `BigDecimal` | 基础成本价(元) | +| `totalRooms` | `Integer` | 总房间数 | +| `description` | `String` | 房型描述 | +| `coverMaterialId` | `String` | 封面素材ID | +| `coverUrl` | `String` | 封面图URL | +| `bannerMaterialIds` | `List` | 横幅素材ID列表 | +| `bannerUrls` | `List` | 横幅图URL列表 | +| `videoMaterialId` | `String` | 视频素材ID | +| `videoUrl` | `String` | 视频URL | +| `sortOrder` | `Integer` | 排序权重 | +| `status` | `Integer` | 状态:0=禁用 1=启用 | +| `approvalNo` | `String` | 审批单号 | +| `pendingStatus` | `Integer` | 待审批目标状态 | +| `createdAt` | `LocalDateTime` | 创建时间 | +| `updatedAt` | `LocalDateTime` | 更新时间 | + +--- + +## 📦 其他数据对象变更 + +> 以下变更未直接关联到本次接口变更,但可能影响现有接口的请求/响应 + +### 资源服务 + +#### ✏️ HotelVO + + - 🆕 `roomTypes` (`List`) — 房型列表(C端详情返回,仅包含已启用房型) + +
+📁 全部变更文件 (点击展开) + +``` +M hl-mp-service/src/main/java/com/hulalv/mp/controller/MpHotelController.java +M hl-mp-service/src/main/java/com/hulalv/mp/feign/MpResourceFeignClient.java +M hl-mp-service/src/main/java/com/hulalv/mp/feign/MpResourceFeignFallbackFactory.java +M hl-resource-service/src/main/java/com/hulalv/resource/hotel/controller/InternalMpHotelController.java +M hl-resource-service/src/main/java/com/hulalv/resource/hotel/vo/HotelVO.java +M nacos-config/hl-contract-service-dev.yml +``` +
\ No newline at end of file