From ab873587536ea4fa8d30fb934213cd774eb10ed4 Mon Sep 17 00:00:00 2001
From: API Changelog Bot <changelog@hulalv.com>
Date: Tue, 7 Jul 2026 12:32:40 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20=E5=90=8C=E6=AD=A5=E6=88=BF=E5=8A=A1?=
 =?UTF-8?q?=E5=BA=93=E5=AD=98=E5=BD=93=E5=89=8D=E5=8F=AF=E7=94=A8=E6=88=BF?=
 =?UTF-8?q?=E5=8F=A3=E5=BE=84?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 ...历库存改为当前可用房口径-前端待处理-管理后台.md | 29 +++++++++++++++++++
 1 file changed, 29 insertions(+)
 create mode 100644 changelogs-v2/2026-07/37_4809_房务价格日历库存改为当前可用房口径-前端待处理-管理后台.md

diff --git a/changelogs-v2/2026-07/37_4809_房务价格日历库存改为当前可用房口径-前端待处理-管理后台.md b/changelogs-v2/2026-07/37_4809_房务价格日历库存改为当前可用房口径-前端待处理-管理后台.md
new file mode 100644
index 0000000..1d69b2a
--- /dev/null
+++ b/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。
+- 不扣系统库存的配房不改变可用房。
+- 清空 / 删除已扣库存配房后，可用房回补。