hl-api-changelog/changelogs-v2/2026-07/37_4809_房务价格日历库存改为当前可用房口径-前端待处理-管理后台.md
2026-07-07 12:32:40 +08:00

1.5 KiB

37_4809_房务价格日历库存改为当前可用房口径-前端待处理-管理后台

背景

工单HL #4809

资源价格日历中业务维护的“库存”应表示当前可用房间数,不是总库存。旧前端如果按 stock - stockUsed 再算一次可用房,会出现价格日历填 999、已有占用 1、房务候选只显示 998 的问题。

后端口径

  • room_price_calendar.stock:当前可用房。
  • room_price_calendar.stock_used:已占用记录,仅作记录和审计。
  • 房务候选、库存日历、价格日历 internal 响应中的 available 直接等于 stock
  • stock = null 仍表示不限库存,available = nullunlimited = true
  • 配房选择扣减系统库存时:stock -= qtystock_used += qty
  • 删除 / 清空 / 释放已扣库存配房时:stock += qtystock_used -= qty

前端需要调整

  1. 价格日历里的“库存”按当前可用房展示和编辑。
  2. 房务选择酒店弹窗的“可用房”直接展示接口返回的 availablestock,不要再计算 stock - stockUsed
  3. 如果仍展示 stockUsed,文案应是“已占用记录”,不能把它用于扣减当前可用房展示。
  4. 验收例:价格日历 stock=999、stockUsed=1 时,房务候选可用房应显示 999。

验证口径

  • 扣系统库存 1 间后,可用房从 999 变 998。
  • 不扣系统库存的配房不改变可用房。
  • 清空 / 删除已扣库存配房后,可用房回补。