docs(house): update ledger export and lead handoff
这个提交包含在:
父节点
88d4cd5a8a
当前提交
532afb1c97
@ -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,也不能通过前端请求看到其他房务待办。
|
||||
- 房务组长能看到所有已归属房务的订单,不限已完成。
|
||||
- 房务组长列表展示具体负责房务名。
|
||||
- 点击「联系房务」后,聊天标题显示具体房务,不显示“对端”。
|
||||
正在加载...
x
在新工单中引用
屏蔽一个用户