docs(house): update ledger export and lead handoff

这个提交包含在:
API Changelog Bot
2026-07-07 16:58:00 +08:00
父节点 88d4cd5a8a
当前提交 532afb1c97
共修改 2 个文件,包含 93 行新增和 0 行删除
@@ -46,9 +46,42 @@
- 间夜:该月配房完毕订单中,落到该酒店的间夜合计。
- 合计:对上方表格订单数、间夜数求和。
## 接口对接
页面数据:
```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,内容与页面酒店汇总表一致。