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

30 行
1.5 KiB
Markdown

此文件含有模棱两可的 Unicode 字符

此文件含有可能会与其他字符混淆的 Unicode 字符。 如果您是想特意这样的,可以安全地忽略该警告。 使用 Escape 按钮显示他们。

# 37_4809_房务价格日历库存改为当前可用房口径-前端待处理-管理后台
## 背景
工单HL #4809
资源价格日历中业务维护的“库存”应表示当前可用房间数,不是总库存。旧前端如果按 `stock - stockUsed` 再算一次可用房,会出现价格日历填 999、已有占用 1、房务候选只显示 998 的问题。
## 后端口径
- `room_price_calendar.stock`:当前可用房。
- `room_price_calendar.stock_used`:已占用记录,仅作记录和审计。
- 房务候选、库存日历、价格日历 internal 响应中的 `available` 直接等于 `stock`
- `stock = null` 仍表示不限库存,`available = null``unlimited = true`
- 配房选择扣减系统库存时:`stock -= qty``stock_used += qty`
- 删除 / 清空 / 释放已扣库存配房时:`stock += qty``stock_used -= qty`
## 前端需要调整
1. 价格日历里的“库存”按当前可用房展示和编辑。
2. 房务选择酒店弹窗的“可用房”直接展示接口返回的 `available``stock`,不要再计算 `stock - stockUsed`
3. 如果仍展示 `stockUsed`,文案应是“已占用记录”,不能把它用于扣减当前可用房展示。
4. 验收例:价格日历 stock=999、stockUsed=1 时,房务候选可用房应显示 999。
## 验证口径
- 扣系统库存 1 间后,可用房从 999 变 998。
- 不扣系统库存的配房不改变可用房。
- 清空 / 删除已扣库存配房后,可用房回补。