hl-api-changelog/changelogs-v2/2026-06/53_房务订单列表超管与组长应能看团队全部带房务归属_前端对接-管理后台.md
API Changelog Bot 0c90b14bc5 docs(changelog-v2): 房务订单列表超管/组长应看团队全部带房务归属(前端对接)
后端all-claims已对SUPER_ADMIN+house_keeper_lead放行(200,含claimerName),前端给超管补团队监督tab。
附后端待办:房务写口未校房务/超管角色门(另跟踪)。
2026-06-29 14:51:07 +08:00

27 行
2.3 KiB
Markdown

此文件含有模棱两可的 Unicode 字符

此文件含有可能会与其他字符混淆的 Unicode 字符。 如果您是想特意这样的,可以安全地忽略该警告。 使用 Escape 按钮显示他们。

# 房务订单列表:超级管理员(和房务组长)应能看「团队全部」单 + 显示房务归属
> 模块:房务管家 · 订单列表 / 我的接单(管理后台)
> 类型:前端交互(后端 API 已就绪,已测试服实测)
> 日期2026-06-29
> 反馈来源wx 超级管理员手测
## 反馈
超级管理员进入「房务管家 → 订单列表」,只看到 **「我的订单」(空,因为超管不抢单) + 抢单池**,
**看不到团队里每张单是谁(哪个房务)负责的**。诉求:超管得能看到「是谁的单子」。
## 后端现状(已就绪,无需改后端)
团队监督端点 `GET /v3/admin/order/grab-pool/all-claims/hotel`**超级管理员(SUPER_ADMIN) 与 房务组长(house_keeper_lead) 均放行**(其它角色返 808092
测试服实测(超管 token返回 200,total=20,**每条都带 `claimerName`(房务归属名)**,与「我的接单」(my-claims) 同结构list + stats + total
- 我的接单 `GET /v3/admin/order/grab-pool/my-claims/hotel`:只返**当前登录人自己抢的单**(超管不抢单→空)。
- 团队全部 `GET /v3/admin/order/grab-pool/all-claims/hotel`:返**全部房务已抢的单 + 每单 claimerName**(超管/组长可调)。
## 【前端处理】
房务订单列表页,对 **SUPER_ADMIN 和 house_keeper_lead** 两类角色:
- 增加(或默认展示)「团队全部 / 监督视图」tab,调 `all-claims` 端点,列表每行展示「房务 {claimerName}」。
- 「我的订单」(my-claims) tab 对超管/组长意义不大(基本为空),可弱化或后置。
- 订单详情里归属字段已就绪:`GET /admin/house/orders/{orderId}``claim.claimerName` + `claim.isMine`(超管看他人单 isMine=false,详情 `permissions.canEdit=false` → 隐藏配房写按钮,与日历只读同口径)。
## 备注(后端待办,与本前端项解耦,仅知悉)
手测同时发现:房务写口(抢单/配房/确认/finalize 等)后端目前**只拦房务组长(只读),未校验"必须房务管理员/超管"角色** → 理论上其它后台角色(如定制师)的 token 也能调用房务写接口。前端本就不给非房务角色展示房务模块入口,正常使用无影响;后端将评估补角色门(另跟踪,不影响本前端对接)。