docs: notify frontend house calendar excludes grab pool
这个提交包含在:
父节点
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 条 |
|
||||||
|
| 点击对应出行日期 | 右侧日期明细不显示抢单池待领取订单 |
|
||||||
|
| 房务订单列表切到抢单池 | 抢单池订单仍正常展示 |
|
||||||
|
| 订单已被房务领取但尚未配房 | 日历仍显示为配房中 |
|
||||||
|
|
||||||
正在加载...
x
在新工单中引用
屏蔽一个用户