234527639f
43 #4573 配房询房即扣库存+单日确认requirementId+弹窗全态回显currentSelections(前端必改) 44 #4574 日历团数按团期折叠修复+某天下钻详情新端点 45 #4575 待办按订单聚合一行多类型标签+类型字典化(前端必改) 46 #4578 定制师联系房务未读角标unreadMessageCount+站内信标题团号·联系人 47 #4576 转单操作日志显示接收人真名+转单理由(知悉)
45 行
2.0 KiB
Markdown
45 行
2.0 KiB
Markdown
# 房务日历：团数按团期折叠修复 + 新增「某天下钻详情」端点（前端对接）
|
||
|
||
> 模块：房务管家 · 日历视图（管理后台）
|
||
> 类型：计数修复 + 新增端点（PR #4586 已合 dev-v3 + 测试服实测）
|
||
> 关联工单：#4574
|
||
> 日期：2026-06-28
|
||
|
||
## 1. 【修复·知悉】日历「共 N 团」不再按子订单膨胀
|
||
|
||
房务反馈「某天显示『共 32 团』，实际就 3 个团」。
|
||
|
||
- 根因：原按 `distinct order_id` 计数，但一个团期(productBatchId)会拆成多个子订单(1 单=1 房)，3 个团期约 32 间房被算成 32 团。
|
||
- 已修：`GET /admin/house/calendar` 的 `tourCount` 与各状态点计数改按**团期优先键**折叠（同团期多子订单当天折叠为 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/**`。
|