docs(house): update ledger export and lead handoff
这个提交包含在:
@@ -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,内容与页面酒店汇总表一致。
|
||||
|
||||
在新工单中引用
屏蔽一个用户