酒店 · 12301-dscp 接口速查

HotelApiController 17/17 在用

POST /hotelApi/getHotelCalendar 在用开放/回调 #

获取低价日历 · HotelApiController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelApiController#getHotelCalendar
所属模块	酒店 `hotel`
暴露渠道	开放/回调（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_room_price_calendar

ControllerHotelApiController#getHotelCalendar

ServiceHotelRoomPriceCalendarService#queryList （HotelRoomPriceCalendarServiceImpl）

MapperHotelRoomPriceCalendarMapper#selectList ⇒ 表 hotel_room_price_calendar

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/open-api/hotelApi/getHotelCalendar
uat	https://dscp-uat.hn12301.net/open-api/hotelApi/getHotelCalendar
pro	https://dscp-uat.hn12301.net/open-api/hotelApi/getHotelCalendar	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`hotel_room_price_calendar`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　List<HotelCalendarResponse>　（list）

字段	类型	表 / 列	说明
[ ]	array	—	列表，元素结构见下
date	String	`hotel_room_price_calendar`.`date`
price	String	—

示例

请求示例（自动生成，仅结构参考）

POST /hotelApi/getHotelCalendar

{
  "body": {
    "id": 1
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "date": "2026-01-01 12:00:00",
      "price": ""
    }
  ]
}

处理逻辑

逻辑摘要调用 parse（DateUtil.parse）；调用 format（DateUtil.format）；调用 nextMonth（DateUtil.nextMonth）

前端调用方

xghmall getHotelCalendar exact

POST /hotelApi/getHotelInfo 在用开放/回调 #

（无摘要） · HotelApiController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelApiController#getHotelInfo
所属模块	酒店 `hotel`
暴露渠道	开放/回调（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_infohotel_facility_relhotel_facility

ControllerHotelApiController#getHotelInfo

转换BeanUtils.map → HotelInfoDetailResponse

ServiceHotelInfoService#get （HotelInfoServiceImpl）

MapperHotelInfoMapper#selectById ⇒ 表 hotel_info

ServiceHotelFacilityRelService#queryList （HotelFacilityRelServiceImpl）

MapperHotelFacilityRelMapper#selectList ⇒ 表 hotel_facility_rel

ServiceHotelFacilityService#queryList （HotelFacilityServiceImpl）

MapperHotelFacilityMapper#selectList ⇒ 表 hotel_facility

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/open-api/hotelApi/getHotelInfo
uat	https://dscp-uat.hn12301.net/open-api/hotelApi/getHotelInfo
pro	https://dscp-uat.hn12301.net/open-api/hotelApi/getHotelInfo	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HotelInfoRequest

字段	类型	表 / 列	说明
id	Long	`hotel_info`.`id`
userLongitude	String	—	经度
userLatitude	String	—	纬度

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　HotelInfoDetailResponse　（object）

字段	类型	取值/校验	表 / 列	说明
id	Long		`hotel_info`.`id`	id
merchantId	Long		`hotel_info`.`merchant_id`	商户ID
shopId	Long		`hotel_info`.`shop_id`	店铺ID
name	String		`hotel_info`.`name`	酒店名称
grade	HotelGrade	1二星及以下/经济2三星/舒适3四星/高档4五星/豪华5奢华	`hotel_info`.`grade`	酒店等级
type	HotelType	1酒店2民宿3公寓4青年旅社5别墅6度假村7客栈8农家乐+4	`hotel_info`.`type`
openingYear	Integer		`hotel_info`.`opening_year`	开业年份
roomCount	Integer		`hotel_info`.`room_count`	房间数量
phone	String		`hotel_info`.`phone`	联系电话
coverImage	String		`hotel_info`.`cover_image`	封面图片
address	String		`hotel_info`.`address`	地址
landmark	String		`hotel_info`.`landmark`	地标
provinceId	Long		`hotel_info`.`province_id`	省id
cityId	Long		`hotel_info`.`city_id`	市id
districtId	Long		`hotel_info`.`district_id`	区县id
longitude	BigDecimal		`hotel_info`.`longitude`	经度
latitude	BigDecimal		`hotel_info`.`latitude`	纬度
highlights	String		`hotel_info`.`highlights`	亮点介绍
tags	String		`hotel_info`.`tags`	酒店标签
locationTags	String		`hotel_info`.`location_tags`	位置标签
images	String		`hotel_info`.`images`	酒店图片，多个用逗号分隔
status	Integer		`hotel_info`.`status`	状态(0正常 1停用)
distance	BigDecimal		—
facilities	List<FacilityTree>		—	设施列表
nearbyHotel	List<HotelInfoResponse>		—	附件酒店
nearbyHotel[].id	Long		`hotel_info`.`id`	酒店ID
nearbyHotel[].name	String		`hotel_info`.`name`	酒店名称
nearbyHotel[].grade	HotelGrade	1二星及以下/经济2三星/舒适3四星/高档4五星/豪华5奢华	`hotel_info`.`grade`	酒店等级(枚举:HotelGrade)，1二星及以下/经济，2三星/舒适，3四星/高档，4五星/豪华，5奢华
nearbyHotel[].type	HotelType	1酒店2民宿3公寓4青年旅社5别墅6度假村7客栈8农家乐+4	`hotel_info`.`type`
nearbyHotel[].status	Integer		`hotel_info`.`status`	状态，0正常，1停用
nearbyHotel[].openingYear	Integer		`hotel_info`.`opening_year`	开业年份
nearbyHotel[].roomCount	Integer		`hotel_info`.`room_count`	房间数量
nearbyHotel[].roomTypeCount	Long		—	房型数量
nearbyHotel[].phone	String		`hotel_info`.`phone`	联系电话
nearbyHotel[].address	String		`hotel_info`.`address`	详细地址
nearbyHotel[].landmark	String		`hotel_info`.`landmark`	地标
nearbyHotel[].provinceId	Long		`hotel_info`.`province_id`	省id
nearbyHotel[].cityId	Long		`hotel_info`.`city_id`	市id
nearbyHotel[].districtId	Long		`hotel_info`.`district_id`	区县id
nearbyHotel[].longitude	BigDecimal		`hotel_info`.`longitude`	经度
nearbyHotel[].latitude	BigDecimal		`hotel_info`.`latitude`	纬度
nearbyHotel[].coverImage	String		`hotel_info`.`cover_image`	主图URL
nearbyHotel[].images	String		`hotel_info`.`images`	轮播图URL，多个用逗号分隔
nearbyHotel[].tags	String		`hotel_info`.`tags`	酒店标签，多个用逗号分隔
nearbyHotel[].locationTags	String		`hotel_info`.`location_tags`	位置描述标签，多个用逗号分隔
nearbyHotel[].highlights	String		`hotel_info`.`highlights`	酒店亮点(富文本)
nearbyHotel[].isDeleted	Boolean		`hotel_info`.`is_deleted`	是否删除(0否 1是)
nearbyHotel[].createdBy	Long		`hotel_info`.`created_by`	创建人ID
nearbyHotel[].createdTime	Date		`hotel_info`.`created_time`	创建时间
nearbyHotel[].updatedBy	Long		`hotel_info`.`updated_by`	更新人ID
nearbyHotel[].updatedTime	Date		`hotel_info`.`updated_time`	更新时间
nearbyHotel[].lowestPrice	BigDecimal		—
nearbyHotel[].distance	BigDecimal		—

示例

请求示例（自动生成，仅结构参考）

POST /hotelApi/getHotelInfo

{
  "body": {
    "id": 1,
    "userLongitude": "",
    "userLatitude": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": 1,
    "merchantId": 1,
    "shopId": 1,
    "name": "",
    "grade": "1",
    "type": "1",
    "openingYear": 0,
    "roomCount": 0,
    "phone": "13800000000",
    "coverImage": "",
    "address": "",
    "landmark": "",
    "provinceId": 1,
    "cityId": 1,
    "districtId": 1,
    "longitude": 0,
    "latitude": 0,
    "highlights": "",
    "tags": "",
    "locationTags": "",
    "images": "",
    "status": 0,
    "distance": 0,
    "facilities": "",
    "nearbyHotel": [
      {
        "id": 1,
        "name": "",
        "grade": "1",
        "type": "1",
        "status": 0,
        "openingYear": 0,
        "roomCount": 0,
        "roomTypeCount": 0,
        "phone": "13800000000",
        "address": "",
        "landmark": "",
        "provinceId": 1,
        "cityId": 1,
        "districtId": 1,
        "longitude": 0,
        "latitude": 0,
        "coverImage": "",
        "images": "",
        "tags": "",
        "locationTags": "",
        "highlights": "",
        "isDeleted": false,
        "createdBy": 0,
        "createdTime": "2026-01-01 12:00:00",
        "updatedBy": 0,
        "updatedTime": "2026-01-01 12:00:00",
        "lowestPrice": 0,
        "distance": 0
      }
    ]
  }
}

处理逻辑

逻辑摘要查询详情（hotelInfoService.get）；列表查询（hotelFacilityRelService.queryList）；列表查询（hotelFacilityService.queryList）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

1. 查询酒店基本信息
2. 查询酒店关联的所有设施
3. 查询设施详情
4. 构建设施树
查询附件酒店
计算距离

前端调用方

xghmall getHotelInfo exact

POST /hotelApi/getHotelOrder 在用开放/回调 #

查询订单 · HotelApiController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelApiController#getHotelOrder
所属模块	酒店 `hotel`
暴露渠道	开放/回调（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表memberhotel_orderhotel_infohotel_room_typehotel_room_type_plan

ControllerHotelApiController#getHotelOrder

ServiceHotelApiService#getHotelOrder （HotelApiServiceImpl）

ServiceMemberService#get （MemberServiceImpl）

MapperMemberMapper#selectById ⇒ 表 member

ServiceHotelOrderService#queryPage （HotelOrderServiceImpl）

MapperHotelOrderMapper#selectPage ⇒ 表 hotel_order

ServiceHotelInfoService#get （HotelInfoServiceImpl）

MapperHotelInfoMapper#selectById ⇒ 表 hotel_info

ServiceHotelRoomTypeService#get （HotelRoomTypeServiceImpl）

MapperHotelRoomTypeMapper#selectById ⇒ 表 hotel_room_type

ServiceHotelRoomTypePlanService#get （HotelRoomTypePlanServiceImpl）

MapperHotelRoomTypePlanMapper#selectById ⇒ 表 hotel_room_type_plan

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/open-api/hotelApi/getHotelOrder
uat	https://dscp-uat.hn12301.net/open-api/hotelApi/getHotelOrder
pro	https://dscp-uat.hn12301.net/open-api/hotelApi/getHotelOrder	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　GetHotelOrderRequest

字段	类型	必填	表 / 列	说明
pageNum	Integer	否	—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否	—	每页条数（继承自框架分页基类 AbstractPageRequest）
mobile	String		`member`.`mobile`
status	Integer		`member`.`status`

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　PageInfo<GetHotelOrderResponse>　（page）

字段	类型	取值/校验	表 / 列	说明
list / records	array		—	分页列表，元素结构见下
total	long		—	总条数（PageInfo）
id	Long		`member`.`id`
orderDate	Date		—
image	String		—
hotelName	String		—
roomName	String		—
num	Integer		—
nights	Integer		—
checkInDate	Date		`hotel_order`.`check_in_date`
checkOutDate	Date		`hotel_order`.`check_out_date`
totalAmount	Integer		`hotel_order`.`total_amount`
status	HotelOrderStatus	0待支付1待确认2待入住3已入住4已退房5已取消6部分退房	`member`.`status`

示例

请求示例（自动生成，仅结构参考）

POST /hotelApi/getHotelOrder

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "mobile": "13800000000",
    "status": 0
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1,
        "orderDate": "2026-01-01 12:00:00",
        "image": "",
        "hotelName": "",
        "roomName": "",
        "num": 0,
        "nights": 0,
        "checkInDate": "2026-01-01 12:00:00",
        "checkOutDate": "2026-01-01 12:00:00",
        "totalAmount": 0,
        "status": "0"
      }
    ],
    "total": 0
  }
}

处理逻辑

逻辑摘要查询详情（hotelApiService.getHotelOrder）

前端调用方

xghmall getHotelOrder exact

POST /hotelApi/getHotelOrderDetail 在用开放/回调 #

获取订单详情 · HotelApiController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelApiController#getHotelOrderDetail
所属模块	酒店 `hotel`
暴露渠道	开放/回调（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_orderhotel_infohotel_room_typehotel_order_roomhotel_room_type_planhotel_member_traveler

ControllerHotelApiController#getHotelOrderDetail

ServiceHotelApiService#getHotelOrderDetail （HotelApiServiceImpl）

ServiceHotelOrderService#get （HotelOrderServiceImpl）

MapperHotelOrderMapper#selectById ⇒ 表 hotel_order

ServiceHotelInfoService#get （HotelInfoServiceImpl）

MapperHotelInfoMapper#selectById ⇒ 表 hotel_info

ServiceHotelRoomTypeService#get （HotelRoomTypeServiceImpl）

MapperHotelRoomTypeMapper#selectById ⇒ 表 hotel_room_type

ServiceHotelOrderRoomService#queryList （HotelOrderRoomServiceImpl）

MapperHotelOrderRoomMapper#selectList ⇒ 表 hotel_order_room

ServiceHotelRoomTypePlanService#get （HotelRoomTypePlanServiceImpl）

MapperHotelRoomTypePlanMapper#selectById ⇒ 表 hotel_room_type_plan

ServiceHotelMemberTravelerService#queryList （HotelMemberTravelerServiceImpl）

MapperHotelMemberTravelerMapper#selectList ⇒ 表 hotel_member_traveler

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/open-api/hotelApi/getHotelOrderDetail
uat	https://dscp-uat.hn12301.net/open-api/hotelApi/getHotelOrderDetail
pro	https://dscp-uat.hn12301.net/open-api/hotelApi/getHotelOrderDetail	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`hotel_order`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　GetHotelOrderDetailResponse　（object）

字段	类型	取值/校验	表 / 列	说明
order	HotelOrder		—
order.id	Long		`hotel_order`.`id`	订单ID
order.orderNo	String		`hotel_order`.`order_no`	订单编号
order.channel	HotelChannel	1质慧游小程序	`hotel_order`.`channel`	渠道
order.merchantId	Long		`hotel_order`.`merchant_id`	商户ID
order.shopId	Long		`hotel_order`.`shop_id`	商铺ID
order.hotelId	Long		`hotel_order`.`hotel_id`	酒店ID
order.roomTypeId	Long		`hotel_order`.`room_type_id`	房型ID
order.planId	Long		`hotel_order`.`plan_id`	价格方案ID
order.purchaseDate	Date		`hotel_order`.`purchase_date`	购买日期
order.checkInDate	Date		`hotel_order`.`check_in_date`	入住日期
order.checkOutDate	Date		`hotel_order`.`check_out_date`	离店日期
order.expectedArrivalTime	Date		`hotel_order`.`expected_arrival_time`	预计到店时间
order.actualCheckinTime	Date		`hotel_order`.`actual_checkin_time`	实际入住时间
order.actualCheckoutTime	Date		`hotel_order`.`actual_checkout_time`	实际离店时间
order.stayNights	Integer		`hotel_order`.`stay_nights`	入住天数
order.roomNum	Integer		`hotel_order`.`room_num`	房间数量
order.originalAmount	Integer		`hotel_order`.`original_amount`	订单原价(分)
order.discountAmount	Integer		`hotel_order`.`discount_amount`	优惠金额(分)
order.totalAmount	Integer		`hotel_order`.`total_amount`	订单应付金额(分)
order.paidAmount	Integer		`hotel_order`.`paid_amount`	已付金额(分)
order.couponId	String		`hotel_order`.`coupon_id`	优惠券ID
order.couponAmount	Integer		`hotel_order`.`coupon_amount`	优惠券抵扣金额(分)
order.guestId	String		`hotel_order`.`guest_id`	入住人姓名(关联traveId,多个用逗号分隔)
order.guestNum	Integer		`hotel_order`.`guest_num`	入住人数
order.breakfastNum	Integer		`hotel_order`.`breakfast_num`	早餐份数
order.cancelType	Integer		`hotel_order`.`cancel_type`	取消政策类型
order.cancelTime	Date		`hotel_order`.`cancel_time`	最晚取消时间
order.memberId	Long		`hotel_order`.`member_id`	下单用户ID
order.contactName	String		`hotel_order`.`contact_name`	联系人姓名
order.contactPhone	String		`hotel_order`.`contact_phone`	联系人手机号
order.remark	String		`hotel_order`.`remark`	备注
order.reviewStatus	Integer		`hotel_order`.`review_status`	评价状态(0-未评价,1-已评价)
order.paymentStatus	HotelOrderPaymentStatus	0未支付1部分支付2已支付3已退款4部分退款5退款中6退款失败	`hotel_order`.`payment_status`	支付状态(0-未支付,1-部分支付,2-已支付,3-已退款,4-部分退款)
order.status	HotelOrderStatus	0待支付1待确认2待入住3已入住4已退房5已取消6部分退房	`hotel_order`.`status`	订单状态
order.isDeleted	Boolean		`hotel_order`.`is_deleted`	是否删除(0否 1是)
order.createdBy	Long		`hotel_order`.`created_by`	创建人
order.createdTime	Date		`hotel_order`.`created_time`
order.updatedBy	Long		`hotel_order`.`updated_by`	修改人
order.updatedTime	Date		`hotel_order`.`updated_time`
order.orderExpressTime	Date		`hotel_order`.`order_express_time`	失效时间
hotelInfo	HotelInfo		—
hotelInfo.id	Long		`hotel_order`.`id`	酒店ID
hotelInfo.merchantId	Long		`hotel_order`.`merchant_id`	商户ID
hotelInfo.shopId	Long		`hotel_order`.`shop_id`	店铺ID
hotelInfo.name	String		`hotel_info`.`name`	酒店名称
hotelInfo.grade	HotelGrade	1二星及以下/经济2三星/舒适3四星/高档4五星/豪华5奢华	`hotel_info`.`grade`	酒店等级(枚举:HotelGrade)，1二星及以下/经济，2三星/舒适，3四星/高档，4五星/豪华，5奢华
hotelInfo.type	HotelType	1酒店2民宿3公寓4青年旅社5别墅6度假村7客栈8农家乐+4	`hotel_info`.`type`	酒店类型
hotelInfo.status	Integer		`hotel_order`.`status`	状态(枚举:CommonStatus)，0正常，1停用
hotelInfo.openingYear	Integer		`hotel_info`.`opening_year`	开业年份
hotelInfo.roomCount	Integer		`hotel_info`.`room_count`	房间数量
hotelInfo.phone	String		`hotel_info`.`phone`	联系电话
hotelInfo.address	String		`hotel_info`.`address`	详细地址
hotelInfo.landmark	String		`hotel_info`.`landmark`	地标
hotelInfo.provinceId	Long		`hotel_info`.`province_id`	省id
hotelInfo.cityId	Long		`hotel_info`.`city_id`	市id
hotelInfo.districtId	Long		`hotel_info`.`district_id`	区县id
hotelInfo.longitude	BigDecimal		`hotel_info`.`longitude`	经度
hotelInfo.latitude	BigDecimal		`hotel_info`.`latitude`	纬度
hotelInfo.coverImage	String		`hotel_info`.`cover_image`	主图URL
hotelInfo.images	String		`hotel_info`.`images`	轮播图URL，多个用逗号分隔
hotelInfo.tags	String		`hotel_info`.`tags`	酒店标签，多个用逗号分隔
hotelInfo.locationTags	String		`hotel_info`.`location_tags`	位置描述标签，多个用逗号分隔
hotelInfo.highlights	String		`hotel_info`.`highlights`	酒店亮点(富文本)
hotelInfo.isDeleted	Boolean		`hotel_order`.`is_deleted`	是否删除(0否 1是)
hotelInfo.createdBy	Long		`hotel_order`.`created_by`	创建人ID
hotelInfo.createdTime	Date		`hotel_order`.`created_time`	创建时间
hotelInfo.updatedBy	Long		`hotel_order`.`updated_by`	更新人ID
hotelInfo.updatedTime	Date		`hotel_order`.`updated_time`	更新时间
roomType	HotelRoomType		—
roomType.id	Long		`hotel_order`.`id`	房型ID
roomType.merchantId	Long		`hotel_order`.`merchant_id`	所属商户id，关联merchant表id
roomType.shopId	Long		`hotel_order`.`shop_id`	所属商铺id
roomType.hotelId	Long		`hotel_order`.`hotel_id`	所属酒店ID
roomType.name	String		`hotel_info`.`name`	房型名称
roomType.basePrice	Integer		`hotel_room_type`.`base_price`	基本价格
roomType.coverImage	String		`hotel_info`.`cover_image`	主图URL
roomType.images	String		`hotel_info`.`images`	房型图片，JSON格式存储多张图片URL
roomType.status	Integer		`hotel_order`.`status`	状态
roomType.sort	Integer		`hotel_room_type`.`sort`	显示顺序
roomType.roomTypeArea	BigDecimal		`hotel_room_type`.`room_type_area`	面积
roomType.floorInfo	String		`hotel_room_type`.`floor_info`	楼层信息
roomType.windowType	WindowType	1无窗2部分有窗3全部有窗	`hotel_room_type`.`window_type`	窗户类型
roomType.bedInfo	String		`hotel_room_type`.`bed_info`	床型
roomType.guests	Integer		`hotel_room_type`.`guests`	可住人数
roomType.smoking	Integer		`hotel_room_type`.`smoking`	是否禁烟(0否 1是)
roomType.networkType	NetworkType	1免费WiFi2收费WiFi3无网络	`hotel_room_type`.`network_type`	网络类型
roomType.extraBedAllowed	Integer		`hotel_room_type`.`extra_bed_allowed`	是否可加床(0否 1是)
roomType.extraBedDesc	String		`hotel_room_type`.`extra_bed_desc`	加床说明
roomType.isDeleted	Boolean		`hotel_order`.`is_deleted`	是否删除(0否 1是)
roomType.createdBy	Long		`hotel_order`.`created_by`	创建人ID
roomType.createdTime	Date		`hotel_order`.`created_time`	创建时间
roomType.updatedBy	Long		`hotel_order`.`updated_by`	更新人ID
roomType.updatedTime	Date		`hotel_order`.`updated_time`	更新时间
roomList	List<HotelOrderRoom>		—
roomList[].id	Long		`hotel_order`.`id`	主键ID
roomList[].orderId	Long		`hotel_order_room`.`order_id`	订单ID
roomList[].roomTypeId	Long		`hotel_order`.`room_type_id`	房型ID
roomList[].planId	Long		`hotel_order`.`plan_id`	价格方案ID
roomList[].priceCalendarId	Long		`hotel_order_room`.`price_calendar_id`	价格日历ID
roomList[].roomName	String		`hotel_order_room`.`room_name`	房型名称
roomList[].roomDate	Date		`hotel_order_room`.`room_date`	房间日期
roomList[].roomNum	Integer		`hotel_order`.`room_num`	房间数量
roomList[].roomPrice	Integer		`hotel_order_room`.`room_price`	每天单房间实际支付价(分).去掉了每天每间房的优惠券
roomList[].totalPrice	Integer		`hotel_order_room`.`total_price`	每天所有房间实际支付总价(分).去掉了每天的优惠券
roomList[].status	Integer		`hotel_order`.`status`	状态(0-正常,1-已退房)
roomList[].checkedOutNum	Integer		`hotel_order_room`.`checked_out_num`	已退房数量
roomList[].isDeleted	Boolean		`hotel_order`.`is_deleted`	是否删除(0否 1是)
roomList[].createdBy	Long		`hotel_order`.`created_by`	创建人
roomList[].createdTime	Date		`hotel_order`.`created_time`
roomList[].updatedBy	Long		`hotel_order`.`updated_by`	修改人
roomList[].updatedTime	Date		`hotel_order`.`updated_time`
plan	HotelRoomTypePlan		—
plan.id	Long		`hotel_order`.`id`
plan.hotelId	Long		`hotel_order`.`hotel_id`	酒店ID
plan.roomTypeId	Long		`hotel_order`.`room_type_id`	房型ID
plan.name	String		`hotel_info`.`name`	方案名称
plan.autoConfirm	Integer		`hotel_room_type_plan`.`auto_confirm`	是否自动确认
plan.breakfast	Integer		`hotel_room_type_plan`.`breakfast`	是否含早
plan.basePrice	Integer		`hotel_room_type`.`base_price`	底价(分)
plan.salePrice	Integer		`hotel_room_type_plan`.`sale_price`	卖价(分)
plan.stockType	StockType	0无限1共享2独立	`hotel_room_type_plan`.`stock_type`	库存类型
plan.stockNum	Integer		`hotel_room_type_plan`.`stock_num`	数量
plan.cancelType	CancelType	1免费取消2不可取消3有条件取消	`hotel_order`.`cancel_type`	取消类型
plan.cancelDays	Integer		`hotel_room_type_plan`.`cancel_days`	提前取消天数，0表示入住当天
plan.cancelHours	String		`hotel_room_type_plan`.`cancel_hours`	取消截止时间点，如18:00
plan.sort	Integer		`hotel_room_type`.`sort`	排序号
plan.status	Integer		`hotel_order`.`status`	状态
plan.isDeleted	Boolean		`hotel_order`.`is_deleted`	是否删除(0否 1是)
plan.createdBy	Long		`hotel_order`.`created_by`	创建人ID
plan.createdTime	Date		`hotel_order`.`created_time`	创建时间
plan.updatedBy	Long		`hotel_order`.`updated_by`	更新人ID
plan.updatedTime	Date		`hotel_order`.`updated_time`	更新时间
guestName	String		—

示例

请求示例（自动生成，仅结构参考）

POST /hotelApi/getHotelOrderDetail

{
  "body": {
    "id": 1
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "order": {
      "id": 1,
      "orderNo": "",
      "channel": "1",
      "merchantId": 1,
      "shopId": 1,
      "hotelId": 1,
      "roomTypeId": 1,
      "planId": 1,
      "purchaseDate": "2026-01-01 12:00:00",
      "checkInDate": "2026-01-01 12:00:00",
      "checkOutDate": "2026-01-01 12:00:00",
      "expectedArrivalTime": "2026-01-01 12:00:00",
      "actualCheckinTime": "2026-01-01 12:00:00",
      "actualCheckoutTime": "2026-01-01 12:00:00",
      "stayNights": 0,
      "roomNum": 0,
      "originalAmount": 0,
      "discountAmount": 0,
      "totalAmount": 0,
      "paidAmount": 1,
      "couponId": "",
      "couponAmount": 0,
      "guestId": "",
      "guestNum": 0,
      "breakfastNum": 0,
      "cancelType": 0,
      "cancelTime": "2026-01-01 12:00:00",
      "memberId": 1,
      "contactName": "",
      "contactPhone": "13800000000",
      "remark": "",
      "reviewStatus": 0,
      "paymentStatus": "0",
      "status": "0",
      "isDeleted": false,
      "createdBy": 0,
      "createdTime": "2026-01-01 12:00:00",
      "updatedBy": 0,
      "updatedTime": "2026-01-01 12:00:00",
      "orderExpressTime": "2026-01-01 12:00:00"
    },
    "hotelInfo": {
      "id": 1,
      "merchantId": 1,
      "shopId": 1,
      "name": "",
      "grade": "1",
      "type": "1",
      "status": 0,
      "openingYear": 0,
      "roomCount": 0,
      "phone": "13800000000",
      "address": "",
      "landmark": "",
      "provinceId": 1,
      "cityId": 1,
      "districtId": 1,
      "longitude": 0,
      "latitude": 0,
      "coverImage": "",
      "images": "",
      "tags": "",
      "locationTags": "",
      "highlights": "",
      "isDeleted": false,
      "createdBy": 0,
      "createdTime": "2026-01-01 12:00:00",
      "updatedBy": 0,
      "updatedTime": "2026-01-01 12:00:00"
    },
    "roomType": {
      "id": 1,
      "merchantId": 1,
      "shopId": 1,
      "hotelId": 1,
      "name": "",
      "basePrice": 0,
      "coverImage": "",
      "images": "",
      "status": 0,
      "sort": 0,
      "roomTypeArea": 0,
      "floorInfo": "",
      "windowType": "1",
      "bedInfo": "",
      "guests": 0,
      "smoking": 0,
      "networkType": "1",
      "extraBedAllowed": 0,
      "extraBedDesc": "",
      "isDeleted": false,
      "createdBy": 0,
      "createdTime": "2026-01-01 12:00:00",
      "updatedBy": 0,
      "updatedTime": "2026-01-01 12:00:00"
    },
    "roomList": [
      {
        "id": 1,
        "orderId": 1,
        "roomTypeId": 1,
        "planId": 1,
        "priceCalendarId": 1,
        "roomName": "",
        "roomDate": "2026-01-01 12:00:00",
        "roomNum": 0,
        "roomPrice": 0,
        "totalPrice": 0,
        "status": 0,
        "checkedOutNum": 0,
        "isDeleted": false,
        "createdBy": 0,
        "createdTime": "2026-01-01 12:00:00",
        "updatedBy": 0,
        "updatedTime": "2026-01-01 12:00:00"
      }
    ],
    "plan": {
      "id": 1,
      "hotelId": 1,
      "roomTypeId": 1,
      "name": "",
      "autoConfirm": 0,
      "breakfast": 0,
      "basePrice": 0,
      "salePrice": 0,
      "stockType": "0",
      "stockNum": 0,
      "cancelType": "1",
      "cancelDays": 0,
      "cancelHours": "",
      "sort": 0,
      "status": 0,
      "isDeleted": false,
      "createdBy": 0,
      "createdTime": "2026-01-01 12:00:00",
      "updatedBy": 0,
      "updatedTime": "2026-01-01 12:00:00"
    },
    "guestName": ""
  }
}

处理逻辑

逻辑摘要查询详情（hotelApiService.getHotelOrderDetail）

前端调用方

xghmall getHotelOrderDetail exact

POST /hotelApi/getHotelOrderLog 在用开放/回调 #

获取订单详情 · HotelApiController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelApiController#getHotelOrderLog
所属模块	酒店 `hotel`
暴露渠道	开放/回调（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_order_log

ControllerHotelApiController#getHotelOrderLog

ServiceHotelApiService#getHotelOrderLog （HotelApiServiceImpl）

ServiceHotelOrderLogService#queryList （HotelOrderLogServiceImpl）

MapperHotelOrderLogMapper#selectList ⇒ 表 hotel_order_log

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/open-api/hotelApi/getHotelOrderLog
uat	https://dscp-uat.hn12301.net/open-api/hotelApi/getHotelOrderLog
pro	https://dscp-uat.hn12301.net/open-api/hotelApi/getHotelOrderLog	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`hotel_order_log`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　List<HotelOrderLog>　（list）

字段	类型	取值/校验	表 / 列	说明
[ ]	array		—	列表，元素结构见下
id	Long		`hotel_order_log`.`id`	日志ID
orderId	Long		`hotel_order_log`.`order_id`	订单ID
actionType	HotelOrderActionType	1创建订单2支付订单3确认订单4取消订单5入住6退房7提前退房	`hotel_order_log`.`action_type`	操作类型
actionNote	String		`hotel_order_log`.`action_note`	操作说明
actionSource	HotelOrderActionSource	1用户端2商户端3商铺端4平台端5系统	`hotel_order_log`.`action_source`	操作来源
operatorId	Long		`hotel_order_log`.`operator_id`	操作人ID(商户/商铺/平台操作时使用)
operatorName	String		`hotel_order_log`.`operator_name`	操作人名称
isDeleted	Boolean		`hotel_order_log`.`is_deleted`	是否删除(0否 1是)
createdBy	Long		`hotel_order_log`.`created_by`	创建人
createdTime	Date		`hotel_order_log`.`created_time`
updatedBy	Long		`hotel_order_log`.`updated_by`	修改人
updatedTime	Date		`hotel_order_log`.`updated_time`

示例

请求示例（自动生成，仅结构参考）

POST /hotelApi/getHotelOrderLog

{
  "body": {
    "id": 1
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "id": 1,
      "orderId": 1,
      "actionType": "1",
      "actionNote": "",
      "actionSource": "1",
      "operatorId": 1,
      "operatorName": "",
      "isDeleted": false,
      "createdBy": 0,
      "createdTime": "2026-01-01 12:00:00",
      "updatedBy": 0,
      "updatedTime": "2026-01-01 12:00:00"
    }
  ]
}

处理逻辑

逻辑摘要查询详情（hotelApiService.getHotelOrderLog）

前端调用方

xghmall getHotelOrderLog exact

POST /hotelApi/getHotelRoomDetail 在用开放/回调 #

房间plan详情(树形) · HotelApiController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelApiController#getHotelRoomDetail
所属模块	酒店 `hotel`
暴露渠道	开放/回调（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_room_type_planhotel_room_typehotel_room_attr_relhotel_room_attrhotel_room_price_calendar

ControllerHotelApiController#getHotelRoomDetail

ServiceHotelRoomTypePlanService#get （HotelRoomTypePlanServiceImpl）

MapperHotelRoomTypePlanMapper#selectById ⇒ 表 hotel_room_type_plan

ServiceHotelRoomTypeService#get （HotelRoomTypeServiceImpl）

MapperHotelRoomTypeMapper#selectById ⇒ 表 hotel_room_type

ServiceHotelRoomAttrRelService#queryList （HotelRoomAttrRelServiceImpl）

MapperHotelRoomAttrRelMapper#selectList ⇒ 表 hotel_room_attr_rel

ServiceHotelRoomAttrService#queryList （HotelRoomAttrServiceImpl）

MapperHotelRoomAttrMapper#selectList ⇒ 表 hotel_room_attr

ServiceHotelRoomPriceCalendarService#get （HotelRoomPriceCalendarServiceImpl）

MapperHotelRoomPriceCalendarMapper#selectById ⇒ 表 hotel_room_price_calendar

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/open-api/hotelApi/getHotelRoomDetail
uat	https://dscp-uat.hn12301.net/open-api/hotelApi/getHotelRoomDetail
pro	https://dscp-uat.hn12301.net/open-api/hotelApi/getHotelRoomDetail	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HotelPlanDetailRequest

字段	类型	必填	取值/校验	表 / 列	说明
planId	Long			`hotel_room_price_calendar`.`plan_id`
dates	Date[]	是	必填	—

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　HotelPlanDetailResponse　（object）

字段	类型	取值/校验	表 / 列	说明
plan	HotelRoomTypePlan		—
plan.id	Long		`hotel_room_type_plan`.`id`
plan.hotelId	Long		`hotel_room_type_plan`.`hotel_id`	酒店ID
plan.roomTypeId	Long		`hotel_room_type_plan`.`room_type_id`	房型ID
plan.name	String		`hotel_room_type_plan`.`name`	方案名称
plan.autoConfirm	Integer		`hotel_room_type_plan`.`auto_confirm`	是否自动确认
plan.breakfast	Integer		`hotel_room_type_plan`.`breakfast`	是否含早
plan.basePrice	Integer		`hotel_room_type_plan`.`base_price`	底价(分)
plan.salePrice	Integer		`hotel_room_type_plan`.`sale_price`	卖价(分)
plan.stockType	StockType	0无限1共享2独立	`hotel_room_type_plan`.`stock_type`	库存类型
plan.stockNum	Integer		`hotel_room_type_plan`.`stock_num`	数量
plan.cancelType	CancelType	1免费取消2不可取消3有条件取消	`hotel_room_type_plan`.`cancel_type`	取消类型
plan.cancelDays	Integer		`hotel_room_type_plan`.`cancel_days`	提前取消天数，0表示入住当天
plan.cancelHours	String		`hotel_room_type_plan`.`cancel_hours`	取消截止时间点，如18:00
plan.sort	Integer		`hotel_room_type_plan`.`sort`	排序号
plan.status	Integer		`hotel_room_type_plan`.`status`	状态
plan.isDeleted	Boolean		`hotel_room_type_plan`.`is_deleted`	是否删除(0否 1是)
plan.createdBy	Long		`hotel_room_type_plan`.`created_by`	创建人ID
plan.createdTime	Date		`hotel_room_type_plan`.`created_time`	创建时间
plan.updatedBy	Long		`hotel_room_type_plan`.`updated_by`	更新人ID
plan.updatedTime	Date		`hotel_room_type_plan`.`updated_time`	更新时间
roomType	HotelRoomTypeTreeResponse		—
roomType.id	Long		`hotel_room_type_plan`.`id`	id
roomType.hotelId	Long		`hotel_room_type_plan`.`hotel_id`	酒店ID
roomType.name	String		`hotel_room_type_plan`.`name`	房型名称
roomType.basePrice	Integer		`hotel_room_type_plan`.`base_price`	基础价格(分)
roomType.sort	Integer		`hotel_room_type_plan`.`sort`	排序号
roomType.status	Integer		`hotel_room_type_plan`.`status`	状态(0正常 1停用)
roomType.coverImage	String		`hotel_room_type`.`cover_image`	主图URL
roomType.images	String		`hotel_room_type`.`images`	房型图片，多个用逗号分隔
roomType.roomTypeArea	BigDecimal		`hotel_room_type`.`room_type_area`	面积(平方米)
roomType.floorInfo	String		`hotel_room_type`.`floor_info`	楼层信息
roomType.windowType	WindowType	1无窗2部分有窗3全部有窗	`hotel_room_type`.`window_type`	窗户类型
roomType.bedInfo	String		`hotel_room_type`.`bed_info`	床型
roomType.guests	Integer		`hotel_room_type`.`guests`	可住人数
roomType.smoking	Integer		`hotel_room_type`.`smoking`	是否禁烟(0否 1是)
roomType.networkType	NetworkType	1免费WiFi2收费WiFi3无网络	`hotel_room_type`.`network_type`	网络类型
roomType.extraBedAllowed	Integer		`hotel_room_type`.`extra_bed_allowed`	是否可加床(0否 1是)
roomType.extraBedDesc	String		`hotel_room_type`.`extra_bed_desc`	加床说明
roomType.facilities	List<FacilityTree>		—	设施列表
roomType.showPrice	Integer		—
roomType.pricePlans	List<HotelRoomTypePlan>		—	价格方案列表
pricePlans[].id	Long		`hotel_room_type_plan`.`id`
pricePlans[].hotelId	Long		`hotel_room_type_plan`.`hotel_id`	酒店ID
pricePlans[].roomTypeId	Long		`hotel_room_type_plan`.`room_type_id`	房型ID
pricePlans[].name	String		`hotel_room_type_plan`.`name`	方案名称
pricePlans[].autoConfirm	Integer		`hotel_room_type_plan`.`auto_confirm`	是否自动确认
pricePlans[].breakfast	Integer		`hotel_room_type_plan`.`breakfast`	是否含早
pricePlans[].basePrice	Integer		`hotel_room_type_plan`.`base_price`	底价(分)
pricePlans[].salePrice	Integer		`hotel_room_type_plan`.`sale_price`	卖价(分)
pricePlans[].stockType	StockType	0无限1共享2独立	`hotel_room_type_plan`.`stock_type`	库存类型
pricePlans[].stockNum	Integer		`hotel_room_type_plan`.`stock_num`	数量
pricePlans[].cancelType	CancelType	1免费取消2不可取消3有条件取消	`hotel_room_type_plan`.`cancel_type`	取消类型
pricePlans[].cancelDays	Integer		`hotel_room_type_plan`.`cancel_days`	提前取消天数，0表示入住当天
pricePlans[].cancelHours	String		`hotel_room_type_plan`.`cancel_hours`	取消截止时间点，如18:00
pricePlans[].sort	Integer		`hotel_room_type_plan`.`sort`	排序号
pricePlans[].status	Integer		`hotel_room_type_plan`.`status`	状态
pricePlans[].isDeleted	Boolean		`hotel_room_type_plan`.`is_deleted`	是否删除(0否 1是)
pricePlans[].createdBy	Long		`hotel_room_type_plan`.`created_by`	创建人ID
pricePlans[].createdTime	Date		`hotel_room_type_plan`.`created_time`	创建时间
pricePlans[].updatedBy	Long		`hotel_room_type_plan`.`updated_by`	更新人ID
pricePlans[].updatedTime	Date		`hotel_room_type_plan`.`updated_time`	更新时间
basePrice	Integer		`hotel_room_type_plan`.`base_price`
salePrice	Integer		`hotel_room_type_plan`.`sale_price`
stockNum	Integer		`hotel_room_type_plan`.`stock_num`

示例

请求示例（自动生成，仅结构参考）

POST /hotelApi/getHotelRoomDetail

{
  "body": {
    "planId": 1,
    "dates": "2026-01-01 12:00:00"
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "plan": {
      "id": 1,
      "hotelId": 1,
      "roomTypeId": 1,
      "name": "",
      "autoConfirm": 0,
      "breakfast": 0,
      "basePrice": 0,
      "salePrice": 0,
      "stockType": "0",
      "stockNum": 0,
      "cancelType": "1",
      "cancelDays": 0,
      "cancelHours": "",
      "sort": 0,
      "status": 0,
      "isDeleted": false,
      "createdBy": 0,
      "createdTime": "2026-01-01 12:00:00",
      "updatedBy": 0,
      "updatedTime": "2026-01-01 12:00:00"
    },
    "roomType": {
      "id": 1,
      "hotelId": 1,
      "name": "",
      "basePrice": 0,
      "sort": 0,
      "status": 0,
      "coverImage": "",
      "images": "",
      "roomTypeArea": 0,
      "floorInfo": "",
      "windowType": "1",
      "bedInfo": "",
      "guests": 0,
      "smoking": 0,
      "networkType": "1",
      "extraBedAllowed": 0,
      "extraBedDesc": "",
      "facilities": "",
      "showPrice": 0,
      "pricePlans": [
        {
          "id": 1,
          "hotelId": 1,
          "roomTypeId": 1,
          "name": "",
          "autoConfirm": 0,
          "breakfast": 0,
          "basePrice": 0,
          "salePrice": 0,
          "stockType": "0",
          "stockNum": 0,
          "cancelType": "1",
          "cancelDays": 0,
          "cancelHours": "",
          "sort": 0,
          "status": 0,
          "isDeleted": false,
          "createdBy": 0,
          "createdTime": "2026-01-01 12:00:00",
          "updatedBy": 0,
          "updatedTime": "2026-01-01 12:00:00"
        }
      ]
    },
    "basePrice": 0,
    "salePrice": 0,
    "stockNum": 0
  }
}

处理逻辑

逻辑摘要查询详情（hotelRoomTypePlanService.get）；查询详情（hotelRoomTypeService.get）；列表查询（hotelRoomAttrRelService.queryList）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

查询房型关联的设施
查询设施详情
构建设施树
价格日历
.dateRange(request.getDates())

前端调用方

xghmall getHotelRoomDetail exact

POST /hotelApi/getHotelRoomInfo 在用开放/回调 #

获取酒店房型及sku列表信息 · HotelApiController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelApiController#getHotelRoomInfo
所属模块	酒店 `hotel`
暴露渠道	开放/回调（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_room_price_calendar

ControllerHotelApiController#getHotelRoomInfo

ServiceHotelRoomPriceCalendarService#queryList （HotelRoomPriceCalendarServiceImpl）

MapperHotelRoomPriceCalendarMapper#selectList ⇒ 表 hotel_room_price_calendar

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/open-api/hotelApi/getHotelRoomInfo
uat	https://dscp-uat.hn12301.net/open-api/hotelApi/getHotelRoomInfo
pro	https://dscp-uat.hn12301.net/open-api/hotelApi/getHotelRoomInfo	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HotelRoomInfoRequest

字段	类型	必填	取值/校验	表 / 列	说明
hotelId	Long	是	必填	`hotel_room_price_calendar`.`hotel_id`
dates	Date[]	是	必填	—	日期范围

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　List<HotelRoomTypeTreeResponse>　（list）

字段	类型	取值/校验	表 / 列	说明
[ ]	array		—	列表，元素结构见下
id	Long		`hotel_room_price_calendar`.`id`	id
hotelId	Long		`hotel_room_price_calendar`.`hotel_id`	酒店ID
name	String		—	房型名称
basePrice	Integer		`hotel_room_price_calendar`.`base_price`	基础价格(分)
sort	Integer		—	排序号
status	Integer		`hotel_room_price_calendar`.`status`	状态(0正常 1停用)
coverImage	String		—	主图URL
images	String		—	房型图片，多个用逗号分隔
roomTypeArea	BigDecimal		—	面积(平方米)
floorInfo	String		—	楼层信息
windowType	WindowType	1无窗2部分有窗3全部有窗	—	窗户类型
bedInfo	String		—	床型
guests	Integer		—	可住人数
smoking	Integer		—	是否禁烟(0否 1是)
networkType	NetworkType	1免费WiFi2收费WiFi3无网络	—	网络类型
extraBedAllowed	Integer		—	是否可加床(0否 1是)
extraBedDesc	String		—	加床说明
facilities	List<FacilityTree>		—	设施列表
showPrice	Integer		—
pricePlans	List<HotelRoomTypePlan>		—	价格方案列表
pricePlans[].id	Long		`hotel_room_price_calendar`.`id`
pricePlans[].hotelId	Long		`hotel_room_price_calendar`.`hotel_id`	酒店ID
pricePlans[].roomTypeId	Long		`hotel_room_price_calendar`.`room_type_id`	房型ID
pricePlans[].name	String		—	方案名称
pricePlans[].autoConfirm	Integer		—	是否自动确认
pricePlans[].breakfast	Integer		—	是否含早
pricePlans[].basePrice	Integer		`hotel_room_price_calendar`.`base_price`	底价(分)
pricePlans[].salePrice	Integer		`hotel_room_price_calendar`.`sale_price`	卖价(分)
pricePlans[].stockType	StockType	0无限1共享2独立	—	库存类型
pricePlans[].stockNum	Integer		—	数量
pricePlans[].cancelType	CancelType	1免费取消2不可取消3有条件取消	—	取消类型
pricePlans[].cancelDays	Integer		—	提前取消天数，0表示入住当天
pricePlans[].cancelHours	String		—	取消截止时间点，如18:00
pricePlans[].sort	Integer		—	排序号
pricePlans[].status	Integer		`hotel_room_price_calendar`.`status`	状态
pricePlans[].isDeleted	Boolean		`hotel_room_price_calendar`.`is_deleted`	是否删除(0否 1是)
pricePlans[].createdBy	Long		`hotel_room_price_calendar`.`created_by`	创建人ID
pricePlans[].createdTime	Date		`hotel_room_price_calendar`.`created_time`	创建时间
pricePlans[].updatedBy	Long		`hotel_room_price_calendar`.`updated_by`	更新人ID
pricePlans[].updatedTime	Date		`hotel_room_price_calendar`.`updated_time`	更新时间

示例

请求示例（自动生成，仅结构参考）

POST /hotelApi/getHotelRoomInfo

{
  "body": {
    "hotelId": 1,
    "dates": "2026-01-01 12:00:00"
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "id": 1,
      "hotelId": 1,
      "name": "",
      "basePrice": 0,
      "sort": 0,
      "status": 0,
      "coverImage": "",
      "images": "",
      "roomTypeArea": 0,
      "floorInfo": "",
      "windowType": "1",
      "bedInfo": "",
      "guests": 0,
      "smoking": 0,
      "networkType": "1",
      "extraBedAllowed": 0,
      "extraBedDesc": "",
      "facilities": "",
      "showPrice": 0,
      "pricePlans": [
        {
          "id": 1,
          "hotelId": 1,
          "roomTypeId": 1,
          "name": "",
          "autoConfirm": 0,
          "breakfast": 0,
          "basePrice": 0,
          "salePrice": 0,
          "stockType": "0",
          "stockNum": 0,
          "cancelType": "1",
          "cancelDays": 0,
          "cancelHours": "",
          "sort": 0,
          "status": 0,
          "isDeleted": false,
          "createdBy": 0,
          "createdTime": "2026-01-01 12:00:00",
          "updatedBy": 0,
          "updatedTime": "2026-01-01 12:00:00"
        }
      ]
    }
  ]
}

处理逻辑

逻辑摘要列表查询（hotelRoomPriceCalendarService.queryList）

内联注释

每个sku从价格日历表去设置的价格
房间战士价格

前端调用方

xghmall getHotelRoomInfo exact

POST /hotelApi/hotelAddMember 在用开放/回调 #

添加联系人 · HotelApiController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelApiController#hotelAddMember
所属模块	酒店 `hotel`
暴露渠道	开放/回调（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表memberhotel_member_traveler

ControllerHotelApiController#hotelAddMember

ServiceMemberService#get （MemberServiceImpl）

MapperMemberMapper#selectById ⇒ 表 member

ServiceHotelMemberTravelerService#add （HotelMemberTravelerServiceImpl）

MapperHotelMemberTravelerMapper#insert ⇒ 表 hotel_member_traveler

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/open-api/hotelApi/hotelAddMember
uat	https://dscp-uat.hn12301.net/open-api/hotelApi/hotelAddMember
pro	https://dscp-uat.hn12301.net/open-api/hotelApi/hotelAddMember	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HotelAddMemberRequest

字段	类型	表 / 列
mobile	String	`member`.`mobile`
name	String	`member`.`name`
idType	Integer	`hotel_member_traveler`.`id_type`
idNo	String	`hotel_member_traveler`.`id_no`
isDefault	boolean	`hotel_member_traveler`.`is_default`
id	Long	`member`.`id`

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /hotelApi/hotelAddMember

{
  "body": {
    "mobile": "13800000000",
    "name": "",
    "idType": 1,
    "idNo": "",
    "isDefault": false,
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志hotel / 酒店添加联系人

逻辑摘要查询详情（memberService.get）；新增（hotelMemberTravelerService.add）

前端调用方

xghmall hotelAddMember exact

POST /hotelApi/hotelBook 在用开放/回调 #

酒店预订 · HotelApiController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelApiController#hotelBook
所属模块	酒店 `hotel`
暴露渠道	开放/回调（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_room_price_calendarmemberhotel_room_type_planhotel_member_travelerhotel_orderpromotion_couponhotel_order_roomhotel_order_log

ControllerHotelApiController#hotelBook

ServiceHotelApiService#hotelBook （HotelApiServiceImpl）

ServiceHotelRoomPriceCalendarService#get （HotelRoomPriceCalendarServiceImpl）

MapperHotelRoomPriceCalendarMapper#selectById ⇒ 表 hotel_room_price_calendar

ServiceMemberService#queryList （MemberServiceImpl）

MapperMemberMapper#selectList ⇒ 表 member

ServiceHotelRoomTypePlanService#get （HotelRoomTypePlanServiceImpl）

MapperHotelRoomTypePlanMapper#selectById ⇒ 表 hotel_room_type_plan

ServiceHotelMemberTravelerService#get （HotelMemberTravelerServiceImpl）

MapperHotelMemberTravelerMapper#selectById ⇒ 表 hotel_member_traveler

ServiceHotelOrderService#add （HotelOrderServiceImpl）

MapperHotelOrderMapper#insert ⇒ 表 hotel_order

ServicePromotionCouponService#getCoupon （PromotionCouponServiceImpl）

MapperPromotionCouponMapper#selectByIdAndUserId ⇒ 表 promotion_coupon

ServicePromotionCouponService#useCoupon （PromotionCouponServiceImpl）

MapperPromotionCouponMapper#updateByIdAndStatus ⇒ 表 promotion_coupon

ServiceHotelOrderRoomService#add （HotelOrderRoomServiceImpl）

MapperHotelOrderRoomMapper#insert ⇒ 表 hotel_order_room

ServiceHotelOrderLogService#add （HotelOrderLogServiceImpl）

MapperHotelOrderLogMapper#insert ⇒ 表 hotel_order_log

ServiceHotelRoomPriceCalendarService#update （HotelRoomPriceCalendarServiceImpl）

MapperHotelRoomPriceCalendarMapper#updateById ⇒ 表 hotel_room_price_calendar

ServiceHotelOrderService#update （HotelOrderServiceImpl）

MapperHotelOrderMapper#updateById ⇒ 表 hotel_order

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/open-api/hotelApi/hotelBook
uat	https://dscp-uat.hn12301.net/open-api/hotelApi/hotelBook
pro	https://dscp-uat.hn12301.net/open-api/hotelApi/hotelBook	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HotelBookRequest

字段	类型	表 / 列
hotelPlanId	Long	—
beginDate	String	—
endDate	String	—
num	Integer	—
couponId	Long	`hotel_order`.`coupon_id`
mobile	String	`member`.`mobile`
travelerId	String	—
contactMobile	String	—

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　Long　（scalar）

标量/Map/外部类型：Long

示例

请求示例（自动生成，仅结构参考）

POST /hotelApi/hotelBook

{
  "body": {
    "hotelPlanId": 1,
    "beginDate": "2026-01-01 12:00:00",
    "endDate": "2026-01-01 12:00:00",
    "num": 0,
    "couponId": 1,
    "mobile": "13800000000",
    "travelerId": "",
    "contactMobile": "13800000000"
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": 0
}

处理逻辑

操作日志hotel / 酒店预订

逻辑摘要调用 hotelBook（hotelApiService.hotelBook）

前端调用方

xghmall hotelBook exact

POST /hotelApi/hotelBookDetail 在用开放/回调 #

酒店预订 · HotelApiController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelApiController#hotelBookDetail
所属模块	酒店 `hotel`
暴露渠道	开放/回调（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_room_type_planhotel_room_price_calendarmemberpromotion_coupon

ControllerHotelApiController#hotelBookDetail

ServiceHotelApiService#hotelBookDetail （HotelApiServiceImpl）

ServiceHotelRoomTypePlanService#get （HotelRoomTypePlanServiceImpl）

MapperHotelRoomTypePlanMapper#selectById ⇒ 表 hotel_room_type_plan

ServiceHotelRoomPriceCalendarService#get （HotelRoomPriceCalendarServiceImpl）

MapperHotelRoomPriceCalendarMapper#selectById ⇒ 表 hotel_room_price_calendar

ServiceMemberService#get （MemberServiceImpl）

MapperMemberMapper#selectById ⇒ 表 member

ServicePromotionCouponService#getCoupon （PromotionCouponServiceImpl）

MapperPromotionCouponMapper#selectByIdAndUserId ⇒ 表 promotion_coupon

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/open-api/hotelApi/hotelBookDetail
uat	https://dscp-uat.hn12301.net/open-api/hotelApi/hotelBookDetail
pro	https://dscp-uat.hn12301.net/open-api/hotelApi/hotelBookDetail	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HotelBookRequest

字段	类型	表 / 列
hotelPlanId	Long	—
beginDate	String	—
endDate	String	—
num	Integer	—
couponId	Long	—
mobile	String	`member`.`mobile`
travelerId	String	—
contactMobile	String	—

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　HotelBookDetailResponse　（object）

字段	类型	表 / 列
totalPrice	Integer	—
payPrice	Integer	—
discountPrice	Integer	`promotion_coupon`.`discount_price`
details	List<BookDetail>	—
details[].date	String	`hotel_room_price_calendar`.`date`
details[].name	String	`hotel_room_type_plan`.`name`
details[].price	Integer	—
details[].num	Integer	—

示例

请求示例（自动生成，仅结构参考）

POST /hotelApi/hotelBookDetail

{
  "body": {
    "hotelPlanId": 1,
    "beginDate": "2026-01-01 12:00:00",
    "endDate": "2026-01-01 12:00:00",
    "num": 0,
    "couponId": 1,
    "mobile": "13800000000",
    "travelerId": "",
    "contactMobile": "13800000000"
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "totalPrice": 0,
    "payPrice": 0,
    "discountPrice": 0,
    "details": [
      {
        "date": "2026-01-01 12:00:00",
        "name": "",
        "price": 0,
        "num": 0
      }
    ]
  }
}

处理逻辑

逻辑摘要调用 hotelBookDetail（hotelApiService.hotelBookDetail）

前端调用方

xghmall hotelBookDetail exact

POST /hotelApi/hotelCancelOrder 在用开放/回调 #

酒店取消订单 · HotelApiController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelApiController#hotelCancelOrder
所属模块	酒店 `hotel`
暴露渠道	开放/回调（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_ordermemberhotel_order_log

ControllerHotelApiController#hotelCancelOrder

ServiceHotelApiService#hotelCancelOrder （HotelApiServiceImpl）

ServiceHotelOrderService#get （HotelOrderServiceImpl）

MapperHotelOrderMapper#selectById ⇒ 表 hotel_order

ServiceMemberService#get （MemberServiceImpl）

MapperMemberMapper#selectById ⇒ 表 member

ServiceHotelOrderLogService#add （HotelOrderLogServiceImpl）

MapperHotelOrderLogMapper#insert ⇒ 表 hotel_order_log

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 4

HotelOrderService.cancelOrderHotelOrderService.updateHotelOrderService.releaseRoomNumHotelOrderRoomService.queryList

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/open-api/hotelApi/hotelCancelOrder
uat	https://dscp-uat.hn12301.net/open-api/hotelApi/hotelCancelOrder
pro	https://dscp-uat.hn12301.net/open-api/hotelApi/hotelCancelOrder	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`hotel_order`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /hotelApi/hotelCancelOrder

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志hotel / 酒店取消订单

逻辑摘要调用 hotelCancelOrder（hotelApiService.hotelCancelOrder）

前端调用方

xghmall hotelCancelOrder exact

POST /hotelApi/hotelDeleteMember 在用开放/回调 #

删除联系人 · HotelApiController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelApiController#hotelDeleteMember
所属模块	酒店 `hotel`
暴露渠道	开放/回调（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_member_traveler

ControllerHotelApiController#hotelDeleteMember

ServiceHotelMemberTravelerService#get （HotelMemberTravelerServiceImpl）

MapperHotelMemberTravelerMapper#selectById ⇒ 表 hotel_member_traveler

ServiceHotelMemberTravelerService#update （HotelMemberTravelerServiceImpl）

MapperHotelMemberTravelerMapper#updateById ⇒ 表 hotel_member_traveler

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/open-api/hotelApi/hotelDeleteMember
uat	https://dscp-uat.hn12301.net/open-api/hotelApi/hotelDeleteMember
pro	https://dscp-uat.hn12301.net/open-api/hotelApi/hotelDeleteMember	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`hotel_member_traveler`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /hotelApi/hotelDeleteMember

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志hotel / 酒店删除联系人

逻辑摘要查询详情（hotelMemberTravelerService.get）；更新（hotelMemberTravelerService.update）

前端调用方

xghmall hotelDeleteMember exact

POST /hotelApi/hotelMemberList 在用开放/回调 #

获取联系人列表 · HotelApiController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelApiController#hotelMemberList
所属模块	酒店 `hotel`
暴露渠道	开放/回调（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_member_travelermember

ControllerHotelApiController#hotelMemberList

ServiceMemberService#get （MemberServiceImpl）

MapperMemberMapper#selectById ⇒ 表 member

ServiceMemberService#add （MemberServiceImpl）

MapperMemberMapper#insert ⇒ 表 member

ServiceHotelMemberTravelerService#queryList （HotelMemberTravelerServiceImpl）

MapperHotelMemberTravelerMapper#selectList ⇒ 表 hotel_member_traveler

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/open-api/hotelApi/hotelMemberList
uat	https://dscp-uat.hn12301.net/open-api/hotelApi/hotelMemberList
pro	https://dscp-uat.hn12301.net/open-api/hotelApi/hotelMemberList	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HotelMemberListRequest

字段	类型	必填	取值/校验	表 / 列	说明
mobile	String			`member`.`mobile`
openId	String			`member`.`open_id`

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　List<HotelMemberTraveler>　（list）

字段	类型	表 / 列	说明
[ ]	array	—	列表，元素结构见下
id	Long	`hotel_member_traveler`.`id`	旅客ID
memberId	Long	`hotel_member_traveler`.`member_id`	会员ID
name	String	`hotel_member_traveler`.`name`	旅客姓名
idType	Integer	`hotel_member_traveler`.`id_type`	证件类型(1-身份证,2-护照,3-港澳通行证,4-台胞证)
idNo	String	`hotel_member_traveler`.`id_no`	证件号码
phone	String	`hotel_member_traveler`.`phone`	手机号
gender	Integer	`hotel_member_traveler`.`gender`	性别(0-未知,1-男,2-女)
birthday	Date	`hotel_member_traveler`.`birthday`	出生日期
isDefault	Boolean	`hotel_member_traveler`.`is_default`	是否默认(0-否,1-是)
isDeleted	Boolean	`hotel_member_traveler`.`is_deleted`	是否删除(0-否,1-是)
createdBy	String	`hotel_member_traveler`.`created_by`	创建人
createdTime	Date	`hotel_member_traveler`.`created_time`	创建时间
updatedBy	String	`hotel_member_traveler`.`updated_by`	修改人
updatedTime	Date	`hotel_member_traveler`.`updated_time`	修改时间

示例

请求示例（自动生成，仅结构参考）

POST /hotelApi/hotelMemberList

{
  "body": {
    "mobile": "13800000000",
    "openId": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "id": 1,
      "memberId": 1,
      "name": "",
      "idType": 1,
      "idNo": "",
      "phone": "13800000000",
      "gender": 0,
      "birthday": "2026-01-01 12:00:00",
      "isDefault": false,
      "isDeleted": false,
      "createdBy": "",
      "createdTime": "2026-01-01 12:00:00",
      "updatedBy": "2026-01-01 12:00:00",
      "updatedTime": "2026-01-01 12:00:00"
    }
  ]
}

处理逻辑

逻辑摘要查询详情（memberService.get）；调用 date（DateUtil.date）；新增（memberService.add）

内联注释

会员不存在，新增会员信息

前端调用方

xghmall hotelMemberList exact

POST /hotelApi/hotelPrePayXgh 在用开放/回调 #

酒店预支付 - 湘工惠 · HotelApiController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelApiController#hotelPrePayXgh
所属模块	酒店 `hotel`
暴露渠道	开放/回调（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_infohotel_room_typemember

ControllerHotelApiController#hotelPrePayXgh

ServiceHotelInfoService#get （HotelInfoServiceImpl）

MapperHotelInfoMapper#selectById ⇒ 表 hotel_info

ServiceHotelRoomTypeService#get （HotelRoomTypeServiceImpl）

MapperHotelRoomTypeMapper#selectById ⇒ 表 hotel_room_type

ServiceMemberService#get （MemberServiceImpl）

MapperMemberMapper#selectById ⇒ 表 member

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 8

LockService.tryLockHotelOrderService.mustGetXghService.getXghAccessTokenRedisCacheService.getCacheService.getCacheService.putRedisCacheService.putLockService.unlock

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/open-api/hotelApi/hotelPrePayXgh
uat	https://dscp-uat.hn12301.net/open-api/hotelApi/hotelPrePayXgh
pro	https://dscp-uat.hn12301.net/open-api/hotelApi/hotelPrePayXgh	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　PrepayRequest

字段	类型	必填	取值/校验	表 / 列	说明
openId	String	是	必填	`member`.`open_id`	openId
orderNo	String	是	必填	—	商户订单号
amount	Long			—	订单金额，单位为分
description	String			—	商品描述
expireTime	Date	否	可选(@MvcOptional)	—	订单失效时间

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　ChannelPrePayResponse　（object）

字段	类型	表 / 列	说明
outTradeNo	String	—	我方交易号
tradeNo	String	—	第三方交易号
flag	Boolean	—
payUrl	String	—

示例

请求示例（自动生成，仅结构参考）

POST /hotelApi/hotelPrePayXgh

{
  "body": {
    "openId": "",
    "orderNo": "",
    "amount": 0,
    "description": "",
    "expireTime": "2026-01-01 12:00:00"
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "outTradeNo": "",
    "tradeNo": "",
    "flag": false,
    "payUrl": "https://example.com/x.png"
  }
}

处理逻辑

逻辑摘要调用 tryLock（lockService.tryLock）；调用 mustGet（hotelOrderService.mustGet）；查询详情（hotelInfoService.get）

内联注释

查询订单状态
设置订单信息
IdRequest orderRequest = new IdRequest();
orderRequest.setId(order.getId());
CardOrderResponse orderInfo = cardService.getCardOrder(orderRequest);
subOrder.setAmount(orderGoods.getSkuPrice().longValue());

前端调用方

xghmall hotelPrePayXgh exact

POST /hotelApi/hotelUpdateMember 在用开放/回调 #

修改联系人 · HotelApiController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelApiController#hotelUpdateMember
所属模块	酒店 `hotel`
暴露渠道	开放/回调（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_member_traveler

ControllerHotelApiController#hotelUpdateMember

ServiceHotelMemberTravelerService#get （HotelMemberTravelerServiceImpl）

MapperHotelMemberTravelerMapper#selectById ⇒ 表 hotel_member_traveler

ServiceHotelMemberTravelerService#update （HotelMemberTravelerServiceImpl）

MapperHotelMemberTravelerMapper#updateById ⇒ 表 hotel_member_traveler

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/open-api/hotelApi/hotelUpdateMember
uat	https://dscp-uat.hn12301.net/open-api/hotelApi/hotelUpdateMember
pro	https://dscp-uat.hn12301.net/open-api/hotelApi/hotelUpdateMember	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HotelAddMemberRequest

字段	类型	表 / 列
mobile	String	—
name	String	`hotel_member_traveler`.`name`
idType	Integer	`hotel_member_traveler`.`id_type`
idNo	String	`hotel_member_traveler`.`id_no`
isDefault	boolean	`hotel_member_traveler`.`is_default`
id	Long	`hotel_member_traveler`.`id`

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /hotelApi/hotelUpdateMember

{
  "body": {
    "mobile": "13800000000",
    "name": "",
    "idType": 1,
    "idNo": "",
    "isDefault": false,
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志hotel / 酒店更新联系人

逻辑摘要查询详情（hotelMemberTravelerService.get）；更新（hotelMemberTravelerService.update）

前端调用方

xghmall hotelUpdateMember exact

POST /hotelApi/queryHotelInfoPage 在用开放/回调 #

（无摘要） · HotelApiController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelApiController#queryHotelInfoPage
所属模块	酒店 `hotel`
暴露渠道	开放/回调（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_infohotel_room_typehotel_room_price_calendar

ControllerHotelApiController#queryHotelInfoPage

转换BeanUtils.map → HotelInfoQuery

ServiceHotelInfoService#queryPage （HotelInfoServiceImpl）

MapperHotelInfoMapper#selectPage ⇒ 表 hotel_info

ServiceHotelRoomTypeService#count （HotelRoomTypeServiceImpl）

MapperHotelRoomTypeMapper#selectCount ⇒ 表 hotel_room_type

ServiceHotelRoomPriceCalendarService#queryList （HotelRoomPriceCalendarServiceImpl）

MapperHotelRoomPriceCalendarMapper#selectList ⇒ 表 hotel_room_price_calendar

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/open-api/hotelApi/queryHotelInfoPage
uat	https://dscp-uat.hn12301.net/open-api/hotelApi/queryHotelInfoPage
pro	https://dscp-uat.hn12301.net/open-api/hotelApi/queryHotelInfoPage	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HotelListPageRequest

字段	类型	必填	取值/校验	表 / 列	说明
pageNum	Integer	否		—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否		—	每页条数（继承自框架分页基类 AbstractPageRequest）
name	String			`hotel_info`.`name`	酒店名称
grade	HotelGrade		1二星及以下/经济2三星/舒适3四星/高档4五星/豪华5奢华	`hotel_info`.`grade`
status	Integer			`hotel_info`.`status`	状态，0正常，1停用
roomFlag	Integer			—
userLongitude	String			—	经度
userLatitude	String			—	纬度

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　PageInfo<HotelInfoResponse>　（page）

字段	类型	取值/校验	表 / 列	说明
list / records	array		—	分页列表，元素结构见下
total	long		—	总条数（PageInfo）
id	Long		`hotel_info`.`id`	酒店ID
name	String		`hotel_info`.`name`	酒店名称
grade	HotelGrade	1二星及以下/经济2三星/舒适3四星/高档4五星/豪华5奢华	`hotel_info`.`grade`	酒店等级(枚举:HotelGrade)，1二星及以下/经济，2三星/舒适，3四星/高档，4五星/豪华，5奢华
type	HotelType	1酒店2民宿3公寓4青年旅社5别墅6度假村7客栈8农家乐+4	`hotel_info`.`type`
status	Integer		`hotel_info`.`status`	状态，0正常，1停用
openingYear	Integer		`hotel_info`.`opening_year`	开业年份
roomCount	Integer		`hotel_info`.`room_count`	房间数量
roomTypeCount	Long		—	房型数量
phone	String		`hotel_info`.`phone`	联系电话
address	String		`hotel_info`.`address`	详细地址
landmark	String		`hotel_info`.`landmark`	地标
provinceId	Long		`hotel_info`.`province_id`	省id
cityId	Long		`hotel_info`.`city_id`	市id
districtId	Long		`hotel_info`.`district_id`	区县id
longitude	BigDecimal		`hotel_info`.`longitude`	经度
latitude	BigDecimal		`hotel_info`.`latitude`	纬度
coverImage	String		`hotel_info`.`cover_image`	主图URL
images	String		`hotel_info`.`images`	轮播图URL，多个用逗号分隔
tags	String		`hotel_info`.`tags`	酒店标签，多个用逗号分隔
locationTags	String		`hotel_info`.`location_tags`	位置描述标签，多个用逗号分隔
highlights	String		`hotel_info`.`highlights`	酒店亮点(富文本)
isDeleted	Boolean		`hotel_info`.`is_deleted`	是否删除(0否 1是)
createdBy	Long		`hotel_info`.`created_by`	创建人ID
createdTime	Date		`hotel_info`.`created_time`	创建时间
updatedBy	Long		`hotel_info`.`updated_by`	更新人ID
updatedTime	Date		`hotel_info`.`updated_time`	更新时间
lowestPrice	BigDecimal		—
distance	BigDecimal		—

示例

请求示例（自动生成，仅结构参考）

POST /hotelApi/queryHotelInfoPage

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "name": "",
    "grade": "1",
    "status": 0,
    "roomFlag": 0,
    "userLongitude": "",
    "userLatitude": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1,
        "name": "",
        "grade": "1",
        "type": "1",
        "status": 0,
        "openingYear": 0,
        "roomCount": 0,
        "roomTypeCount": 0,
        "phone": "13800000000",
        "address": "",
        "landmark": "",
        "provinceId": 1,
        "cityId": 1,
        "districtId": 1,
        "longitude": 0,
        "latitude": 0,
        "coverImage": "",
        "images": "",
        "tags": "",
        "locationTags": "",
        "highlights": "",
        "isDeleted": false,
        "createdBy": 0,
        "createdTime": "2026-01-01 12:00:00",
        "updatedBy": 0,
        "updatedTime": "2026-01-01 12:00:00",
        "lowestPrice": 0,
        "distance": 0
      }
    ],
    "total": 0
  }
}

处理逻辑

逻辑摘要分页查询（hotelInfoService.queryPage）；调用 count（hotelRoomTypeService.count）；列表查询（hotelRoomPriceCalendarService.queryList）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件
查询每个酒店的房型数量
计算评分
设置最低价
计算距离

前端调用方

xghmall queryHotelInfoPage exact

POST /hotelApi/queryHotelRoomTypeTreePage 在用开放/回调 #

房型表-分页查询(树形) · HotelApiController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelApiController#queryHotelRoomTypeTreePage
所属模块	酒店 `hotel`
暴露渠道	开放/回调（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_room_typehotel_room_type_planhotel_room_attr_relhotel_room_attr

ControllerHotelApiController#queryHotelRoomTypeTreePage

转换BeanUtils.map → HotelRoomTypeQuery

转换BeanUtils.map → HotelRoomTypeTreeResponse

ServiceHotelRoomTypeService#queryPage （HotelRoomTypeServiceImpl）

MapperHotelRoomTypeMapper#selectPage ⇒ 表 hotel_room_type

ServiceHotelRoomTypePlanService#queryList （HotelRoomTypePlanServiceImpl）

MapperHotelRoomTypePlanMapper#selectList ⇒ 表 hotel_room_type_plan

ServiceHotelRoomAttrRelService#queryList （HotelRoomAttrRelServiceImpl）

MapperHotelRoomAttrRelMapper#selectList ⇒ 表 hotel_room_attr_rel

ServiceHotelRoomAttrService#queryList （HotelRoomAttrServiceImpl）

MapperHotelRoomAttrMapper#selectList ⇒ 表 hotel_room_attr

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/open-api/hotelApi/queryHotelRoomTypeTreePage
uat	https://dscp-uat.hn12301.net/open-api/hotelApi/queryHotelRoomTypeTreePage
pro	https://dscp-uat.hn12301.net/open-api/hotelApi/queryHotelRoomTypeTreePage	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HotelRoomListPageRequest

字段	类型	必填	取值/校验	表 / 列	说明
pageNum	Integer	否		—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否		—	每页条数（继承自框架分页基类 AbstractPageRequest）
hotelId	Long			`hotel_room_type`.`hotel_id`	所属酒店ID
name	String			`hotel_room_type`.`name`	房型名称
status	Integer			`hotel_room_type`.`status`
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　PageInfo<HotelRoomTypeTreeResponse>　（page）

字段	类型	取值/校验	表 / 列	说明
list / records	array		—	分页列表，元素结构见下
total	long		—	总条数（PageInfo）
id	Long		`hotel_room_type`.`id`	id
hotelId	Long		`hotel_room_type`.`hotel_id`	酒店ID
name	String		`hotel_room_type`.`name`	房型名称
basePrice	Integer		`hotel_room_type`.`base_price`	基础价格(分)
sort	Integer		`hotel_room_type`.`sort`	排序号
status	Integer		`hotel_room_type`.`status`	状态(0正常 1停用)
coverImage	String		`hotel_room_type`.`cover_image`	主图URL
images	String		`hotel_room_type`.`images`	房型图片，多个用逗号分隔
roomTypeArea	BigDecimal		`hotel_room_type`.`room_type_area`	面积(平方米)
floorInfo	String		`hotel_room_type`.`floor_info`	楼层信息
windowType	WindowType	1无窗2部分有窗3全部有窗	`hotel_room_type`.`window_type`	窗户类型
bedInfo	String		`hotel_room_type`.`bed_info`	床型
guests	Integer		`hotel_room_type`.`guests`	可住人数
smoking	Integer		`hotel_room_type`.`smoking`	是否禁烟(0否 1是)
networkType	NetworkType	1免费WiFi2收费WiFi3无网络	`hotel_room_type`.`network_type`	网络类型
extraBedAllowed	Integer		`hotel_room_type`.`extra_bed_allowed`	是否可加床(0否 1是)
extraBedDesc	String		`hotel_room_type`.`extra_bed_desc`	加床说明
facilities	List<FacilityTree>		—	设施列表
showPrice	Integer		—
pricePlans	List<HotelRoomTypePlan>		—	价格方案列表
pricePlans[].id	Long		`hotel_room_type`.`id`
pricePlans[].hotelId	Long		`hotel_room_type`.`hotel_id`	酒店ID
pricePlans[].roomTypeId	Long		`hotel_room_type_plan`.`room_type_id`	房型ID
pricePlans[].name	String		`hotel_room_type`.`name`	方案名称
pricePlans[].autoConfirm	Integer		`hotel_room_type_plan`.`auto_confirm`	是否自动确认
pricePlans[].breakfast	Integer		`hotel_room_type_plan`.`breakfast`	是否含早
pricePlans[].basePrice	Integer		`hotel_room_type`.`base_price`	底价(分)
pricePlans[].salePrice	Integer		`hotel_room_type_plan`.`sale_price`	卖价(分)
pricePlans[].stockType	StockType	0无限1共享2独立	`hotel_room_type_plan`.`stock_type`	库存类型
pricePlans[].stockNum	Integer		`hotel_room_type_plan`.`stock_num`	数量
pricePlans[].cancelType	CancelType	1免费取消2不可取消3有条件取消	`hotel_room_type_plan`.`cancel_type`	取消类型
pricePlans[].cancelDays	Integer		`hotel_room_type_plan`.`cancel_days`	提前取消天数，0表示入住当天
pricePlans[].cancelHours	String		`hotel_room_type_plan`.`cancel_hours`	取消截止时间点，如18:00
pricePlans[].sort	Integer		`hotel_room_type`.`sort`	排序号
pricePlans[].status	Integer		`hotel_room_type`.`status`	状态
pricePlans[].isDeleted	Boolean		`hotel_room_type`.`is_deleted`	是否删除(0否 1是)
pricePlans[].createdBy	Long		`hotel_room_type`.`created_by`	创建人ID
pricePlans[].createdTime	Date		`hotel_room_type`.`created_time`	创建时间
pricePlans[].updatedBy	Long		`hotel_room_type`.`updated_by`	更新人ID
pricePlans[].updatedTime	Date		`hotel_room_type`.`updated_time`	更新时间

示例

请求示例（自动生成，仅结构参考）

POST /hotelApi/queryHotelRoomTypeTreePage

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "hotelId": 1,
    "name": "",
    "status": 0,
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1,
        "hotelId": 1,
        "name": "",
        "basePrice": 0,
        "sort": 0,
        "status": 0,
        "coverImage": "",
        "images": "",
        "roomTypeArea": 0,
        "floorInfo": "",
        "windowType": "1",
        "bedInfo": "",
        "guests": 0,
        "smoking": 0,
        "networkType": "1",
        "extraBedAllowed": 0,
        "extraBedDesc": "",
        "facilities": "",
        "showPrice": 0,
        "pricePlans": [
          {
            "id": 1,
            "hotelId": 1,
            "roomTypeId": 1,
            "name": "",
            "autoConfirm": 0,
            "breakfast": 0,
            "basePrice": 0,
            "salePrice": 0,
            "stockType": "0",
            "stockNum": 0,
            "cancelType": "1",
            "cancelDays": 0,
            "cancelHours": "",
            "sort": 0,
            "status": 0,
            "isDeleted": false,
            "createdBy": 0,
            "createdTime": "2026-01-01 12:00:00",
            "updatedBy": 0,
            "updatedTime": "2026-01-01 12:00:00"
          }
        ]
      }
    ],
    "total": 0
  }
}

处理逻辑

逻辑摘要分页查询（hotelRoomTypeService.queryPage）；列表查询（hotelRoomTypePlanService.queryList）；列表查询（hotelRoomAttrRelService.queryList）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

1. 查询房型基本信息
2. 转换并填充设施信息
查询价格方案
查询房型关联的设施
查询设施详情
构建设施树
3. 构建返回结果

前端调用方

xghmall queryHotelRoomTypeTreePage exact

HotelAutoOrderExcludeDateController 0/6 在用

POST /hotel/addHotelAutoOrderExcludeDate 未使用管理后台 #

自动接单规则不适用日期-新增 · HotelAutoOrderExcludeDateController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelAutoOrderExcludeDateController#addHotelAutoOrderExcludeDate
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_auto_order_exclude_date

ControllerHotelAutoOrderExcludeDateController#addHotelAutoOrderExcludeDate

转换BeanUtils.map → HotelAutoOrderExcludeDate ⇒ 表 hotel_auto_order_exclude_date

ServiceHotelAutoOrderExcludeDateService#add （HotelAutoOrderExcludeDateServiceImpl）

MapperHotelAutoOrderExcludeDateMapper#insert ⇒ 表 hotel_auto_order_exclude_date

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/addHotelAutoOrderExcludeDate
uat	https://dscp-uat.hn12301.net/manage-api/hotel/addHotelAutoOrderExcludeDate
pro	https://dscp-uat.hn12301.net/manage-api/hotel/addHotelAutoOrderExcludeDate	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HotelAutoOrderExcludeDateAddRequest

字段	类型	必填	取值/校验	表 / 列	说明
name	String			—	名称

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /hotel/addHotelAutoOrderExcludeDate

{
  "body": {
    "name": ""
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志hotel / 新增自动排单排除日期

逻辑摘要新增（hotelAutoOrderExcludeDateService.add）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /hotel/deleteHotelAutoOrderExcludeDate 未使用管理后台 #

自动接单规则不适用日期-删除 · HotelAutoOrderExcludeDateController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelAutoOrderExcludeDateController#deleteHotelAutoOrderExcludeDate
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_auto_order_exclude_date

ControllerHotelAutoOrderExcludeDateController#deleteHotelAutoOrderExcludeDate

ServiceHotelAutoOrderExcludeDateService#delete （HotelAutoOrderExcludeDateServiceImpl）

MapperHotelAutoOrderExcludeDateMapper#deleteById ⇒ 表 hotel_auto_order_exclude_date

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/deleteHotelAutoOrderExcludeDate
uat	https://dscp-uat.hn12301.net/manage-api/hotel/deleteHotelAutoOrderExcludeDate
pro	https://dscp-uat.hn12301.net/manage-api/hotel/deleteHotelAutoOrderExcludeDate	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`hotel_auto_order_exclude_date`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /hotel/deleteHotelAutoOrderExcludeDate

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志hotel / 删除自动排单排除日期

逻辑摘要删除（hotelAutoOrderExcludeDateService.delete）

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /hotel/getHotelAutoOrderExcludeDate 未使用管理后台 #

自动接单规则不适用日期-详情 · HotelAutoOrderExcludeDateController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelAutoOrderExcludeDateController#getHotelAutoOrderExcludeDate
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_auto_order_exclude_date

ControllerHotelAutoOrderExcludeDateController#getHotelAutoOrderExcludeDate

ServiceHotelAutoOrderExcludeDateService#get （HotelAutoOrderExcludeDateServiceImpl）

MapperHotelAutoOrderExcludeDateMapper#selectById ⇒ 表 hotel_auto_order_exclude_date

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/getHotelAutoOrderExcludeDate
uat	https://dscp-uat.hn12301.net/manage-api/hotel/getHotelAutoOrderExcludeDate
pro	https://dscp-uat.hn12301.net/manage-api/hotel/getHotelAutoOrderExcludeDate	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`hotel_auto_order_exclude_date`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　HotelAutoOrderExcludeDateResponse　（object）

字段	类型	必填	取值/校验	表 / 列	说明
id	Long			`hotel_auto_order_exclude_date`.`id`	id

示例

请求示例（自动生成，仅结构参考）

POST /hotel/getHotelAutoOrderExcludeDate

{
  "body": {
    "id": 1
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": 1
  }
}

处理逻辑

逻辑摘要查询详情（hotelAutoOrderExcludeDateService.get）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /hotel/queryHotelAutoOrderExcludeDateList 未使用管理后台 #

自动接单规则不适用日期-列表查询 · HotelAutoOrderExcludeDateController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelAutoOrderExcludeDateController#queryHotelAutoOrderExcludeDateList
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_auto_order_exclude_date

ControllerHotelAutoOrderExcludeDateController#queryHotelAutoOrderExcludeDateList

转换BeanUtils.map → HotelAutoOrderExcludeDateQuery

ServiceHotelAutoOrderExcludeDateService#queryList （HotelAutoOrderExcludeDateServiceImpl）

MapperHotelAutoOrderExcludeDateMapper#selectList ⇒ 表 hotel_auto_order_exclude_date

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/queryHotelAutoOrderExcludeDateList
uat	https://dscp-uat.hn12301.net/manage-api/hotel/queryHotelAutoOrderExcludeDateList
pro	https://dscp-uat.hn12301.net/manage-api/hotel/queryHotelAutoOrderExcludeDateList	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HotelAutoOrderExcludeDateListRequest

字段	类型	必填	取值/校验	表 / 列	说明
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　List<HotelAutoOrderExcludeDateResponse>　（list）

字段	类型	必填	取值/校验	表 / 列	说明
[ ]	array			—	列表，元素结构见下
id	Long			`hotel_auto_order_exclude_date`.`id`	id

示例

请求示例（自动生成，仅结构参考）

POST /hotel/queryHotelAutoOrderExcludeDateList

{
  "body": {
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "id": 1
    }
  ]
}

处理逻辑

逻辑摘要列表查询（hotelAutoOrderExcludeDateService.queryList）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /hotel/queryHotelAutoOrderExcludeDatePage 未使用管理后台 #

自动接单规则不适用日期-分页查询 · HotelAutoOrderExcludeDateController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelAutoOrderExcludeDateController#queryHotelAutoOrderExcludeDatePage
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_auto_order_exclude_date

ControllerHotelAutoOrderExcludeDateController#queryHotelAutoOrderExcludeDatePage

转换BeanUtils.map → HotelAutoOrderExcludeDateQuery

ServiceHotelAutoOrderExcludeDateService#queryPage （HotelAutoOrderExcludeDateServiceImpl）

MapperHotelAutoOrderExcludeDateMapper#selectPage ⇒ 表 hotel_auto_order_exclude_date

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/queryHotelAutoOrderExcludeDatePage
uat	https://dscp-uat.hn12301.net/manage-api/hotel/queryHotelAutoOrderExcludeDatePage
pro	https://dscp-uat.hn12301.net/manage-api/hotel/queryHotelAutoOrderExcludeDatePage	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HotelAutoOrderExcludeDatePageRequest

字段	类型	必填	取值/校验	表 / 列	说明
pageNum	Integer	否		—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否		—	每页条数（继承自框架分页基类 AbstractPageRequest）
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　PageInfo<HotelAutoOrderExcludeDateResponse>　（page）

字段	类型	表 / 列	说明
list / records	array	—	分页列表，元素结构见下
total	long	—	总条数（PageInfo）
id	Long	`hotel_auto_order_exclude_date`.`id`	id

示例

请求示例（自动生成，仅结构参考）

POST /hotel/queryHotelAutoOrderExcludeDatePage

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1
      }
    ],
    "total": 0
  }
}

处理逻辑

逻辑摘要分页查询（hotelAutoOrderExcludeDateService.queryPage）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /hotel/updateHotelAutoOrderExcludeDate 未使用管理后台 #

自动接单规则不适用日期-更新 · HotelAutoOrderExcludeDateController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelAutoOrderExcludeDateController#updateHotelAutoOrderExcludeDate
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_auto_order_exclude_date

ControllerHotelAutoOrderExcludeDateController#updateHotelAutoOrderExcludeDate

转换BeanUtils.map → HotelAutoOrderExcludeDate ⇒ 表 hotel_auto_order_exclude_date

ServiceHotelAutoOrderExcludeDateService#update （HotelAutoOrderExcludeDateServiceImpl）

MapperHotelAutoOrderExcludeDateMapper#updateById ⇒ 表 hotel_auto_order_exclude_date

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/updateHotelAutoOrderExcludeDate
uat	https://dscp-uat.hn12301.net/manage-api/hotel/updateHotelAutoOrderExcludeDate
pro	https://dscp-uat.hn12301.net/manage-api/hotel/updateHotelAutoOrderExcludeDate	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HotelAutoOrderExcludeDateUpdateRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long			`hotel_auto_order_exclude_date`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /hotel/updateHotelAutoOrderExcludeDate

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志hotel / 更新自动排单排除日期

逻辑摘要更新（hotelAutoOrderExcludeDateService.update）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

HotelAutoOrderRoomLimitController 0/6 在用

POST /hotel/addHotelAutoOrderRoomLimit 未使用管理后台 #

自动接单房型价格方案限制-新增 · HotelAutoOrderRoomLimitController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelAutoOrderRoomLimitController#addHotelAutoOrderRoomLimit
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_auto_order_room_limit

ControllerHotelAutoOrderRoomLimitController#addHotelAutoOrderRoomLimit

转换BeanUtils.map → HotelAutoOrderRoomLimit ⇒ 表 hotel_auto_order_room_limit

ServiceHotelAutoOrderRoomLimitService#add （HotelAutoOrderRoomLimitServiceImpl）

MapperHotelAutoOrderRoomLimitMapper#insert ⇒ 表 hotel_auto_order_room_limit

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/addHotelAutoOrderRoomLimit
uat	https://dscp-uat.hn12301.net/manage-api/hotel/addHotelAutoOrderRoomLimit
pro	https://dscp-uat.hn12301.net/manage-api/hotel/addHotelAutoOrderRoomLimit	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HotelAutoOrderRoomLimitAddRequest

字段	类型	必填	取值/校验	表 / 列	说明
name	String			—	名称

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /hotel/addHotelAutoOrderRoomLimit

{
  "body": {
    "name": ""
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志hotel / 新增自动排单房量限制

逻辑摘要新增（hotelAutoOrderRoomLimitService.add）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /hotel/deleteHotelAutoOrderRoomLimit 未使用管理后台 #

自动接单房型价格方案限制-删除 · HotelAutoOrderRoomLimitController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelAutoOrderRoomLimitController#deleteHotelAutoOrderRoomLimit
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_auto_order_room_limit

ControllerHotelAutoOrderRoomLimitController#deleteHotelAutoOrderRoomLimit

ServiceHotelAutoOrderRoomLimitService#delete （HotelAutoOrderRoomLimitServiceImpl）

MapperHotelAutoOrderRoomLimitMapper#deleteById ⇒ 表 hotel_auto_order_room_limit

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/deleteHotelAutoOrderRoomLimit
uat	https://dscp-uat.hn12301.net/manage-api/hotel/deleteHotelAutoOrderRoomLimit
pro	https://dscp-uat.hn12301.net/manage-api/hotel/deleteHotelAutoOrderRoomLimit	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`hotel_auto_order_room_limit`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /hotel/deleteHotelAutoOrderRoomLimit

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志hotel / 删除自动排单房量限制

逻辑摘要删除（hotelAutoOrderRoomLimitService.delete）

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /hotel/getHotelAutoOrderRoomLimit 未使用管理后台 #

自动接单房型价格方案限制-详情 · HotelAutoOrderRoomLimitController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelAutoOrderRoomLimitController#getHotelAutoOrderRoomLimit
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_auto_order_room_limit

ControllerHotelAutoOrderRoomLimitController#getHotelAutoOrderRoomLimit

ServiceHotelAutoOrderRoomLimitService#get （HotelAutoOrderRoomLimitServiceImpl）

MapperHotelAutoOrderRoomLimitMapper#selectById ⇒ 表 hotel_auto_order_room_limit

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/getHotelAutoOrderRoomLimit
uat	https://dscp-uat.hn12301.net/manage-api/hotel/getHotelAutoOrderRoomLimit
pro	https://dscp-uat.hn12301.net/manage-api/hotel/getHotelAutoOrderRoomLimit	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`hotel_auto_order_room_limit`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　HotelAutoOrderRoomLimitResponse　（object）

字段	类型	必填	取值/校验	表 / 列	说明
id	Long			`hotel_auto_order_room_limit`.`id`	id

示例

请求示例（自动生成，仅结构参考）

POST /hotel/getHotelAutoOrderRoomLimit

{
  "body": {
    "id": 1
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": 1
  }
}

处理逻辑

逻辑摘要查询详情（hotelAutoOrderRoomLimitService.get）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /hotel/queryHotelAutoOrderRoomLimitList 未使用管理后台 #

自动接单房型价格方案限制-列表查询 · HotelAutoOrderRoomLimitController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelAutoOrderRoomLimitController#queryHotelAutoOrderRoomLimitList
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_auto_order_room_limit

ControllerHotelAutoOrderRoomLimitController#queryHotelAutoOrderRoomLimitList

转换BeanUtils.map → HotelAutoOrderRoomLimitQuery

ServiceHotelAutoOrderRoomLimitService#queryList （HotelAutoOrderRoomLimitServiceImpl）

MapperHotelAutoOrderRoomLimitMapper#selectList ⇒ 表 hotel_auto_order_room_limit

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/queryHotelAutoOrderRoomLimitList
uat	https://dscp-uat.hn12301.net/manage-api/hotel/queryHotelAutoOrderRoomLimitList
pro	https://dscp-uat.hn12301.net/manage-api/hotel/queryHotelAutoOrderRoomLimitList	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HotelAutoOrderRoomLimitListRequest

字段	类型	必填	取值/校验	表 / 列	说明
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　List<HotelAutoOrderRoomLimitResponse>　（list）

字段	类型	必填	取值/校验	表 / 列	说明
[ ]	array			—	列表，元素结构见下
id	Long			`hotel_auto_order_room_limit`.`id`	id

示例

请求示例（自动生成，仅结构参考）

POST /hotel/queryHotelAutoOrderRoomLimitList

{
  "body": {
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "id": 1
    }
  ]
}

处理逻辑

逻辑摘要列表查询（hotelAutoOrderRoomLimitService.queryList）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /hotel/queryHotelAutoOrderRoomLimitPage 未使用管理后台 #

自动接单房型价格方案限制-分页查询 · HotelAutoOrderRoomLimitController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelAutoOrderRoomLimitController#queryHotelAutoOrderRoomLimitPage
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_auto_order_room_limit

ControllerHotelAutoOrderRoomLimitController#queryHotelAutoOrderRoomLimitPage

转换BeanUtils.map → HotelAutoOrderRoomLimitQuery

ServiceHotelAutoOrderRoomLimitService#queryPage （HotelAutoOrderRoomLimitServiceImpl）

MapperHotelAutoOrderRoomLimitMapper#selectPage ⇒ 表 hotel_auto_order_room_limit

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/queryHotelAutoOrderRoomLimitPage
uat	https://dscp-uat.hn12301.net/manage-api/hotel/queryHotelAutoOrderRoomLimitPage
pro	https://dscp-uat.hn12301.net/manage-api/hotel/queryHotelAutoOrderRoomLimitPage	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HotelAutoOrderRoomLimitPageRequest

字段	类型	必填	取值/校验	表 / 列	说明
pageNum	Integer	否		—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否		—	每页条数（继承自框架分页基类 AbstractPageRequest）
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　PageInfo<HotelAutoOrderRoomLimitResponse>　（page）

字段	类型	表 / 列	说明
list / records	array	—	分页列表，元素结构见下
total	long	—	总条数（PageInfo）
id	Long	`hotel_auto_order_room_limit`.`id`	id

示例

请求示例（自动生成，仅结构参考）

POST /hotel/queryHotelAutoOrderRoomLimitPage

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1
      }
    ],
    "total": 0
  }
}

处理逻辑

逻辑摘要分页查询（hotelAutoOrderRoomLimitService.queryPage）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /hotel/updateHotelAutoOrderRoomLimit 未使用管理后台 #

自动接单房型价格方案限制-更新 · HotelAutoOrderRoomLimitController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelAutoOrderRoomLimitController#updateHotelAutoOrderRoomLimit
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_auto_order_room_limit

ControllerHotelAutoOrderRoomLimitController#updateHotelAutoOrderRoomLimit

转换BeanUtils.map → HotelAutoOrderRoomLimit ⇒ 表 hotel_auto_order_room_limit

ServiceHotelAutoOrderRoomLimitService#update （HotelAutoOrderRoomLimitServiceImpl）

MapperHotelAutoOrderRoomLimitMapper#updateById ⇒ 表 hotel_auto_order_room_limit

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/updateHotelAutoOrderRoomLimit
uat	https://dscp-uat.hn12301.net/manage-api/hotel/updateHotelAutoOrderRoomLimit
pro	https://dscp-uat.hn12301.net/manage-api/hotel/updateHotelAutoOrderRoomLimit	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HotelAutoOrderRoomLimitUpdateRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long			`hotel_auto_order_room_limit`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /hotel/updateHotelAutoOrderRoomLimit

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志hotel / 更新自动排单房量限制

逻辑摘要更新（hotelAutoOrderRoomLimitService.update）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

HotelAutoOrderRuleController 4/7 在用

POST /hotel/addHotelAutoOrderRule 在用管理后台 #

酒店自动接单规则-新增 · HotelAutoOrderRuleController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelAutoOrderRuleController#addHotelAutoOrderRule
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_infohotel_auto_order_rulehotel_auto_order_rule_log

ControllerHotelAutoOrderRuleController#addHotelAutoOrderRule

ServiceHotelInfoService#get （HotelInfoServiceImpl）

MapperHotelInfoMapper#selectById ⇒ 表 hotel_info

ServiceHotelAutoOrderRuleService#add （HotelAutoOrderRuleServiceImpl）

MapperHotelAutoOrderRuleMapper#insert ⇒ 表 hotel_auto_order_rule

ServiceHotelAutoOrderRuleLogService#add （HotelAutoOrderRuleLogServiceImpl）

MapperHotelAutoOrderRuleLogMapper#insert ⇒ 表 hotel_auto_order_rule_log

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 2

SessionUserService.getSessionIdSessionUserService.getSessionUser

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/addHotelAutoOrderRule
uat	https://dscp-uat.hn12301.net/manage-api/hotel/addHotelAutoOrderRule
pro	https://dscp-uat.hn12301.net/manage-api/hotel/addHotelAutoOrderRule	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HotelAutoOrderRuleAddRequest

字段	类型	必填	取值/校验	表 / 列	说明
hotelId	Long	是	必填	`hotel_auto_order_rule`.`hotel_id`	酒店ID
isEnabled	Integer	是	必填	`hotel_auto_order_rule`.`is_enabled`	是否启用(0-启用 1-禁用)
timeType	Integer	是	必填	`hotel_auto_order_rule`.`time_type`	时间类型(1-所有时间全部房型 2-自定义时间和房型)
weekDays	List<String>			`hotel_auto_order_rule`.`week_days`	适用星期
timeRangeType	Integer			`hotel_auto_order_rule`.`time_range_type`	时间范围类型(1-全天 2-特殊时间段)
timeRange	HotelAutoOrderRuleRequest.TimeRange			—	时间范围
excludeDates	List<HotelAutoOrderRuleRequest.@Valid ExcludeDate>			—	不适用日期列表
roomTypes	List<HotelAutoOrderRuleRequest.@Valid RoomType>			—	房型配置列表

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /hotel/addHotelAutoOrderRule

{
  "body": {
    "hotelId": 1,
    "isEnabled": 0,
    "timeType": 0,
    "weekDays": "",
    "timeRangeType": 0,
    "timeRange": "2026-01-01 12:00:00",
    "excludeDates": "2026-01-01 12:00:00",
    "roomTypes": ""
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志hotel / 新增自动排单规则

逻辑摘要查询详情（hotelInfoService.get）；查询详情（sessionUserService.getSessionId）；新增（hotelAutoOrderRuleService.add）

内联注释

1. 保存规则主表
1.1 查询酒店基本信息
2. 设置自定义时间配置
2.1 设置星期
2.2 设置时间范围
3. ��置创建人和时间
4. 保存规则
5. 保存排除日期和房型限制(仅在timeType==2时)

前端调用方

dscp-html-manage addHotelAutoOrderRule exact

POST /hotel/deleteHotelAutoOrderRule 未使用管理后台 #

酒店自动接单规则-删除 · HotelAutoOrderRuleController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelAutoOrderRuleController#deleteHotelAutoOrderRule
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_auto_order_exclude_datehotel_auto_order_room_limithotel_auto_order_rulehotel_auto_order_rule_log

ControllerHotelAutoOrderRuleController#deleteHotelAutoOrderRule

MapperHotelAutoOrderExcludeDateService.getMapper#delete ⇒ 表 hotel_auto_order_exclude_date

MapperHotelAutoOrderRoomLimitService.getMapper#delete ⇒ 表 hotel_auto_order_room_limit

ServiceHotelAutoOrderRuleService#get （HotelAutoOrderRuleServiceImpl）

MapperHotelAutoOrderRuleMapper#selectById ⇒ 表 hotel_auto_order_rule

ServiceHotelAutoOrderRuleService#delete （HotelAutoOrderRuleServiceImpl）

MapperHotelAutoOrderRuleMapper#deleteById ⇒ 表 hotel_auto_order_rule

ServiceHotelAutoOrderRuleLogService#add （HotelAutoOrderRuleLogServiceImpl）

MapperHotelAutoOrderRuleLogMapper#insert ⇒ 表 hotel_auto_order_rule_log

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 2

SessionUserService.getSessionIdSessionUserService.getSessionUser

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/deleteHotelAutoOrderRule
uat	https://dscp-uat.hn12301.net/manage-api/hotel/deleteHotelAutoOrderRule
pro	https://dscp-uat.hn12301.net/manage-api/hotel/deleteHotelAutoOrderRule	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`hotel_auto_order_exclude_date`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /hotel/deleteHotelAutoOrderRule

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志hotel / 删除自动排单规则

逻辑摘要查询详情（hotelAutoOrderRuleService.get）；删除（hotelAutoOrderRuleService.delete）；查询详情（hotelAutoOrderExcludeDateService.getMapper）

内联注释

1. 查询规则是否存在
2. 删除规则
3. 删除关联的排除日期和房型限制
4. 记录操作日志

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /hotel/getHotelAutoOrderRule 在用管理后台 #

酒店自动接单规则-详情 · HotelAutoOrderRuleController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelAutoOrderRuleController#getHotelAutoOrderRule
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_auto_order_rulehotel_auto_order_exclude_datehotel_auto_order_room_limit

ControllerHotelAutoOrderRuleController#getHotelAutoOrderRule

ServiceHotelAutoOrderRuleService#get （HotelAutoOrderRuleServiceImpl）

MapperHotelAutoOrderRuleMapper#selectById ⇒ 表 hotel_auto_order_rule

ServiceHotelAutoOrderExcludeDateService#queryList （HotelAutoOrderExcludeDateServiceImpl）

MapperHotelAutoOrderExcludeDateMapper#selectList ⇒ 表 hotel_auto_order_exclude_date

ServiceHotelAutoOrderRoomLimitService#queryList （HotelAutoOrderRoomLimitServiceImpl）

MapperHotelAutoOrderRoomLimitMapper#selectList ⇒ 表 hotel_auto_order_room_limit

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/getHotelAutoOrderRule
uat	https://dscp-uat.hn12301.net/manage-api/hotel/getHotelAutoOrderRule
pro	https://dscp-uat.hn12301.net/manage-api/hotel/getHotelAutoOrderRule	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　GetHotelAutoOrderRuleRequest

字段	类型	必填	取值/校验	表 / 列	说明
hotelId	Long	是	必填	`hotel_auto_order_rule`.`hotel_id`	酒店ID

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　HotelAutoOrderRuleResponse　（object）

字段	类型	表 / 列	说明
id	Long	`hotel_auto_order_rule`.`id`	规则ID
hotelId	Long	`hotel_auto_order_rule`.`hotel_id`	酒店ID
isEnabled	Integer	`hotel_auto_order_rule`.`is_enabled`	是否启用(0-启用 1-禁用)
timeType	Integer	`hotel_auto_order_rule`.`time_type`	时间类型(1-所有时间全部房型 2-自定义时间和房型)
weekDays	List<String>	`hotel_auto_order_rule`.`week_days`	适用星期
timeRangeType	Integer	`hotel_auto_order_rule`.`time_range_type`	时间范围类型(1-全天 2-特殊时间段)
timeRange	HotelAutoOrderRuleResponse.TimeRange	—	时间范围
excludeDates	List<HotelAutoOrderRuleResponse.ExcludeDate>	—	不适用日期列表
roomTypes	List<HotelAutoOrderRuleResponse.RoomType>	—	房型配置列表
status	Integer	`hotel_auto_order_rule`.`status`	状态(0-正常 1-删除)
createdBy	Long	`hotel_auto_order_rule`.`created_by`	创建人
createdTime	Date	`hotel_auto_order_rule`.`created_time`	创建时间
updatedBy	Long	`hotel_auto_order_rule`.`updated_by`	修改人
updatedTime	Date	`hotel_auto_order_rule`.`updated_time`	修改时间

示例

请求示例（自动生成，仅结构参考）

POST /hotel/getHotelAutoOrderRule

{
  "body": {
    "hotelId": 1
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": 1,
    "hotelId": 1,
    "isEnabled": 0,
    "timeType": 0,
    "weekDays": "",
    "timeRangeType": 0,
    "timeRange": "2026-01-01 12:00:00",
    "excludeDates": "2026-01-01 12:00:00",
    "roomTypes": "",
    "status": 0,
    "createdBy": 0,
    "createdTime": "2026-01-01 12:00:00",
    "updatedBy": 0,
    "updatedTime": "2026-01-01 12:00:00"
  }
}

处理逻辑

逻辑摘要查询详情（hotelAutoOrderRuleService.get）；调用 isNotBlank（StringUtils.isNotBlank）；列表查询（hotelAutoOrderExcludeDateService.queryList）

内联注释

1. 参数校验
2. 查询规则主表
如果规则不存在,
3. 构建响应对象
4. 设置自定义时间配置
4.1 设置星期
4.2 设置时间范围
4.3 查询排除日期

前端调用方

dscp-html-manage getHotelAutoOrderRule exact

POST /hotel/getHotelAutoOrderRuleLogs 在用管理后台 #

酒店自动接单规则-操作日志 · HotelAutoOrderRuleController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelAutoOrderRuleController#getHotelAutoOrderRuleLogs
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_auto_order_rule_log

ControllerHotelAutoOrderRuleController#getHotelAutoOrderRuleLogs

转换BeanUtils.mapList → HotelAutoOrderRuleLogResponse

ServiceHotelAutoOrderRuleLogService#queryList （HotelAutoOrderRuleLogServiceImpl）

MapperHotelAutoOrderRuleLogMapper#selectList ⇒ 表 hotel_auto_order_rule_log

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/getHotelAutoOrderRuleLogs
uat	https://dscp-uat.hn12301.net/manage-api/hotel/getHotelAutoOrderRuleLogs
pro	https://dscp-uat.hn12301.net/manage-api/hotel/getHotelAutoOrderRuleLogs	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`hotel_auto_order_rule_log`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　List<HotelAutoOrderRuleLogResponse>　（list）

字段	类型	表 / 列	说明
[ ]	array	—	列表，元素结构见下
id	Long	`hotel_auto_order_rule_log`.`id`	主键
hotelId	Long	`hotel_auto_order_rule_log`.`hotel_id`	酒店ID
ruleId	Long	`hotel_auto_order_rule_log`.`rule_id`	规则ID
content	String	`hotel_auto_order_rule_log`.`content`	操作内容
operatorId	Long	`hotel_auto_order_rule_log`.`operator_id`	操作人ID
operatorName	String	`hotel_auto_order_rule_log`.`operator_name`	操作人姓名
createdTime	Date	`hotel_auto_order_rule_log`.`created_time`	创建时间

示例

请求示例（自动生成，仅结构参考）

POST /hotel/getHotelAutoOrderRuleLogs

{
  "body": {
    "id": 1
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "id": 1,
      "hotelId": 1,
      "ruleId": 1,
      "content": "",
      "operatorId": 1,
      "operatorName": "",
      "createdTime": "2026-01-01 12:00:00"
    }
  ]
}

处理逻辑

逻辑摘要列表查询（hotelAutoOrderRuleLogService.queryList）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

1. 参数校验
2. 查询日志列表
3. 构建响应对象列表

前端调用方

dscp-html-manage getHotelAutoOrderRuleLogs exact

POST /hotel/queryHotelAutoOrderRuleList 未使用管理后台 #

酒店自动接单规则-列表查询 · HotelAutoOrderRuleController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelAutoOrderRuleController#queryHotelAutoOrderRuleList
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_auto_order_rule

ControllerHotelAutoOrderRuleController#queryHotelAutoOrderRuleList

转换BeanUtils.map → HotelAutoOrderRuleQuery

ServiceHotelAutoOrderRuleService#queryList （HotelAutoOrderRuleServiceImpl）

MapperHotelAutoOrderRuleMapper#selectList ⇒ 表 hotel_auto_order_rule

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/queryHotelAutoOrderRuleList
uat	https://dscp-uat.hn12301.net/manage-api/hotel/queryHotelAutoOrderRuleList
pro	https://dscp-uat.hn12301.net/manage-api/hotel/queryHotelAutoOrderRuleList	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HotelAutoOrderRuleListRequest

字段	类型	必填	取值/校验	表 / 列	说明
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　List<HotelAutoOrderRuleResponse>　（list）

字段	类型	表 / 列	说明
[ ]	array	—	列表，元素结构见下
id	Long	`hotel_auto_order_rule`.`id`	规则ID
hotelId	Long	`hotel_auto_order_rule`.`hotel_id`	酒店ID
isEnabled	Integer	`hotel_auto_order_rule`.`is_enabled`	是否启用(0-启用 1-禁用)
timeType	Integer	`hotel_auto_order_rule`.`time_type`	时间类型(1-所有时间全部房型 2-自定义时间和房型)
weekDays	List<String>	`hotel_auto_order_rule`.`week_days`	适用星期
timeRangeType	Integer	`hotel_auto_order_rule`.`time_range_type`	时间范围类型(1-全天 2-特殊时间段)
timeRange	HotelAutoOrderRuleResponse.TimeRange	—	时间范围
excludeDates	List<HotelAutoOrderRuleResponse.ExcludeDate>	—	不适用日期列表
roomTypes	List<HotelAutoOrderRuleResponse.RoomType>	—	房型配置列表
status	Integer	`hotel_auto_order_rule`.`status`	状态(0-正常 1-删除)
createdBy	Long	`hotel_auto_order_rule`.`created_by`	创建人
createdTime	Date	`hotel_auto_order_rule`.`created_time`	创建时间
updatedBy	Long	`hotel_auto_order_rule`.`updated_by`	修改人
updatedTime	Date	`hotel_auto_order_rule`.`updated_time`	修改时间

示例

请求示例（自动生成，仅结构参考）

POST /hotel/queryHotelAutoOrderRuleList

{
  "body": {
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "id": 1,
      "hotelId": 1,
      "isEnabled": 0,
      "timeType": 0,
      "weekDays": "",
      "timeRangeType": 0,
      "timeRange": "2026-01-01 12:00:00",
      "excludeDates": "2026-01-01 12:00:00",
      "roomTypes": "",
      "status": 0,
      "createdBy": 0,
      "createdTime": "2026-01-01 12:00:00",
      "updatedBy": 0,
      "updatedTime": "2026-01-01 12:00:00"
    }
  ]
}

处理逻辑

逻辑摘要列表查询（hotelAutoOrderRuleService.queryList）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /hotel/queryHotelAutoOrderRulePage 未使用管理后台 #

酒店自动接单规则-分页查询 · HotelAutoOrderRuleController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelAutoOrderRuleController#queryHotelAutoOrderRulePage
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_auto_order_rule

ControllerHotelAutoOrderRuleController#queryHotelAutoOrderRulePage

转换BeanUtils.map → HotelAutoOrderRuleQuery

ServiceHotelAutoOrderRuleService#queryPage （HotelAutoOrderRuleServiceImpl）

MapperHotelAutoOrderRuleMapper#selectPage ⇒ 表 hotel_auto_order_rule

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/queryHotelAutoOrderRulePage
uat	https://dscp-uat.hn12301.net/manage-api/hotel/queryHotelAutoOrderRulePage
pro	https://dscp-uat.hn12301.net/manage-api/hotel/queryHotelAutoOrderRulePage	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HotelAutoOrderRulePageRequest

字段	类型	必填	取值/校验	表 / 列	说明
pageNum	Integer	否		—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否		—	每页条数（继承自框架分页基类 AbstractPageRequest）
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　PageInfo<HotelAutoOrderRuleResponse>　（page）

字段	类型	表 / 列	说明
list / records	array	—	分页列表，元素结构见下
total	long	—	总条数（PageInfo）
id	Long	`hotel_auto_order_rule`.`id`	规则ID
hotelId	Long	`hotel_auto_order_rule`.`hotel_id`	酒店ID
isEnabled	Integer	`hotel_auto_order_rule`.`is_enabled`	是否启用(0-启用 1-禁用)
timeType	Integer	`hotel_auto_order_rule`.`time_type`	时间类型(1-所有时间全部房型 2-自定义时间和房型)
weekDays	List<String>	`hotel_auto_order_rule`.`week_days`	适用星期
timeRangeType	Integer	`hotel_auto_order_rule`.`time_range_type`	时间范围类型(1-全天 2-特殊时间段)
timeRange	HotelAutoOrderRuleResponse.TimeRange	—	时间范围
excludeDates	List<HotelAutoOrderRuleResponse.ExcludeDate>	—	不适用日期列表
roomTypes	List<HotelAutoOrderRuleResponse.RoomType>	—	房型配置列表
status	Integer	`hotel_auto_order_rule`.`status`	状态(0-正常 1-删除)
createdBy	Long	`hotel_auto_order_rule`.`created_by`	创建人
createdTime	Date	`hotel_auto_order_rule`.`created_time`	创建时间
updatedBy	Long	`hotel_auto_order_rule`.`updated_by`	修改人
updatedTime	Date	`hotel_auto_order_rule`.`updated_time`	修改时间

示例

请求示例（自动生成，仅结构参考）

POST /hotel/queryHotelAutoOrderRulePage

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1,
        "hotelId": 1,
        "isEnabled": 0,
        "timeType": 0,
        "weekDays": "",
        "timeRangeType": 0,
        "timeRange": "2026-01-01 12:00:00",
        "excludeDates": "2026-01-01 12:00:00",
        "roomTypes": "",
        "status": 0,
        "createdBy": 0,
        "createdTime": "2026-01-01 12:00:00",
        "updatedBy": 0,
        "updatedTime": "2026-01-01 12:00:00"
      }
    ],
    "total": 0
  }
}

处理逻辑

逻辑摘要分页查询（hotelAutoOrderRuleService.queryPage）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /hotel/updateHotelAutoOrderRule 在用管理后台 #

酒店自动接单规则-更新 · HotelAutoOrderRuleController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelAutoOrderRuleController#updateHotelAutoOrderRule
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_auto_order_exclude_datehotel_auto_order_room_limithotel_auto_order_rulehotel_infohotel_auto_order_rule_log

ControllerHotelAutoOrderRuleController#updateHotelAutoOrderRule

MapperHotelAutoOrderExcludeDateService.getMapper#delete ⇒ 表 hotel_auto_order_exclude_date

MapperHotelAutoOrderRoomLimitService.getMapper#delete ⇒ 表 hotel_auto_order_room_limit

ServiceHotelAutoOrderRuleService#get （HotelAutoOrderRuleServiceImpl）

MapperHotelAutoOrderRuleMapper#selectById ⇒ 表 hotel_auto_order_rule

ServiceHotelInfoService#get （HotelInfoServiceImpl）

MapperHotelInfoMapper#selectById ⇒ 表 hotel_info

ServiceHotelAutoOrderRuleService#update （HotelAutoOrderRuleServiceImpl）

MapperHotelAutoOrderRuleMapper#updateById ⇒ 表 hotel_auto_order_rule

ServiceHotelAutoOrderRuleLogService#add （HotelAutoOrderRuleLogServiceImpl）

MapperHotelAutoOrderRuleLogMapper#insert ⇒ 表 hotel_auto_order_rule_log

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 2

SessionUserService.getSessionIdSessionUserService.getSessionUser

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/updateHotelAutoOrderRule
uat	https://dscp-uat.hn12301.net/manage-api/hotel/updateHotelAutoOrderRule
pro	https://dscp-uat.hn12301.net/manage-api/hotel/updateHotelAutoOrderRule	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HotelAutoOrderRuleUpdateRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`hotel_auto_order_exclude_date`.`id`	规则ID
hotelId	Long	是	必填	`hotel_auto_order_rule`.`hotel_id`	酒店ID
isEnabled	Integer	是	必填	`hotel_auto_order_rule`.`is_enabled`	是否启用(0-启用 1-禁用)
timeType	Integer	是	必填	`hotel_auto_order_rule`.`time_type`	时间类型(1-所有时间全部房型 2-自定义时间和房型)
weekDays	List<String>			`hotel_auto_order_rule`.`week_days`	适用星期
timeRangeType	Integer			`hotel_auto_order_rule`.`time_range_type`	时间范围类型(1-全天 2-特殊时间段)
timeRange	HotelAutoOrderRuleRequest.TimeRange			—	时间范围
excludeDates	List<HotelAutoOrderRuleRequest.@Valid ExcludeDate>			—	不适用日期列表
roomTypes	List<HotelAutoOrderRuleRequest.@Valid RoomType>			—	房型配置列表

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /hotel/updateHotelAutoOrderRule

{
  "body": {
    "id": 1,
    "hotelId": 1,
    "isEnabled": 0,
    "timeType": 0,
    "weekDays": "",
    "timeRangeType": 0,
    "timeRange": "2026-01-01 12:00:00",
    "excludeDates": "2026-01-01 12:00:00",
    "roomTypes": ""
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志hotel / 更新自动排单规则

逻辑摘要查询详情（hotelAutoOrderRuleService.get）；查询详情（hotelInfoService.get）；查询详情（sessionUserService.getSessionId）

内联注释

1. ��证规则是否存在
2. 查询酒店基本信息
3. 更新规则主表
4. 设置自定义时间配置
4.1 设置星期
4.2 设置��间范围
5. 设置更新人和时间
6. 更新规则

前端调用方

dscp-html-manage updateHotelAutoOrderRule exact

HotelAutoOrderRuleLogController 0/6 在用

POST /hotel/addHotelAutoOrderRuleLog 未使用管理后台 #

自动接单规则操作日志-新增 · HotelAutoOrderRuleLogController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelAutoOrderRuleLogController#addHotelAutoOrderRuleLog
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_auto_order_rule_log

ControllerHotelAutoOrderRuleLogController#addHotelAutoOrderRuleLog

转换BeanUtils.map → HotelAutoOrderRuleLog ⇒ 表 hotel_auto_order_rule_log

ServiceHotelAutoOrderRuleLogService#add （HotelAutoOrderRuleLogServiceImpl）

MapperHotelAutoOrderRuleLogMapper#insert ⇒ 表 hotel_auto_order_rule_log

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/addHotelAutoOrderRuleLog
uat	https://dscp-uat.hn12301.net/manage-api/hotel/addHotelAutoOrderRuleLog
pro	https://dscp-uat.hn12301.net/manage-api/hotel/addHotelAutoOrderRuleLog	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HotelAutoOrderRuleLogAddRequest

字段	类型	必填	取值/校验	表 / 列	说明
name	String			—	名称

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /hotel/addHotelAutoOrderRuleLog

{
  "body": {
    "name": ""
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志hotel / 新增自动排单规则日志

逻辑摘要新增（hotelAutoOrderRuleLogService.add）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /hotel/deleteHotelAutoOrderRuleLog 未使用管理后台 #

自动接单规则操作日志-删除 · HotelAutoOrderRuleLogController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelAutoOrderRuleLogController#deleteHotelAutoOrderRuleLog
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_auto_order_rule_log

ControllerHotelAutoOrderRuleLogController#deleteHotelAutoOrderRuleLog

ServiceHotelAutoOrderRuleLogService#delete （HotelAutoOrderRuleLogServiceImpl）

MapperHotelAutoOrderRuleLogMapper#deleteById ⇒ 表 hotel_auto_order_rule_log

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/deleteHotelAutoOrderRuleLog
uat	https://dscp-uat.hn12301.net/manage-api/hotel/deleteHotelAutoOrderRuleLog
pro	https://dscp-uat.hn12301.net/manage-api/hotel/deleteHotelAutoOrderRuleLog	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`hotel_auto_order_rule_log`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /hotel/deleteHotelAutoOrderRuleLog

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志hotel / 删除自动排单规则日志

逻辑摘要删除（hotelAutoOrderRuleLogService.delete）

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /hotel/getHotelAutoOrderRuleLog 未使用管理后台 #

自动接单规则操作日志-详情 · HotelAutoOrderRuleLogController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelAutoOrderRuleLogController#getHotelAutoOrderRuleLog
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_auto_order_rule_log

ControllerHotelAutoOrderRuleLogController#getHotelAutoOrderRuleLog

转换BeanUtils.map → HotelAutoOrderRuleLogResponse

ServiceHotelAutoOrderRuleLogService#get （HotelAutoOrderRuleLogServiceImpl）

MapperHotelAutoOrderRuleLogMapper#selectById ⇒ 表 hotel_auto_order_rule_log

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/getHotelAutoOrderRuleLog
uat	https://dscp-uat.hn12301.net/manage-api/hotel/getHotelAutoOrderRuleLog
pro	https://dscp-uat.hn12301.net/manage-api/hotel/getHotelAutoOrderRuleLog	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`hotel_auto_order_rule_log`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　HotelAutoOrderRuleLogResponse　（object）

字段	类型	表 / 列	说明
id	Long	`hotel_auto_order_rule_log`.`id`	主键
hotelId	Long	`hotel_auto_order_rule_log`.`hotel_id`	酒店ID
ruleId	Long	`hotel_auto_order_rule_log`.`rule_id`	规则ID
content	String	`hotel_auto_order_rule_log`.`content`	操作内容
operatorId	Long	`hotel_auto_order_rule_log`.`operator_id`	操作人ID
operatorName	String	`hotel_auto_order_rule_log`.`operator_name`	操作人姓名
createdTime	Date	`hotel_auto_order_rule_log`.`created_time`	创建时间

示例

请求示例（自动生成，仅结构参考）

POST /hotel/getHotelAutoOrderRuleLog

{
  "body": {
    "id": 1
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": 1,
    "hotelId": 1,
    "ruleId": 1,
    "content": "",
    "operatorId": 1,
    "operatorName": "",
    "createdTime": "2026-01-01 12:00:00"
  }
}

处理逻辑

逻辑摘要查询详情（hotelAutoOrderRuleLogService.get）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

1. 参数校验
2. 查询日志
3. 构建响应对象

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /hotel/queryHotelAutoOrderRuleLogList 未使用管理后台 #

自动接单规则操作日志-列表查询 · HotelAutoOrderRuleLogController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelAutoOrderRuleLogController#queryHotelAutoOrderRuleLogList
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_auto_order_rule_log

ControllerHotelAutoOrderRuleLogController#queryHotelAutoOrderRuleLogList

转换BeanUtils.map → HotelAutoOrderRuleLogQuery

ServiceHotelAutoOrderRuleLogService#queryList （HotelAutoOrderRuleLogServiceImpl）

MapperHotelAutoOrderRuleLogMapper#selectList ⇒ 表 hotel_auto_order_rule_log

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/queryHotelAutoOrderRuleLogList
uat	https://dscp-uat.hn12301.net/manage-api/hotel/queryHotelAutoOrderRuleLogList
pro	https://dscp-uat.hn12301.net/manage-api/hotel/queryHotelAutoOrderRuleLogList	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HotelAutoOrderRuleLogListRequest

字段	类型	必填	取值/校验	表 / 列	说明
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　List<HotelAutoOrderRuleLogResponse>　（list）

字段	类型	表 / 列	说明
[ ]	array	—	列表，元素结构见下
id	Long	`hotel_auto_order_rule_log`.`id`	主键
hotelId	Long	`hotel_auto_order_rule_log`.`hotel_id`	酒店ID
ruleId	Long	`hotel_auto_order_rule_log`.`rule_id`	规则ID
content	String	`hotel_auto_order_rule_log`.`content`	操作内容
operatorId	Long	`hotel_auto_order_rule_log`.`operator_id`	操作人ID
operatorName	String	`hotel_auto_order_rule_log`.`operator_name`	操作人姓名
createdTime	Date	`hotel_auto_order_rule_log`.`created_time`	创建时间

示例

请求示例（自动生成，仅结构参考）

POST /hotel/queryHotelAutoOrderRuleLogList

{
  "body": {
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "id": 1,
      "hotelId": 1,
      "ruleId": 1,
      "content": "",
      "operatorId": 1,
      "operatorName": "",
      "createdTime": "2026-01-01 12:00:00"
    }
  ]
}

处理逻辑

逻辑摘要列表查询（hotelAutoOrderRuleLogService.queryList）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /hotel/queryHotelAutoOrderRuleLogPage 未使用管理后台 #

自动接单规则操作日志-分页查询 · HotelAutoOrderRuleLogController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelAutoOrderRuleLogController#queryHotelAutoOrderRuleLogPage
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_auto_order_rule_log

ControllerHotelAutoOrderRuleLogController#queryHotelAutoOrderRuleLogPage

转换BeanUtils.map → HotelAutoOrderRuleLogQuery

ServiceHotelAutoOrderRuleLogService#queryPage （HotelAutoOrderRuleLogServiceImpl）

MapperHotelAutoOrderRuleLogMapper#selectPage ⇒ 表 hotel_auto_order_rule_log

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/queryHotelAutoOrderRuleLogPage
uat	https://dscp-uat.hn12301.net/manage-api/hotel/queryHotelAutoOrderRuleLogPage
pro	https://dscp-uat.hn12301.net/manage-api/hotel/queryHotelAutoOrderRuleLogPage	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HotelAutoOrderRuleLogPageRequest

字段	类型	必填	取值/校验	表 / 列	说明
pageNum	Integer	否		—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否		—	每页条数（继承自框架分页基类 AbstractPageRequest）
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　PageInfo<HotelAutoOrderRuleLogResponse>　（page）

字段	类型	表 / 列	说明
list / records	array	—	分页列表，元素结构见下
total	long	—	总条数（PageInfo）
id	Long	`hotel_auto_order_rule_log`.`id`	主键
hotelId	Long	`hotel_auto_order_rule_log`.`hotel_id`	酒店ID
ruleId	Long	`hotel_auto_order_rule_log`.`rule_id`	规则ID
content	String	`hotel_auto_order_rule_log`.`content`	操作内容
operatorId	Long	`hotel_auto_order_rule_log`.`operator_id`	操作人ID
operatorName	String	`hotel_auto_order_rule_log`.`operator_name`	操作人姓名
createdTime	Date	`hotel_auto_order_rule_log`.`created_time`	创建时间

示例

请求示例（自动生成，仅结构参考）

POST /hotel/queryHotelAutoOrderRuleLogPage

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1,
        "hotelId": 1,
        "ruleId": 1,
        "content": "",
        "operatorId": 1,
        "operatorName": "",
        "createdTime": "2026-01-01 12:00:00"
      }
    ],
    "total": 0
  }
}

处理逻辑

逻辑摘要分页查询（hotelAutoOrderRuleLogService.queryPage）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /hotel/updateHotelAutoOrderRuleLog 未使用管理后台 #

自动接单规则操作日志-更新 · HotelAutoOrderRuleLogController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelAutoOrderRuleLogController#updateHotelAutoOrderRuleLog
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_auto_order_rule_log

ControllerHotelAutoOrderRuleLogController#updateHotelAutoOrderRuleLog

转换BeanUtils.map → HotelAutoOrderRuleLog ⇒ 表 hotel_auto_order_rule_log

ServiceHotelAutoOrderRuleLogService#update （HotelAutoOrderRuleLogServiceImpl）

MapperHotelAutoOrderRuleLogMapper#updateById ⇒ 表 hotel_auto_order_rule_log

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/updateHotelAutoOrderRuleLog
uat	https://dscp-uat.hn12301.net/manage-api/hotel/updateHotelAutoOrderRuleLog
pro	https://dscp-uat.hn12301.net/manage-api/hotel/updateHotelAutoOrderRuleLog	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HotelAutoOrderRuleLogUpdateRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long			`hotel_auto_order_rule_log`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /hotel/updateHotelAutoOrderRuleLog

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志hotel / 更新自动排单规则日志

逻辑摘要更新（hotelAutoOrderRuleLogService.update）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

HotelCommentController 6/10 在用

POST /hotel/addHotelComment 未使用管理后台 #

酒店评价表-新增 · HotelCommentController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelCommentController#addHotelComment
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_comment

ControllerHotelCommentController#addHotelComment

转换BeanUtils.map → HotelComment ⇒ 表 hotel_comment

ServiceHotelCommentService#add （HotelCommentServiceImpl）

MapperHotelCommentMapper#insert ⇒ 表 hotel_comment

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/addHotelComment
uat	https://dscp-uat.hn12301.net/manage-api/hotel/addHotelComment
pro	https://dscp-uat.hn12301.net/manage-api/hotel/addHotelComment	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HotelCommentAddRequest

字段	类型	必填	取值/校验	表 / 列	说明
name	String			—	名称

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /hotel/addHotelComment

{
  "body": {
    "name": ""
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志hotel / 新增评价

逻辑摘要新增（hotelCommentService.add）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /hotel/auditHotelComment 在用管理后台 #

酒店评价表-审核 · HotelCommentController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelCommentController#auditHotelComment
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_commenthotel_comment_log

ControllerHotelCommentController#auditHotelComment

ServiceHotelCommentService#get （HotelCommentServiceImpl）

MapperHotelCommentMapper#selectById ⇒ 表 hotel_comment

ServiceHotelCommentService#update （HotelCommentServiceImpl）

MapperHotelCommentMapper#updateById ⇒ 表 hotel_comment

ServiceHotelCommentLogService#add （HotelCommentLogServiceImpl）

MapperHotelCommentLogMapper#insert ⇒ 表 hotel_comment_log

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 2

SessionUserService.getSessionIdSessionUserService.getSessionUser

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/auditHotelComment
uat	https://dscp-uat.hn12301.net/manage-api/hotel/auditHotelComment
pro	https://dscp-uat.hn12301.net/manage-api/hotel/auditHotelComment	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HotelCommentAuditRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long			`hotel_comment`.`id`	评价ID
status	Integer			`hotel_comment`.`status`	状态 0-待审核 1-已审核

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /hotel/auditHotelComment

{
  "body": {
    "id": 1,
    "status": 0
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志hotel / 审核评价

逻辑摘要查询详情（hotelCommentService.get）；更新（hotelCommentService.update）；查询详情（sessionUserService.getSessionId）

内联注释

获取评价信息
更新评价状态
记录审核日志
1-审核

前端调用方

dscp-html-manage auditHotelComment exact

POST /hotel/batchAuditHotelComment 在用管理后台 #

酒店评价表-批量审核 · HotelCommentController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelCommentController#batchAuditHotelComment
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_commenthotel_comment_log

ControllerHotelCommentController#batchAuditHotelComment

ServiceHotelCommentService#queryList （HotelCommentServiceImpl）

MapperHotelCommentMapper#selectList ⇒ 表 hotel_comment

ServiceHotelCommentService#update （HotelCommentServiceImpl）

MapperHotelCommentMapper#updateById ⇒ 表 hotel_comment

ServiceHotelCommentLogService#add （HotelCommentLogServiceImpl）

MapperHotelCommentLogMapper#insert ⇒ 表 hotel_comment_log

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 2

SessionUserService.getSessionIdSessionUserService.getSessionUser

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/batchAuditHotelComment
uat	https://dscp-uat.hn12301.net/manage-api/hotel/batchAuditHotelComment
pro	https://dscp-uat.hn12301.net/manage-api/hotel/batchAuditHotelComment	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HotelCommentBatchAuditRequest

字段	类型	必填	取值/校验	表 / 列	说明
ids	List<Long>			—	评价ID列表
status	Integer			`hotel_comment`.`status`	状态 0-待审核 1-已审核

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /hotel/batchAuditHotelComment

{
  "body": {
    "ids": "",
    "status": 0
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志hotel / 批量审核评价

逻辑摘要列表查询（hotelCommentService.queryList）；更新（hotelCommentService.update）；查询详情（sessionUserService.getSessionId）

内联注释

查询评价列表
批量更新评价状态
记录审核日志
1-审核

前端调用方

dscp-html-manage batchAuditHotelComment exact

POST /hotel/batchDeleteHotelComment 在用管理后台 #

酒店评价表-批量删除 · HotelCommentController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelCommentController#batchDeleteHotelComment
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_commenthotel_comment_log

ControllerHotelCommentController#batchDeleteHotelComment

ServiceHotelCommentService#queryList （HotelCommentServiceImpl）

MapperHotelCommentMapper#selectList ⇒ 表 hotel_comment

ServiceHotelCommentService#delete （HotelCommentServiceImpl）

MapperHotelCommentMapper#deleteById ⇒ 表 hotel_comment

ServiceHotelCommentLogService#add （HotelCommentLogServiceImpl）

MapperHotelCommentLogMapper#insert ⇒ 表 hotel_comment_log

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 2

SessionUserService.getSessionIdSessionUserService.getSessionUser

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/batchDeleteHotelComment
uat	https://dscp-uat.hn12301.net/manage-api/hotel/batchDeleteHotelComment
pro	https://dscp-uat.hn12301.net/manage-api/hotel/batchDeleteHotelComment	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HotelCommentBatchDeleteRequest

字段	类型	必填	取值/校验	表 / 列	说明
ids	List<Long>			—	评价ID列表

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /hotel/batchDeleteHotelComment

{
  "body": {
    "ids": ""
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志hotel / 批量删除评价

逻辑摘要列表查询（hotelCommentService.queryList）；删除（hotelCommentService.delete）；查询详情（sessionUserService.getSessionId）

内联注释

查询评价列表
批量删除评价
记录删除日志
3-删除

前端调用方

dscp-html-manage batchDeleteHotelComment exact

POST /hotel/deleteHotelComment 在用管理后台 #

酒店评价表-删除 · HotelCommentController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelCommentController#deleteHotelComment
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_commenthotel_comment_log

ControllerHotelCommentController#deleteHotelComment

ServiceHotelCommentService#get （HotelCommentServiceImpl）

MapperHotelCommentMapper#selectById ⇒ 表 hotel_comment

ServiceHotelCommentService#delete （HotelCommentServiceImpl）

MapperHotelCommentMapper#deleteById ⇒ 表 hotel_comment

ServiceHotelCommentLogService#add （HotelCommentLogServiceImpl）

MapperHotelCommentLogMapper#insert ⇒ 表 hotel_comment_log

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 2

SessionUserService.getSessionIdSessionUserService.getSessionUser

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/deleteHotelComment
uat	https://dscp-uat.hn12301.net/manage-api/hotel/deleteHotelComment
pro	https://dscp-uat.hn12301.net/manage-api/hotel/deleteHotelComment	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`hotel_comment`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /hotel/deleteHotelComment

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志hotel / 删除评价

逻辑摘要查询详情（hotelCommentService.get）；删除（hotelCommentService.delete）；查询详情（sessionUserService.getSessionId）

内联注释

获取评价信息
删除评价
记录删除日志
3-删除

前端调用方

dscp-html-manage deleteHotelComment exact

POST /hotel/getHotelComment 未使用管理后台 #

酒店评价表-详情 · HotelCommentController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelCommentController#getHotelComment
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_comment

ControllerHotelCommentController#getHotelComment

ServiceHotelCommentService#get （HotelCommentServiceImpl）

MapperHotelCommentMapper#selectById ⇒ 表 hotel_comment

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/getHotelComment
uat	https://dscp-uat.hn12301.net/manage-api/hotel/getHotelComment
pro	https://dscp-uat.hn12301.net/manage-api/hotel/getHotelComment	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`hotel_comment`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　HotelCommentResponse　（object）

字段	类型	表 / 列	说明
id	Long	`hotel_comment`.`id`	id
hotelId	Long	`hotel_comment`.`hotel_id`	酒店ID
roomTypeId	Long	`hotel_comment`.`room_type_id`	房型ID
roomTypeName	String	—
orderId	String	`hotel_comment`.`order_id`	订单号
stayDate	Date	`hotel_comment`.`stay_date`	入住日期
memberId	Long	`hotel_comment`.`member_id`	用户ID
memberName	String	`hotel_comment`.`member_name`	用户名称
rating	Integer	`hotel_comment`.`rating`	评分 1-5星
content	String	`hotel_comment`.`content`	评价内容
images	String	`hotel_comment`.`images`	图片，逗号隔开
tags	String	`hotel_comment`.`tags`	评价标签，逗号隔开
status	Integer	`hotel_comment`.`status`	状态 0-待审核 1-已审核
isDeleted	Boolean	`hotel_comment`.`is_deleted`	是否删除(0-否,1-是)
createdBy	Long	`hotel_comment`.`created_by`	创建人
createdTime	Date	`hotel_comment`.`created_time`	创建时间
updatedBy	Long	`hotel_comment`.`updated_by`	修改人
updatedTime	Date	`hotel_comment`.`updated_time`	修改时间

示例

请求示例（自动生成，仅结构参考）

POST /hotel/getHotelComment

{
  "body": {
    "id": 1
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": 1,
    "hotelId": 1,
    "roomTypeId": 1,
    "roomTypeName": "",
    "orderId": "",
    "stayDate": "2026-01-01 12:00:00",
    "memberId": 1,
    "memberName": "",
    "rating": 0,
    "content": "",
    "images": "",
    "tags": "",
    "status": 0,
    "isDeleted": false,
    "createdBy": 0,
    "createdTime": "2026-01-01 12:00:00",
    "updatedBy": 0,
    "updatedTime": "2026-01-01 12:00:00"
  }
}

处理逻辑

逻辑摘要查询详情（hotelCommentService.get）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /hotel/queryHotelCommentList 未使用管理后台 #

酒店评价表-列表查询 · HotelCommentController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelCommentController#queryHotelCommentList
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_comment

ControllerHotelCommentController#queryHotelCommentList

转换BeanUtils.map → HotelCommentQuery

ServiceHotelCommentService#queryList （HotelCommentServiceImpl）

MapperHotelCommentMapper#selectList ⇒ 表 hotel_comment

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/queryHotelCommentList
uat	https://dscp-uat.hn12301.net/manage-api/hotel/queryHotelCommentList
pro	https://dscp-uat.hn12301.net/manage-api/hotel/queryHotelCommentList	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HotelCommentListRequest

字段	类型	必填	取值/校验	表 / 列	说明
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　List<HotelCommentResponse>　（list）

字段	类型	表 / 列	说明
[ ]	array	—	列表，元素结构见下
id	Long	`hotel_comment`.`id`	id
hotelId	Long	`hotel_comment`.`hotel_id`	酒店ID
roomTypeId	Long	`hotel_comment`.`room_type_id`	房型ID
roomTypeName	String	—
orderId	String	`hotel_comment`.`order_id`	订单号
stayDate	Date	`hotel_comment`.`stay_date`	入住日期
memberId	Long	`hotel_comment`.`member_id`	用户ID
memberName	String	`hotel_comment`.`member_name`	用户名称
rating	Integer	`hotel_comment`.`rating`	评分 1-5星
content	String	`hotel_comment`.`content`	评价内容
images	String	`hotel_comment`.`images`	图片，逗号隔开
tags	String	`hotel_comment`.`tags`	评价标签，逗号隔开
status	Integer	`hotel_comment`.`status`	状态 0-待审核 1-已审核
isDeleted	Boolean	`hotel_comment`.`is_deleted`	是否删除(0-否,1-是)
createdBy	Long	`hotel_comment`.`created_by`	创建人
createdTime	Date	`hotel_comment`.`created_time`	创建时间
updatedBy	Long	`hotel_comment`.`updated_by`	修改人
updatedTime	Date	`hotel_comment`.`updated_time`	修改时间

示例

请求示例（自动生成，仅结构参考）

POST /hotel/queryHotelCommentList

{
  "body": {
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "id": 1,
      "hotelId": 1,
      "roomTypeId": 1,
      "roomTypeName": "",
      "orderId": "",
      "stayDate": "2026-01-01 12:00:00",
      "memberId": 1,
      "memberName": "",
      "rating": 0,
      "content": "",
      "images": "",
      "tags": "",
      "status": 0,
      "isDeleted": false,
      "createdBy": 0,
      "createdTime": "2026-01-01 12:00:00",
      "updatedBy": 0,
      "updatedTime": "2026-01-01 12:00:00"
    }
  ]
}

处理逻辑

逻辑摘要列表查询（hotelCommentService.queryList）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /hotel/queryHotelCommentPage 在用管理后台 #

酒店评价表-分页查询 · HotelCommentController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelCommentController#queryHotelCommentPage
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_comment

ControllerHotelCommentController#queryHotelCommentPage

转换BeanUtils.map → HotelCommentQuery

ServiceHotelCommentService#queryPage （HotelCommentServiceImpl）

MapperHotelCommentMapper#selectPage ⇒ 表 hotel_comment

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 1

HotelRoomTypeCache.get

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/queryHotelCommentPage
uat	https://dscp-uat.hn12301.net/manage-api/hotel/queryHotelCommentPage
pro	https://dscp-uat.hn12301.net/manage-api/hotel/queryHotelCommentPage	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HotelCommentPageRequest

字段	类型	必填	表 / 列	说明
pageNum	Integer	否	—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否	—	每页条数（继承自框架分页基类 AbstractPageRequest）
merchantId	Long		`hotel_comment`.`merchant_id`	所属商户id，关联merchant表id
shopId	Long		`hotel_comment`.`shop_id`	所属商铺id，关联shop表id
hotelId	Long		`hotel_comment`.`hotel_id`
status	Integer		`hotel_comment`.`status`	状态 0-待审核 1-已审核
roomTypeId	Long		`hotel_comment`.`room_type_id`	房型ID
createdTimeRange	Date[]		—	购买日期
rating	Integer		`hotel_comment`.`rating`

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　PageInfo<HotelCommentResponse>　（page）

字段	类型	表 / 列	说明
list / records	array	—	分页列表，元素结构见下
total	long	—	总条数（PageInfo）
id	Long	`hotel_comment`.`id`	id
hotelId	Long	`hotel_comment`.`hotel_id`	酒店ID
roomTypeId	Long	`hotel_comment`.`room_type_id`	房型ID
roomTypeName	String	—
orderId	String	`hotel_comment`.`order_id`	订单号
stayDate	Date	`hotel_comment`.`stay_date`	入住日期
memberId	Long	`hotel_comment`.`member_id`	用户ID
memberName	String	`hotel_comment`.`member_name`	用户名称
rating	Integer	`hotel_comment`.`rating`	评分 1-5星
content	String	`hotel_comment`.`content`	评价内容
images	String	`hotel_comment`.`images`	图片，逗号隔开
tags	String	`hotel_comment`.`tags`	评价标签，逗号隔开
status	Integer	`hotel_comment`.`status`	状态 0-待审核 1-已审核
isDeleted	Boolean	`hotel_comment`.`is_deleted`	是否删除(0-否,1-是)
createdBy	Long	`hotel_comment`.`created_by`	创建人
createdTime	Date	`hotel_comment`.`created_time`	创建时间
updatedBy	Long	`hotel_comment`.`updated_by`	修改人
updatedTime	Date	`hotel_comment`.`updated_time`	修改时间

示例

请求示例（自动生成，仅结构参考）

POST /hotel/queryHotelCommentPage

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "merchantId": 1,
    "shopId": 1,
    "hotelId": 1,
    "status": 0,
    "roomTypeId": 1,
    "createdTimeRange": "2026-01-01 12:00:00",
    "rating": 0
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1,
        "hotelId": 1,
        "roomTypeId": 1,
        "roomTypeName": "",
        "orderId": "",
        "stayDate": "2026-01-01 12:00:00",
        "memberId": 1,
        "memberName": "",
        "rating": 0,
        "content": "",
        "images": "",
        "tags": "",
        "status": 0,
        "isDeleted": false,
        "createdBy": 0,
        "createdTime": "2026-01-01 12:00:00",
        "updatedBy": 0,
        "updatedTime": "2026-01-01 12:00:00"
      }
    ],
    "total": 0
  }
}

处理逻辑

逻辑摘要分页查询（hotelCommentService.queryPage）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置时间范围
设置排序
查询评价列表
填充房型名称

前端调用方

dscp-html-manage queryHotelCommentPage exact

POST /hotel/queryHotelCommentStats 在用管理后台 #

评价统计 · HotelCommentController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelCommentController#queryHotelCommentStats
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_comment

ControllerHotelCommentController#queryHotelCommentStats

ServiceHotelCommentService#queryList （HotelCommentServiceImpl）

MapperHotelCommentMapper#selectList ⇒ 表 hotel_comment

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/queryHotelCommentStats
uat	https://dscp-uat.hn12301.net/manage-api/hotel/queryHotelCommentStats
pro	https://dscp-uat.hn12301.net/manage-api/hotel/queryHotelCommentStats	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HotelCommentStatsRequest

字段	类型	必填	取值/校验	表 / 列	说明
hotelId	Long			`hotel_comment`.`hotel_id`	酒店ID
timeRange	String			—	时间范围：today-今日, week-本周, month-本月

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　HotelCommentStatsResponse　（object）

字段	类型	表 / 列	说明
totalCount	Long	—	总评价数
avgRating	Double	—	平均评分
pendingCount	Long	—	待审核数
goodRatePercent	Double	—	好评率
totalCountChange	Double	—	总评价数变化率
avgRatingChange	Double	—	平均评分变化率
pendingCountChange	Double	—	待审核数变化率
goodRateChange	Double	—	好评率变化率

示例

请求示例（自动生成，仅结构参考）

POST /hotel/queryHotelCommentStats

{
  "body": {
    "hotelId": 1,
    "timeRange": "2026-01-01 12:00:00"
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "totalCount": 0,
    "avgRating": 0,
    "pendingCount": 0,
    "goodRatePercent": 0,
    "totalCountChange": 0,
    "avgRatingChange": 0,
    "pendingCountChange": 0,
    "goodRateChange": 0
  }
}

处理逻辑

逻辑摘要列表查询（hotelCommentService.queryList）

内联注释

1. 获取当前时间范围
2. 获取对比时间范围
3. 查询当前时间范围的数据
4. 查询对比时间范围的数据
5. 计算统计数据

前端调用方

dscp-html-manage queryHotelCommentStats exact

POST /hotel/updateHotelComment 未使用管理后台 #

酒店评价表-更新 · HotelCommentController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelCommentController#updateHotelComment
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_comment

ControllerHotelCommentController#updateHotelComment

转换BeanUtils.map → HotelComment ⇒ 表 hotel_comment

ServiceHotelCommentService#update （HotelCommentServiceImpl）

MapperHotelCommentMapper#updateById ⇒ 表 hotel_comment

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/updateHotelComment
uat	https://dscp-uat.hn12301.net/manage-api/hotel/updateHotelComment
pro	https://dscp-uat.hn12301.net/manage-api/hotel/updateHotelComment	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HotelCommentUpdateRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long			`hotel_comment`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /hotel/updateHotelComment

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志hotel / 更新评价

逻辑摘要更新（hotelCommentService.update）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

HotelCommentLogController 1/7 在用

POST /hotel/addHotelCommentLog 未使用管理后台 #

评价操作日志表-新增 · HotelCommentLogController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelCommentLogController#addHotelCommentLog
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_comment_log

ControllerHotelCommentLogController#addHotelCommentLog

转换BeanUtils.map → HotelCommentLog ⇒ 表 hotel_comment_log

ServiceHotelCommentLogService#add （HotelCommentLogServiceImpl）

MapperHotelCommentLogMapper#insert ⇒ 表 hotel_comment_log

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/addHotelCommentLog
uat	https://dscp-uat.hn12301.net/manage-api/hotel/addHotelCommentLog
pro	https://dscp-uat.hn12301.net/manage-api/hotel/addHotelCommentLog	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HotelCommentLogAddRequest

字段	类型	必填	取值/校验	表 / 列	说明
name	String			—	名称

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /hotel/addHotelCommentLog

{
  "body": {
    "name": ""
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志hotel / 新增评价日志

逻辑摘要新增（hotelCommentLogService.add）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /hotel/deleteHotelCommentLog 未使用管理后台 #

评价操作日志表-删除 · HotelCommentLogController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelCommentLogController#deleteHotelCommentLog
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_comment_log

ControllerHotelCommentLogController#deleteHotelCommentLog

ServiceHotelCommentLogService#delete （HotelCommentLogServiceImpl）

MapperHotelCommentLogMapper#deleteById ⇒ 表 hotel_comment_log

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/deleteHotelCommentLog
uat	https://dscp-uat.hn12301.net/manage-api/hotel/deleteHotelCommentLog
pro	https://dscp-uat.hn12301.net/manage-api/hotel/deleteHotelCommentLog	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`hotel_comment_log`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /hotel/deleteHotelCommentLog

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志hotel / 删除评价日志

逻辑摘要删除（hotelCommentLogService.delete）

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /hotel/getHotelCommentLog 未使用管理后台 #

评价操作日志表-详情 · HotelCommentLogController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelCommentLogController#getHotelCommentLog
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_comment_log

ControllerHotelCommentLogController#getHotelCommentLog

ServiceHotelCommentLogService#get （HotelCommentLogServiceImpl）

MapperHotelCommentLogMapper#selectById ⇒ 表 hotel_comment_log

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/getHotelCommentLog
uat	https://dscp-uat.hn12301.net/manage-api/hotel/getHotelCommentLog
pro	https://dscp-uat.hn12301.net/manage-api/hotel/getHotelCommentLog	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`hotel_comment_log`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　HotelCommentLogResponse　（object）

字段	类型	表 / 列	说明
id	Long	`hotel_comment_log`.`id`	主键
commentId	Long	`hotel_comment_log`.`comment_id`	评价ID
operatorId	Long	`hotel_comment_log`.`operator_id`	操作人ID
operatorName	String	`hotel_comment_log`.`operator_name`	操作人名称
operationType	Integer	`hotel_comment_log`.`operation_type`	操作类型 1-审核 2-回复 3-删除
operationDesc	String	`hotel_comment_log`.`operation_desc`	操作描述
createdTime	Date	`hotel_comment_log`.`created_time`	创建时间

示例

请求示例（自动生成，仅结构参考）

POST /hotel/getHotelCommentLog

{
  "body": {
    "id": 1
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": 1,
    "commentId": 1,
    "operatorId": 1,
    "operatorName": "",
    "operationType": 0,
    "operationDesc": "",
    "createdTime": "2026-01-01 12:00:00"
  }
}

处理逻辑

逻辑摘要查询详情（hotelCommentLogService.get）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /hotel/queryHotelCommentLogList 未使用管理后台 #

评价操作日志表-列表查询 · HotelCommentLogController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelCommentLogController#queryHotelCommentLogList
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_comment_log

ControllerHotelCommentLogController#queryHotelCommentLogList

转换BeanUtils.map → HotelCommentLogQuery

ServiceHotelCommentLogService#queryList （HotelCommentLogServiceImpl）

MapperHotelCommentLogMapper#selectList ⇒ 表 hotel_comment_log

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/queryHotelCommentLogList
uat	https://dscp-uat.hn12301.net/manage-api/hotel/queryHotelCommentLogList
pro	https://dscp-uat.hn12301.net/manage-api/hotel/queryHotelCommentLogList	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HotelCommentLogListRequest

字段	类型	必填	取值/校验	表 / 列	说明
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　List<HotelCommentLogResponse>　（list）

字段	类型	表 / 列	说明
[ ]	array	—	列表，元素结构见下
id	Long	`hotel_comment_log`.`id`	主键
commentId	Long	`hotel_comment_log`.`comment_id`	评价ID
operatorId	Long	`hotel_comment_log`.`operator_id`	操作人ID
operatorName	String	`hotel_comment_log`.`operator_name`	操作人名称
operationType	Integer	`hotel_comment_log`.`operation_type`	操作类型 1-审核 2-回复 3-删除
operationDesc	String	`hotel_comment_log`.`operation_desc`	操作描述
createdTime	Date	`hotel_comment_log`.`created_time`	创建时间

示例

请求示例（自动生成，仅结构参考）

POST /hotel/queryHotelCommentLogList

{
  "body": {
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "id": 1,
      "commentId": 1,
      "operatorId": 1,
      "operatorName": "",
      "operationType": 0,
      "operationDesc": "",
      "createdTime": "2026-01-01 12:00:00"
    }
  ]
}

处理逻辑

逻辑摘要列表查询（hotelCommentLogService.queryList）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /hotel/queryHotelCommentLogPage 未使用管理后台 #

评价操作日志表-分页查询 · HotelCommentLogController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelCommentLogController#queryHotelCommentLogPage
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_comment_log

ControllerHotelCommentLogController#queryHotelCommentLogPage

转换BeanUtils.map → HotelCommentLogQuery

ServiceHotelCommentLogService#queryPage （HotelCommentLogServiceImpl）

MapperHotelCommentLogMapper#selectPage ⇒ 表 hotel_comment_log

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/queryHotelCommentLogPage
uat	https://dscp-uat.hn12301.net/manage-api/hotel/queryHotelCommentLogPage
pro	https://dscp-uat.hn12301.net/manage-api/hotel/queryHotelCommentLogPage	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HotelCommentLogPageRequest

字段	类型	必填	取值/校验	表 / 列	说明
pageNum	Integer	否		—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否		—	每页条数（继承自框架分页基类 AbstractPageRequest）
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　PageInfo<HotelCommentLogResponse>　（page）

字段	类型	表 / 列	说明
list / records	array	—	分页列表，元素结构见下
total	long	—	总条数（PageInfo）
id	Long	`hotel_comment_log`.`id`	主键
commentId	Long	`hotel_comment_log`.`comment_id`	评价ID
operatorId	Long	`hotel_comment_log`.`operator_id`	操作人ID
operatorName	String	`hotel_comment_log`.`operator_name`	操作人名称
operationType	Integer	`hotel_comment_log`.`operation_type`	操作类型 1-审核 2-回复 3-删除
operationDesc	String	`hotel_comment_log`.`operation_desc`	操作描述
createdTime	Date	`hotel_comment_log`.`created_time`	创建时间

示例

请求示例（自动生成，仅结构参考）

POST /hotel/queryHotelCommentLogPage

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1,
        "commentId": 1,
        "operatorId": 1,
        "operatorName": "",
        "operationType": 0,
        "operationDesc": "",
        "createdTime": "2026-01-01 12:00:00"
      }
    ],
    "total": 0
  }
}

处理逻辑

逻辑摘要分页查询（hotelCommentLogService.queryPage）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /hotel/queryHotelCommentLogs 在用管理后台 #

根据评论ID查询操作日志 · HotelCommentLogController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelCommentLogController#queryHotelCommentLogs
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_comment_log

ControllerHotelCommentLogController#queryHotelCommentLogs

ServiceHotelCommentLogService#queryList （HotelCommentLogServiceImpl）

MapperHotelCommentLogMapper#selectList ⇒ 表 hotel_comment_log

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/queryHotelCommentLogs
uat	https://dscp-uat.hn12301.net/manage-api/hotel/queryHotelCommentLogs
pro	https://dscp-uat.hn12301.net/manage-api/hotel/queryHotelCommentLogs	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HotelCommentLogQueryRequest

字段	类型	必填	取值/校验	表 / 列	说明
commentId	Long			`hotel_comment_log`.`comment_id`	评论ID

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　List<HotelCommentLogResponse>　（list）

字段	类型	表 / 列	说明
[ ]	array	—	列表，元素结构见下
id	Long	`hotel_comment_log`.`id`	主键
commentId	Long	`hotel_comment_log`.`comment_id`	评价ID
operatorId	Long	`hotel_comment_log`.`operator_id`	操作人ID
operatorName	String	`hotel_comment_log`.`operator_name`	操作人名称
operationType	Integer	`hotel_comment_log`.`operation_type`	操作类型 1-审核 2-回复 3-删除
operationDesc	String	`hotel_comment_log`.`operation_desc`	操作描述
createdTime	Date	`hotel_comment_log`.`created_time`	创建时间

示例

请求示例（自动生成，仅结构参考）

POST /hotel/queryHotelCommentLogs

{
  "body": {
    "commentId": 1
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "id": 1,
      "commentId": 1,
      "operatorId": 1,
      "operatorName": "",
      "operationType": 0,
      "operationDesc": "",
      "createdTime": "2026-01-01 12:00:00"
    }
  ]
}

处理逻辑

逻辑摘要列表查询（hotelCommentLogService.queryList）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

dscp-html-manage queryHotelCommentLogs exact

POST /hotel/updateHotelCommentLog 未使用管理后台 #

评价操作日志表-更新 · HotelCommentLogController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelCommentLogController#updateHotelCommentLog
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_comment_log

ControllerHotelCommentLogController#updateHotelCommentLog

转换BeanUtils.map → HotelCommentLog ⇒ 表 hotel_comment_log

ServiceHotelCommentLogService#update （HotelCommentLogServiceImpl）

MapperHotelCommentLogMapper#updateById ⇒ 表 hotel_comment_log

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/updateHotelCommentLog
uat	https://dscp-uat.hn12301.net/manage-api/hotel/updateHotelCommentLog
pro	https://dscp-uat.hn12301.net/manage-api/hotel/updateHotelCommentLog	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HotelCommentLogUpdateRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long			`hotel_comment_log`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /hotel/updateHotelCommentLog

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志hotel / 更新评价日志

逻辑摘要更新（hotelCommentLogService.update）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

HotelCommentReplyController 2/7 在用

POST /hotel/addHotelCommentReply 在用管理后台 #

评价回复表-新增 · HotelCommentReplyController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelCommentReplyController#addHotelCommentReply
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_comment_replyhotel_commenthotel_comment_log

ControllerHotelCommentReplyController#addHotelCommentReply

转换BeanUtils.map → HotelCommentReply ⇒ 表 hotel_comment_reply

ServiceHotelCommentService#get （HotelCommentServiceImpl）

MapperHotelCommentMapper#selectById ⇒ 表 hotel_comment

ServiceHotelCommentReplyService#add （HotelCommentReplyServiceImpl）

MapperHotelCommentReplyMapper#insert ⇒ 表 hotel_comment_reply

ServiceHotelCommentLogService#add （HotelCommentLogServiceImpl）

MapperHotelCommentLogMapper#insert ⇒ 表 hotel_comment_log

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 2

SessionUserService.getSessionIdSessionUserService.getSessionUser

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/addHotelCommentReply
uat	https://dscp-uat.hn12301.net/manage-api/hotel/addHotelCommentReply
pro	https://dscp-uat.hn12301.net/manage-api/hotel/addHotelCommentReply	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HotelCommentReplyAddRequest

字段	类型	必填	取值/校验	表 / 列	说明
commentId	Long			`hotel_comment_reply`.`comment_id`	评价ID
content	String			`hotel_comment_reply`.`content`	回复内容

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /hotel/addHotelCommentReply

{
  "body": {
    "commentId": 1,
    "content": ""
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志hotel / 新增评价回复

逻辑摘要查询详情（hotelCommentService.get）；查询详情（sessionUserService.getSessionId）；查询详情（sessionUserService.getSessionUser）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

校验评价是否存在
构建回复对象
记录回复日志
2-回复

前端调用方

dscp-html-manage addHotelCommentReply exact

POST /hotel/deleteHotelCommentReply 未使用管理后台 #

评价回复表-删除 · HotelCommentReplyController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelCommentReplyController#deleteHotelCommentReply
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_comment_reply

ControllerHotelCommentReplyController#deleteHotelCommentReply

ServiceHotelCommentReplyService#delete （HotelCommentReplyServiceImpl）

MapperHotelCommentReplyMapper#deleteById ⇒ 表 hotel_comment_reply

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/deleteHotelCommentReply
uat	https://dscp-uat.hn12301.net/manage-api/hotel/deleteHotelCommentReply
pro	https://dscp-uat.hn12301.net/manage-api/hotel/deleteHotelCommentReply	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`hotel_comment_reply`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /hotel/deleteHotelCommentReply

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志hotel / 删除评价回复

逻辑摘要删除（hotelCommentReplyService.delete）

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /hotel/getHotelCommentReply 未使用管理后台 #

评价回复表-详情 · HotelCommentReplyController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelCommentReplyController#getHotelCommentReply
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_comment_reply

ControllerHotelCommentReplyController#getHotelCommentReply

ServiceHotelCommentReplyService#get （HotelCommentReplyServiceImpl）

MapperHotelCommentReplyMapper#selectById ⇒ 表 hotel_comment_reply

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/getHotelCommentReply
uat	https://dscp-uat.hn12301.net/manage-api/hotel/getHotelCommentReply
pro	https://dscp-uat.hn12301.net/manage-api/hotel/getHotelCommentReply	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`hotel_comment_reply`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　HotelCommentReplyResponse　（object）

字段	类型	表 / 列	说明
id	Long	`hotel_comment_reply`.`id`	主键
commentId	Long	`hotel_comment_reply`.`comment_id`	评价ID
content	String	`hotel_comment_reply`.`content`	回复内容
operatorId	Long	`hotel_comment_reply`.`operator_id`	操作人ID
operatorName	String	`hotel_comment_reply`.`operator_name`	操作人名称
createdTime	Date	`hotel_comment_reply`.`created_time`	创建时间

示例

请求示例（自动生成，仅结构参考）

POST /hotel/getHotelCommentReply

{
  "body": {
    "id": 1
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": 1,
    "commentId": 1,
    "content": "",
    "operatorId": 1,
    "operatorName": "",
    "createdTime": "2026-01-01 12:00:00"
  }
}

处理逻辑

逻辑摘要查询详情（hotelCommentReplyService.get）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /hotel/queryHotelCommentReplyList 未使用管理后台 #

评价回复表-列表查询 · HotelCommentReplyController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelCommentReplyController#queryHotelCommentReplyList
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_comment_reply

ControllerHotelCommentReplyController#queryHotelCommentReplyList

转换BeanUtils.map → HotelCommentReplyQuery

ServiceHotelCommentReplyService#queryList （HotelCommentReplyServiceImpl）

MapperHotelCommentReplyMapper#selectList ⇒ 表 hotel_comment_reply

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/queryHotelCommentReplyList
uat	https://dscp-uat.hn12301.net/manage-api/hotel/queryHotelCommentReplyList
pro	https://dscp-uat.hn12301.net/manage-api/hotel/queryHotelCommentReplyList	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HotelCommentReplyListRequest

字段	类型	必填	取值/校验	表 / 列	说明
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　List<HotelCommentReplyResponse>　（list）

字段	类型	表 / 列	说明
[ ]	array	—	列表，元素结构见下
id	Long	`hotel_comment_reply`.`id`	主键
commentId	Long	`hotel_comment_reply`.`comment_id`	评价ID
content	String	`hotel_comment_reply`.`content`	回复内容
operatorId	Long	`hotel_comment_reply`.`operator_id`	操作人ID
operatorName	String	`hotel_comment_reply`.`operator_name`	操作人名称
createdTime	Date	`hotel_comment_reply`.`created_time`	创建时间

示例

请求示例（自动生成，仅结构参考）

POST /hotel/queryHotelCommentReplyList

{
  "body": {
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "id": 1,
      "commentId": 1,
      "content": "",
      "operatorId": 1,
      "operatorName": "",
      "createdTime": "2026-01-01 12:00:00"
    }
  ]
}

处理逻辑

逻辑摘要列表查询（hotelCommentReplyService.queryList）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /hotel/queryHotelCommentReplyPage 未使用管理后台 #

评价回复表-分页查询 · HotelCommentReplyController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelCommentReplyController#queryHotelCommentReplyPage
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_comment_reply

ControllerHotelCommentReplyController#queryHotelCommentReplyPage

转换BeanUtils.map → HotelCommentReplyQuery

ServiceHotelCommentReplyService#queryPage （HotelCommentReplyServiceImpl）

MapperHotelCommentReplyMapper#selectPage ⇒ 表 hotel_comment_reply

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/queryHotelCommentReplyPage
uat	https://dscp-uat.hn12301.net/manage-api/hotel/queryHotelCommentReplyPage
pro	https://dscp-uat.hn12301.net/manage-api/hotel/queryHotelCommentReplyPage	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HotelCommentReplyPageRequest

字段	类型	必填	取值/校验	表 / 列	说明
pageNum	Integer	否		—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否		—	每页条数（继承自框架分页基类 AbstractPageRequest）
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　PageInfo<HotelCommentReplyResponse>　（page）

字段	类型	表 / 列	说明
list / records	array	—	分页列表，元素结构见下
total	long	—	总条数（PageInfo）
id	Long	`hotel_comment_reply`.`id`	主键
commentId	Long	`hotel_comment_reply`.`comment_id`	评价ID
content	String	`hotel_comment_reply`.`content`	回复内容
operatorId	Long	`hotel_comment_reply`.`operator_id`	操作人ID
operatorName	String	`hotel_comment_reply`.`operator_name`	操作人名称
createdTime	Date	`hotel_comment_reply`.`created_time`	创建时间

示例

请求示例（自动生成，仅结构参考）

POST /hotel/queryHotelCommentReplyPage

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1,
        "commentId": 1,
        "content": "",
        "operatorId": 1,
        "operatorName": "",
        "createdTime": "2026-01-01 12:00:00"
      }
    ],
    "total": 0
  }
}

处理逻辑

逻辑摘要分页查询（hotelCommentReplyService.queryPage）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /hotel/queryHotelCommentReplys 在用管理后台 #

根据评论ID查询回复列表 · HotelCommentReplyController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelCommentReplyController#queryHotelCommentReplys
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_comment_reply

ControllerHotelCommentReplyController#queryHotelCommentReplys

ServiceHotelCommentReplyService#queryList （HotelCommentReplyServiceImpl）

MapperHotelCommentReplyMapper#selectList ⇒ 表 hotel_comment_reply

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/queryHotelCommentReplys
uat	https://dscp-uat.hn12301.net/manage-api/hotel/queryHotelCommentReplys
pro	https://dscp-uat.hn12301.net/manage-api/hotel/queryHotelCommentReplys	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HotelCommentReplyQueryRequest

字段	类型	必填	取值/校验	表 / 列	说明
commentId	Long			`hotel_comment_reply`.`comment_id`	评论ID

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　List<HotelCommentReplyResponse>　（list）

字段	类型	表 / 列	说明
[ ]	array	—	列表，元素结构见下
id	Long	`hotel_comment_reply`.`id`	主键
commentId	Long	`hotel_comment_reply`.`comment_id`	评价ID
content	String	`hotel_comment_reply`.`content`	回复内容
operatorId	Long	`hotel_comment_reply`.`operator_id`	操作人ID
operatorName	String	`hotel_comment_reply`.`operator_name`	操作人名称
createdTime	Date	`hotel_comment_reply`.`created_time`	创建时间

示例

请求示例（自动生成，仅结构参考）

POST /hotel/queryHotelCommentReplys

{
  "body": {
    "commentId": 1
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "id": 1,
      "commentId": 1,
      "content": "",
      "operatorId": 1,
      "operatorName": "",
      "createdTime": "2026-01-01 12:00:00"
    }
  ]
}

处理逻辑

逻辑摘要列表查询（hotelCommentReplyService.queryList）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

按创建时间倒序

前端调用方

dscp-html-manage queryHotelCommentReplys exact

POST /hotel/updateHotelCommentReply 未使用管理后台 #

评价回复表-更新 · HotelCommentReplyController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelCommentReplyController#updateHotelCommentReply
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_comment_reply

ControllerHotelCommentReplyController#updateHotelCommentReply

转换BeanUtils.map → HotelCommentReply ⇒ 表 hotel_comment_reply

ServiceHotelCommentReplyService#update （HotelCommentReplyServiceImpl）

MapperHotelCommentReplyMapper#updateById ⇒ 表 hotel_comment_reply

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/updateHotelCommentReply
uat	https://dscp-uat.hn12301.net/manage-api/hotel/updateHotelCommentReply
pro	https://dscp-uat.hn12301.net/manage-api/hotel/updateHotelCommentReply	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HotelCommentReplyUpdateRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long			`hotel_comment_reply`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /hotel/updateHotelCommentReply

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志hotel / 更新评价回复

逻辑摘要更新（hotelCommentReplyService.update）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

HotelFacilityController 0/6 在用

POST /hotel/addHotelFacility 未使用管理后台 #

酒店设施分类表-新增 · HotelFacilityController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelFacilityController#addHotelFacility
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_facility

ControllerHotelFacilityController#addHotelFacility

转换BeanUtils.map → HotelFacility ⇒ 表 hotel_facility

ServiceHotelFacilityService#add （HotelFacilityServiceImpl）

MapperHotelFacilityMapper#insert ⇒ 表 hotel_facility

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/addHotelFacility
uat	https://dscp-uat.hn12301.net/manage-api/hotel/addHotelFacility
pro	https://dscp-uat.hn12301.net/manage-api/hotel/addHotelFacility	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HotelFacilityAddRequest

字段	类型	必填	取值/校验	表 / 列	说明
name	String	是	必填	`hotel_facility`.`name`	设施名称
type	String	是	必填	`hotel_facility`.`type`	设施类型
level	Integer	是	必填	`hotel_facility`.`level`	层级
sort	Integer	是	必填	`hotel_facility`.`sort`	排序号
parentId	Long			`hotel_facility`.`parent_id`	父级ID
createdBy	Long			`hotel_facility`.`created_by`	创建人ID
createdTime	Date			`hotel_facility`.`created_time`	创建时间
updatedBy	Long			`hotel_facility`.`updated_by`	更新人ID
updatedTime	Date			`hotel_facility`.`updated_time`	更新时间

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /hotel/addHotelFacility

{
  "body": {
    "name": "",
    "type": "",
    "level": 0,
    "sort": 0,
    "parentId": 1,
    "createdBy": 0,
    "createdTime": "2026-01-01 12:00:00",
    "updatedBy": 0,
    "updatedTime": "2026-01-01 12:00:00"
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志hotel / 新增酒店设施

逻辑摘要新增（hotelFacilityService.add）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /hotel/deleteHotelFacility 未使用管理后台 #

酒店设施分类表-删除 · HotelFacilityController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelFacilityController#deleteHotelFacility
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_facility

ControllerHotelFacilityController#deleteHotelFacility

ServiceHotelFacilityService#delete （HotelFacilityServiceImpl）

MapperHotelFacilityMapper#deleteById ⇒ 表 hotel_facility

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/deleteHotelFacility
uat	https://dscp-uat.hn12301.net/manage-api/hotel/deleteHotelFacility
pro	https://dscp-uat.hn12301.net/manage-api/hotel/deleteHotelFacility	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`hotel_facility`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /hotel/deleteHotelFacility

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志hotel / 删除酒店设施

逻辑摘要删除（hotelFacilityService.delete）

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /hotel/getHotelFacility 未使用管理后台 #

酒店设施分类表-详情 · HotelFacilityController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelFacilityController#getHotelFacility
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_facility

ControllerHotelFacilityController#getHotelFacility

ServiceHotelFacilityService#get （HotelFacilityServiceImpl）

MapperHotelFacilityMapper#selectById ⇒ 表 hotel_facility

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/getHotelFacility
uat	https://dscp-uat.hn12301.net/manage-api/hotel/getHotelFacility
pro	https://dscp-uat.hn12301.net/manage-api/hotel/getHotelFacility	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`hotel_facility`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　HotelFacilityResponse　（object）

字段	类型	必填	取值/校验	表 / 列	说明
id	Long			`hotel_facility`.`id`	id

示例

请求示例（自动生成，仅结构参考）

POST /hotel/getHotelFacility

{
  "body": {
    "id": 1
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": 1
  }
}

处理逻辑

逻辑摘要查询详情（hotelFacilityService.get）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /hotel/queryHotelFacilityList 未使用管理后台 #

酒店设施分类表-列表查询 · HotelFacilityController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelFacilityController#queryHotelFacilityList
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_facility

ControllerHotelFacilityController#queryHotelFacilityList

转换BeanUtils.map → HotelFacilityQuery

ServiceHotelFacilityService#queryList （HotelFacilityServiceImpl）

MapperHotelFacilityMapper#selectList ⇒ 表 hotel_facility

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/queryHotelFacilityList
uat	https://dscp-uat.hn12301.net/manage-api/hotel/queryHotelFacilityList
pro	https://dscp-uat.hn12301.net/manage-api/hotel/queryHotelFacilityList	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HotelFacilityListRequest

字段	类型	必填	取值/校验	表 / 列	说明
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　List<HotelFacilityResponse>　（list）

字段	类型	必填	取值/校验	表 / 列	说明
[ ]	array			—	列表，元素结构见下
id	Long			`hotel_facility`.`id`	id

示例

请求示例（自动生成，仅结构参考）

POST /hotel/queryHotelFacilityList

{
  "body": {
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "id": 1
    }
  ]
}

处理逻辑

逻辑摘要列表查询（hotelFacilityService.queryList）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /hotel/queryHotelFacilityPage 未使用管理后台 #

酒店设施分类表-分页查询 · HotelFacilityController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelFacilityController#queryHotelFacilityPage
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_facility

ControllerHotelFacilityController#queryHotelFacilityPage

转换BeanUtils.map → HotelFacilityQuery

ServiceHotelFacilityService#queryPage （HotelFacilityServiceImpl）

MapperHotelFacilityMapper#selectPage ⇒ 表 hotel_facility

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/queryHotelFacilityPage
uat	https://dscp-uat.hn12301.net/manage-api/hotel/queryHotelFacilityPage
pro	https://dscp-uat.hn12301.net/manage-api/hotel/queryHotelFacilityPage	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HotelFacilityPageRequest

字段	类型	必填	取值/校验	表 / 列	说明
pageNum	Integer	否		—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否		—	每页条数（继承自框架分页基类 AbstractPageRequest）
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　PageInfo<HotelFacilityResponse>　（page）

字段	类型	表 / 列	说明
list / records	array	—	分页列表，元素结构见下
total	long	—	总条数（PageInfo）
id	Long	`hotel_facility`.`id`	id

示例

请求示例（自动生成，仅结构参考）

POST /hotel/queryHotelFacilityPage

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1
      }
    ],
    "total": 0
  }
}

处理逻辑

逻辑摘要分页查询（hotelFacilityService.queryPage）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /hotel/updateHotelFacility 未使用管理后台 #

酒店设施分类表-更新 · HotelFacilityController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelFacilityController#updateHotelFacility
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_facility

ControllerHotelFacilityController#updateHotelFacility

转换BeanUtils.map → HotelFacility ⇒ 表 hotel_facility

ServiceHotelFacilityService#update （HotelFacilityServiceImpl）

MapperHotelFacilityMapper#updateById ⇒ 表 hotel_facility

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/updateHotelFacility
uat	https://dscp-uat.hn12301.net/manage-api/hotel/updateHotelFacility
pro	https://dscp-uat.hn12301.net/manage-api/hotel/updateHotelFacility	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HotelFacilityUpdateRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long			`hotel_facility`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /hotel/updateHotelFacility

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志hotel / 更新酒店设施

逻辑摘要更新（hotelFacilityService.update）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

HotelFacilityRelController 0/6 在用

POST /hotel/addHotelFacilityRel 未使用管理后台 #

酒店设施关联表-新增 · HotelFacilityRelController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelFacilityRelController#addHotelFacilityRel
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_facility_rel

ControllerHotelFacilityRelController#addHotelFacilityRel

转换BeanUtils.map → HotelFacilityRel ⇒ 表 hotel_facility_rel

ServiceHotelFacilityRelService#add （HotelFacilityRelServiceImpl）

MapperHotelFacilityRelMapper#insert ⇒ 表 hotel_facility_rel

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/addHotelFacilityRel
uat	https://dscp-uat.hn12301.net/manage-api/hotel/addHotelFacilityRel
pro	https://dscp-uat.hn12301.net/manage-api/hotel/addHotelFacilityRel	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HotelFacilityRelAddRequest

字段	类型	必填	取值/校验	表 / 列	说明
hotelId	Long	是	必填	`hotel_facility_rel`.`hotel_id`	酒店ID
facilityId	Long	是	必填	`hotel_facility_rel`.`facility_id`	设施ID
createdBy	Long			`hotel_facility_rel`.`created_by`	创建人ID
createdTime	Date			`hotel_facility_rel`.`created_time`	创建时间
updatedBy	Long			`hotel_facility_rel`.`updated_by`	更新人ID
updatedTime	Date			`hotel_facility_rel`.`updated_time`	更新时间

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /hotel/addHotelFacilityRel

{
  "body": {
    "hotelId": 1,
    "facilityId": 1,
    "createdBy": 0,
    "createdTime": "2026-01-01 12:00:00",
    "updatedBy": 0,
    "updatedTime": "2026-01-01 12:00:00"
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志hotel / 新增设施关联

逻辑摘要新增（hotelFacilityRelService.add）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /hotel/deleteHotelFacilityRel 未使用管理后台 #

酒店设施关联表-删除 · HotelFacilityRelController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelFacilityRelController#deleteHotelFacilityRel
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_facility_rel

ControllerHotelFacilityRelController#deleteHotelFacilityRel

ServiceHotelFacilityRelService#delete （HotelFacilityRelServiceImpl）

MapperHotelFacilityRelMapper#deleteById ⇒ 表 hotel_facility_rel

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/deleteHotelFacilityRel
uat	https://dscp-uat.hn12301.net/manage-api/hotel/deleteHotelFacilityRel
pro	https://dscp-uat.hn12301.net/manage-api/hotel/deleteHotelFacilityRel	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`hotel_facility_rel`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /hotel/deleteHotelFacilityRel

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志hotel / 删除设施关联

逻辑摘要删除（hotelFacilityRelService.delete）

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /hotel/getHotelFacilityRel 未使用管理后台 #

酒店设施关联表-详情 · HotelFacilityRelController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelFacilityRelController#getHotelFacilityRel
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_facility_rel

ControllerHotelFacilityRelController#getHotelFacilityRel

ServiceHotelFacilityRelService#get （HotelFacilityRelServiceImpl）

MapperHotelFacilityRelMapper#selectById ⇒ 表 hotel_facility_rel

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/getHotelFacilityRel
uat	https://dscp-uat.hn12301.net/manage-api/hotel/getHotelFacilityRel
pro	https://dscp-uat.hn12301.net/manage-api/hotel/getHotelFacilityRel	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`hotel_facility_rel`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　HotelFacilityRelResponse　（object）

字段	类型	必填	取值/校验	表 / 列	说明
id	Long			`hotel_facility_rel`.`id`	id

示例

请求示例（自动生成，仅结构参考）

POST /hotel/getHotelFacilityRel

{
  "body": {
    "id": 1
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": 1
  }
}

处理逻辑

逻辑摘要查询详情（hotelFacilityRelService.get）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /hotel/queryHotelFacilityRelList 未使用管理后台 #

酒店设施关联表-列表查询 · HotelFacilityRelController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelFacilityRelController#queryHotelFacilityRelList
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_facility_rel

ControllerHotelFacilityRelController#queryHotelFacilityRelList

转换BeanUtils.map → HotelFacilityRelQuery

ServiceHotelFacilityRelService#queryList （HotelFacilityRelServiceImpl）

MapperHotelFacilityRelMapper#selectList ⇒ 表 hotel_facility_rel

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/queryHotelFacilityRelList
uat	https://dscp-uat.hn12301.net/manage-api/hotel/queryHotelFacilityRelList
pro	https://dscp-uat.hn12301.net/manage-api/hotel/queryHotelFacilityRelList	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HotelFacilityRelListRequest

字段	类型	必填	取值/校验	表 / 列	说明
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　List<HotelFacilityRelResponse>　（list）

字段	类型	必填	取值/校验	表 / 列	说明
[ ]	array			—	列表，元素结构见下
id	Long			`hotel_facility_rel`.`id`	id

示例

请求示例（自动生成，仅结构参考）

POST /hotel/queryHotelFacilityRelList

{
  "body": {
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "id": 1
    }
  ]
}

处理逻辑

逻辑摘要列表查询（hotelFacilityRelService.queryList）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /hotel/queryHotelFacilityRelPage 未使用管理后台 #

酒店设施关联表-分页查询 · HotelFacilityRelController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelFacilityRelController#queryHotelFacilityRelPage
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_facility_rel

ControllerHotelFacilityRelController#queryHotelFacilityRelPage

转换BeanUtils.map → HotelFacilityRelQuery

ServiceHotelFacilityRelService#queryPage （HotelFacilityRelServiceImpl）

MapperHotelFacilityRelMapper#selectPage ⇒ 表 hotel_facility_rel

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/queryHotelFacilityRelPage
uat	https://dscp-uat.hn12301.net/manage-api/hotel/queryHotelFacilityRelPage
pro	https://dscp-uat.hn12301.net/manage-api/hotel/queryHotelFacilityRelPage	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HotelFacilityRelPageRequest

字段	类型	必填	取值/校验	表 / 列	说明
pageNum	Integer	否		—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否		—	每页条数（继承自框架分页基类 AbstractPageRequest）
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　PageInfo<HotelFacilityRelResponse>　（page）

字段	类型	表 / 列	说明
list / records	array	—	分页列表，元素结构见下
total	long	—	总条数（PageInfo）
id	Long	`hotel_facility_rel`.`id`	id

示例

请求示例（自动生成，仅结构参考）

POST /hotel/queryHotelFacilityRelPage

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1
      }
    ],
    "total": 0
  }
}

处理逻辑

逻辑摘要分页查询（hotelFacilityRelService.queryPage）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /hotel/updateHotelFacilityRel 未使用管理后台 #

酒店设施关联表-更新 · HotelFacilityRelController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelFacilityRelController#updateHotelFacilityRel
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_facility_rel

ControllerHotelFacilityRelController#updateHotelFacilityRel

转换BeanUtils.map → HotelFacilityRel ⇒ 表 hotel_facility_rel

ServiceHotelFacilityRelService#update （HotelFacilityRelServiceImpl）

MapperHotelFacilityRelMapper#updateById ⇒ 表 hotel_facility_rel

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/updateHotelFacilityRel
uat	https://dscp-uat.hn12301.net/manage-api/hotel/updateHotelFacilityRel
pro	https://dscp-uat.hn12301.net/manage-api/hotel/updateHotelFacilityRel	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HotelFacilityRelUpdateRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long			`hotel_facility_rel`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /hotel/updateHotelFacilityRel

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志hotel / 更新设施关联

逻辑摘要更新（hotelFacilityRelService.update）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

HotelFacilityTemplateController 5/7 在用

POST /hotel/addHotelFacilityTemplate 在用管理后台 #

设施模板表-新增 · HotelFacilityTemplateController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelFacilityTemplateController#addHotelFacilityTemplate
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_facility_template

ControllerHotelFacilityTemplateController#addHotelFacilityTemplate

ServiceHotelFacilityTemplateService#add （HotelFacilityTemplateServiceImpl）

MapperHotelFacilityTemplateMapper#insert ⇒ 表 hotel_facility_template

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 1

SessionUserService.getSessionUser

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/addHotelFacilityTemplate
uat	https://dscp-uat.hn12301.net/manage-api/hotel/addHotelFacilityTemplate
pro	https://dscp-uat.hn12301.net/manage-api/hotel/addHotelFacilityTemplate	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HotelFacilityTemplateTreeAddRequest

字段	类型	必填	取值/校验	表 / 列	说明
name	String	是	必填	`hotel_facility_template`.`name`	模板名称
type	HotelTemplateType	是	1酒店设施2酒店政策3其他4房型设施5房型政策	`hotel_facility_template`.`type`	模板类型
details	List<FacilityDetailTree>			—	设施明细树形结构

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /hotel/addHotelFacilityTemplate

{
  "body": {
    "name": "",
    "type": "1",
    "details": ""
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志hotel / 新增设施模板

逻辑摘要调用 builder（HotelFacilityTemplate.builder）；查询详情（sessionUserService.getSessionUser）；新增（hotelFacilityTemplateService.add）

内联注释

1. 保存模板基本信息
2. 递归保存设施明细

前端调用方

dscp-html-manage addHotelFacilityTemplate exact

POST /hotel/deleteHotelFacilityTemplate 在用管理后台 #

设施模板表-删除 · HotelFacilityTemplateController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelFacilityTemplateController#deleteHotelFacilityTemplate
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_facility_template

ControllerHotelFacilityTemplateController#deleteHotelFacilityTemplate

ServiceHotelFacilityTemplateService#delete （HotelFacilityTemplateServiceImpl）

MapperHotelFacilityTemplateMapper#deleteById ⇒ 表 hotel_facility_template

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/deleteHotelFacilityTemplate
uat	https://dscp-uat.hn12301.net/manage-api/hotel/deleteHotelFacilityTemplate
pro	https://dscp-uat.hn12301.net/manage-api/hotel/deleteHotelFacilityTemplate	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`hotel_facility_template`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /hotel/deleteHotelFacilityTemplate

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志hotel / 删除设施模板

逻辑摘要删除（hotelFacilityTemplateService.delete）；调用 builder（HotelFacilityTemplate.builder）

前端调用方

dscp-html-manage deleteHotelFacilityTemplate exact

POST /hotel/getHotelFacilityTemplate 在用管理后台 #

设施模板表-详情 · HotelFacilityTemplateController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelFacilityTemplateController#getHotelFacilityTemplate
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_facility_template

ControllerHotelFacilityTemplateController#getHotelFacilityTemplate

ServiceHotelFacilityTemplateService#get （HotelFacilityTemplateServiceImpl）

MapperHotelFacilityTemplateMapper#selectById ⇒ 表 hotel_facility_template

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/getHotelFacilityTemplate
uat	https://dscp-uat.hn12301.net/manage-api/hotel/getHotelFacilityTemplate
pro	https://dscp-uat.hn12301.net/manage-api/hotel/getHotelFacilityTemplate	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`hotel_facility_template`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　HotelFacilityTemplateResponse　（object）

字段	类型	取值/校验	表 / 列	说明
id	Long		`hotel_facility_template`.`id`	id
name	String		`hotel_facility_template`.`name`	模板名称
type	HotelTemplateType	1酒店设施2酒店政策3其他4房型设施5房型政策	`hotel_facility_template`.`type`	模板类型(枚举:TemplateType)，1酒店设施，2酒店政策，3其他，4房型设施
isDeleted	Boolean		`hotel_facility_template`.`is_deleted`	是否删除(0否，1是)
createdBy	Long		`hotel_facility_template`.`created_by`	创建人ID
createdTime	Date		`hotel_facility_template`.`created_time`	创建时间
updatedBy	Long		`hotel_facility_template`.`updated_by`	更新人ID
updatedTime	Date		`hotel_facility_template`.`updated_time`	更新时间
details	List<HotelFacilityTemplateDetailResponse>		—
details[].id	Long		`hotel_facility_template`.`id`	模板明细ID
details[].templateId	Long		—	模板ID
details[].parentId	Long		—	父级ID，一级分类为0
details[].name	String		`hotel_facility_template`.`name`	设施名称
details[].level	Integer		—	层级(1一级，2二级，3三级)
details[].sort	Integer		—	排序号
details[].isDeleted	Boolean		`hotel_facility_template`.`is_deleted`	是否删除(0否 1是)
details[].createdBy	Long		`hotel_facility_template`.`created_by`	创建人ID
details[].createdTime	Date		`hotel_facility_template`.`created_time`	创建时间
details[].updatedBy	Long		`hotel_facility_template`.`updated_by`	更新人ID
details[].updatedTime	Date		`hotel_facility_template`.`updated_time`	更新时间

示例

请求示例（自动生成，仅结构参考）

POST /hotel/getHotelFacilityTemplate

{
  "body": {
    "id": 1
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": 1,
    "name": "",
    "type": "1",
    "isDeleted": false,
    "createdBy": 0,
    "createdTime": "2026-01-01 12:00:00",
    "updatedBy": 0,
    "updatedTime": "2026-01-01 12:00:00",
    "details": [
      {
        "id": 1,
        "templateId": 1,
        "parentId": 1,
        "name": "",
        "level": 0,
        "sort": 0,
        "isDeleted": false,
        "createdBy": 0,
        "createdTime": "2026-01-01 12:00:00",
        "updatedBy": 0,
        "updatedTime": "2026-01-01 12:00:00"
      }
    ]
  }
}

处理逻辑

逻辑摘要查询详情（hotelFacilityTemplateService.get）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

dscp-html-manage getHotelFacilityTemplate exact

POST /hotel/getHotelTemplateDetail 在用管理后台 #

设施模板明细 · HotelFacilityTemplateController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelFacilityTemplateController#getHotelTemplateDetail
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_facility_templatehotel_facility_template_detail

ControllerHotelFacilityTemplateController#getHotelTemplateDetail

ServiceHotelFacilityTemplateService#get （HotelFacilityTemplateServiceImpl）

MapperHotelFacilityTemplateMapper#selectById ⇒ 表 hotel_facility_template

ServiceHotelFacilityTemplateDetailService#queryList （HotelFacilityTemplateDetailServiceImpl）

MapperHotelFacilityTemplateDetailMapper#selectList ⇒ 表 hotel_facility_template_detail

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/getHotelTemplateDetail
uat	https://dscp-uat.hn12301.net/manage-api/hotel/getHotelTemplateDetail
pro	https://dscp-uat.hn12301.net/manage-api/hotel/getHotelTemplateDetail	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`hotel_facility_template`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　HotelFacilityTemplateTreeResponse　（object）

字段	类型	取值/校验	表 / 列	说明
id	Long		`hotel_facility_template`.`id`	id
name	String		`hotel_facility_template`.`name`	模板名称
type	HotelTemplateType	1酒店设施2酒店政策3其他4房型设施5房型政策	`hotel_facility_template`.`type`	模板类型
details	List<FacilityDetailTree>		—	设施明细树形结构

示例

请求示例（自动生成，仅结构参考）

POST /hotel/getHotelTemplateDetail

{
  "body": {
    "id": 1
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": 1,
    "name": "",
    "type": "1",
    "details": ""
  }
}

处理逻辑

逻辑摘要查询详情（hotelFacilityTemplateService.get）；列表查询（hotelFacilityTemplateDetailService.queryList）

内联注释

1. 查询模板基本信息
2. 查询该模板下的所有设施明细
3. 构建返回数据
4. 构建树形结构

前端调用方

dscp-html-manage getHotelTemplateDetail exact

POST /hotel/queryHotelFacilityTemplateList 未使用管理后台 #

设施模板表-列表查询 · HotelFacilityTemplateController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelFacilityTemplateController#queryHotelFacilityTemplateList
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_facility_template

ControllerHotelFacilityTemplateController#queryHotelFacilityTemplateList

转换BeanUtils.map → HotelFacilityTemplateQuery

ServiceHotelFacilityTemplateService#queryList （HotelFacilityTemplateServiceImpl）

MapperHotelFacilityTemplateMapper#selectList ⇒ 表 hotel_facility_template

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/queryHotelFacilityTemplateList
uat	https://dscp-uat.hn12301.net/manage-api/hotel/queryHotelFacilityTemplateList
pro	https://dscp-uat.hn12301.net/manage-api/hotel/queryHotelFacilityTemplateList	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HotelFacilityTemplateListRequest

字段	类型	必填	取值/校验	表 / 列	说明
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　List<HotelFacilityTemplateResponse>　（list）

字段	类型	取值/校验	表 / 列	说明
[ ]	array		—	列表，元素结构见下
id	Long		`hotel_facility_template`.`id`	id
name	String		`hotel_facility_template`.`name`	模板名称
type	HotelTemplateType	1酒店设施2酒店政策3其他4房型设施5房型政策	`hotel_facility_template`.`type`	模板类型(枚举:TemplateType)，1酒店设施，2酒店政策，3其他，4房型设施
isDeleted	Boolean		`hotel_facility_template`.`is_deleted`	是否删除(0否，1是)
createdBy	Long		`hotel_facility_template`.`created_by`	创建人ID
createdTime	Date		`hotel_facility_template`.`created_time`	创建时间
updatedBy	Long		`hotel_facility_template`.`updated_by`	更新人ID
updatedTime	Date		`hotel_facility_template`.`updated_time`	更新时间
details	List<HotelFacilityTemplateDetailResponse>		—
details[].id	Long		`hotel_facility_template`.`id`	模板明细ID
details[].templateId	Long		—	模板ID
details[].parentId	Long		—	父级ID，一级分类为0
details[].name	String		`hotel_facility_template`.`name`	设施名称
details[].level	Integer		—	层级(1一级，2二级，3三级)
details[].sort	Integer		—	排序号
details[].isDeleted	Boolean		`hotel_facility_template`.`is_deleted`	是否删除(0否 1是)
details[].createdBy	Long		`hotel_facility_template`.`created_by`	创建人ID
details[].createdTime	Date		`hotel_facility_template`.`created_time`	创建时间
details[].updatedBy	Long		`hotel_facility_template`.`updated_by`	更新人ID
details[].updatedTime	Date		`hotel_facility_template`.`updated_time`	更新时间

示例

请求示例（自动生成，仅结构参考）

POST /hotel/queryHotelFacilityTemplateList

{
  "body": {
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "id": 1,
      "name": "",
      "type": "1",
      "isDeleted": false,
      "createdBy": 0,
      "createdTime": "2026-01-01 12:00:00",
      "updatedBy": 0,
      "updatedTime": "2026-01-01 12:00:00",
      "details": [
        {
          "id": 1,
          "templateId": 1,
          "parentId": 1,
          "name": "",
          "level": 0,
          "sort": 0,
          "isDeleted": false,
          "createdBy": 0,
          "createdTime": "2026-01-01 12:00:00",
          "updatedBy": 0,
          "updatedTime": "2026-01-01 12:00:00"
        }
      ]
    }
  ]
}

处理逻辑

逻辑摘要列表查询（hotelFacilityTemplateService.queryList）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /hotel/queryHotelFacilityTemplatePage 在用管理后台 #

设施模板表-分页查询 · HotelFacilityTemplateController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelFacilityTemplateController#queryHotelFacilityTemplatePage
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_facility_template

ControllerHotelFacilityTemplateController#queryHotelFacilityTemplatePage

转换BeanUtils.map → HotelFacilityTemplateQuery

ServiceHotelFacilityTemplateService#queryPage （HotelFacilityTemplateServiceImpl）

MapperHotelFacilityTemplateMapper#selectPage ⇒ 表 hotel_facility_template

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/queryHotelFacilityTemplatePage
uat	https://dscp-uat.hn12301.net/manage-api/hotel/queryHotelFacilityTemplatePage
pro	https://dscp-uat.hn12301.net/manage-api/hotel/queryHotelFacilityTemplatePage	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HotelFacilityTemplatePageRequest

字段	类型	必填	取值/校验	表 / 列	说明
pageNum	Integer	否		—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否		—	每页条数（继承自框架分页基类 AbstractPageRequest）
name	String			`hotel_facility_template`.`name`
type	HotelTemplateType		1酒店设施2酒店政策3其他4房型设施5房型政策	`hotel_facility_template`.`type`
types	List<HotelTemplateType>			—
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　PageInfo<HotelFacilityTemplateResponse>　（page）

字段	类型	取值/校验	表 / 列	说明
list / records	array		—	分页列表，元素结构见下
total	long		—	总条数（PageInfo）
id	Long		`hotel_facility_template`.`id`	id
name	String		`hotel_facility_template`.`name`	模板名称
type	HotelTemplateType	1酒店设施2酒店政策3其他4房型设施5房型政策	`hotel_facility_template`.`type`	模板类型(枚举:TemplateType)，1酒店设施，2酒店政策，3其他，4房型设施
isDeleted	Boolean		`hotel_facility_template`.`is_deleted`	是否删除(0否，1是)
createdBy	Long		`hotel_facility_template`.`created_by`	创建人ID
createdTime	Date		`hotel_facility_template`.`created_time`	创建时间
updatedBy	Long		`hotel_facility_template`.`updated_by`	更新人ID
updatedTime	Date		`hotel_facility_template`.`updated_time`	更新时间
details	List<HotelFacilityTemplateDetailResponse>		—
details[].id	Long		`hotel_facility_template`.`id`	模板明细ID
details[].templateId	Long		—	模板ID
details[].parentId	Long		—	父级ID，一级分类为0
details[].name	String		`hotel_facility_template`.`name`	设施名称
details[].level	Integer		—	层级(1一级，2二级，3三级)
details[].sort	Integer		—	排序号
details[].isDeleted	Boolean		`hotel_facility_template`.`is_deleted`	是否删除(0否 1是)
details[].createdBy	Long		`hotel_facility_template`.`created_by`	创建人ID
details[].createdTime	Date		`hotel_facility_template`.`created_time`	创建时间
details[].updatedBy	Long		`hotel_facility_template`.`updated_by`	更新人ID
details[].updatedTime	Date		`hotel_facility_template`.`updated_time`	更新时间

示例

请求示例（自动生成，仅结构参考）

POST /hotel/queryHotelFacilityTemplatePage

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "name": "",
    "type": "1",
    "types": "",
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1,
        "name": "",
        "type": "1",
        "isDeleted": false,
        "createdBy": 0,
        "createdTime": "2026-01-01 12:00:00",
        "updatedBy": 0,
        "updatedTime": "2026-01-01 12:00:00",
        "details": [
          {
            "id": 1,
            "templateId": 1,
            "parentId": 1,
            "name": "",
            "level": 0,
            "sort": 0,
            "isDeleted": false,
            "createdBy": 0,
            "createdTime": "2026-01-01 12:00:00",
            "updatedBy": 0,
            "updatedTime": "2026-01-01 12:00:00"
          }
        ]
      }
    ],
    "total": 0
  }
}

处理逻辑

逻辑摘要分页查询（hotelFacilityTemplateService.queryPage）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

dscp-html-manage queryHotelFacilityTemplatePage exact

POST /hotel/updateHotelFacilityTemplate 未使用管理后台 #

设施模板表-更新 · HotelFacilityTemplateController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelFacilityTemplateController#updateHotelFacilityTemplate
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_facility_template

ControllerHotelFacilityTemplateController#updateHotelFacilityTemplate

转换BeanUtils.map → HotelFacilityTemplate ⇒ 表 hotel_facility_template

ServiceHotelFacilityTemplateService#update （HotelFacilityTemplateServiceImpl）

MapperHotelFacilityTemplateMapper#updateById ⇒ 表 hotel_facility_template

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/updateHotelFacilityTemplate
uat	https://dscp-uat.hn12301.net/manage-api/hotel/updateHotelFacilityTemplate
pro	https://dscp-uat.hn12301.net/manage-api/hotel/updateHotelFacilityTemplate	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HotelFacilityTemplateUpdateRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long			`hotel_facility_template`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /hotel/updateHotelFacilityTemplate

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志hotel / 更新设施模板

逻辑摘要更新（hotelFacilityTemplateService.update）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

HotelFacilityTemplateDetailController 0/6 在用

POST /hotel/addHotelFacilityTemplateDetail 未使用管理后台 #

酒店设施模板明细表-新增 · HotelFacilityTemplateDetailController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelFacilityTemplateDetailController#addHotelFacilityTemplateDetail
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_facility_template_detail

ControllerHotelFacilityTemplateDetailController#addHotelFacilityTemplateDetail

转换BeanUtils.map → HotelFacilityTemplateDetail ⇒ 表 hotel_facility_template_detail

ServiceHotelFacilityTemplateDetailService#add （HotelFacilityTemplateDetailServiceImpl）

MapperHotelFacilityTemplateDetailMapper#insert ⇒ 表 hotel_facility_template_detail

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/addHotelFacilityTemplateDetail
uat	https://dscp-uat.hn12301.net/manage-api/hotel/addHotelFacilityTemplateDetail
pro	https://dscp-uat.hn12301.net/manage-api/hotel/addHotelFacilityTemplateDetail	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HotelFacilityTemplateDetailAddRequest

字段	类型	表 / 列	说明
templateId	Long	`hotel_facility_template_detail`.`template_id`	模板ID
parentId	Long	`hotel_facility_template_detail`.`parent_id`	父级ID，一级分类为0
name	String	`hotel_facility_template_detail`.`name`	设施名称
level	Integer	`hotel_facility_template_detail`.`level`	层级(1一级，2二级，3三级)
sort	Integer	`hotel_facility_template_detail`.`sort`	排序号

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /hotel/addHotelFacilityTemplateDetail

{
  "body": {
    "templateId": 1,
    "parentId": 1,
    "name": "",
    "level": 0,
    "sort": 0
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志hotel / 新增设施模板明细

逻辑摘要新增（hotelFacilityTemplateDetailService.add）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /hotel/deleteHotelFacilityTemplateDetail 未使用管理后台 #

酒店设施模板明细表-删除 · HotelFacilityTemplateDetailController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelFacilityTemplateDetailController#deleteHotelFacilityTemplateDetail
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_facility_template_detail

ControllerHotelFacilityTemplateDetailController#deleteHotelFacilityTemplateDetail

ServiceHotelFacilityTemplateDetailService#delete （HotelFacilityTemplateDetailServiceImpl）

MapperHotelFacilityTemplateDetailMapper#deleteById ⇒ 表 hotel_facility_template_detail

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/deleteHotelFacilityTemplateDetail
uat	https://dscp-uat.hn12301.net/manage-api/hotel/deleteHotelFacilityTemplateDetail
pro	https://dscp-uat.hn12301.net/manage-api/hotel/deleteHotelFacilityTemplateDetail	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`hotel_facility_template_detail`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /hotel/deleteHotelFacilityTemplateDetail

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志hotel / 删除设施模板明细

逻辑摘要删除（hotelFacilityTemplateDetailService.delete）

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /hotel/getHotelFacilityTemplateDetail 未使用管理后台 #

酒店设施模板明细表-详情 · HotelFacilityTemplateDetailController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelFacilityTemplateDetailController#getHotelFacilityTemplateDetail
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_facility_template_detail

ControllerHotelFacilityTemplateDetailController#getHotelFacilityTemplateDetail

ServiceHotelFacilityTemplateDetailService#get （HotelFacilityTemplateDetailServiceImpl）

MapperHotelFacilityTemplateDetailMapper#selectById ⇒ 表 hotel_facility_template_detail

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/getHotelFacilityTemplateDetail
uat	https://dscp-uat.hn12301.net/manage-api/hotel/getHotelFacilityTemplateDetail
pro	https://dscp-uat.hn12301.net/manage-api/hotel/getHotelFacilityTemplateDetail	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`hotel_facility_template_detail`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　HotelFacilityTemplateDetailResponse　（object）

字段	类型	表 / 列	说明
id	Long	`hotel_facility_template_detail`.`id`	模板明细ID
templateId	Long	`hotel_facility_template_detail`.`template_id`	模板ID
parentId	Long	`hotel_facility_template_detail`.`parent_id`	父级ID，一级分类为0
name	String	`hotel_facility_template_detail`.`name`	设施名称
level	Integer	`hotel_facility_template_detail`.`level`	层级(1一级，2二级，3三级)
sort	Integer	`hotel_facility_template_detail`.`sort`	排序号
isDeleted	Boolean	`hotel_facility_template_detail`.`is_deleted`	是否删除(0否 1是)
createdBy	Long	`hotel_facility_template_detail`.`created_by`	创建人ID
createdTime	Date	`hotel_facility_template_detail`.`created_time`	创建时间
updatedBy	Long	`hotel_facility_template_detail`.`updated_by`	更新人ID
updatedTime	Date	`hotel_facility_template_detail`.`updated_time`	更新时间

示例

请求示例（自动生成，仅结构参考）

POST /hotel/getHotelFacilityTemplateDetail

{
  "body": {
    "id": 1
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": 1,
    "templateId": 1,
    "parentId": 1,
    "name": "",
    "level": 0,
    "sort": 0,
    "isDeleted": false,
    "createdBy": 0,
    "createdTime": "2026-01-01 12:00:00",
    "updatedBy": 0,
    "updatedTime": "2026-01-01 12:00:00"
  }
}

处理逻辑

逻辑摘要查询详情（hotelFacilityTemplateDetailService.get）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /hotel/queryHotelFacilityTemplateDetailList 未使用管理后台 #

酒店设施模板明细表-列表查询 · HotelFacilityTemplateDetailController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelFacilityTemplateDetailController#queryHotelFacilityTemplateDetailList
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_facility_template_detail

ControllerHotelFacilityTemplateDetailController#queryHotelFacilityTemplateDetailList

转换BeanUtils.map → HotelFacilityTemplateDetailQuery

ServiceHotelFacilityTemplateDetailService#queryList （HotelFacilityTemplateDetailServiceImpl）

MapperHotelFacilityTemplateDetailMapper#selectList ⇒ 表 hotel_facility_template_detail

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/queryHotelFacilityTemplateDetailList
uat	https://dscp-uat.hn12301.net/manage-api/hotel/queryHotelFacilityTemplateDetailList
pro	https://dscp-uat.hn12301.net/manage-api/hotel/queryHotelFacilityTemplateDetailList	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HotelFacilityTemplateDetailListRequest

字段	类型	必填	取值/校验	表 / 列	说明
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　List<HotelFacilityTemplateDetailResponse>　（list）

字段	类型	表 / 列	说明
[ ]	array	—	列表，元素结构见下
id	Long	`hotel_facility_template_detail`.`id`	模板明细ID
templateId	Long	`hotel_facility_template_detail`.`template_id`	模板ID
parentId	Long	`hotel_facility_template_detail`.`parent_id`	父级ID，一级分类为0
name	String	`hotel_facility_template_detail`.`name`	设施名称
level	Integer	`hotel_facility_template_detail`.`level`	层级(1一级，2二级，3三级)
sort	Integer	`hotel_facility_template_detail`.`sort`	排序号
isDeleted	Boolean	`hotel_facility_template_detail`.`is_deleted`	是否删除(0否 1是)
createdBy	Long	`hotel_facility_template_detail`.`created_by`	创建人ID
createdTime	Date	`hotel_facility_template_detail`.`created_time`	创建时间
updatedBy	Long	`hotel_facility_template_detail`.`updated_by`	更新人ID
updatedTime	Date	`hotel_facility_template_detail`.`updated_time`	更新时间

示例

请求示例（自动生成，仅结构参考）

POST /hotel/queryHotelFacilityTemplateDetailList

{
  "body": {
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "id": 1,
      "templateId": 1,
      "parentId": 1,
      "name": "",
      "level": 0,
      "sort": 0,
      "isDeleted": false,
      "createdBy": 0,
      "createdTime": "2026-01-01 12:00:00",
      "updatedBy": 0,
      "updatedTime": "2026-01-01 12:00:00"
    }
  ]
}

处理逻辑

逻辑摘要列表查询（hotelFacilityTemplateDetailService.queryList）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /hotel/queryHotelFacilityTemplateDetailPage 未使用管理后台 #

酒店设施模板明细表-分页查询 · HotelFacilityTemplateDetailController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelFacilityTemplateDetailController#queryHotelFacilityTemplateDetailPage
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_facility_template_detail

ControllerHotelFacilityTemplateDetailController#queryHotelFacilityTemplateDetailPage

转换BeanUtils.map → HotelFacilityTemplateDetailQuery

ServiceHotelFacilityTemplateDetailService#queryPage （HotelFacilityTemplateDetailServiceImpl）

MapperHotelFacilityTemplateDetailMapper#selectPage ⇒ 表 hotel_facility_template_detail

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/queryHotelFacilityTemplateDetailPage
uat	https://dscp-uat.hn12301.net/manage-api/hotel/queryHotelFacilityTemplateDetailPage
pro	https://dscp-uat.hn12301.net/manage-api/hotel/queryHotelFacilityTemplateDetailPage	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HotelFacilityTemplateDetailPageRequest

字段	类型	必填	取值/校验	表 / 列	说明
pageNum	Integer	否		—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否		—	每页条数（继承自框架分页基类 AbstractPageRequest）
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　PageInfo<HotelFacilityTemplateDetailResponse>　（page）

字段	类型	表 / 列	说明
list / records	array	—	分页列表，元素结构见下
total	long	—	总条数（PageInfo）
id	Long	`hotel_facility_template_detail`.`id`	模板明细ID
templateId	Long	`hotel_facility_template_detail`.`template_id`	模板ID
parentId	Long	`hotel_facility_template_detail`.`parent_id`	父级ID，一级分类为0
name	String	`hotel_facility_template_detail`.`name`	设施名称
level	Integer	`hotel_facility_template_detail`.`level`	层级(1一级，2二级，3三级)
sort	Integer	`hotel_facility_template_detail`.`sort`	排序号
isDeleted	Boolean	`hotel_facility_template_detail`.`is_deleted`	是否删除(0否 1是)
createdBy	Long	`hotel_facility_template_detail`.`created_by`	创建人ID
createdTime	Date	`hotel_facility_template_detail`.`created_time`	创建时间
updatedBy	Long	`hotel_facility_template_detail`.`updated_by`	更新人ID
updatedTime	Date	`hotel_facility_template_detail`.`updated_time`	更新时间

示例

请求示例（自动生成，仅结构参考）

POST /hotel/queryHotelFacilityTemplateDetailPage

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1,
        "templateId": 1,
        "parentId": 1,
        "name": "",
        "level": 0,
        "sort": 0,
        "isDeleted": false,
        "createdBy": 0,
        "createdTime": "2026-01-01 12:00:00",
        "updatedBy": 0,
        "updatedTime": "2026-01-01 12:00:00"
      }
    ],
    "total": 0
  }
}

处理逻辑

逻辑摘要分页查询（hotelFacilityTemplateDetailService.queryPage）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /hotel/updateHotelFacilityTemplateDetail 未使用管理后台 #

酒店设施模板明细表-更新 · HotelFacilityTemplateDetailController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelFacilityTemplateDetailController#updateHotelFacilityTemplateDetail
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_facility_template_detail

ControllerHotelFacilityTemplateDetailController#updateHotelFacilityTemplateDetail

转换BeanUtils.map → HotelFacilityTemplateDetail ⇒ 表 hotel_facility_template_detail

ServiceHotelFacilityTemplateDetailService#update （HotelFacilityTemplateDetailServiceImpl）

MapperHotelFacilityTemplateDetailMapper#updateById ⇒ 表 hotel_facility_template_detail

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/updateHotelFacilityTemplateDetail
uat	https://dscp-uat.hn12301.net/manage-api/hotel/updateHotelFacilityTemplateDetail
pro	https://dscp-uat.hn12301.net/manage-api/hotel/updateHotelFacilityTemplateDetail	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HotelFacilityTemplateDetailUpdateRequest

字段	类型	表 / 列	说明
id	Long	`hotel_facility_template_detail`.`id`	模板明细ID
templateId	Long	`hotel_facility_template_detail`.`template_id`	模板ID
parentId	Long	`hotel_facility_template_detail`.`parent_id`	父级ID，一级分类为0
name	String	`hotel_facility_template_detail`.`name`	设施名称
level	Integer	`hotel_facility_template_detail`.`level`	层级(1一级，2二级，3三级)
sort	Integer	`hotel_facility_template_detail`.`sort`	排序号

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /hotel/updateHotelFacilityTemplateDetail

{
  "body": {
    "id": 1,
    "templateId": 1,
    "parentId": 1,
    "name": "",
    "level": 0,
    "sort": 0
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志hotel / 更新设施模板明细

逻辑摘要更新（hotelFacilityTemplateDetailService.update）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

HotelInfoController 9/9 在用

POST /hotel/addHotelInfo 在用管理后台 #

酒店信息表-新增 · HotelInfoController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelInfoController#addHotelInfo
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_infoshop

ControllerHotelInfoController#addHotelInfo

转换BeanUtils.map → HotelInfo ⇒ 表 hotel_info

ServiceShopService#addShop （ShopServiceImpl）

转换BeanUtils.map → Shop ⇒ 表 shop

ServiceHotelInfoService#add （HotelInfoServiceImpl）

MapperHotelInfoMapper#insert ⇒ 表 hotel_info

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 2

ChaosTransactionTemplate.executeMerchantCache.get

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/addHotelInfo
uat	https://dscp-uat.hn12301.net/manage-api/hotel/addHotelInfo
pro	https://dscp-uat.hn12301.net/manage-api/hotel/addHotelInfo	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HotelInfoAddRequest

字段	类型	必填	取值/校验	表 / 列	说明
merchantId	Long	是	必填	`hotel_info`.`merchant_id`	商户ID
shopId	Long			`hotel_info`.`shop_id`	商铺ID
name	String	是	必填	`hotel_info`.`name`	酒店名称
grade	HotelGrade	是	1二星及以下/经济2三星/舒适3四星/高档4五星/豪华5奢华	`hotel_info`.`grade`	酒店等级
type	HotelType		1酒店2民宿3公寓4青年旅社5别墅6度假村7客栈8农家乐+4	`hotel_info`.`type`
openingYear	Integer			`hotel_info`.`opening_year`	开业年份
roomCount	Integer			`hotel_info`.`room_count`	房间数量
phone	String			`hotel_info`.`phone`	联系电话
coverImage	String			`hotel_info`.`cover_image`	封面图片
address	String			`hotel_info`.`address`	地址
landmark	String			`hotel_info`.`landmark`	地标
provinceId	Long			`hotel_info`.`province_id`	省id
cityId	Long			`hotel_info`.`city_id`	市id
districtId	Long			`hotel_info`.`district_id`	区县id
longitude	BigDecimal			`hotel_info`.`longitude`	经度
latitude	BigDecimal			`hotel_info`.`latitude`	纬度
highlights	String			`hotel_info`.`highlights`	亮点介绍
tags	String			`hotel_info`.`tags`	酒店标签
locationTags	String			`hotel_info`.`location_tags`	位置标签
images	String			`hotel_info`.`images`	酒店图片，多个用逗号分隔
status	Integer			`hotel_info`.`status`	状态(0正常 1停用)
facilities	List<FacilityTree>			—	设施列表

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /hotel/addHotelInfo

{
  "body": {
    "merchantId": 1,
    "shopId": 1,
    "name": "",
    "grade": "1",
    "type": "1",
    "openingYear": 0,
    "roomCount": 0,
    "phone": "13800000000",
    "coverImage": "",
    "address": "",
    "landmark": "",
    "provinceId": 1,
    "cityId": 1,
    "districtId": 1,
    "longitude": 0,
    "latitude": 0,
    "highlights": "",
    "tags": "",
    "locationTags": "",
    "images": "",
    "status": 0,
    "facilities": ""
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志hotel / 新增酒店

逻辑摘要新增（shopService.addShop）；新增（hotelInfoService.add）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

商铺信息
1. 保存酒店基本信息
2. 递归保存设施信息

前端调用方

dscp-html-manage addHotelInfo exact

POST /hotel/deleteHotelInfo 在用管理后台 #

酒店信息表-删除 · HotelInfoController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelInfoController#deleteHotelInfo
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_info

ControllerHotelInfoController#deleteHotelInfo

ServiceHotelInfoService#delete （HotelInfoServiceImpl）

MapperHotelInfoMapper#deleteById ⇒ 表 hotel_info

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/deleteHotelInfo
uat	https://dscp-uat.hn12301.net/manage-api/hotel/deleteHotelInfo
pro	https://dscp-uat.hn12301.net/manage-api/hotel/deleteHotelInfo	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`hotel_info`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /hotel/deleteHotelInfo

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志hotel / 删除酒店

逻辑摘要删除（hotelInfoService.delete）

前端调用方

dscp-html-manage deleteHotel exact

POST /hotel/getHotelIdByMerchantIdAndShopId 在用管理后台 #

根据merchantId shopId查hotel · HotelInfoController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelInfoController#getHotelIdByMerchantIdAndShopId
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_info

ControllerHotelInfoController#getHotelIdByMerchantIdAndShopId

ServiceHotelInfoService#get （HotelInfoServiceImpl）

MapperHotelInfoMapper#selectById ⇒ 表 hotel_info

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/getHotelIdByMerchantIdAndShopId
uat	https://dscp-uat.hn12301.net/manage-api/hotel/getHotelIdByMerchantIdAndShopId
pro	https://dscp-uat.hn12301.net/manage-api/hotel/getHotelIdByMerchantIdAndShopId	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HotelInfoPageRequest

字段	类型	必填	取值/校验	表 / 列	说明
pageNum	Integer	否		—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否		—	每页条数（继承自框架分页基类 AbstractPageRequest）
merchantId	Long			`hotel_info`.`merchant_id`	所属商户id，关联merchant表id
shopId	Long			`hotel_info`.`shop_id`	所属商铺id，关联shop表id
id	Long			`hotel_info`.`id`	酒店名称
name	String			`hotel_info`.`name`	酒店名称
grade	HotelGrade		1二星及以下/经济2三星/舒适3四星/高档4五星/豪华5奢华	`hotel_info`.`grade`
status	Integer			`hotel_info`.`status`	状态，0正常，1停用
roomFlag	Integer			—
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　HotelInfo　（object）

字段	类型	取值/校验	表 / 列	说明
id	Long		`hotel_info`.`id`	酒店ID
merchantId	Long		`hotel_info`.`merchant_id`	商户ID
shopId	Long		`hotel_info`.`shop_id`	店铺ID
name	String		`hotel_info`.`name`	酒店名称
grade	HotelGrade	1二星及以下/经济2三星/舒适3四星/高档4五星/豪华5奢华	`hotel_info`.`grade`	酒店等级(枚举:HotelGrade)，1二星及以下/经济，2三星/舒适，3四星/高档，4五星/豪华，5奢华
type	HotelType	1酒店2民宿3公寓4青年旅社5别墅6度假村7客栈8农家乐+4	`hotel_info`.`type`	酒店类型
status	Integer		`hotel_info`.`status`	状态(枚举:CommonStatus)，0正常，1停用
openingYear	Integer		`hotel_info`.`opening_year`	开业年份
roomCount	Integer		`hotel_info`.`room_count`	房间数量
phone	String		`hotel_info`.`phone`	联系电话
address	String		`hotel_info`.`address`	详细地址
landmark	String		`hotel_info`.`landmark`	地标
provinceId	Long		`hotel_info`.`province_id`	省id
cityId	Long		`hotel_info`.`city_id`	市id
districtId	Long		`hotel_info`.`district_id`	区县id
longitude	BigDecimal		`hotel_info`.`longitude`	经度
latitude	BigDecimal		`hotel_info`.`latitude`	纬度
coverImage	String		`hotel_info`.`cover_image`	主图URL
images	String		`hotel_info`.`images`	轮播图URL，多个用逗号分隔
tags	String		`hotel_info`.`tags`	酒店标签，多个用逗号分隔
locationTags	String		`hotel_info`.`location_tags`	位置描述标签，多个用逗号分隔
highlights	String		`hotel_info`.`highlights`	酒店亮点(富文本)
isDeleted	Boolean		`hotel_info`.`is_deleted`	是否删除(0否 1是)
createdBy	Long		`hotel_info`.`created_by`	创建人ID
createdTime	Date		`hotel_info`.`created_time`	创建时间
updatedBy	Long		`hotel_info`.`updated_by`	更新人ID
updatedTime	Date		`hotel_info`.`updated_time`	更新时间

示例

请求示例（自动生成，仅结构参考）

POST /hotel/getHotelIdByMerchantIdAndShopId

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "merchantId": 1,
    "shopId": 1,
    "id": 1,
    "name": "",
    "grade": "1",
    "status": 0,
    "roomFlag": 0,
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": 1,
    "merchantId": 1,
    "shopId": 1,
    "name": "",
    "grade": "1",
    "type": "1",
    "status": 0,
    "openingYear": 0,
    "roomCount": 0,
    "phone": "13800000000",
    "address": "",
    "landmark": "",
    "provinceId": 1,
    "cityId": 1,
    "districtId": 1,
    "longitude": 0,
    "latitude": 0,
    "coverImage": "",
    "images": "",
    "tags": "",
    "locationTags": "",
    "highlights": "",
    "isDeleted": false,
    "createdBy": 0,
    "createdTime": "2026-01-01 12:00:00",
    "updatedBy": 0,
    "updatedTime": "2026-01-01 12:00:00"
  }
}

处理逻辑

逻辑摘要查询详情（hotelInfoService.get）

前端调用方

dscp-html-manage getHotelIdByMerchantIdAndShopId exact

POST /hotel/getHotelInfo 在用管理后台 #

酒店信息表-详情 · HotelInfoController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelInfoController#getHotelInfo
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_infohotel_facility_relhotel_facility

ControllerHotelInfoController#getHotelInfo

转换BeanUtils.map → HotelInfoDetailResponse

ServiceHotelInfoService#get （HotelInfoServiceImpl）

MapperHotelInfoMapper#selectById ⇒ 表 hotel_info

ServiceHotelFacilityRelService#queryList （HotelFacilityRelServiceImpl）

MapperHotelFacilityRelMapper#selectList ⇒ 表 hotel_facility_rel

ServiceHotelFacilityService#queryList （HotelFacilityServiceImpl）

MapperHotelFacilityMapper#selectList ⇒ 表 hotel_facility

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/getHotelInfo
uat	https://dscp-uat.hn12301.net/manage-api/hotel/getHotelInfo
pro	https://dscp-uat.hn12301.net/manage-api/hotel/getHotelInfo	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`hotel_info`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　HotelInfoDetailResponse　（object）

字段	类型	取值/校验	表 / 列	说明
id	Long		`hotel_info`.`id`	id
merchantId	Long		`hotel_info`.`merchant_id`	商户ID
shopId	Long		`hotel_info`.`shop_id`	店铺ID
name	String		`hotel_info`.`name`	酒店名称
grade	HotelGrade	1二星及以下/经济2三星/舒适3四星/高档4五星/豪华5奢华	`hotel_info`.`grade`	酒店等级
type	HotelType	1酒店2民宿3公寓4青年旅社5别墅6度假村7客栈8农家乐+4	`hotel_info`.`type`
openingYear	Integer		`hotel_info`.`opening_year`	开业年份
roomCount	Integer		`hotel_info`.`room_count`	房间数量
phone	String		`hotel_info`.`phone`	联系电话
coverImage	String		`hotel_info`.`cover_image`	封面图片
address	String		`hotel_info`.`address`	地址
landmark	String		`hotel_info`.`landmark`	地标
provinceId	Long		`hotel_info`.`province_id`	省id
cityId	Long		`hotel_info`.`city_id`	市id
districtId	Long		`hotel_info`.`district_id`	区县id
longitude	BigDecimal		`hotel_info`.`longitude`	经度
latitude	BigDecimal		`hotel_info`.`latitude`	纬度
highlights	String		`hotel_info`.`highlights`	亮点介绍
tags	String		`hotel_info`.`tags`	酒店标签
locationTags	String		`hotel_info`.`location_tags`	位置标签
images	String		`hotel_info`.`images`	酒店图片，多个用逗号分隔
status	Integer		`hotel_info`.`status`	状态(0正常 1停用)
distance	BigDecimal		—
facilities	List<FacilityTree>		—	设施列表
nearbyHotel	List<HotelInfoResponse>		—	附件酒店
nearbyHotel[].id	Long		`hotel_info`.`id`	酒店ID
nearbyHotel[].name	String		`hotel_info`.`name`	酒店名称
nearbyHotel[].grade	HotelGrade	1二星及以下/经济2三星/舒适3四星/高档4五星/豪华5奢华	`hotel_info`.`grade`	酒店等级(枚举:HotelGrade)，1二星及以下/经济，2三星/舒适，3四星/高档，4五星/豪华，5奢华
nearbyHotel[].type	HotelType	1酒店2民宿3公寓4青年旅社5别墅6度假村7客栈8农家乐+4	`hotel_info`.`type`
nearbyHotel[].status	Integer		`hotel_info`.`status`	状态，0正常，1停用
nearbyHotel[].openingYear	Integer		`hotel_info`.`opening_year`	开业年份
nearbyHotel[].roomCount	Integer		`hotel_info`.`room_count`	房间数量
nearbyHotel[].roomTypeCount	Long		—	房型数量
nearbyHotel[].phone	String		`hotel_info`.`phone`	联系电话
nearbyHotel[].address	String		`hotel_info`.`address`	详细地址
nearbyHotel[].landmark	String		`hotel_info`.`landmark`	地标
nearbyHotel[].provinceId	Long		`hotel_info`.`province_id`	省id
nearbyHotel[].cityId	Long		`hotel_info`.`city_id`	市id
nearbyHotel[].districtId	Long		`hotel_info`.`district_id`	区县id
nearbyHotel[].longitude	BigDecimal		`hotel_info`.`longitude`	经度
nearbyHotel[].latitude	BigDecimal		`hotel_info`.`latitude`	纬度
nearbyHotel[].coverImage	String		`hotel_info`.`cover_image`	主图URL
nearbyHotel[].images	String		`hotel_info`.`images`	轮播图URL，多个用逗号分隔
nearbyHotel[].tags	String		`hotel_info`.`tags`	酒店标签，多个用逗号分隔
nearbyHotel[].locationTags	String		`hotel_info`.`location_tags`	位置描述标签，多个用逗号分隔
nearbyHotel[].highlights	String		`hotel_info`.`highlights`	酒店亮点(富文本)
nearbyHotel[].isDeleted	Boolean		`hotel_info`.`is_deleted`	是否删除(0否 1是)
nearbyHotel[].createdBy	Long		`hotel_info`.`created_by`	创建人ID
nearbyHotel[].createdTime	Date		`hotel_info`.`created_time`	创建时间
nearbyHotel[].updatedBy	Long		`hotel_info`.`updated_by`	更新人ID
nearbyHotel[].updatedTime	Date		`hotel_info`.`updated_time`	更新时间
nearbyHotel[].lowestPrice	BigDecimal		—
nearbyHotel[].distance	BigDecimal		—

示例

请求示例（自动生成，仅结构参考）

POST /hotel/getHotelInfo

{
  "body": {
    "id": 1
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": 1,
    "merchantId": 1,
    "shopId": 1,
    "name": "",
    "grade": "1",
    "type": "1",
    "openingYear": 0,
    "roomCount": 0,
    "phone": "13800000000",
    "coverImage": "",
    "address": "",
    "landmark": "",
    "provinceId": 1,
    "cityId": 1,
    "districtId": 1,
    "longitude": 0,
    "latitude": 0,
    "highlights": "",
    "tags": "",
    "locationTags": "",
    "images": "",
    "status": 0,
    "distance": 0,
    "facilities": "",
    "nearbyHotel": [
      {
        "id": 1,
        "name": "",
        "grade": "1",
        "type": "1",
        "status": 0,
        "openingYear": 0,
        "roomCount": 0,
        "roomTypeCount": 0,
        "phone": "13800000000",
        "address": "",
        "landmark": "",
        "provinceId": 1,
        "cityId": 1,
        "districtId": 1,
        "longitude": 0,
        "latitude": 0,
        "coverImage": "",
        "images": "",
        "tags": "",
        "locationTags": "",
        "highlights": "",
        "isDeleted": false,
        "createdBy": 0,
        "createdTime": "2026-01-01 12:00:00",
        "updatedBy": 0,
        "updatedTime": "2026-01-01 12:00:00",
        "lowestPrice": 0,
        "distance": 0
      }
    ]
  }
}

处理逻辑

逻辑摘要查询详情（hotelInfoService.get）；列表查询（hotelFacilityRelService.queryList）；列表查询（hotelFacilityService.queryList）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

1. 查询酒店基本信息
2. 查询酒店关联的所有设施
3. 查询设施详情
4. 构建设施树

前端调用方

dscp-html-manage getHotelInfo exact

POST /hotel/getHotelsList 在用管理后台 #

（无摘要） · HotelInfoController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelInfoController#getHotelsList
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表（未解析到业务表：可能为纯校验/转发/缓存/外部接口）

调用链路（控制器方法内未解析到 Service/Mapper 调用，可能为接口声明或简单转发）

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/getHotelsList
uat	https://dscp-uat.hn12301.net/manage-api/hotel/getHotelsList
pro	https://dscp-uat.hn12301.net/manage-api/hotel/getHotelsList	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　List<IdRequest>

请求体类型：List<IdRequest>（未在仓库索引到该 DTO 源码，无法展开字段；可能位于依赖 jar 或为 Map/基础类型）

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　List<HotelInfoDetailResponse>　（list）

字段	类型	取值/校验	表 / 列	说明
[ ]	array		—	列表，元素结构见下
id	Long		—	id
merchantId	Long		—	商户ID
shopId	Long		—	店铺ID
name	String		—	酒店名称
grade	HotelGrade	1二星及以下/经济2三星/舒适3四星/高档4五星/豪华5奢华	—	酒店等级
type	HotelType	1酒店2民宿3公寓4青年旅社5别墅6度假村7客栈8农家乐+4	—
openingYear	Integer		—	开业年份
roomCount	Integer		—	房间数量
phone	String		—	联系电话
coverImage	String		—	封面图片
address	String		—	地址
landmark	String		—	地标
provinceId	Long		—	省id
cityId	Long		—	市id
districtId	Long		—	区县id
longitude	BigDecimal		—	经度
latitude	BigDecimal		—	纬度
highlights	String		—	亮点介绍
tags	String		—	酒店标签
locationTags	String		—	位置标签
images	String		—	酒店图片，多个用逗号分隔
status	Integer		—	状态(0正常 1停用)
distance	BigDecimal		—
facilities	List<FacilityTree>		—	设施列表
nearbyHotel	List<HotelInfoResponse>		—	附件酒店
nearbyHotel[].id	Long		—	酒店ID
nearbyHotel[].name	String		—	酒店名称
nearbyHotel[].grade	HotelGrade	1二星及以下/经济2三星/舒适3四星/高档4五星/豪华5奢华	—	酒店等级(枚举:HotelGrade)，1二星及以下/经济，2三星/舒适，3四星/高档，4五星/豪华，5奢华
nearbyHotel[].type	HotelType	1酒店2民宿3公寓4青年旅社5别墅6度假村7客栈8农家乐+4	—
nearbyHotel[].status	Integer		—	状态，0正常，1停用
nearbyHotel[].openingYear	Integer		—	开业年份
nearbyHotel[].roomCount	Integer		—	房间数量
nearbyHotel[].roomTypeCount	Long		—	房型数量
nearbyHotel[].phone	String		—	联系电话
nearbyHotel[].address	String		—	详细地址
nearbyHotel[].landmark	String		—	地标
nearbyHotel[].provinceId	Long		—	省id
nearbyHotel[].cityId	Long		—	市id
nearbyHotel[].districtId	Long		—	区县id
nearbyHotel[].longitude	BigDecimal		—	经度
nearbyHotel[].latitude	BigDecimal		—	纬度
nearbyHotel[].coverImage	String		—	主图URL
nearbyHotel[].images	String		—	轮播图URL，多个用逗号分隔
nearbyHotel[].tags	String		—	酒店标签，多个用逗号分隔
nearbyHotel[].locationTags	String		—	位置描述标签，多个用逗号分隔
nearbyHotel[].highlights	String		—	酒店亮点(富文本)
nearbyHotel[].isDeleted	Boolean		—	是否删除(0否 1是)
nearbyHotel[].createdBy	Long		—	创建人ID
nearbyHotel[].createdTime	Date		—	创建时间
nearbyHotel[].updatedBy	Long		—	更新人ID
nearbyHotel[].updatedTime	Date		—	更新时间
nearbyHotel[].lowestPrice	BigDecimal		—
nearbyHotel[].distance	BigDecimal		—

示例

请求示例（自动生成，仅结构参考）

POST /hotel/getHotelsList

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "id": 1,
      "merchantId": 1,
      "shopId": 1,
      "name": "",
      "grade": "1",
      "type": "1",
      "openingYear": 0,
      "roomCount": 0,
      "phone": "13800000000",
      "coverImage": "",
      "address": "",
      "landmark": "",
      "provinceId": 1,
      "cityId": 1,
      "districtId": 1,
      "longitude": 0,
      "latitude": 0,
      "highlights": "",
      "tags": "",
      "locationTags": "",
      "images": "",
      "status": 0,
      "distance": 0,
      "facilities": "",
      "nearbyHotel": [
        {
          "id": 1,
          "name": "",
          "grade": "1",
          "type": "1",
          "status": 0,
          "openingYear": 0,
          "roomCount": 0,
          "roomTypeCount": 0,
          "phone": "13800000000",
          "address": "",
          "landmark": "",
          "provinceId": 1,
          "cityId": 1,
          "districtId": 1,
          "longitude": 0,
          "latitude": 0,
          "coverImage": "",
          "images": "",
          "tags": "",
          "locationTags": "",
          "highlights": "",
          "isDeleted": false,
          "createdBy": 0,
          "createdTime": "2026-01-01 12:00:00",
          "updatedBy": 0,
          "updatedTime": "2026-01-01 12:00:00",
          "lowestPrice": 0,
          "distance": 0
        }
      ]
    }
  ]
}

处理逻辑

逻辑摘要见下方调用链

前端调用方

dscp-html-manage getHotelsList exact

POST /hotel/queryHotelInfoList 在用管理后台 #

酒店信息表-列表查询 · HotelInfoController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelInfoController#queryHotelInfoList
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_info

ControllerHotelInfoController#queryHotelInfoList

转换BeanUtils.map → HotelInfoQuery

ServiceHotelInfoService#queryList （HotelInfoServiceImpl）

MapperHotelInfoMapper#selectList ⇒ 表 hotel_info

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/queryHotelInfoList
uat	https://dscp-uat.hn12301.net/manage-api/hotel/queryHotelInfoList
pro	https://dscp-uat.hn12301.net/manage-api/hotel/queryHotelInfoList	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HotelInfoListRequest

字段	类型	必填	取值/校验	表 / 列	说明
merchantId	Long			`hotel_info`.`merchant_id`	所属商户id，关联merchant表id
shopId	Long			`hotel_info`.`shop_id`	所属商铺id，关联shop表id
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　List<HotelInfoResponse>　（list）

字段	类型	取值/校验	表 / 列	说明
[ ]	array		—	列表，元素结构见下
id	Long		`hotel_info`.`id`	酒店ID
name	String		`hotel_info`.`name`	酒店名称
grade	HotelGrade	1二星及以下/经济2三星/舒适3四星/高档4五星/豪华5奢华	`hotel_info`.`grade`	酒店等级(枚举:HotelGrade)，1二星及以下/经济，2三星/舒适，3四星/高档，4五星/豪华，5奢华
type	HotelType	1酒店2民宿3公寓4青年旅社5别墅6度假村7客栈8农家乐+4	`hotel_info`.`type`
status	Integer		`hotel_info`.`status`	状态，0正常，1停用
openingYear	Integer		`hotel_info`.`opening_year`	开业年份
roomCount	Integer		`hotel_info`.`room_count`	房间数量
roomTypeCount	Long		—	房型数量
phone	String		`hotel_info`.`phone`	联系电话
address	String		`hotel_info`.`address`	详细地址
landmark	String		`hotel_info`.`landmark`	地标
provinceId	Long		`hotel_info`.`province_id`	省id
cityId	Long		`hotel_info`.`city_id`	市id
districtId	Long		`hotel_info`.`district_id`	区县id
longitude	BigDecimal		`hotel_info`.`longitude`	经度
latitude	BigDecimal		`hotel_info`.`latitude`	纬度
coverImage	String		`hotel_info`.`cover_image`	主图URL
images	String		`hotel_info`.`images`	轮播图URL，多个用逗号分隔
tags	String		`hotel_info`.`tags`	酒店标签，多个用逗号分隔
locationTags	String		`hotel_info`.`location_tags`	位置描述标签，多个用逗号分隔
highlights	String		`hotel_info`.`highlights`	酒店亮点(富文本)
isDeleted	Boolean		`hotel_info`.`is_deleted`	是否删除(0否 1是)
createdBy	Long		`hotel_info`.`created_by`	创建人ID
createdTime	Date		`hotel_info`.`created_time`	创建时间
updatedBy	Long		`hotel_info`.`updated_by`	更新人ID
updatedTime	Date		`hotel_info`.`updated_time`	更新时间
lowestPrice	BigDecimal		—
distance	BigDecimal		—

示例

请求示例（自动生成，仅结构参考）

POST /hotel/queryHotelInfoList

{
  "body": {
    "merchantId": 1,
    "shopId": 1,
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "id": 1,
      "name": "",
      "grade": "1",
      "type": "1",
      "status": 0,
      "openingYear": 0,
      "roomCount": 0,
      "roomTypeCount": 0,
      "phone": "13800000000",
      "address": "",
      "landmark": "",
      "provinceId": 1,
      "cityId": 1,
      "districtId": 1,
      "longitude": 0,
      "latitude": 0,
      "coverImage": "",
      "images": "",
      "tags": "",
      "locationTags": "",
      "highlights": "",
      "isDeleted": false,
      "createdBy": 0,
      "createdTime": "2026-01-01 12:00:00",
      "updatedBy": 0,
      "updatedTime": "2026-01-01 12:00:00",
      "lowestPrice": 0,
      "distance": 0
    }
  ]
}

处理逻辑

逻辑摘要列表查询（hotelInfoService.queryList）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

dscp-html-manage queryHotelInfoList exact

POST /hotel/queryHotelInfoPage 在用管理后台 #

酒店信息表-分页查询 · HotelInfoController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelInfoController#queryHotelInfoPage
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_infohotel_room_type

ControllerHotelInfoController#queryHotelInfoPage

转换BeanUtils.map → HotelInfoQuery

ServiceHotelInfoService#queryPage （HotelInfoServiceImpl）

MapperHotelInfoMapper#selectPage ⇒ 表 hotel_info

ServiceHotelRoomTypeService#count （HotelRoomTypeServiceImpl）

MapperHotelRoomTypeMapper#selectCount ⇒ 表 hotel_room_type

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/queryHotelInfoPage
uat	https://dscp-uat.hn12301.net/manage-api/hotel/queryHotelInfoPage
pro	https://dscp-uat.hn12301.net/manage-api/hotel/queryHotelInfoPage	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HotelInfoPageRequest

字段	类型	必填	取值/校验	表 / 列	说明
pageNum	Integer	否		—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否		—	每页条数（继承自框架分页基类 AbstractPageRequest）
merchantId	Long			`hotel_info`.`merchant_id`	所属商户id，关联merchant表id
shopId	Long			`hotel_info`.`shop_id`	所属商铺id，关联shop表id
id	Long			`hotel_info`.`id`	酒店名称
name	String			`hotel_info`.`name`	酒店名称
grade	HotelGrade		1二星及以下/经济2三星/舒适3四星/高档4五星/豪华5奢华	`hotel_info`.`grade`
status	Integer			`hotel_info`.`status`	状态，0正常，1停用
roomFlag	Integer			—
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　PageInfo<HotelInfoResponse>　（page）

字段	类型	取值/校验	表 / 列	说明
list / records	array		—	分页列表，元素结构见下
total	long		—	总条数（PageInfo）
id	Long		`hotel_info`.`id`	酒店ID
name	String		`hotel_info`.`name`	酒店名称
grade	HotelGrade	1二星及以下/经济2三星/舒适3四星/高档4五星/豪华5奢华	`hotel_info`.`grade`	酒店等级(枚举:HotelGrade)，1二星及以下/经济，2三星/舒适，3四星/高档，4五星/豪华，5奢华
type	HotelType	1酒店2民宿3公寓4青年旅社5别墅6度假村7客栈8农家乐+4	`hotel_info`.`type`
status	Integer		`hotel_info`.`status`	状态，0正常，1停用
openingYear	Integer		`hotel_info`.`opening_year`	开业年份
roomCount	Integer		`hotel_info`.`room_count`	房间数量
roomTypeCount	Long		—	房型数量
phone	String		`hotel_info`.`phone`	联系电话
address	String		`hotel_info`.`address`	详细地址
landmark	String		`hotel_info`.`landmark`	地标
provinceId	Long		`hotel_info`.`province_id`	省id
cityId	Long		`hotel_info`.`city_id`	市id
districtId	Long		`hotel_info`.`district_id`	区县id
longitude	BigDecimal		`hotel_info`.`longitude`	经度
latitude	BigDecimal		`hotel_info`.`latitude`	纬度
coverImage	String		`hotel_info`.`cover_image`	主图URL
images	String		`hotel_info`.`images`	轮播图URL，多个用逗号分隔
tags	String		`hotel_info`.`tags`	酒店标签，多个用逗号分隔
locationTags	String		`hotel_info`.`location_tags`	位置描述标签，多个用逗号分隔
highlights	String		`hotel_info`.`highlights`	酒店亮点(富文本)
isDeleted	Boolean		`hotel_info`.`is_deleted`	是否删除(0否 1是)
createdBy	Long		`hotel_info`.`created_by`	创建人ID
createdTime	Date		`hotel_info`.`created_time`	创建时间
updatedBy	Long		`hotel_info`.`updated_by`	更新人ID
updatedTime	Date		`hotel_info`.`updated_time`	更新时间
lowestPrice	BigDecimal		—
distance	BigDecimal		—

示例

请求示例（自动生成，仅结构参考）

POST /hotel/queryHotelInfoPage

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "merchantId": 1,
    "shopId": 1,
    "id": 1,
    "name": "",
    "grade": "1",
    "status": 0,
    "roomFlag": 0,
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1,
        "name": "",
        "grade": "1",
        "type": "1",
        "status": 0,
        "openingYear": 0,
        "roomCount": 0,
        "roomTypeCount": 0,
        "phone": "13800000000",
        "address": "",
        "landmark": "",
        "provinceId": 1,
        "cityId": 1,
        "districtId": 1,
        "longitude": 0,
        "latitude": 0,
        "coverImage": "",
        "images": "",
        "tags": "",
        "locationTags": "",
        "highlights": "",
        "isDeleted": false,
        "createdBy": 0,
        "createdTime": "2026-01-01 12:00:00",
        "updatedBy": 0,
        "updatedTime": "2026-01-01 12:00:00",
        "lowestPrice": 0,
        "distance": 0
      }
    ],
    "total": 0
  }
}

处理逻辑

逻辑摘要分页查询（hotelInfoService.queryPage）；调用 count（hotelRoomTypeService.count）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件
查询每个酒店的房型数量

前端调用方

dscp-html-manage queryHotelInfoPage exact

POST /hotel/setHotelInfoStatus 在用管理后台 #

酒店信息表-状态 · HotelInfoController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelInfoController#setHotelInfoStatus
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_info

ControllerHotelInfoController#setHotelInfoStatus

ServiceHotelInfoService#get （HotelInfoServiceImpl）

MapperHotelInfoMapper#selectById ⇒ 表 hotel_info

ServiceHotelInfoService#update （HotelInfoServiceImpl）

MapperHotelInfoMapper#updateById ⇒ 表 hotel_info

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/setHotelInfoStatus
uat	https://dscp-uat.hn12301.net/manage-api/hotel/setHotelInfoStatus
pro	https://dscp-uat.hn12301.net/manage-api/hotel/setHotelInfoStatus	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`hotel_info`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /hotel/setHotelInfoStatus

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志hotel / 设置酒店状态

逻辑摘要查询详情（hotelInfoService.get）；更新（hotelInfoService.update）

内联注释

停止
正常

前端调用方

dscp-html-manage setHotelInfoStatus exact

POST /hotel/updateHotelInfo 在用管理后台 #

酒店信息表-更新 · HotelInfoController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelInfoController#updateHotelInfo
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_infohotel_facility_relhotel_facility

ControllerHotelInfoController#updateHotelInfo

转换BeanUtils.map → HotelInfo ⇒ 表 hotel_info

MapperHotelFacilityRelService.getMapper#delete ⇒ 表 hotel_facility_rel

ServiceHotelInfoService#update （HotelInfoServiceImpl）

MapperHotelInfoMapper#updateById ⇒ 表 hotel_info

ServiceHotelFacilityRelService#queryList （HotelFacilityRelServiceImpl）

MapperHotelFacilityRelMapper#selectList ⇒ 表 hotel_facility_rel

ServiceHotelFacilityService#delete （HotelFacilityServiceImpl）

MapperHotelFacilityMapper#deleteById ⇒ 表 hotel_facility

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 1

SessionUserService.getSessionUser

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/updateHotelInfo
uat	https://dscp-uat.hn12301.net/manage-api/hotel/updateHotelInfo
pro	https://dscp-uat.hn12301.net/manage-api/hotel/updateHotelInfo	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HotelInfoUpdateRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`hotel_info`.`id`	id
merchantId	Long			`hotel_info`.`merchant_id`	商户ID
shopId	Long			`hotel_info`.`shop_id`	店铺ID
name	String	是	必填	`hotel_info`.`name`	酒店名称
grade	HotelGrade	是	1二星及以下/经济2三星/舒适3四星/高档4五星/豪华5奢华	`hotel_info`.`grade`	酒店等级
type	HotelType		1酒店2民宿3公寓4青年旅社5别墅6度假村7客栈8农家乐+4	`hotel_info`.`type`
openingYear	Integer			`hotel_info`.`opening_year`	开业年份
roomCount	Integer			`hotel_info`.`room_count`	房间数量
phone	String			`hotel_info`.`phone`	联系电话
coverImage	String			`hotel_info`.`cover_image`	封面图片
address	String			`hotel_info`.`address`	地址
landmark	String			`hotel_info`.`landmark`	地标
provinceId	Long			`hotel_info`.`province_id`	省id
cityId	Long			`hotel_info`.`city_id`	市id
districtId	Long			`hotel_info`.`district_id`	区县id
longitude	BigDecimal			`hotel_info`.`longitude`	经度
latitude	BigDecimal			`hotel_info`.`latitude`	纬度
highlights	String			`hotel_info`.`highlights`	亮点介绍
tags	String			`hotel_info`.`tags`	酒店标签
locationTags	String			`hotel_info`.`location_tags`	位置标签
images	String			`hotel_info`.`images`	酒店图片，多个用逗号分隔
status	Integer			`hotel_info`.`status`	状态(0正常 1停用)
facilities	List<HotelInfoAddRequest.FacilityTree>			—	设施列表

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /hotel/updateHotelInfo

{
  "body": {
    "id": 1,
    "merchantId": 1,
    "shopId": 1,
    "name": "",
    "grade": "1",
    "type": "1",
    "openingYear": 0,
    "roomCount": 0,
    "phone": "13800000000",
    "coverImage": "",
    "address": "",
    "landmark": "",
    "provinceId": 1,
    "cityId": 1,
    "districtId": 1,
    "longitude": 0,
    "latitude": 0,
    "highlights": "",
    "tags": "",
    "locationTags": "",
    "images": "",
    "status": 0,
    "facilities": ""
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志hotel / 更新酒店

逻辑摘要查询详情（sessionUserService.getSessionUser）；更新（hotelInfoService.update）；查询详情（hotelFacilityRelService.getMapper）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

1. 更新酒店基本信息
2. 删除原有的设施关联关系
3. 删除原有的设施信息
4. 重新保存设施信息

前端调用方

dscp-html-manage updateHotelInfo exact

HotelMemberTravelerController 0/6 在用

POST /hotel/addHotelMemberTraveler 未使用管理后台 #

会员常用旅客表-新增 · HotelMemberTravelerController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelMemberTravelerController#addHotelMemberTraveler
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_member_traveler

ControllerHotelMemberTravelerController#addHotelMemberTraveler

转换BeanUtils.map → HotelMemberTraveler ⇒ 表 hotel_member_traveler

ServiceHotelMemberTravelerService#add （HotelMemberTravelerServiceImpl）

MapperHotelMemberTravelerMapper#insert ⇒ 表 hotel_member_traveler

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/addHotelMemberTraveler
uat	https://dscp-uat.hn12301.net/manage-api/hotel/addHotelMemberTraveler
pro	https://dscp-uat.hn12301.net/manage-api/hotel/addHotelMemberTraveler	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HotelMemberTravelerAddRequest

字段	类型	必填	取值/校验	表 / 列	说明
name	String			`hotel_member_traveler`.`name`	名称

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /hotel/addHotelMemberTraveler

{
  "body": {
    "name": ""
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志hotel / 新增入住人

逻辑摘要新增（hotelMemberTravelerService.add）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /hotel/deleteHotelMemberTraveler 未使用管理后台 #

会员常用旅客表-删除 · HotelMemberTravelerController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelMemberTravelerController#deleteHotelMemberTraveler
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_member_traveler

ControllerHotelMemberTravelerController#deleteHotelMemberTraveler

ServiceHotelMemberTravelerService#delete （HotelMemberTravelerServiceImpl）

MapperHotelMemberTravelerMapper#deleteById ⇒ 表 hotel_member_traveler

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/deleteHotelMemberTraveler
uat	https://dscp-uat.hn12301.net/manage-api/hotel/deleteHotelMemberTraveler
pro	https://dscp-uat.hn12301.net/manage-api/hotel/deleteHotelMemberTraveler	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`hotel_member_traveler`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /hotel/deleteHotelMemberTraveler

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志hotel / 删除入住人

逻辑摘要删除（hotelMemberTravelerService.delete）

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /hotel/getHotelMemberTraveler 未使用管理后台 #

会员常用旅客表-详情 · HotelMemberTravelerController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelMemberTravelerController#getHotelMemberTraveler
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_member_traveler

ControllerHotelMemberTravelerController#getHotelMemberTraveler

ServiceHotelMemberTravelerService#get （HotelMemberTravelerServiceImpl）

MapperHotelMemberTravelerMapper#selectById ⇒ 表 hotel_member_traveler

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/getHotelMemberTraveler
uat	https://dscp-uat.hn12301.net/manage-api/hotel/getHotelMemberTraveler
pro	https://dscp-uat.hn12301.net/manage-api/hotel/getHotelMemberTraveler	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`hotel_member_traveler`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　HotelMemberTravelerResponse　（object）

字段	类型	必填	取值/校验	表 / 列	说明
id	Long			`hotel_member_traveler`.`id`	id

示例

请求示例（自动生成，仅结构参考）

POST /hotel/getHotelMemberTraveler

{
  "body": {
    "id": 1
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": 1
  }
}

处理逻辑

逻辑摘要查询详情（hotelMemberTravelerService.get）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /hotel/queryHotelMemberTravelerList 未使用管理后台 #

会员常用旅客表-列表查询 · HotelMemberTravelerController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelMemberTravelerController#queryHotelMemberTravelerList
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_member_traveler

ControllerHotelMemberTravelerController#queryHotelMemberTravelerList

转换BeanUtils.map → HotelMemberTravelerQuery

ServiceHotelMemberTravelerService#queryList （HotelMemberTravelerServiceImpl）

MapperHotelMemberTravelerMapper#selectList ⇒ 表 hotel_member_traveler

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/queryHotelMemberTravelerList
uat	https://dscp-uat.hn12301.net/manage-api/hotel/queryHotelMemberTravelerList
pro	https://dscp-uat.hn12301.net/manage-api/hotel/queryHotelMemberTravelerList	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HotelMemberTravelerListRequest

字段	类型	必填	取值/校验	表 / 列	说明
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　List<HotelMemberTravelerResponse>　（list）

字段	类型	必填	取值/校验	表 / 列	说明
[ ]	array			—	列表，元素结构见下
id	Long			`hotel_member_traveler`.`id`	id

示例

请求示例（自动生成，仅结构参考）

POST /hotel/queryHotelMemberTravelerList

{
  "body": {
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "id": 1
    }
  ]
}

处理逻辑

逻辑摘要列表查询（hotelMemberTravelerService.queryList）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /hotel/queryHotelMemberTravelerPage 未使用管理后台 #

会员常用旅客表-分页查询 · HotelMemberTravelerController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelMemberTravelerController#queryHotelMemberTravelerPage
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_member_traveler

ControllerHotelMemberTravelerController#queryHotelMemberTravelerPage

转换BeanUtils.map → HotelMemberTravelerQuery

ServiceHotelMemberTravelerService#queryPage （HotelMemberTravelerServiceImpl）

MapperHotelMemberTravelerMapper#selectPage ⇒ 表 hotel_member_traveler

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/queryHotelMemberTravelerPage
uat	https://dscp-uat.hn12301.net/manage-api/hotel/queryHotelMemberTravelerPage
pro	https://dscp-uat.hn12301.net/manage-api/hotel/queryHotelMemberTravelerPage	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HotelMemberTravelerPageRequest

字段	类型	必填	取值/校验	表 / 列	说明
pageNum	Integer	否		—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否		—	每页条数（继承自框架分页基类 AbstractPageRequest）
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　PageInfo<HotelMemberTravelerResponse>　（page）

字段	类型	表 / 列	说明
list / records	array	—	分页列表，元素结构见下
total	long	—	总条数（PageInfo）
id	Long	`hotel_member_traveler`.`id`	id

示例

请求示例（自动生成，仅结构参考）

POST /hotel/queryHotelMemberTravelerPage

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1
      }
    ],
    "total": 0
  }
}

处理逻辑

逻辑摘要分页查询（hotelMemberTravelerService.queryPage）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /hotel/updateHotelMemberTraveler 未使用管理后台 #

会员常用旅客表-更新 · HotelMemberTravelerController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelMemberTravelerController#updateHotelMemberTraveler
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_member_traveler

ControllerHotelMemberTravelerController#updateHotelMemberTraveler

转换BeanUtils.map → HotelMemberTraveler ⇒ 表 hotel_member_traveler

ServiceHotelMemberTravelerService#update （HotelMemberTravelerServiceImpl）

MapperHotelMemberTravelerMapper#updateById ⇒ 表 hotel_member_traveler

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/updateHotelMemberTraveler
uat	https://dscp-uat.hn12301.net/manage-api/hotel/updateHotelMemberTraveler
pro	https://dscp-uat.hn12301.net/manage-api/hotel/updateHotelMemberTraveler	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HotelMemberTravelerUpdateRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long			`hotel_member_traveler`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /hotel/updateHotelMemberTraveler

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志hotel / 更新入住人

逻辑摘要更新（hotelMemberTravelerService.update）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

HotelOrderController 7/11 在用

POST /hotel/addHotelOrder 未使用管理后台 #

酒店订单表-新增 · HotelOrderController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelOrderController#addHotelOrder
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_order

ControllerHotelOrderController#addHotelOrder

转换BeanUtils.map → HotelOrder ⇒ 表 hotel_order

ServiceHotelOrderService#add （HotelOrderServiceImpl）

MapperHotelOrderMapper#insert ⇒ 表 hotel_order

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/addHotelOrder
uat	https://dscp-uat.hn12301.net/manage-api/hotel/addHotelOrder
pro	https://dscp-uat.hn12301.net/manage-api/hotel/addHotelOrder	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HotelOrderAddRequest

字段	类型	必填	取值/校验	表 / 列	说明
name	String			—	名称

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /hotel/addHotelOrder

{
  "body": {
    "name": ""
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志hotel / 新增酒店订单

逻辑摘要新增（hotelOrderService.add）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /hotel/cancelHotelOrder 在用管理后台 #

取消订单 · HotelOrderController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelOrderController#cancelHotelOrder
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_orderhotel_order_loghotel_order_roomhotel_order_paymentmember

ControllerHotelOrderController#cancelHotelOrder

ServiceHotelOrderService#get （HotelOrderServiceImpl）

MapperHotelOrderMapper#selectById ⇒ 表 hotel_order

ServiceHotelOrderService#cancelOrder （HotelOrderServiceImpl）

ServiceHotelOrderService#update （HotelOrderServiceImpl）

MapperHotelOrderMapper#updateById ⇒ 表 hotel_order

ServiceHotelOrderLogService#add （HotelOrderLogServiceImpl）

MapperHotelOrderLogMapper#insert ⇒ 表 hotel_order_log

ServiceHotelOrderService#releaseRoomNum （HotelOrderServiceImpl）

ServiceHotelOrderRoomService#queryList （HotelOrderRoomServiceImpl）

MapperHotelOrderRoomMapper#selectList ⇒ 表 hotel_order_room

ServiceHotelApiService#refundOrder （HotelApiServiceImpl）

ServiceHotelOrderPaymentService#add （HotelOrderPaymentServiceImpl）

MapperHotelOrderPaymentMapper#insert ⇒ 表 hotel_order_payment

ServiceHotelApiService#refundOrderXgh （HotelApiServiceImpl）

ServiceMemberService#get （MemberServiceImpl）

MapperMemberMapper#selectById ⇒ 表 member

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 14

SessionUserService.getSessionIdSessionUserService.isMerchantSessionUserService.isShopSessionUserService.isPlatformUserSessionUserService.getSessionUserWechatJsapiRefundService.refundSessionUserService.getSessionIdLockService.tryLockXghService.getXghAccessTokenRedisCacheService.getCacheService.getCacheService.putRedisCacheService.putLockService.unlock

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/cancelHotelOrder
uat	https://dscp-uat.hn12301.net/manage-api/hotel/cancelHotelOrder
pro	https://dscp-uat.hn12301.net/manage-api/hotel/cancelHotelOrder	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HotelOrderRejectRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`hotel_order`.`id`	订单ID
rejectReason	String	是	必填	—	拒绝原因

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /hotel/cancelHotelOrder

{
  "body": {
    "id": 1,
    "rejectReason": ""
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志hotel / 取消酒店订单

逻辑摘要查询详情（hotelOrderService.get）；调用 cancelOrder（hotelOrderService.cancelOrder）；查询详情（sessionUserService.getSessionId）

内联注释

4. 根据用户角色确定操作来源和描述
5. 记录操作日志
TODO: 6. 释放库存
7. 处理退款
TODO: 调用退款服务进行退款处理 &
hotelApiService.refundOrder(order, order.getTotalAmount(),"酒店取消订单退款");
TODO 触发取消订单短信

前端调用方

dscp-html-manage cancelHotelOrder exact

POST /hotel/checkInHotelOrder 在用管理后台 #

办理入住 · HotelOrderController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelOrderController#checkInHotelOrder
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_orderhotel_order_log

ControllerHotelOrderController#checkInHotelOrder

ServiceHotelOrderService#get （HotelOrderServiceImpl）

MapperHotelOrderMapper#selectById ⇒ 表 hotel_order

ServiceHotelOrderService#update （HotelOrderServiceImpl）

MapperHotelOrderMapper#updateById ⇒ 表 hotel_order

ServiceHotelOrderLogService#add （HotelOrderLogServiceImpl）

MapperHotelOrderLogMapper#insert ⇒ 表 hotel_order_log

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 5

SessionUserService.getSessionIdSessionUserService.isMerchantSessionUserService.isShopSessionUserService.isPlatformUserSessionUserService.getSessionUser

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/checkInHotelOrder
uat	https://dscp-uat.hn12301.net/manage-api/hotel/checkInHotelOrder
pro	https://dscp-uat.hn12301.net/manage-api/hotel/checkInHotelOrder	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`hotel_order`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /hotel/checkInHotelOrder

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志hotel / 酒店入住

逻辑摘要查询详情（hotelOrderService.get）；查询详情（sessionUserService.getSessionId）；更新（hotelOrderService.update）

内联注释

1. 查询订单
2. 校验订单状态
3. 更新订单状态和入住时间
4. 根据用户角色确定操作来源和描述
5. 记录操作日志

前端调用方

dscp-html-manage checkInHotelOrder exact

POST /hotel/checkOutHotelOrder 在用管理后台 #

办理退房 · HotelOrderController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelOrderController#checkOutHotelOrder
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_order

ControllerHotelOrderController#checkOutHotelOrder

ServiceHotelOrderService#get （HotelOrderServiceImpl）

MapperHotelOrderMapper#selectById ⇒ 表 hotel_order

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/checkOutHotelOrder
uat	https://dscp-uat.hn12301.net/manage-api/hotel/checkOutHotelOrder
pro	https://dscp-uat.hn12301.net/manage-api/hotel/checkOutHotelOrder	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HotelOrderCheckOutRequest

字段	类型	表 / 列	说明
id	Long	`hotel_order`.`id`	订单ID
type	String	—	退房类型：CHECK_OUT-正常退房，EARLY_CHECK_OUT-提前退房
checkOutRooms	List<CheckOutRoom>	—	退房房间信息
checkOutRooms[].date	Date	—	退房日期
checkOutRooms[].num	Integer	—	退房房间数

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /hotel/checkOutHotelOrder

{
  "body": {
    "id": 1,
    "type": "",
    "checkOutRooms": [
      {
        "date": "2026-01-01 12:00:00",
        "num": 0
      }
    ]
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志hotel / 酒店退房

逻辑摘要查询详情（hotelOrderService.get）

内联注释

1. 查询订单
2. 校验订单状态
3. 校验退房日期
4. 处理退房
提前退房处理
正常退房处理

前端调用方

dscp-html-manage checkOutHotelOrder exact

POST /hotel/confirmHotelOrder 在用管理后台 #

确认订单 · HotelOrderController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelOrderController#confirmHotelOrder
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_orderhotel_order_log

ControllerHotelOrderController#confirmHotelOrder

ServiceHotelOrderService#get （HotelOrderServiceImpl）

MapperHotelOrderMapper#selectById ⇒ 表 hotel_order

ServiceHotelOrderService#update （HotelOrderServiceImpl）

MapperHotelOrderMapper#updateById ⇒ 表 hotel_order

ServiceHotelOrderLogService#add （HotelOrderLogServiceImpl）

MapperHotelOrderLogMapper#insert ⇒ 表 hotel_order_log

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 5

SessionUserService.getSessionIdSessionUserService.isMerchantSessionUserService.isShopSessionUserService.isPlatformUserSessionUserService.getSessionUser

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/confirmHotelOrder
uat	https://dscp-uat.hn12301.net/manage-api/hotel/confirmHotelOrder
pro	https://dscp-uat.hn12301.net/manage-api/hotel/confirmHotelOrder	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`hotel_order`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /hotel/confirmHotelOrder

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志hotel / 确认酒店订单

逻辑摘要查询详情（hotelOrderService.get）；查询详情（sessionUserService.getSessionId）；更新（hotelOrderService.update）

内联注释

1. 查询订单
2. 校验订单状态
3. 更新订单状态
4. 根据用户角色确定操作来源和描述
5. 记录操作日志
TODO: 6. 触发确认订单短信

前端调用方

dscp-html-manage confirmHotelOrder exact

POST /hotel/deleteHotelOrder 未使用管理后台 #

酒店订单表-删除 · HotelOrderController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelOrderController#deleteHotelOrder
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_order

ControllerHotelOrderController#deleteHotelOrder

ServiceHotelOrderService#delete （HotelOrderServiceImpl）

MapperHotelOrderMapper#deleteById ⇒ 表 hotel_order

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/deleteHotelOrder
uat	https://dscp-uat.hn12301.net/manage-api/hotel/deleteHotelOrder
pro	https://dscp-uat.hn12301.net/manage-api/hotel/deleteHotelOrder	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`hotel_order`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /hotel/deleteHotelOrder

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志hotel / 删除酒店订单

逻辑摘要删除（hotelOrderService.delete）

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /hotel/getHotelOrderDetail 在用管理后台 #

酒店订单表-详情 · HotelOrderController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelOrderController#getHotelOrderDetail
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_orderhotel_room_typehotel_room_type_planhotel_order_roomhotel_member_traveler

ControllerHotelOrderController#getHotelOrderDetail

ServiceHotelOrderService#get （HotelOrderServiceImpl）

MapperHotelOrderMapper#selectById ⇒ 表 hotel_order

ServiceHotelRoomTypeService#get （HotelRoomTypeServiceImpl）

MapperHotelRoomTypeMapper#selectById ⇒ 表 hotel_room_type

ServiceHotelRoomTypePlanService#get （HotelRoomTypePlanServiceImpl）

MapperHotelRoomTypePlanMapper#selectById ⇒ 表 hotel_room_type_plan

ServiceHotelOrderRoomService#queryList （HotelOrderRoomServiceImpl）

MapperHotelOrderRoomMapper#selectList ⇒ 表 hotel_order_room

ServiceHotelMemberTravelerService#queryList （HotelMemberTravelerServiceImpl）

MapperHotelMemberTravelerMapper#selectList ⇒ 表 hotel_member_traveler

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/getHotelOrderDetail
uat	https://dscp-uat.hn12301.net/manage-api/hotel/getHotelOrderDetail
pro	https://dscp-uat.hn12301.net/manage-api/hotel/getHotelOrderDetail	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`hotel_order`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　HotelOrderDetailResponse　（object）

字段	类型	取值/校验	表 / 列	说明
id	Long		`hotel_order`.`id`	订单ID
orderNo	String		`hotel_order`.`order_no`	订单编号
createdTime	Date		`hotel_order`.`created_time`	创建时间
status	HotelOrderStatus	0待支付1待确认2待入住3已入住4已退房5已取消6部分退房	`hotel_order`.`status`	订单状态
roomNum	Integer		`hotel_order`.`room_num`	房间数量
roomTypeName	String		—	房型名称
roomTypePlanName	String		—	房型价格方案名称
stayNights	Integer		`hotel_order`.`stay_nights`	入住天数
checkInDate	Date		`hotel_order`.`check_in_date`	入住日期
checkOutDate	Date		`hotel_order`.`check_out_date`	离店日期
contactName	String		`hotel_order`.`contact_name`	联系人姓名
contactPhone	String		`hotel_order`.`contact_phone`	联系人手机号
guestNames	String		—	入住人姓名列表
guestNum	Integer		`hotel_order`.`guest_num`	入住人数
expectedArrivalTime	Date		`hotel_order`.`expected_arrival_time`	预计到店时间
channel	HotelChannel	1质慧游小程序	`hotel_order`.`channel`	订单渠道
originalAmount	Integer		`hotel_order`.`original_amount`	订单原价(分)
discountAmount	Integer		`hotel_order`.`discount_amount`	优惠金额(分)
totalAmount	Integer		`hotel_order`.`total_amount`	订单应付金额(分)
couponId	String		`hotel_order`.`coupon_id`	优惠券ID
orderRoomList	List<OrderRoom>		—	订单房间明细列表
orderRoomList[].roomDate	Date		`hotel_order_room`.`room_date`	房间日期
orderRoomList[].roomName	String		`hotel_order_room`.`room_name`	房型名称
orderRoomList[].roomNum	Integer		`hotel_order`.`room_num`	房间数量
orderRoomList[].roomPrice	Integer		`hotel_order_room`.`room_price`	房间单价(分)
orderRoomList[].totalPrice	Integer		`hotel_order_room`.`total_price`	房间总价(分)
orderRoomList[].roomStatus	Integer		—
orderRoomList[].checkedOutNum	Integer		`hotel_order_room`.`checked_out_num`	已退房数量

示例

请求示例（自动生成，仅结构参考）

POST /hotel/getHotelOrderDetail

{
  "body": {
    "id": 1
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": 1,
    "orderNo": "",
    "createdTime": "2026-01-01 12:00:00",
    "status": "0",
    "roomNum": 0,
    "roomTypeName": "",
    "roomTypePlanName": "",
    "stayNights": 0,
    "checkInDate": "2026-01-01 12:00:00",
    "checkOutDate": "2026-01-01 12:00:00",
    "contactName": "",
    "contactPhone": "13800000000",
    "guestNames": "",
    "guestNum": 0,
    "expectedArrivalTime": "2026-01-01 12:00:00",
    "channel": "1",
    "originalAmount": 0,
    "discountAmount": 0,
    "totalAmount": 0,
    "couponId": "",
    "orderRoomList": [
      {
        "roomDate": "2026-01-01 12:00:00",
        "roomName": "",
        "roomNum": 0,
        "roomPrice": 0,
        "totalPrice": 0,
        "roomStatus": 0,
        "checkedOutNum": 0
      }
    ]
  }
}

处理逻辑

逻辑摘要查询详情（hotelOrderService.get）；查询详情（hotelRoomTypeService.get）；查询详情（hotelRoomTypePlanService.get）

内联注释

1. 查询订单基本信息
2. 查询房型信息
3. 查询订单房间明细
4. 查询入住人信息
构建入住人信息字符串: 姓名|身份证号(隐藏中间部分)
5. 构建响应对象
设置格式化后的入住人信息
6. 构建房间明细列表

前端调用方

dscp-html-manage getHotelOrderDetail exact

POST /hotel/queryHotelOrderList 未使用管理后台 #

酒店订单表-列表查询 · HotelOrderController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelOrderController#queryHotelOrderList
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_order

ControllerHotelOrderController#queryHotelOrderList

转换BeanUtils.map → HotelOrderQuery

ServiceHotelOrderService#queryList （HotelOrderServiceImpl）

MapperHotelOrderMapper#selectList ⇒ 表 hotel_order

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/queryHotelOrderList
uat	https://dscp-uat.hn12301.net/manage-api/hotel/queryHotelOrderList
pro	https://dscp-uat.hn12301.net/manage-api/hotel/queryHotelOrderList	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HotelOrderListRequest

字段	类型	必填	取值/校验	表 / 列	说明
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　List<HotelOrderResponse>　（list）

字段	类型	必填	取值/校验	表 / 列	说明
[ ]	array			—	列表，元素结构见下
id	Long			`hotel_order`.`id`	id

示例

请求示例（自动生成，仅结构参考）

POST /hotel/queryHotelOrderList

{
  "body": {
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "id": 1
    }
  ]
}

处理逻辑

逻辑摘要列表查询（hotelOrderService.queryList）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /hotel/queryHotelOrderPage 在用管理后台 #

酒店订单表-分页查询 · HotelOrderController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelOrderController#queryHotelOrderPage
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_orderhotel_room_type

ControllerHotelOrderController#queryHotelOrderPage

转换BeanUtils.map → HotelOrderQuery

ServiceHotelOrderService#queryPage （HotelOrderServiceImpl）

MapperHotelOrderMapper#selectPage ⇒ 表 hotel_order

ServiceHotelRoomTypeService#queryList （HotelRoomTypeServiceImpl）

MapperHotelRoomTypeMapper#selectList ⇒ 表 hotel_room_type

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/queryHotelOrderPage
uat	https://dscp-uat.hn12301.net/manage-api/hotel/queryHotelOrderPage
pro	https://dscp-uat.hn12301.net/manage-api/hotel/queryHotelOrderPage	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HotelOrderPageRequest

字段	类型	必填	取值/校验	表 / 列	说明
pageNum	Integer	否		—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否		—	每页条数（继承自框架分页基类 AbstractPageRequest）
merchantId	Long			`hotel_order`.`merchant_id`	所属商户id，关联merchant表id
shopId	Long			`hotel_order`.`shop_id`	所属商铺id，关联shop表id
hotelId	Long			`hotel_order`.`hotel_id`	酒店ID
roomTypeId	Long			`hotel_order`.`room_type_id`	房型ID
planId	Long			`hotel_order`.`plan_id`	价格方案ID
purchaseDateRange	Date[]			—	购买日期
checkInDateRange	Date[]			—	入住日期
checkOutDateRange	Date[]			—	离店日期
paymentStatus	HotelOrderPaymentStatus		0未支付1部分支付2已支付3已退款4部分退款5退款中6退款失败	`hotel_order`.`payment_status`	支付状态(0-未支付,1-部分支付,2-已支付,3-已退款,4-部分退款)
status	HotelOrderStatus		0待支付1待确认2待入住3已入住4已退房5已取消6部分退房	`hotel_order`.`status`	订单状态(0-待支付,1-待确认,2-待入住,3-已完成,4-已取消)

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　PageInfo<HotelOrderListResponse>　（page）

字段	类型	取值/校验	表 / 列	说明
list / records	array		—	分页列表，元素结构见下
total	long		—	总条数（PageInfo）
id	Long		`hotel_order`.`id`	订单ID
orderNo	String		`hotel_order`.`order_no`	订单编号
createdTime	Date		`hotel_order`.`created_time`	创建时间
status	HotelOrderStatus	0待支付1待确认2待入住3已入住4已退房5已取消6部分退房	`hotel_order`.`status`	订单状态
roomNum	Integer		`hotel_order`.`room_num`	房间数量
roomTypeName	String		—	房型名称
stayNights	Integer		`hotel_order`.`stay_nights`	入住天数
checkInDate	Date		`hotel_order`.`check_in_date`	入住日期
checkOutDate	Date		`hotel_order`.`check_out_date`	离店日期
contactName	String		`hotel_order`.`contact_name`	联系人姓名
contactPhone	String		`hotel_order`.`contact_phone`	联系人手机号
originalAmount	Integer		`hotel_order`.`original_amount`	订单原价(分)
discountAmount	Integer		`hotel_order`.`discount_amount`	优惠金额(分)
totalAmount	Integer		`hotel_order`.`total_amount`	订单应付金额(分)

示例

请求示例（自动生成，仅结构参考）

POST /hotel/queryHotelOrderPage

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "merchantId": 1,
    "shopId": 1,
    "hotelId": 1,
    "roomTypeId": 1,
    "planId": 1,
    "purchaseDateRange": "2026-01-01 12:00:00",
    "checkInDateRange": "2026-01-01 12:00:00",
    "checkOutDateRange": "2026-01-01 12:00:00",
    "paymentStatus": "0",
    "status": "0"
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1,
        "orderNo": "",
        "createdTime": "2026-01-01 12:00:00",
        "status": "0",
        "roomNum": 0,
        "roomTypeName": "",
        "stayNights": 0,
        "checkInDate": "2026-01-01 12:00:00",
        "checkOutDate": "2026-01-01 12:00:00",
        "contactName": "",
        "contactPhone": "13800000000",
        "originalAmount": 0,
        "discountAmount": 0,
        "totalAmount": 0
      }
    ],
    "total": 0
  }
}

处理逻辑

逻辑摘要分页查询（hotelOrderService.queryPage）；列表查询（hotelRoomTypeService.queryList）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

1. 查询订单列表
按创建时间倒序
2. 查询房型信息
3. 转换响应对象
4. 构建分页结果

前端调用方

dscp-html-manage queryHotelOrderPage exact

POST /hotel/rejectHotelOrder 在用管理后台 #

拒绝订单 · HotelOrderController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelOrderController#rejectHotelOrder
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_orderhotel_order_loghotel_order_roomhotel_order_paymentmember

ControllerHotelOrderController#rejectHotelOrder

ServiceHotelOrderService#get （HotelOrderServiceImpl）

MapperHotelOrderMapper#selectById ⇒ 表 hotel_order

ServiceHotelOrderService#update （HotelOrderServiceImpl）

MapperHotelOrderMapper#updateById ⇒ 表 hotel_order

ServiceHotelOrderLogService#add （HotelOrderLogServiceImpl）

MapperHotelOrderLogMapper#insert ⇒ 表 hotel_order_log

ServiceHotelOrderService#releaseRoomNum （HotelOrderServiceImpl）

ServiceHotelOrderRoomService#queryList （HotelOrderRoomServiceImpl）

MapperHotelOrderRoomMapper#selectList ⇒ 表 hotel_order_room

ServiceHotelApiService#refundOrder （HotelApiServiceImpl）

ServiceHotelOrderPaymentService#add （HotelOrderPaymentServiceImpl）

MapperHotelOrderPaymentMapper#insert ⇒ 表 hotel_order_payment

ServiceHotelApiService#refundOrderXgh （HotelApiServiceImpl）

ServiceMemberService#get （MemberServiceImpl）

MapperMemberMapper#selectById ⇒ 表 member

ServiceHotelOrderService#update （HotelOrderServiceImpl）

MapperHotelOrderMapper#updateById ⇒ 表 hotel_order

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 14

SessionUserService.getSessionIdSessionUserService.isMerchantSessionUserService.isShopSessionUserService.isPlatformUserSessionUserService.getSessionUserWechatJsapiRefundService.refundSessionUserService.getSessionIdLockService.tryLockXghService.getXghAccessTokenRedisCacheService.getCacheService.getCacheService.putRedisCacheService.putLockService.unlock

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/rejectHotelOrder
uat	https://dscp-uat.hn12301.net/manage-api/hotel/rejectHotelOrder
pro	https://dscp-uat.hn12301.net/manage-api/hotel/rejectHotelOrder	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HotelOrderRejectRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`hotel_order`.`id`	订单ID
rejectReason	String	是	必填	—	拒绝原因

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /hotel/rejectHotelOrder

{
  "body": {
    "id": 1,
    "rejectReason": ""
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志hotel / 拒绝酒店订单

逻辑摘要查询详情（hotelOrderService.get）；查询详情（sessionUserService.getSessionId）；更新（hotelOrderService.update）

内联注释

1. 查询订单
2. 校验订单状态
3. 更新订单状态
4. 根据用户角色确定操作来源和描述
5. 记录操作日志
TODO: 6. 释放库存
TODO: 7. 触发退款流程
调用退款服务

前端调用方

dscp-html-manage rejectHotelOrder exact

POST /hotel/updateHotelOrder 未使用管理后台 #

酒店订单表-更新 · HotelOrderController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelOrderController#updateHotelOrder
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_order

ControllerHotelOrderController#updateHotelOrder

转换BeanUtils.map → HotelOrder ⇒ 表 hotel_order

ServiceHotelOrderService#update （HotelOrderServiceImpl）

MapperHotelOrderMapper#updateById ⇒ 表 hotel_order

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/updateHotelOrder
uat	https://dscp-uat.hn12301.net/manage-api/hotel/updateHotelOrder
pro	https://dscp-uat.hn12301.net/manage-api/hotel/updateHotelOrder	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HotelOrderUpdateRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long			`hotel_order`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /hotel/updateHotelOrder

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志hotel / 更新酒店订单

逻辑摘要更新（hotelOrderService.update）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

HotelOrderLogController 1/7 在用

POST /hotel/addHotelOrderLog 未使用管理后台 #

订单操作日志表-新增 · HotelOrderLogController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelOrderLogController#addHotelOrderLog
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_order_log

ControllerHotelOrderLogController#addHotelOrderLog

转换BeanUtils.map → HotelOrderLog ⇒ 表 hotel_order_log

ServiceHotelOrderLogService#add （HotelOrderLogServiceImpl）

MapperHotelOrderLogMapper#insert ⇒ 表 hotel_order_log

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/addHotelOrderLog
uat	https://dscp-uat.hn12301.net/manage-api/hotel/addHotelOrderLog
pro	https://dscp-uat.hn12301.net/manage-api/hotel/addHotelOrderLog	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HotelOrderLogAddRequest

字段	类型	必填	取值/校验	表 / 列	说明
name	String			—	名称

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /hotel/addHotelOrderLog

{
  "body": {
    "name": ""
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志hotel / 新增酒店订单日志

逻辑摘要新增（hotelOrderLogService.add）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /hotel/deleteHotelOrderLog 未使用管理后台 #

订单操作日志表-删除 · HotelOrderLogController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelOrderLogController#deleteHotelOrderLog
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_order_log

ControllerHotelOrderLogController#deleteHotelOrderLog

ServiceHotelOrderLogService#delete （HotelOrderLogServiceImpl）

MapperHotelOrderLogMapper#deleteById ⇒ 表 hotel_order_log

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/deleteHotelOrderLog
uat	https://dscp-uat.hn12301.net/manage-api/hotel/deleteHotelOrderLog
pro	https://dscp-uat.hn12301.net/manage-api/hotel/deleteHotelOrderLog	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`hotel_order_log`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /hotel/deleteHotelOrderLog

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志hotel / 删除酒店订单日志

逻辑摘要删除（hotelOrderLogService.delete）

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /hotel/getHotelOrderLog 未使用管理后台 #

订单操作日志表-详情 · HotelOrderLogController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelOrderLogController#getHotelOrderLog
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_order_log

ControllerHotelOrderLogController#getHotelOrderLog

ServiceHotelOrderLogService#get （HotelOrderLogServiceImpl）

MapperHotelOrderLogMapper#selectById ⇒ 表 hotel_order_log

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/getHotelOrderLog
uat	https://dscp-uat.hn12301.net/manage-api/hotel/getHotelOrderLog
pro	https://dscp-uat.hn12301.net/manage-api/hotel/getHotelOrderLog	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`hotel_order_log`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　HotelOrderLogResponse　（object）

字段	类型	取值/校验	表 / 列	说明
id	Long		`hotel_order_log`.`id`	日志ID
orderId	Long		`hotel_order_log`.`order_id`	订单ID
actionType	HotelOrderActionType	1创建订单2支付订单3确认订单4取消订单5入住6退房7提前退房	`hotel_order_log`.`action_type`	操作类型
actionNote	String		`hotel_order_log`.`action_note`	操作说明
actionSource	HotelOrderActionSource	1用户端2商户端3商铺端4平台端5系统	`hotel_order_log`.`action_source`	操作来源
operatorId	Long		`hotel_order_log`.`operator_id`	操作人ID
operatorName	String		`hotel_order_log`.`operator_name`	操作人名称
createdTime	Date		`hotel_order_log`.`created_time`	操作时间

示例

请求示例（自动生成，仅结构参考）

POST /hotel/getHotelOrderLog

{
  "body": {
    "id": 1
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": 1,
    "orderId": 1,
    "actionType": "1",
    "actionNote": "",
    "actionSource": "1",
    "operatorId": 1,
    "operatorName": "",
    "createdTime": "2026-01-01 12:00:00"
  }
}

处理逻辑

逻辑摘要查询详情（hotelOrderLogService.get）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /hotel/getHotelOrderLogs 在用管理后台 #

查询订单操作日志 · HotelOrderLogController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelOrderLogController#getHotelOrderLogs
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_order_log

ControllerHotelOrderLogController#getHotelOrderLogs

ServiceHotelOrderLogService#queryList （HotelOrderLogServiceImpl）

MapperHotelOrderLogMapper#selectList ⇒ 表 hotel_order_log

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/getHotelOrderLogs
uat	https://dscp-uat.hn12301.net/manage-api/hotel/getHotelOrderLogs
pro	https://dscp-uat.hn12301.net/manage-api/hotel/getHotelOrderLogs	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OrderIdRequest

字段	类型	必填	取值/校验	表 / 列	说明
orderId	Long	是	必填	`hotel_order_log`.`order_id`	订单ID

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　List<HotelOrderLogResponse>　（list）

字段	类型	取值/校验	表 / 列	说明
[ ]	array		—	列表，元素结构见下
id	Long		`hotel_order_log`.`id`	日志ID
orderId	Long		`hotel_order_log`.`order_id`	订单ID
actionType	HotelOrderActionType	1创建订单2支付订单3确认订单4取消订单5入住6退房7提前退房	`hotel_order_log`.`action_type`	操作类型
actionNote	String		`hotel_order_log`.`action_note`	操作说明
actionSource	HotelOrderActionSource	1用户端2商户端3商铺端4平台端5系统	`hotel_order_log`.`action_source`	操作来源
operatorId	Long		`hotel_order_log`.`operator_id`	操作人ID
operatorName	String		`hotel_order_log`.`operator_name`	操作人名称
createdTime	Date		`hotel_order_log`.`created_time`	操作时间

示例

请求示例（自动生成，仅结构参考）

POST /hotel/getHotelOrderLogs

{
  "body": {
    "orderId": 1
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "id": 1,
      "orderId": 1,
      "actionType": "1",
      "actionNote": "",
      "actionSource": "1",
      "operatorId": 1,
      "operatorName": "",
      "createdTime": "2026-01-01 12:00:00"
    }
  ]
}

处理逻辑

逻辑摘要列表查询（hotelOrderLogService.queryList）

内联注释

1. 查询订单日志列表
2. 转换响应对象

前端调用方

dscp-html-manage getHotelOrderLogs exact

POST /hotel/queryHotelOrderLogList 未使用管理后台 #

订单操作日志表-列表查询 · HotelOrderLogController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelOrderLogController#queryHotelOrderLogList
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_order_log

ControllerHotelOrderLogController#queryHotelOrderLogList

转换BeanUtils.map → HotelOrderLogQuery

ServiceHotelOrderLogService#queryList （HotelOrderLogServiceImpl）

MapperHotelOrderLogMapper#selectList ⇒ 表 hotel_order_log

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/queryHotelOrderLogList
uat	https://dscp-uat.hn12301.net/manage-api/hotel/queryHotelOrderLogList
pro	https://dscp-uat.hn12301.net/manage-api/hotel/queryHotelOrderLogList	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HotelOrderLogListRequest

字段	类型	必填	取值/校验	表 / 列	说明
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　List<HotelOrderLogResponse>　（list）

字段	类型	取值/校验	表 / 列	说明
[ ]	array		—	列表，元素结构见下
id	Long		`hotel_order_log`.`id`	日志ID
orderId	Long		`hotel_order_log`.`order_id`	订单ID
actionType	HotelOrderActionType	1创建订单2支付订单3确认订单4取消订单5入住6退房7提前退房	`hotel_order_log`.`action_type`	操作类型
actionNote	String		`hotel_order_log`.`action_note`	操作说明
actionSource	HotelOrderActionSource	1用户端2商户端3商铺端4平台端5系统	`hotel_order_log`.`action_source`	操作来源
operatorId	Long		`hotel_order_log`.`operator_id`	操作人ID
operatorName	String		`hotel_order_log`.`operator_name`	操作人名称
createdTime	Date		`hotel_order_log`.`created_time`	操作时间

示例

请求示例（自动生成，仅结构参考）

POST /hotel/queryHotelOrderLogList

{
  "body": {
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "id": 1,
      "orderId": 1,
      "actionType": "1",
      "actionNote": "",
      "actionSource": "1",
      "operatorId": 1,
      "operatorName": "",
      "createdTime": "2026-01-01 12:00:00"
    }
  ]
}

处理逻辑

逻辑摘要列表查询（hotelOrderLogService.queryList）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /hotel/queryHotelOrderLogPage 未使用管理后台 #

订单操作日志表-分页查询 · HotelOrderLogController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelOrderLogController#queryHotelOrderLogPage
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_order_log

ControllerHotelOrderLogController#queryHotelOrderLogPage

转换BeanUtils.map → HotelOrderLogQuery

ServiceHotelOrderLogService#queryPage （HotelOrderLogServiceImpl）

MapperHotelOrderLogMapper#selectPage ⇒ 表 hotel_order_log

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/queryHotelOrderLogPage
uat	https://dscp-uat.hn12301.net/manage-api/hotel/queryHotelOrderLogPage
pro	https://dscp-uat.hn12301.net/manage-api/hotel/queryHotelOrderLogPage	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HotelOrderLogPageRequest

字段	类型	必填	取值/校验	表 / 列	说明
pageNum	Integer	否		—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否		—	每页条数（继承自框架分页基类 AbstractPageRequest）
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　PageInfo<HotelOrderLogResponse>　（page）

字段	类型	取值/校验	表 / 列	说明
list / records	array		—	分页列表，元素结构见下
total	long		—	总条数（PageInfo）
id	Long		`hotel_order_log`.`id`	日志ID
orderId	Long		`hotel_order_log`.`order_id`	订单ID
actionType	HotelOrderActionType	1创建订单2支付订单3确认订单4取消订单5入住6退房7提前退房	`hotel_order_log`.`action_type`	操作类型
actionNote	String		`hotel_order_log`.`action_note`	操作说明
actionSource	HotelOrderActionSource	1用户端2商户端3商铺端4平台端5系统	`hotel_order_log`.`action_source`	操作来源
operatorId	Long		`hotel_order_log`.`operator_id`	操作人ID
operatorName	String		`hotel_order_log`.`operator_name`	操作人名称
createdTime	Date		`hotel_order_log`.`created_time`	操作时间

示例

请求示例（自动生成，仅结构参考）

POST /hotel/queryHotelOrderLogPage

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1,
        "orderId": 1,
        "actionType": "1",
        "actionNote": "",
        "actionSource": "1",
        "operatorId": 1,
        "operatorName": "",
        "createdTime": "2026-01-01 12:00:00"
      }
    ],
    "total": 0
  }
}

处理逻辑

逻辑摘要分页查询（hotelOrderLogService.queryPage）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /hotel/updateHotelOrderLog 未使用管理后台 #

订单操作日志表-更新 · HotelOrderLogController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelOrderLogController#updateHotelOrderLog
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_order_log

ControllerHotelOrderLogController#updateHotelOrderLog

转换BeanUtils.map → HotelOrderLog ⇒ 表 hotel_order_log

ServiceHotelOrderLogService#update （HotelOrderLogServiceImpl）

MapperHotelOrderLogMapper#updateById ⇒ 表 hotel_order_log

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/updateHotelOrderLog
uat	https://dscp-uat.hn12301.net/manage-api/hotel/updateHotelOrderLog
pro	https://dscp-uat.hn12301.net/manage-api/hotel/updateHotelOrderLog	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HotelOrderLogUpdateRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long			`hotel_order_log`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /hotel/updateHotelOrderLog

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志hotel / 更新酒店订单日志

逻辑摘要更新（hotelOrderLogService.update）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

HotelOrderPaymentController 1/6 在用

POST /hotel/addHotelOrderPayment 未使用管理后台 #

订单支付表-新增 · HotelOrderPaymentController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelOrderPaymentController#addHotelOrderPayment
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_order_payment

ControllerHotelOrderPaymentController#addHotelOrderPayment

转换BeanUtils.map → HotelOrderPayment ⇒ 表 hotel_order_payment

ServiceHotelOrderPaymentService#add （HotelOrderPaymentServiceImpl）

MapperHotelOrderPaymentMapper#insert ⇒ 表 hotel_order_payment

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/addHotelOrderPayment
uat	https://dscp-uat.hn12301.net/manage-api/hotel/addHotelOrderPayment
pro	https://dscp-uat.hn12301.net/manage-api/hotel/addHotelOrderPayment	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HotelOrderPaymentAddRequest

字段	类型	必填	取值/校验	表 / 列	说明
name	String			—	名称

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /hotel/addHotelOrderPayment

{
  "body": {
    "name": ""
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志hotel / 新增酒店订单支付

逻辑摘要新增（hotelOrderPaymentService.add）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /hotel/deleteHotelOrderPayment 未使用管理后台 #

订单支付表-删除 · HotelOrderPaymentController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelOrderPaymentController#deleteHotelOrderPayment
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_order_payment

ControllerHotelOrderPaymentController#deleteHotelOrderPayment

ServiceHotelOrderPaymentService#delete （HotelOrderPaymentServiceImpl）

MapperHotelOrderPaymentMapper#deleteById ⇒ 表 hotel_order_payment

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/deleteHotelOrderPayment
uat	https://dscp-uat.hn12301.net/manage-api/hotel/deleteHotelOrderPayment
pro	https://dscp-uat.hn12301.net/manage-api/hotel/deleteHotelOrderPayment	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`hotel_order_payment`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /hotel/deleteHotelOrderPayment

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志hotel / 删除酒店订单支付

逻辑摘要删除（hotelOrderPaymentService.delete）

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /hotel/getHotelOrderPayment 未使用管理后台 #

订单支付表-详情 · HotelOrderPaymentController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelOrderPaymentController#getHotelOrderPayment
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_order_payment

ControllerHotelOrderPaymentController#getHotelOrderPayment

ServiceHotelOrderPaymentService#get （HotelOrderPaymentServiceImpl）

MapperHotelOrderPaymentMapper#selectById ⇒ 表 hotel_order_payment

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/getHotelOrderPayment
uat	https://dscp-uat.hn12301.net/manage-api/hotel/getHotelOrderPayment
pro	https://dscp-uat.hn12301.net/manage-api/hotel/getHotelOrderPayment	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`hotel_order_payment`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　HotelOrderPaymentResponse　（object）

字段	类型	取值/校验	表 / 列	说明
id	Long		`hotel_order_payment`.`id`	支付ID
orderId	Long		`hotel_order_payment`.`order_id`	订单ID
paymentNo	String		`hotel_order_payment`.`payment_no`	支付流水号
paymentMode	Integer		`hotel_order_payment`.`payment_mode`	支付方式(1-微信支付)
paymentAmount	Integer		`hotel_order_payment`.`payment_amount`	支付金额(分)
paymentType	HotelOrderPaymentType	1支付2全额退款3部分退款4押金5押金退还	`hotel_order_payment`.`payment_type`	支付状态(0-待支付,1-支付中,2-支付成功,3-支付失败,4-已退款,5-部分退款,6-退款中,7-退款失败))
paymentTime	Date		`hotel_order_payment`.`payment_time`	支付时间
refundAmount	Integer		`hotel_order_payment`.`refund_amount`	退款金额(分)
refundTime	Date		`hotel_order_payment`.`refund_time`	退款时间
transactionId	String		`hotel_order_payment`.`transaction_id`	微信支付订单号
paymentNote	String		`hotel_order_payment`.`payment_note`	支付备注
isDeleted	Boolean		`hotel_order_payment`.`is_deleted`	是否删除(0否 1是)
createdBy	Long		`hotel_order_payment`.`created_by`	创建人
createdTime	Date		`hotel_order_payment`.`created_time`
updatedBy	Long		`hotel_order_payment`.`updated_by`	修改人
updatedTime	Date		`hotel_order_payment`.`updated_time`

示例

请求示例（自动生成，仅结构参考）

POST /hotel/getHotelOrderPayment

{
  "body": {
    "id": 1
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": 1,
    "orderId": 1,
    "paymentNo": "",
    "paymentMode": 0,
    "paymentAmount": 0,
    "paymentType": "1",
    "paymentTime": "2026-01-01 12:00:00",
    "refundAmount": 0,
    "refundTime": "2026-01-01 12:00:00",
    "transactionId": "",
    "paymentNote": "",
    "isDeleted": false,
    "createdBy": 0,
    "createdTime": "2026-01-01 12:00:00",
    "updatedBy": 0,
    "updatedTime": "2026-01-01 12:00:00"
  }
}

处理逻辑

逻辑摘要查询详情（hotelOrderPaymentService.get）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /hotel/queryHotelOrderPaymentList 未使用管理后台 #

订单支付表-列表查询 · HotelOrderPaymentController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelOrderPaymentController#queryHotelOrderPaymentList
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_order_payment

ControllerHotelOrderPaymentController#queryHotelOrderPaymentList

转换BeanUtils.map → HotelOrderPaymentQuery

ServiceHotelOrderPaymentService#queryList （HotelOrderPaymentServiceImpl）

MapperHotelOrderPaymentMapper#selectList ⇒ 表 hotel_order_payment

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/queryHotelOrderPaymentList
uat	https://dscp-uat.hn12301.net/manage-api/hotel/queryHotelOrderPaymentList
pro	https://dscp-uat.hn12301.net/manage-api/hotel/queryHotelOrderPaymentList	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HotelOrderPaymentListRequest

字段	类型	必填	取值/校验	表 / 列	说明
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　List<HotelOrderPaymentResponse>　（list）

字段	类型	取值/校验	表 / 列	说明
[ ]	array		—	列表，元素结构见下
id	Long		`hotel_order_payment`.`id`	支付ID
orderId	Long		`hotel_order_payment`.`order_id`	订单ID
paymentNo	String		`hotel_order_payment`.`payment_no`	支付流水号
paymentMode	Integer		`hotel_order_payment`.`payment_mode`	支付方式(1-微信支付)
paymentAmount	Integer		`hotel_order_payment`.`payment_amount`	支付金额(分)
paymentType	HotelOrderPaymentType	1支付2全额退款3部分退款4押金5押金退还	`hotel_order_payment`.`payment_type`	支付状态(0-待支付,1-支付中,2-支付成功,3-支付失败,4-已退款,5-部分退款,6-退款中,7-退款失败))
paymentTime	Date		`hotel_order_payment`.`payment_time`	支付时间
refundAmount	Integer		`hotel_order_payment`.`refund_amount`	退款金额(分)
refundTime	Date		`hotel_order_payment`.`refund_time`	退款时间
transactionId	String		`hotel_order_payment`.`transaction_id`	微信支付订单号
paymentNote	String		`hotel_order_payment`.`payment_note`	支付备注
isDeleted	Boolean		`hotel_order_payment`.`is_deleted`	是否删除(0否 1是)
createdBy	Long		`hotel_order_payment`.`created_by`	创建人
createdTime	Date		`hotel_order_payment`.`created_time`
updatedBy	Long		`hotel_order_payment`.`updated_by`	修改人
updatedTime	Date		`hotel_order_payment`.`updated_time`

示例

请求示例（自动生成，仅结构参考）

POST /hotel/queryHotelOrderPaymentList

{
  "body": {
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "id": 1,
      "orderId": 1,
      "paymentNo": "",
      "paymentMode": 0,
      "paymentAmount": 0,
      "paymentType": "1",
      "paymentTime": "2026-01-01 12:00:00",
      "refundAmount": 0,
      "refundTime": "2026-01-01 12:00:00",
      "transactionId": "",
      "paymentNote": "",
      "isDeleted": false,
      "createdBy": 0,
      "createdTime": "2026-01-01 12:00:00",
      "updatedBy": 0,
      "updatedTime": "2026-01-01 12:00:00"
    }
  ]
}

处理逻辑

逻辑摘要列表查询（hotelOrderPaymentService.queryList）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /hotel/queryHotelOrderPaymentPage 在用管理后台 #

订单支付表-分页查询 · HotelOrderPaymentController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelOrderPaymentController#queryHotelOrderPaymentPage
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_orderhotel_order_payment

ControllerHotelOrderPaymentController#queryHotelOrderPaymentPage

转换BeanUtils.map → HotelOrderPaymentQuery

ServiceHotelOrderService#queryList （HotelOrderServiceImpl）

MapperHotelOrderMapper#selectList ⇒ 表 hotel_order

ServiceHotelOrderPaymentService#queryPage （HotelOrderPaymentServiceImpl）

MapperHotelOrderPaymentMapper#selectPage ⇒ 表 hotel_order_payment

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/queryHotelOrderPaymentPage
uat	https://dscp-uat.hn12301.net/manage-api/hotel/queryHotelOrderPaymentPage
pro	https://dscp-uat.hn12301.net/manage-api/hotel/queryHotelOrderPaymentPage	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HotelOrderPaymentPageRequest

字段	类型	必填	取值/校验	表 / 列	说明
pageNum	Integer	否		—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否		—	每页条数（继承自框架分页基类 AbstractPageRequest）
merchantId	Long			`hotel_order`.`merchant_id`	所属商户id
shopId	Long			`hotel_order`.`shop_id`	所属商铺id
orderId	Long	否	可选(@MvcOptional)	`hotel_order_payment`.`order_id`
paymentType	HotelOrderPaymentType	否	1支付2全额退款3部分退款4押金5押金退还	`hotel_order_payment`.`payment_type`
createdTimeRange	Date[]	否	可选(@MvcOptional)	—	下单时间
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　PageInfo<HotelOrderPaymentResponse>　（page）

字段	类型	取值/校验	表 / 列	说明
list / records	array		—	分页列表，元素结构见下
total	long		—	总条数（PageInfo）
id	Long		`hotel_order`.`id`	支付ID
orderId	Long		`hotel_order_payment`.`order_id`	订单ID
paymentNo	String		`hotel_order_payment`.`payment_no`	支付流水号
paymentMode	Integer		`hotel_order_payment`.`payment_mode`	支付方式(1-微信支付)
paymentAmount	Integer		`hotel_order_payment`.`payment_amount`	支付金额(分)
paymentType	HotelOrderPaymentType	1支付2全额退款3部分退款4押金5押金退还	`hotel_order_payment`.`payment_type`	支付状态(0-待支付,1-支付中,2-支付成功,3-支付失败,4-已退款,5-部分退款,6-退款中,7-退款失败))
paymentTime	Date		`hotel_order_payment`.`payment_time`	支付时间
refundAmount	Integer		`hotel_order_payment`.`refund_amount`	退款金额(分)
refundTime	Date		`hotel_order_payment`.`refund_time`	退款时间
transactionId	String		`hotel_order_payment`.`transaction_id`	微信支付订单号
paymentNote	String		`hotel_order_payment`.`payment_note`	支付备注
isDeleted	Boolean		`hotel_order`.`is_deleted`	是否删除(0否 1是)
createdBy	Long		`hotel_order`.`created_by`	创建人
createdTime	Date		`hotel_order`.`created_time`
updatedBy	Long		`hotel_order`.`updated_by`	修改人
updatedTime	Date		`hotel_order`.`updated_time`

示例

请求示例（自动生成，仅结构参考）

POST /hotel/queryHotelOrderPaymentPage

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "merchantId": 1,
    "shopId": 1,
    "orderId": 1,
    "paymentType": "1",
    "createdTimeRange": "2026-01-01 12:00:00",
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1,
        "orderId": 1,
        "paymentNo": "",
        "paymentMode": 0,
        "paymentAmount": 0,
        "paymentType": "1",
        "paymentTime": "2026-01-01 12:00:00",
        "refundAmount": 0,
        "refundTime": "2026-01-01 12:00:00",
        "transactionId": "",
        "paymentNote": "",
        "isDeleted": false,
        "createdBy": 0,
        "createdTime": "2026-01-01 12:00:00",
        "updatedBy": 0,
        "updatedTime": "2026-01-01 12:00:00"
      }
    ],
    "total": 0
  }
}

处理逻辑

逻辑摘要列表查询（hotelOrderService.queryList）；分页查询（hotelOrderPaymentService.queryPage）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

如果有merchantId或shopId，先查询符合条件的订单ID
如果没有符合条件的订单，直接返回空结果
提取订单ID列表
设置订单ID条件
设置其他查询条件

前端调用方

dscp-html-manage queryHotelOrderPaymentPage exact

POST /hotel/updateHotelOrderPayment 未使用管理后台 #

订单支付表-更新 · HotelOrderPaymentController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelOrderPaymentController#updateHotelOrderPayment
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_order_payment

ControllerHotelOrderPaymentController#updateHotelOrderPayment

转换BeanUtils.map → HotelOrderPayment ⇒ 表 hotel_order_payment

ServiceHotelOrderPaymentService#update （HotelOrderPaymentServiceImpl）

MapperHotelOrderPaymentMapper#updateById ⇒ 表 hotel_order_payment

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/updateHotelOrderPayment
uat	https://dscp-uat.hn12301.net/manage-api/hotel/updateHotelOrderPayment
pro	https://dscp-uat.hn12301.net/manage-api/hotel/updateHotelOrderPayment	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HotelOrderPaymentUpdateRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long			`hotel_order_payment`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /hotel/updateHotelOrderPayment

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志hotel / 更新酒店订单支付

逻辑摘要更新（hotelOrderPaymentService.update）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

HotelOrderRoomController 0/6 在用

POST /hotel/addHotelOrderRoom 未使用管理后台 #

订单房间明细表-新增 · HotelOrderRoomController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelOrderRoomController#addHotelOrderRoom
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_order_room

ControllerHotelOrderRoomController#addHotelOrderRoom

转换BeanUtils.map → HotelOrderRoom ⇒ 表 hotel_order_room

ServiceHotelOrderRoomService#add （HotelOrderRoomServiceImpl）

MapperHotelOrderRoomMapper#insert ⇒ 表 hotel_order_room

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/addHotelOrderRoom
uat	https://dscp-uat.hn12301.net/manage-api/hotel/addHotelOrderRoom
pro	https://dscp-uat.hn12301.net/manage-api/hotel/addHotelOrderRoom	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HotelOrderRoomAddRequest

字段	类型	必填	取值/校验	表 / 列	说明
name	String			—	名称

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /hotel/addHotelOrderRoom

{
  "body": {
    "name": ""
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志hotel / 新增酒店订单房间

逻辑摘要新增（hotelOrderRoomService.add）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /hotel/deleteHotelOrderRoom 未使用管理后台 #

订单房间明细表-删除 · HotelOrderRoomController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelOrderRoomController#deleteHotelOrderRoom
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_order_room

ControllerHotelOrderRoomController#deleteHotelOrderRoom

ServiceHotelOrderRoomService#delete （HotelOrderRoomServiceImpl）

MapperHotelOrderRoomMapper#deleteById ⇒ 表 hotel_order_room

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/deleteHotelOrderRoom
uat	https://dscp-uat.hn12301.net/manage-api/hotel/deleteHotelOrderRoom
pro	https://dscp-uat.hn12301.net/manage-api/hotel/deleteHotelOrderRoom	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`hotel_order_room`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /hotel/deleteHotelOrderRoom

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志hotel / 删除酒店订单房间

逻辑摘要删除（hotelOrderRoomService.delete）

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /hotel/getHotelOrderRoom 未使用管理后台 #

订单房间明细表-详情 · HotelOrderRoomController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelOrderRoomController#getHotelOrderRoom
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_order_room

ControllerHotelOrderRoomController#getHotelOrderRoom

ServiceHotelOrderRoomService#get （HotelOrderRoomServiceImpl）

MapperHotelOrderRoomMapper#selectById ⇒ 表 hotel_order_room

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/getHotelOrderRoom
uat	https://dscp-uat.hn12301.net/manage-api/hotel/getHotelOrderRoom
pro	https://dscp-uat.hn12301.net/manage-api/hotel/getHotelOrderRoom	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`hotel_order_room`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　HotelOrderRoomResponse　（object）

字段	类型	必填	取值/校验	表 / 列	说明
id	Long			`hotel_order_room`.`id`	id

示例

请求示例（自动生成，仅结构参考）

POST /hotel/getHotelOrderRoom

{
  "body": {
    "id": 1
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": 1
  }
}

处理逻辑

逻辑摘要查询详情（hotelOrderRoomService.get）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /hotel/queryHotelOrderRoomList 未使用管理后台 #

订单房间明细表-列表查询 · HotelOrderRoomController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelOrderRoomController#queryHotelOrderRoomList
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_order_room

ControllerHotelOrderRoomController#queryHotelOrderRoomList

转换BeanUtils.map → HotelOrderRoomQuery

ServiceHotelOrderRoomService#queryList （HotelOrderRoomServiceImpl）

MapperHotelOrderRoomMapper#selectList ⇒ 表 hotel_order_room

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/queryHotelOrderRoomList
uat	https://dscp-uat.hn12301.net/manage-api/hotel/queryHotelOrderRoomList
pro	https://dscp-uat.hn12301.net/manage-api/hotel/queryHotelOrderRoomList	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HotelOrderRoomListRequest

字段	类型	必填	取值/校验	表 / 列	说明
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　List<HotelOrderRoomResponse>　（list）

字段	类型	必填	取值/校验	表 / 列	说明
[ ]	array			—	列表，元素结构见下
id	Long			`hotel_order_room`.`id`	id

示例

请求示例（自动生成，仅结构参考）

POST /hotel/queryHotelOrderRoomList

{
  "body": {
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "id": 1
    }
  ]
}

处理逻辑

逻辑摘要列表查询（hotelOrderRoomService.queryList）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /hotel/queryHotelOrderRoomPage 未使用管理后台 #

订单房间明细表-分页查询 · HotelOrderRoomController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelOrderRoomController#queryHotelOrderRoomPage
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_order_room

ControllerHotelOrderRoomController#queryHotelOrderRoomPage

转换BeanUtils.map → HotelOrderRoomQuery

ServiceHotelOrderRoomService#queryPage （HotelOrderRoomServiceImpl）

MapperHotelOrderRoomMapper#selectPage ⇒ 表 hotel_order_room

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/queryHotelOrderRoomPage
uat	https://dscp-uat.hn12301.net/manage-api/hotel/queryHotelOrderRoomPage
pro	https://dscp-uat.hn12301.net/manage-api/hotel/queryHotelOrderRoomPage	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HotelOrderRoomPageRequest

字段	类型	必填	取值/校验	表 / 列	说明
pageNum	Integer	否		—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否		—	每页条数（继承自框架分页基类 AbstractPageRequest）
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　PageInfo<HotelOrderRoomResponse>　（page）

字段	类型	表 / 列	说明
list / records	array	—	分页列表，元素结构见下
total	long	—	总条数（PageInfo）
id	Long	`hotel_order_room`.`id`	id

示例

请求示例（自动生成，仅结构参考）

POST /hotel/queryHotelOrderRoomPage

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1
      }
    ],
    "total": 0
  }
}

处理逻辑

逻辑摘要分页查询（hotelOrderRoomService.queryPage）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /hotel/updateHotelOrderRoom 未使用管理后台 #

订单房间明细表-更新 · HotelOrderRoomController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelOrderRoomController#updateHotelOrderRoom
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_order_room

ControllerHotelOrderRoomController#updateHotelOrderRoom

转换BeanUtils.map → HotelOrderRoom ⇒ 表 hotel_order_room

ServiceHotelOrderRoomService#update （HotelOrderRoomServiceImpl）

MapperHotelOrderRoomMapper#updateById ⇒ 表 hotel_order_room

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/updateHotelOrderRoom
uat	https://dscp-uat.hn12301.net/manage-api/hotel/updateHotelOrderRoom
pro	https://dscp-uat.hn12301.net/manage-api/hotel/updateHotelOrderRoom	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HotelOrderRoomUpdateRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long			`hotel_order_room`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /hotel/updateHotelOrderRoom

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志hotel / 更新酒店订单房间

逻辑摘要更新（hotelOrderRoomService.update）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

HotelRoomAttrController 0/6 在用

POST /hotel/addHotelRoomAttr 未使用管理后台 #

房型属性分类表-新增 · HotelRoomAttrController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelRoomAttrController#addHotelRoomAttr
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_room_attr

ControllerHotelRoomAttrController#addHotelRoomAttr

转换BeanUtils.map → HotelRoomAttr ⇒ 表 hotel_room_attr

ServiceHotelRoomAttrService#add （HotelRoomAttrServiceImpl）

MapperHotelRoomAttrMapper#insert ⇒ 表 hotel_room_attr

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/addHotelRoomAttr
uat	https://dscp-uat.hn12301.net/manage-api/hotel/addHotelRoomAttr
pro	https://dscp-uat.hn12301.net/manage-api/hotel/addHotelRoomAttr	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HotelRoomAttrAddRequest

字段	类型	必填	取值/校验	表 / 列	说明
name	String			`hotel_room_attr`.`name`	名称

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /hotel/addHotelRoomAttr

{
  "body": {
    "name": ""
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志hotel / 新增房间属性

逻辑摘要新增（hotelRoomAttrService.add）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /hotel/deleteHotelRoomAttr 未使用管理后台 #

房型属性分类表-删除 · HotelRoomAttrController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelRoomAttrController#deleteHotelRoomAttr
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_room_attr

ControllerHotelRoomAttrController#deleteHotelRoomAttr

ServiceHotelRoomAttrService#delete （HotelRoomAttrServiceImpl）

MapperHotelRoomAttrMapper#deleteById ⇒ 表 hotel_room_attr

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/deleteHotelRoomAttr
uat	https://dscp-uat.hn12301.net/manage-api/hotel/deleteHotelRoomAttr
pro	https://dscp-uat.hn12301.net/manage-api/hotel/deleteHotelRoomAttr	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`hotel_room_attr`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /hotel/deleteHotelRoomAttr

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志hotel / 删除房间属性

逻辑摘要删除（hotelRoomAttrService.delete）

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /hotel/getHotelRoomAttr 未使用管理后台 #

房型属性分类表-详情 · HotelRoomAttrController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelRoomAttrController#getHotelRoomAttr
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_room_attr

ControllerHotelRoomAttrController#getHotelRoomAttr

ServiceHotelRoomAttrService#get （HotelRoomAttrServiceImpl）

MapperHotelRoomAttrMapper#selectById ⇒ 表 hotel_room_attr

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/getHotelRoomAttr
uat	https://dscp-uat.hn12301.net/manage-api/hotel/getHotelRoomAttr
pro	https://dscp-uat.hn12301.net/manage-api/hotel/getHotelRoomAttr	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`hotel_room_attr`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　HotelRoomAttrResponse　（object）

字段	类型	必填	取值/校验	表 / 列	说明
id	Long			`hotel_room_attr`.`id`	id

示例

请求示例（自动生成，仅结构参考）

POST /hotel/getHotelRoomAttr

{
  "body": {
    "id": 1
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": 1
  }
}

处理逻辑

逻辑摘要查询详情（hotelRoomAttrService.get）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /hotel/queryHotelRoomAttrList 未使用管理后台 #

房型属性分类表-列表查询 · HotelRoomAttrController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelRoomAttrController#queryHotelRoomAttrList
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_room_attr

ControllerHotelRoomAttrController#queryHotelRoomAttrList

转换BeanUtils.map → HotelRoomAttrQuery

ServiceHotelRoomAttrService#queryList （HotelRoomAttrServiceImpl）

MapperHotelRoomAttrMapper#selectList ⇒ 表 hotel_room_attr

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/queryHotelRoomAttrList
uat	https://dscp-uat.hn12301.net/manage-api/hotel/queryHotelRoomAttrList
pro	https://dscp-uat.hn12301.net/manage-api/hotel/queryHotelRoomAttrList	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HotelRoomAttrListRequest

字段	类型	必填	取值/校验	表 / 列	说明
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　List<HotelRoomAttrResponse>　（list）

字段	类型	必填	取值/校验	表 / 列	说明
[ ]	array			—	列表，元素结构见下
id	Long			`hotel_room_attr`.`id`	id

示例

请求示例（自动生成，仅结构参考）

POST /hotel/queryHotelRoomAttrList

{
  "body": {
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "id": 1
    }
  ]
}

处理逻辑

逻辑摘要列表查询（hotelRoomAttrService.queryList）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /hotel/queryHotelRoomAttrPage 未使用管理后台 #

房型属性分类表-分页查询 · HotelRoomAttrController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelRoomAttrController#queryHotelRoomAttrPage
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_room_attr

ControllerHotelRoomAttrController#queryHotelRoomAttrPage

转换BeanUtils.map → HotelRoomAttrQuery

ServiceHotelRoomAttrService#queryPage （HotelRoomAttrServiceImpl）

MapperHotelRoomAttrMapper#selectPage ⇒ 表 hotel_room_attr

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/queryHotelRoomAttrPage
uat	https://dscp-uat.hn12301.net/manage-api/hotel/queryHotelRoomAttrPage
pro	https://dscp-uat.hn12301.net/manage-api/hotel/queryHotelRoomAttrPage	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HotelRoomAttrPageRequest

字段	类型	必填	取值/校验	表 / 列	说明
pageNum	Integer	否		—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否		—	每页条数（继承自框架分页基类 AbstractPageRequest）
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　PageInfo<HotelRoomAttrResponse>　（page）

字段	类型	表 / 列	说明
list / records	array	—	分页列表，元素结构见下
total	long	—	总条数（PageInfo）
id	Long	`hotel_room_attr`.`id`	id

示例

请求示例（自动生成，仅结构参考）

POST /hotel/queryHotelRoomAttrPage

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1
      }
    ],
    "total": 0
  }
}

处理逻辑

逻辑摘要分页查询（hotelRoomAttrService.queryPage）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /hotel/updateHotelRoomAttr 未使用管理后台 #

房型属性分类表-更新 · HotelRoomAttrController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelRoomAttrController#updateHotelRoomAttr
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_room_attr

ControllerHotelRoomAttrController#updateHotelRoomAttr

转换BeanUtils.map → HotelRoomAttr ⇒ 表 hotel_room_attr

ServiceHotelRoomAttrService#update （HotelRoomAttrServiceImpl）

MapperHotelRoomAttrMapper#updateById ⇒ 表 hotel_room_attr

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/updateHotelRoomAttr
uat	https://dscp-uat.hn12301.net/manage-api/hotel/updateHotelRoomAttr
pro	https://dscp-uat.hn12301.net/manage-api/hotel/updateHotelRoomAttr	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HotelRoomAttrUpdateRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long			`hotel_room_attr`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /hotel/updateHotelRoomAttr

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志hotel / 更新房间属性

逻辑摘要更新（hotelRoomAttrService.update）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

HotelRoomAttrRelController 0/6 在用

POST /hotel/addHotelRoomAttrRel 未使用管理后台 #

房型属性关联表-新增 · HotelRoomAttrRelController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelRoomAttrRelController#addHotelRoomAttrRel
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_room_attr_rel

ControllerHotelRoomAttrRelController#addHotelRoomAttrRel

转换BeanUtils.map → HotelRoomAttrRel ⇒ 表 hotel_room_attr_rel

ServiceHotelRoomAttrRelService#add （HotelRoomAttrRelServiceImpl）

MapperHotelRoomAttrRelMapper#insert ⇒ 表 hotel_room_attr_rel

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/addHotelRoomAttrRel
uat	https://dscp-uat.hn12301.net/manage-api/hotel/addHotelRoomAttrRel
pro	https://dscp-uat.hn12301.net/manage-api/hotel/addHotelRoomAttrRel	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HotelRoomAttrRelAddRequest

字段	类型	必填	取值/校验	表 / 列	说明
name	String			—	名称

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /hotel/addHotelRoomAttrRel

{
  "body": {
    "name": ""
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志hotel / 新增房间属性关联

逻辑摘要新增（hotelRoomAttrRelService.add）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /hotel/deleteHotelRoomAttrRel 未使用管理后台 #

房型属性关联表-删除 · HotelRoomAttrRelController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelRoomAttrRelController#deleteHotelRoomAttrRel
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_room_attr_rel

ControllerHotelRoomAttrRelController#deleteHotelRoomAttrRel

ServiceHotelRoomAttrRelService#delete （HotelRoomAttrRelServiceImpl）

MapperHotelRoomAttrRelMapper#deleteById ⇒ 表 hotel_room_attr_rel

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/deleteHotelRoomAttrRel
uat	https://dscp-uat.hn12301.net/manage-api/hotel/deleteHotelRoomAttrRel
pro	https://dscp-uat.hn12301.net/manage-api/hotel/deleteHotelRoomAttrRel	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`hotel_room_attr_rel`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /hotel/deleteHotelRoomAttrRel

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志hotel / 删除房间属性关联

逻辑摘要删除（hotelRoomAttrRelService.delete）

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /hotel/getHotelRoomAttrRel 未使用管理后台 #

房型属性关联表-详情 · HotelRoomAttrRelController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelRoomAttrRelController#getHotelRoomAttrRel
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_room_attr_rel

ControllerHotelRoomAttrRelController#getHotelRoomAttrRel

ServiceHotelRoomAttrRelService#get （HotelRoomAttrRelServiceImpl）

MapperHotelRoomAttrRelMapper#selectById ⇒ 表 hotel_room_attr_rel

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/getHotelRoomAttrRel
uat	https://dscp-uat.hn12301.net/manage-api/hotel/getHotelRoomAttrRel
pro	https://dscp-uat.hn12301.net/manage-api/hotel/getHotelRoomAttrRel	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`hotel_room_attr_rel`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　HotelRoomAttrRelResponse　（object）

字段	类型	必填	取值/校验	表 / 列	说明
id	Long			`hotel_room_attr_rel`.`id`	id

示例

请求示例（自动生成，仅结构参考）

POST /hotel/getHotelRoomAttrRel

{
  "body": {
    "id": 1
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": 1
  }
}

处理逻辑

逻辑摘要查询详情（hotelRoomAttrRelService.get）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /hotel/queryHotelRoomAttrRelList 未使用管理后台 #

房型属性关联表-列表查询 · HotelRoomAttrRelController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelRoomAttrRelController#queryHotelRoomAttrRelList
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_room_attr_rel

ControllerHotelRoomAttrRelController#queryHotelRoomAttrRelList

转换BeanUtils.map → HotelRoomAttrRelQuery

ServiceHotelRoomAttrRelService#queryList （HotelRoomAttrRelServiceImpl）

MapperHotelRoomAttrRelMapper#selectList ⇒ 表 hotel_room_attr_rel

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/queryHotelRoomAttrRelList
uat	https://dscp-uat.hn12301.net/manage-api/hotel/queryHotelRoomAttrRelList
pro	https://dscp-uat.hn12301.net/manage-api/hotel/queryHotelRoomAttrRelList	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HotelRoomAttrRelListRequest

字段	类型	必填	取值/校验	表 / 列	说明
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　List<HotelRoomAttrRelResponse>　（list）

字段	类型	必填	取值/校验	表 / 列	说明
[ ]	array			—	列表，元素结构见下
id	Long			`hotel_room_attr_rel`.`id`	id

示例

请求示例（自动生成，仅结构参考）

POST /hotel/queryHotelRoomAttrRelList

{
  "body": {
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "id": 1
    }
  ]
}

处理逻辑

逻辑摘要列表查询（hotelRoomAttrRelService.queryList）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /hotel/queryHotelRoomAttrRelPage 未使用管理后台 #

房型属性关联表-分页查询 · HotelRoomAttrRelController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelRoomAttrRelController#queryHotelRoomAttrRelPage
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_room_attr_rel

ControllerHotelRoomAttrRelController#queryHotelRoomAttrRelPage

转换BeanUtils.map → HotelRoomAttrRelQuery

ServiceHotelRoomAttrRelService#queryPage （HotelRoomAttrRelServiceImpl）

MapperHotelRoomAttrRelMapper#selectPage ⇒ 表 hotel_room_attr_rel

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/queryHotelRoomAttrRelPage
uat	https://dscp-uat.hn12301.net/manage-api/hotel/queryHotelRoomAttrRelPage
pro	https://dscp-uat.hn12301.net/manage-api/hotel/queryHotelRoomAttrRelPage	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HotelRoomAttrRelPageRequest

字段	类型	必填	取值/校验	表 / 列	说明
pageNum	Integer	否		—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否		—	每页条数（继承自框架分页基类 AbstractPageRequest）
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　PageInfo<HotelRoomAttrRelResponse>　（page）

字段	类型	表 / 列	说明
list / records	array	—	分页列表，元素结构见下
total	long	—	总条数（PageInfo）
id	Long	`hotel_room_attr_rel`.`id`	id

示例

请求示例（自动生成，仅结构参考）

POST /hotel/queryHotelRoomAttrRelPage

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1
      }
    ],
    "total": 0
  }
}

处理逻辑

逻辑摘要分页查询（hotelRoomAttrRelService.queryPage）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /hotel/updateHotelRoomAttrRel 未使用管理后台 #

房型属性关联表-更新 · HotelRoomAttrRelController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelRoomAttrRelController#updateHotelRoomAttrRel
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_room_attr_rel

ControllerHotelRoomAttrRelController#updateHotelRoomAttrRel

转换BeanUtils.map → HotelRoomAttrRel ⇒ 表 hotel_room_attr_rel

ServiceHotelRoomAttrRelService#update （HotelRoomAttrRelServiceImpl）

MapperHotelRoomAttrRelMapper#updateById ⇒ 表 hotel_room_attr_rel

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/updateHotelRoomAttrRel
uat	https://dscp-uat.hn12301.net/manage-api/hotel/updateHotelRoomAttrRel
pro	https://dscp-uat.hn12301.net/manage-api/hotel/updateHotelRoomAttrRel	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HotelRoomAttrRelUpdateRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long			`hotel_room_attr_rel`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /hotel/updateHotelRoomAttrRel

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志hotel / 更新房间属性关联

逻辑摘要更新（hotelRoomAttrRelService.update）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

HotelRoomPriceCalendarController 5/8 在用

POST /hotel/addHotelRoomPriceCalendar 在用管理后台 #

价格日历表-新增 · HotelRoomPriceCalendarController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelRoomPriceCalendarController#addHotelRoomPriceCalendar
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_room_type_planhotel_room_price_calendarhotel_info

ControllerHotelRoomPriceCalendarController#addHotelRoomPriceCalendar

ServiceHotelRoomTypePlanService#get （HotelRoomTypePlanServiceImpl）

MapperHotelRoomTypePlanMapper#selectById ⇒ 表 hotel_room_type_plan

ServiceHotelRoomPriceCalendarService#queryList （HotelRoomPriceCalendarServiceImpl）

MapperHotelRoomPriceCalendarMapper#selectList ⇒ 表 hotel_room_price_calendar

ServiceHotelInfoService#get （HotelInfoServiceImpl）

MapperHotelInfoMapper#selectById ⇒ 表 hotel_info

ServiceHotelRoomPriceCalendarService#add （HotelRoomPriceCalendarServiceImpl）

MapperHotelRoomPriceCalendarMapper#insert ⇒ 表 hotel_room_price_calendar

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 1

SessionUserService.getSessionUser

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/hotel/addHotelRoomPriceCalendar
uat	https://dscp-uat.hn12301.net/manage-api/hotel/addHotelRoomPriceCalendar
pro	https://dscp-uat.hn12301.net/manage-api/hotel/addHotelRoomPriceCalendar	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HotelRoomPriceCalendarAddRequest

字段	类型	必填	取值/校验	表 / 列	说明
hotelId	Long	是	必填	`hotel_room_type_plan`.`hotel_id`	酒店ID
roomTypeId	Long	是	必填	`hotel_room_type_plan`.`room_type_id`	房型ID
planId	Long	是	必填	`hotel_room_price_calendar`.`plan_id`	价格方案ID
date	Date	是	必填	`hotel_room_price_calendar`.`date`	日期
basePrice	Integer	是	必填	`hotel_room_type_plan`.`base_price`	基础价格（单位：分）
salePrice	Integer			`hotel_room_type_plan`.`sale_price`	销售价格（单位：分）
totalRooms	Integer	是	必填	`hotel_room_price_calendar`.`total_rooms`	总房间数
availableRooms	Integer	是	必填	`hotel_room_price_calendar`.`available_rooms`	可用房间数
bookedRooms	Integer			`hotel_room_price_calendar`.`booked_rooms`	已订房间数
status	Integer			`hotel_room_type_plan`.`status`	状态（0-正常，1-停售）

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /hotel/addHotelRoomPriceCalendar

{
  "body": {
    "hotelId": 1,
    "roomTypeId": 1,
    "planId": 1,
    "date": "2026-01-01 12:00:00",
    "basePrice": 0,
    "salePrice": 0,
    "totalRooms": 0,
    "availableRooms": 0,
    "bookedRooms": 0,
    "status": 0
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志hotel / 新增价格日历

逻辑摘要查询详情（hotelRoomTypePlanService.get）；列表查询（hotelRoomPriceCalendarService.queryList）；查询详情（hotelInfoService.get）

内联注释

1. 检查日期是否已过期（只比较年月日）
2. 查询价格方案信息，验证数据
3. 检查是否已存在该日期的价格日历
4. 构建并保存价格日历

前端调用方

dscp-html-manage addHotelRoomPriceCalendar exact

POST /hotel/batchUpdateRoomPriceCalendar 在用管理后台 #

批量设置价格日历 · HotelRoomPriceCalendarController

基本信息

控制器	com.jxxx.dscp.api.controller.hotel.HotelRoomPriceCalendarController#batchUpdateRoomPriceCalendar
所属模块	酒店 `hotel`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hotel_infohotel_room_type_planhotel_room_price_calendar

ControllerHotelRoomPriceCalendarController#batchUpdateRoomPriceCalendar