docs: notify frontend house calendar excludes grab pool

这个提交包含在:
API Changelog Bot 2026-07-02 11:28:18 +08:00
父节点 39988e5380
当前提交 f4999c9848

查看文件

@ -0,0 +1,40 @@
# 房务日历接口排除抢单池待领取订单
> 模块:管理后台 · 房务管家 · 日历视图
> 类型:**后端口径调整** + 前端告知
> 日期2026-07-02
> 背景:房务抢单池中的待领取订单原先会进入日历视图,导致日历出现“待配房”团数;但产品口径要求抢单池订单只展示在抢单池,不进入房务日历。
## 影响接口
| 接口 | 调整 |
|------|------|
| `GET /admin/house/calendar` | 月历摘要、日期格子、状态点排除抢单池待领取订单 |
| `GET /admin/house/calendar/day` | 日期右侧明细/下钻列表排除抢单池待领取订单 |
## 新口径
- `PENDING_CLAIM` 且未领取的用房需求,只出现在房务抢单池。
- 房务日历不再展示抢单池待领取订单:
- 不计入月度 `summary.pending`
- 不计入日期格子 `tourCount`
- 不返回 `pending` 状态点
- 不进入日期明细列表
- 已抢未配订单不属于抢单池,仍按现有逻辑进入日历并展示为配房中。
- 已配房、询房中、异常、已完成等已有日历状态不受影响。
## 前端处理建议
前端无需在日历页额外本地过滤抢单池订单,按接口返回渲染即可。
注意不要再用抢单池数量反推日历“待配房”数量;抢单池与日历现在是两个展示域。
## 验收标准
| 场景 | 期望 |
|------|------|
| 抢单池存在 5 条待领取订单 | `/housekeeper/calendar` 月历不显示这 5 条 |
| 点击对应出行日期 | 右侧日期明细不显示抢单池待领取订单 |
| 房务订单列表切到抢单池 | 抢单池订单仍正常展示 |
| 订单已被房务领取但尚未配房 | 日历仍显示为配房中 |