hl-api-changelog/changelogs-v2/2026-07/38_房务底部驳回按钮仍误展示-前端待处理-管理后台.md
2026-07-07 14:15:13 +08:00

98 行
3.0 KiB
Markdown

此文件含有模棱两可的 Unicode 字符

此文件含有可能会与其他字符混淆的 Unicode 字符。 如果您是想特意这样的,可以安全地忽略该警告。 使用 Escape 按钮显示他们。

# 房务底部驳回需求按钮仍误展示
- 状态front-end urgent
- 影响端:管理后台房务详情弹窗
- 关联通知:
- `29_4777_房务清空配房信息与驳回按钮动作契约-前端待处理-管理后台.md`
## 问题
2026-07-07 复测时,房务详情弹窗底部仍显示“驳回需求”按钮。这是纯前端展示/交互问题:后端 action 和接口守卫已经正确。
当前订单示例:
- 订单:`2074303545149980674`
- 订单号:`HL20260707092437709`
- 状态:`CLAIMING / 配房中`
- 配房进度:`1/2`
- 第 1 晚:已有酒店/配房数据
- 第 2 晚:待配房
这种场景不能驳回需求。只要任意 day 还有 active 配房/询房数据,驳回按钮都不能展示为可操作入口。
## 后端当前返回
接口:
```http
GET /admin/house/orders/2074303545149980674
```
关键字段:
```json
{
"actions": {
"canRejectRequirement": {
"enabled": false,
"code": "REJECT_REQUIREMENT",
"label": "驳回需求",
"disabledReason": "已有配房, 不能驳回, 请先清空/删除配房",
"endpoint": "POST /v3/admin/order/2074303545149980674/hotel-requirement/supplier-reject"
},
"canClearAssignments": {
"enabled": true,
"code": "CLEAR_ASSIGNMENTS",
"label": "清空配房",
"disabledReason": null,
"endpoint": "DELETE /v3/admin/order/hotel-requirements/2074310408247623681/assignments"
}
},
"requirement": {
"actions": {
"canRejectRequirement": false,
"canClearAssignments": true
}
}
}
```
强制调用驳回接口也会被后端拒绝:
```http
POST /v3/admin/order/2074303545149980674/hotel-requirement/supplier-reject
```
返回:
```json
{
"code": 582086,
"success": false,
"message": "该需求已有配房记录, 不能驳回, 请走替换/修改配房"
}
```
## 前端必须修改
1. 底部“驳回需求”按钮必须绑定 `data.actions.canRejectRequirement.enabled`
2. `enabled=false` 时优先不展示“驳回需求”按钮。
3. 如果产品交互坚持保留按钮,则必须是真 disabled
- `disabled=true`
- 不绑定提交/打开驳回弹窗的点击事件
- 展示 `disabledReason`
4. 禁止用这些条件自行推断驳回可用性:
- `houseStatus === CLAIMING`
- 配房进度不是满配,例如 `1/2`
- 当前在“配房中”流程节点
- 第 2 晚仍待配房
5. 前端只需要做展示控制,不需要在前端判断“有没有配房数据”。是否能驳回以后端 action 为准。
6. 清空任意 day 或整体清空后,必须重新拉取详情;只有刷新后后端返回 `enabled=true` 才能展示/启用驳回入口。
## 验收
- 订单 `2074303545149980674`:第 1 晚已有酒店数据、第 2 晚待配房,底部不能出现可点击“驳回需求”。
- 只要 `actions.canRejectRequirement.enabled=false`,按钮隐藏或真实禁用。
- 点击禁用态按钮不会打开驳回原因弹窗,不会调用驳回接口。
- 清空全部配房后刷新详情,如果后端返回 `enabled=true`,才允许显示/启用驳回。