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,内容与页面酒店汇总表一致。

查看文件

@ -0,0 +1,60 @@
# 41_房务组长权限列表联系房务前端待处理-管理后台
## 背景
房务管理员角色当前能打开「全部」待办 Tab,且可以看到其他房务待办,属于越权展示。
房务组长进入订单列表时,应看到所有已被房务抢走、非抢单池状态的订单,不应只看到已完成订单。
另外,列表里「联系房务」打开会话时标题显示“对端”,需要改成具体负责房务。
## 待办 Tab 权限
页面路径:
- `/housekeeper/todos`
前端规则:
1. 普通房务管理员只展示「我的未完成」Tab。
2. 「全部」/「同事在处理」Tab 仅房务组长、超级管理员展示。
3. 普通房务管理员请求待办接口只传 `scope=mine`
4. `scope=all` / `scope=others` 仅房务组长、超级管理员使用。
后端已加兜底权限:普通房务管理员请求 `scope=all``scope=others` 会返回业务错误 `582204`
## 房务组长订单列表
页面路径:
- `/housekeeper/orders`
房务组长「全部房务」列表不要强制传 `status=confirmed` / `DONE` 一类完成态过滤。
应直接查询房务订单列表的组长视角,展示所有已抢单/已归属房务、非抢单池状态的订单,包括:
- 配房中
- 待最终确认
- 已完成
- 异常/待处理
列表行里的负责房务展示:
- 使用接口返回的 `claimerName`
- 后端已优先返回房务企业微信昵称。
- 没绑定企业微信时,后端回退用户名。
## 联系房务
房务组长列表点击「联系房务」时:
1. 使用当前订单行的 `claimerId` 作为聊天对端管理员 ID。
2. 会话抽屉标题展示当前订单行的 `claimerName`
3. 不要展示“对端”这种兜底文案,除非接口确实没有返回任何名字。
## 验收口径
- 普通房务管理员看不到「全部」/「同事在处理」Tab,也不能通过前端请求看到其他房务待办。
- 房务组长能看到所有已归属房务的订单,不限已完成。
- 房务组长列表展示具体负责房务名。
- 点击「联系房务」后,聊天标题显示具体房务,不显示“对端”。