# 接口变更记录 — 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<Map<String, Object>>`

---

## 资源服务

### 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<RoomTypeVO>`

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `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<String>` | 横幅素材ID列表 |
| `bannerUrls` | `List<String>` | 横幅图URL列表 |
| `videoMaterialId` | `String` | 视频素材ID |
| `videoUrl` | `String` | 视频URL |
| `sortOrder` | `Integer` | 排序权重 |
| `status` | `Integer` | 状态：0=禁用 1=启用 |
| `approvalNo` | `String` | 审批单号 |
| `pendingStatus` | `Integer` | 待审批目标状态 |
| `createdAt` | `LocalDateTime` | 创建时间 |
| `updatedAt` | `LocalDateTime` | 更新时间 |

---

## 📦 其他数据对象变更

> 以下变更未直接关联到本次接口变更，但可能影响现有接口的请求/响应

### 资源服务

#### ✏️ HotelVO

  - 🆕 `roomTypes` (`List<RoomTypeVO>`) — 房型列表（C端详情返回，仅包含已启用房型）

<details>
<summary>📁 全部变更文件 (点击展开)</summary>

```
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
```
</details>