docs(house): notify candidate available display fix

这个提交包含在:
API Changelog Bot 2026-07-07 14:55:51 +08:00
父节点 92549d7697
当前提交 d3568c4ec1

查看文件

@ -0,0 +1,49 @@
# 39_4809_房务选酒店可用房不要扣当前已选项-前端待处理-管理后台
## 背景
房务选择酒店弹窗中,同一酒店房型在资源价格日历显示库存 998,但弹窗行内“可用房”显示 997。
本次核对测试环境接口后确认:后端候选接口已经返回 998,前端展示 997 是弹窗本地把“当前已选 1 间”又从接口可用数里扣了一次。
## 接口证据
测试环境:
- `GET /v3/admin/hotel-candidates`
- 入参:`orderId=2074303545149980674&requirementId=2074310408247623681&dayNumber=1&stayDate=2026-07-23&city=满洲里市&roomCount=1&limit=50`
- 目标酒店:呼伦贝尔香格里拉大酒店
- 目标房型:大床房
接口返回口径:
```json
{
"todayAvailable": 998,
"matchedRoomTypeAvailable": 998,
"isCurrentlyAssigned": true,
"roomTypes": [
{
"name": "大床房",
"stock": 998,
"available": 998,
"protocolPrice": "330.00",
"settlementPrice": "290.00",
"inventoryStatus": "AVAILABLE"
}
]
}
```
## 前端需要调整
1. 选择酒店弹窗行内“可用房”直接展示当前选中房型的 `roomTypes[].available`,兜底用 `roomTypes[].stock`
2. 不要用 `available - 已选配房数量` 覆盖行内可用房。
3. `isCurrentlyAssigned=true` 只用于“当前已配/默认选中/预填房型”标记,不表示候选可用房要再扣一次。
4. 已选配房区域可以独立展示“已选 1 间”,但不要影响候选列表的可用房显示。
## 验收口径
- 资源价格日历当前库存 998,房务候选接口返回 `available=998` 时,选择酒店弹窗必须显示“可用房 998 间”。
- 即使弹窗底部已有 1 条已选配房,候选行也不能显示 997。
- 后续点击确认配房后,真正扣库存由后端写口处理;前端不要提前在候选行做本地扣减展示。