diff --git a/changelogs-v2/2026-07/32_4793_房务配房库存扣减选择与库存口径快照-前端待处理-管理后台.md b/changelogs-v2/2026-07/32_4793_房务配房库存扣减选择与库存口径快照-前端待处理-管理后台.md new file mode 100644 index 0000000..f484601 --- /dev/null +++ b/changelogs-v2/2026-07/32_4793_房务配房库存扣减选择与库存口径快照-前端待处理-管理后台.md @@ -0,0 +1,90 @@ +# 4793 房务配房库存扣减选择与库存口径快照 - 前端待处理 - 管理后台 + +- 工单:#4793 +- 状态:前端待处理 +- 后端分支:`fix/4793-house-deduct-inventory-switch` +- 影响页面:房务订单详情 / 配房弹窗 / 替换酒店弹窗 / 已配房展示 + +## 背景 + +房务配房时不是所有订单都使用系统资源库存。有些订单使用线下确认房量或非自有库存,不能在保存配房时扣减资源酒店房型库存。 + +后端已把库存口径从“按产品类型固定判断”改为“按每条配房显式选择”。 + +## 前端必须调整 + +### 1. 提交配房每条 item 必传 `deductInventory` + +接口: + +`POST /v3/admin/order/hotel-requirements/{requirementId}/assignments` + +`items[]` 新增必填字段: + +| 字段 | 类型 | 必填 | 说明 | +|---|---|---|---| +| `deductInventory` | Boolean | 是 | `true`=保存配房并扣减资源酒店房型库存;`false`=仅保存配房快照,不扣资源库存 | + +示例: + +```json +{ + "dayNumber": 1, + "hotelId": "200001", + "roomTypeId": "300001", + "roomCategory": "STANDARD", + "roomCount": 1, + "protoPrice": "320.00", + "settlementPrice": "300.00", + "sellPrice": "340.00", + "deductInventory": true, + "syncProtocolPrice": false, + "syncSettlementPrice": false +} +``` + +缺失时后端返回: + +| code | message | +|---|---| +| `808124` | 是否扣减资源库存不能为空 | + +### 2. 配房弹窗需要让房务显式选择 + +建议文案: + +- `扣减系统库存` +- `不扣系统库存` + +前端不能静默默认,需要房务选择后才能提交。若产品经理要求默认选项,也必须在 UI 上可见并可改。 + +### 3. 回显字段 + +提交配房出参 `items[]` 新增: + +| 字段 | 类型 | 说明 | +|---|---|---| +| `deductInventory` | Boolean | 本条配房是否扣减资源库存 | + +订单详情房务行程中每条已配房 `assignments[]` 新增: + +| 字段 | 类型 | 说明 | +|---|---|---| +| `deductInventory` | Boolean | 本条配房是否扣减资源库存 | + +内部配房查询 `GET /v3/internal/house/orders/{orderId}/assignments` 也返回该字段,供其他服务识别当时配置口径。 + +### 4. 行为规则 + +- `deductInventory=true`:保存配房时扣减 resource 库存;删除/替换/清空/取消时释放。 +- `deductInventory=false`:只保存配房快照;不会扣减 resource 库存;删除/替换/清空/取消时也不会释放。 +- 同一天同酒店同房型同 `deductInventory` 不能重复提交。 +- 同一天同酒店同房型如果确实要拆成“部分扣库存 + 部分不扣库存”,可以拆两条,但 `deductInventory` 必须不同。 +- 价格同步仍按 `syncProtocolPrice/syncSettlementPrice` 显式选择,和 `deductInventory` 是两个独立开关。 + +## 后端已覆盖 + +- `house_hotel_assignment` 新增 `deduct_inventory`,历史数据默认 true。 +- 配房保存按 `deductInventory` 决定是否调用资源库存扣减。 +- 删除、替换、清空、需求作废释放只释放实际扣过库存的行。 +- 单测已覆盖缺字段、false 不扣库存、true/false 切换释放边界、清空只释放已扣库存行。