diff --git a/changelogs-v2/2026-07/40_房务月度对账页面简化为已配房酒店汇总表-前端待处理-管理后台.md b/changelogs-v2/2026-07/40_房务月度对账页面简化为已配房酒店汇总表-前端待处理-管理后台.md index 88ca986..6b22b16 100644 --- a/changelogs-v2/2026-07/40_房务月度对账页面简化为已配房酒店汇总表-前端待处理-管理后台.md +++ b/changelogs-v2/2026-07/40_房务月度对账页面简化为已配房酒店汇总表-前端待处理-管理后台.md @@ -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,内容与页面酒店汇总表一致。 diff --git a/changelogs-v2/2026-07/41_房务组长权限列表联系房务前端待处理-管理后台.md b/changelogs-v2/2026-07/41_房务组长权限列表联系房务前端待处理-管理后台.md new file mode 100644 index 0000000..7006506 --- /dev/null +++ b/changelogs-v2/2026-07/41_房务组长权限列表联系房务前端待处理-管理后台.md @@ -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,也不能通过前端请求看到其他房务待办。 +- 房务组长能看到所有已归属房务的订单,不限已完成。 +- 房务组长列表展示具体负责房务名。 +- 点击「联系房务」后,聊天标题显示具体房务,不显示“对端”。