docs: 同步房务库存当前可用房口径

changelogs-v2/2026-07/37_4809_房务价格日历库存改为当前可用房口径-前端待处理-管理后台.md

@@ -0,0 +1,29 @@
+# 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。
+- 不扣系统库存的配房不改变可用房。
+- 清空 / 删除已扣库存配房后，可用房回补。