hl-api-changelog/changelogs-v2/2026-07/12_房务日历排除抢单池待配房订单-修改接口-管理后台.md
2026-07-02 11:28:18 +08:00

1.7 KiB

房务日历接口排除抢单池待领取订单

模块:管理后台 · 房务管家 · 日历视图 类型:后端口径调整 + 前端告知 日期2026-07-02 背景:房务抢单池中的待领取订单原先会进入日历视图,导致日历出现“待配房”团数;但产品口径要求抢单池订单只展示在抢单池,不进入房务日历。

影响接口

接口 调整
GET /admin/house/calendar 月历摘要、日期格子、状态点排除抢单池待领取订单
GET /admin/house/calendar/day 日期右侧明细/下钻列表排除抢单池待领取订单

新口径

  • PENDING_CLAIM 且未领取的用房需求,只出现在房务抢单池。
  • 房务日历不再展示抢单池待领取订单:
    • 不计入月度 summary.pending
    • 不计入日期格子 tourCount
    • 不返回 pending 状态点
    • 不进入日期明细列表
  • 已抢未配订单不属于抢单池,仍按现有逻辑进入日历并展示为配房中。
  • 已配房、询房中、异常、已完成等已有日历状态不受影响。

前端处理建议

前端无需在日历页额外本地过滤抢单池订单,按接口返回渲染即可。

注意不要再用抢单池数量反推日历“待配房”数量;抢单池与日历现在是两个展示域。

验收标准

场景 期望
抢单池存在 5 条待领取订单 /housekeeper/calendar 月历不显示这 5 条
点击对应出行日期 右侧日期明细不显示抢单池待领取订单
房务订单列表切到抢单池 抢单池订单仍正常展示
订单已被房务领取但尚未配房 日历仍显示为配房中