hl-api-changelog/changelogs-v2/2026-06/44_4574_房务日历团数按团期折叠修复_某天下钻详情新端点_前端对接-管理后台.md
API Changelog Bot 234527639f docs(changelog-v2/house): 房务测试报告(1.docx)整改批次前端对接
43 #4573 配房询房即扣库存+单日确认requirementId+弹窗全态回显currentSelections(前端必改)
44 #4574 日历团数按团期折叠修复+某天下钻详情新端点
45 #4575 待办按订单聚合一行多类型标签+类型字典化(前端必改)
46 #4578 定制师联系房务未读角标unreadMessageCount+站内信标题团号·联系人
47 #4576 转单操作日志显示接收人真名+转单理由(知悉)
2026-06-28 20:07:43 +08:00

2.0 KiB

房务日历:团数按团期折叠修复 + 新增「某天下钻详情」端点(前端对接)

模块:房务管家 · 日历视图(管理后台) 类型:计数修复 + 新增端点PR #4586 已合 dev-v3 + 测试服实测) 关联工单:#4574 日期2026-06-28

1. 【修复·知悉】日历「共 N 团」不再按子订单膨胀

房务反馈「某天显示『共 32 团』,实际就 3 个团」。

  • 根因:原按 distinct order_id 计数,但一个团期(productBatchId)会拆成多个子订单(1 单=1 房),3 个团期约 32 间房被算成 32 团。
  • 已修:GET /admin/house/calendartourCount 与各状态点计数改按团期优先键折叠(同团期多子订单当天折叠为 1 团;散客无团期则回退订单维度,行为不变)。
  • 前端无需改,数字自动正确。

2. 【新增端点·对接】某天团明细下钻

为解决「日历详情信息太少」,新增下钻端点供点开某天时展示团明细。

GET /admin/house/calendar/day

入参 必填 说明
date 日期 yyyy-MM-dd
scope mine(默认)/all
status 按状态桶过滤(进行中/询房中/待配房/异常)

返回 List<DayTourItemVO>(按团折叠),每项字段:

字段 说明
productName 团期/产品名(标题)
orderNo / orderId 团号 / 订单号
customerName / adultCount / roomCount 客人 / 人数 / 间数(团维度合计)
hotelName 酒店(快照)
roomCategory 房型(已翻中文 label,如「标准间」)
stayDate 入住日
status / statusLabel 状态桶 + 中文标签
claimerName 房务(仅 scope=all 回填)

测试服实测

  • 某天 2 行配房同属 1 单 → tourCount=1未膨胀;多团期分别计 1。
  • 下钻端点字段齐全、房型中文(标准间);同团期多子订单折叠为 1 项 roomCount 合计。
  • 网关路由已覆盖 /admin/house/calendar/**