88 行
2.6 KiB
Markdown
88 行
2.6 KiB
Markdown
# 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，内容与页面酒店汇总表一致。
|