diff --git a/changelogs-v2/2026-07/12_房务日历排除抢单池待配房订单-修改接口-管理后台.md b/changelogs-v2/2026-07/12_房务日历排除抢单池待配房订单-修改接口-管理后台.md new file mode 100644 index 0000000..9e17586 --- /dev/null +++ b/changelogs-v2/2026-07/12_房务日历排除抢单池待配房订单-修改接口-管理后台.md @@ -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 条 | +| 点击对应出行日期 | 右侧日期明细不显示抢单池待领取订单 | +| 房务订单列表切到抢单池 | 抢单池订单仍正常展示 | +| 订单已被房务领取但尚未配房 | 日历仍显示为配房中 | +