# 40_房务月度对账页面简化为已配房酒店汇总表-前端待处理-管理后台

## 背景

房务管家「月度对账」页面当前展示了顶部统计卡片、现结汇总、空态大框等内容，和当前业务验收口径不一致。

月度对账当前只需要展示本月所有「配房完毕」订单对应的酒店汇总表。

## 前端调整

页面路径：

- `/housekeeper/ledger`

需要去掉：

1. 顶部“现结 X 家 · X 单”汇总文案。
2. “现结合计 / 现结酒店 / 本月间夜”等统计卡片。
3. 中间大块空态容器，例如“本月暂无现结账单”。

需要保留：

1. 月份筛选。
2. 导出 Excel。
3. 生成 PDF。
4. 酒店汇总表。

## 表格口径

月度对账表只展示本月所有配房完毕订单的酒店汇总，样式参考验收图：

| 酒店名称 | 订单 | 间夜 |
| --- | --- | --- |
| 伯爵大酒店 | 3 | 8 |
| 海拉尔假日酒店 | 4 | 12 |
| 瓦西里木刻楞民宿 | 2 | 6 |
| 金帐汗套房酒店 | 3 | 10 |
| 白桦林主题民宿 | 2 | 4 |
| 游牧记忆太空舱 | 2 | 5 |
| 合计 | 16 | 45 |

字段说明：

- 酒店名称：配房表里的酒店快照名。
- 订单：该月配房完毕订单中，落到该酒店的订单数。
- 间夜：该月配房完毕订单中，落到该酒店的间夜合计。
- 合计：对上方表格订单数、间夜数求和。

## 接口对接

页面数据：

```http
GET /v3/admin/house/reconciliation/monthly?month=2026-07
```

前端只按 `data.hotels[]` 渲染酒店汇总表：

| 字段 | 用途 |
| --- | --- |
| `hotelName` | 酒店名称 |
| `orderCount` | 订单 |
| `roomNights` | 间夜 |

`overview`、金额类字段目前后端为兼容旧页面仍返回，当前页面不要再渲染统计卡片、现结金额、环比等内容。

导出 Excel：

```http
GET /v3/admin/house/reconciliation/monthly/export?month=2026-07&format=xlsx
```

生成 PDF：

```http
GET /v3/admin/house/reconciliation/monthly/export?month=2026-07&format=pdf
```

两个导出接口都返回附件流，前端按 blob 下载即可。文件内容和页面同口径，只包含“酒店名称 / 订单 / 间夜 / 合计”汇总表。

## 验收口径

- 房务管理员进入 `/housekeeper/ledger`，页面不再出现顶部统计卡片和空态大框。
- 有数据时直接显示酒店汇总表。
- 无数据时只在表格区域做轻量空态，不再展示现结类统计。
- 页面语义不要再写“现结账单”，统一按“月度对账 / 配房完毕订单酒店汇总”理解。
- 点击「导出 Excel」下载 xlsx，点击「生成 PDF」下载 pdf，内容与页面酒店汇总表一致。
