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

> 模块：房务管家 · 日历视图（管理后台）
> 类型：计数修复 + 新增端点（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/**`。