POST/hotel/queryHotelCommentStats管理后台

评价统计

酒店 / 点评· HotelCommentController#queryHotelCommentStats

基本信息

接口状态前端在用置信度高
接口URLPOSThttps://dscp-dev.hn12301.net/manage-api/hotel/queryHotelCommentStats
请求方式POST
Content-Typeapplication/json
暴露渠道管理后台　前缀 /manage-api
名称来源源码注释
调用方已确认在用 · 管理后台（1 个前端）
需求上下文自动接单
维护人 / 最后改动hao　2025-01-03　最近提交：自动接单
读写数据表hotel_comment　反查该表全部接口 →
控制器com.jxxx.dscp.api.controller.hotel.HotelCommentController#queryHotelCommentStats
源码位置jxxx-dscp/dscp-service-business/src/main/java/com/jxxx/dscp/api/controller/hotel/HotelCommentController.java:297
判定依据1 个调用点：dscp-html-manage/src/api/hotel/hotel.ts

请求参数

Header 请求参数

参数名	参数值	是否必填	参数类型	描述说明
无（渠道统一鉴权头见《认证方式》）

Query 请求参数

参数名	参数值	是否必填	参数类型	描述说明
无

路径参数及说明

参数名	参数值	是否必填	参数类型	描述说明
无

Body 请求参数

Body 类型 HotelCommentStatsRequest

参数名	参数值	是否必填	参数类型	描述说明
hotelId	…	否	Long	酒店ID → hotel_comment.hotel_id
timeRange	…	否	String	时间范围：today-今日, week-本周, month-本月

认证方式

需登录态：Authorization: Bearer <token>（多租户另带 tenant-id）；30002 会话失效需重登。详见全局公共参数。

响应参数

data 类型 HotelCommentStatsResponse

参数名	参数值	是否必填	参数类型	描述说明
totalCount	…	否	Long	总评价数
avgRating	…	否	Double	平均评分
pendingCount	…	否	Long	待审核数
goodRatePercent	…	否	Double	好评率
totalCountChange	…	否	Double	总评价数变化率
avgRatingChange	…	否	Double	平均评分变化率
pendingCountChange	…	否	Double	待审核数变化率
goodRateChange	…	否	Double	好评率变化率

响应示例

成功响应示例 code=0

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

示例来自源码/导出内容，仅结构参考，非线上真实数据。

附录 · 实现细节

调用链 / 数据表 / 调用点证据 / 源码注释 / 逻辑摘要

涉及数据表：hotel_comment　反查全部引用接口 →

HotelCommentController#queryHotelCommentStats
HotelCommentService#queryList（HotelCommentServiceImpl）
HotelCommentMapper#queryList

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

源码内联注释（旧站解析结果）

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

旧站环境备注：pro：（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

调用点证据

dscp-html-manage/src/api/hotel/hotel.ts:206　管理后台 · request