111 行
3.6 KiB
Markdown
111 行
3.6 KiB
Markdown
# 接口变更记录 — 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> |