docs: 补充房务按天清空配房契约

这个提交包含在:
API Changelog Bot 2026-07-07 11:13:33 +08:00
父节点 be4f1ddd78
当前提交 df0179375f

查看文件

@ -82,3 +82,52 @@ DELETE /v3/admin/order/hotel-requirements/{requirementId}/assignments
- 已配房两晚:驳回按钮隐藏或置灰;清空配房按钮可用。 - 已配房两晚:驳回按钮隐藏或置灰;清空配房按钮可用。
- 清空成功:配房行消失,状态从待最终确认回到配房中,驳回按钮按详情刷新结果变更。 - 清空成功:配房行消失,状态从待最终确认回到配房中,驳回按钮按详情刷新结果变更。
- 无配房:清空按钮隐藏或置灰;驳回按钮按后端 action 显示。 - 无配房:清空按钮隐藏或置灰;驳回按钮按后端 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 晚配房仍保留。
- 清空不扣系统库存的配房时,不应释放资源库存。