docs: 补充房务按天清空配房契约
这个提交包含在:
父节点
be4f1ddd78
当前提交
df0179375f
@ -82,3 +82,52 @@ DELETE /v3/admin/order/hotel-requirements/{requirementId}/assignments
|
||||
- 已配房两晚:驳回按钮隐藏或置灰;清空配房按钮可用。
|
||||
- 清空成功:配房行消失,状态从待最终确认回到配房中,驳回按钮按详情刷新结果变更。
|
||||
- 无配房:清空按钮隐藏或置灰;驳回按钮按后端 action 显示。
|
||||
|
||||
## 2026-07-07 补充:每个行程日都要有清空按钮
|
||||
|
||||
- 补充工单:HL #4804
|
||||
- 状态:front-end todo
|
||||
- 后端接口:已补按天清空,整体清空接口保留为批量动作。
|
||||
|
||||
### 新增按天清空接口
|
||||
|
||||
只清空当前生效需求某一天的 active 配房:
|
||||
|
||||
```http
|
||||
DELETE /v3/admin/order/hotel-requirements/{requirementId}/assignments/days/{dayNumber}
|
||||
```
|
||||
|
||||
响应:
|
||||
|
||||
```json
|
||||
{
|
||||
"code": 200,
|
||||
"message": "success",
|
||||
"data": {
|
||||
"clearedCount": 1
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
语义:
|
||||
|
||||
- 只清空 `{dayNumber}` 当天 active 配房行,不影响其他天。
|
||||
- 级联清空当天房间分配。
|
||||
- 只释放实际扣过资源库存的配房行;`deductInventory=false` 的配房快照不释放库存。
|
||||
- 不释放抢单人,不回抢单池。
|
||||
- 清空成功后刷新订单详情;该天应回到待配房,其他天保持原配房状态。
|
||||
|
||||
### 前端渲染要求
|
||||
|
||||
1. 在每个行程 day 行展示“清空”按钮;不能只在弹窗底部放整体清空。
|
||||
2. 当 `itinerary[].assignments` 非空时,该 day 的“清空”按钮可用。
|
||||
3. 点击 day 行“清空”时调用新增按天清空接口:
|
||||
`DELETE /v3/admin/order/hotel-requirements/{requirementId}/assignments/days/{dayNumber}`。
|
||||
4. 清空前仍需要二次确认,文案要说明“只清空第 N 晚配房,不影响其他晚”。
|
||||
5. 底部整体“清空配房”可保留,但语义必须是清空当前需求全部天;不要替代 day 行清空按钮。
|
||||
|
||||
### 补充验收
|
||||
|
||||
- 两晚订单第 1 晚、第 2 晚都有独立“清空”按钮。
|
||||
- 清空第 1 晚后,第 1 晚回到待配房,第 2 晚配房仍保留。
|
||||
- 清空不扣系统库存的配房时,不应释放资源库存。
|
||||
|
||||
正在加载...
x
在新工单中引用
屏蔽一个用户