# 订单详情已配房后缺少“修改需求”入口（前端待处理）

- 日期：2026-07-03
- 端：管理后台
- 页面：订单详情 v2 / 住宿安排卡片
- 示例订单：`HL20260703140009401`
- 订单 ID：`2072923329412427777`
- 当前状态：住宿已回配，流程节点展示“配房已完成”
- 当前结论：后端已支持已配置/已回配后继续提出修改需求，前端需要保留或补回入口。

## 现象

在订单详情页的「行程安排」页签中，住宿安排已显示为“已回配/配房已完成”，但页面上没有“修改需求”按钮。

截图复现口径：

- 订单：`HL20260703140009401`
- 页面 URL：`/order-v2/detail/2072923329412427777`
- 当前卡片只看到「联系房务」和「查看已配房」等入口。
- 业务期望：即使房务已经配置/回配完成，定制师仍然可以再次发起“修改需求”。

## 业务口径

配置完成后也可以提出修改需求。

“已配房 / 配房已完成”不代表需求不可再调整。定制师在订单未进入后续不可改阶段前，应仍可从住宿安排区域发起修改需求，用于触发房务重新处理。

## 2026-07-05 补充复现

新增复现订单：

- 订单：`HL20260703140009570`
- 订单 ID：`2072923330129653762`
- 页面 URL：`/order-v2/detail/2072923330129653762`
- 页面现象：顶部流程节点展示“配房-已完成”，住宿安排卡片只有“联系房务”，没有“修改需求/调整需求”入口。

后端接口复验：

```http
GET /v3/admin/order/2072923330129653762/itinerary
```

关键返回：

| 字段 | 值 |
|------|----|
| `hotelGroup.requirement.status` | `DONE` |
| `hotelGroup.houseStatus` | `CONFIRMED` |
| `hotelGroup.houseStatusLabel` | `已完成` |
| `hotelGroup.finalized` | `true` |
| `hotelGroup.returnStatusLabel` | `已回配` |

这正是“配房已完成/已回配”场景。该状态下仍允许定制师修改住宿需求，前端不能因为上述状态隐藏入口。

## 前端处理要求

请在订单详情住宿安排模块补回“修改需求”入口：

1. 当订单存在住宿需求，且住宿卡片处于已配房/已回配/配房完成展示态时，仍显示“修改需求”按钮。
2. 点击“修改需求”后复用现有需求编辑/调整弹窗或跳转逻辑。
3. 提交后走现有后端需求提交/调整接口，不需要新增后端接口。
4. 不要因为 `roomControlStatus=DONE`、`houseStatus=CONFIRMED`、页面展示“配房已完成”就隐藏修改需求入口。

## 后端接口说明

本次无后端接口变更。

后端已有兼容接口支持提交/修改/调整房型需求：

```http
PUT /v3/admin/order/{id}/hotel-requirement
```

接口语义：

- 无 active 需求：首次提交。
- active 需求待处理：编辑当前需求。
- 已完成/已回配需求：提交修改需求，生成新版本或触发房务重新处理。

前端只需要恢复入口和调用现有提交流程。

源码契约中该接口的说明为：

```text
提交/修改/调整房型需求（三分支自动判断：无 active=INIT_SUBMIT，PENDING=PENDING_EDIT，DONE=DONE_ADJUST）
```

如果前端已经迁移到统一订单调整接口，也可以继续复用现有的“修改需求”提交流程提交 `updates.hotelRequirement`；关键是页面入口不要因 `DONE / CONFIRMED / finalized=true / 配房已完成` 被隐藏。

## 验收标准

- `HL20260703140009401` 这类已配房订单，在住宿安排卡片可看到“修改需求”入口。
- `HL20260703140009570` 这类 `requirement.status=DONE`、页面显示“配房-已完成”的订单，也能看到“修改需求”入口。
- 点击后可打开现有需求编辑/调整弹窗。
- 提交修改后页面能看到新需求/修改记录，房务侧进入重新处理链路。
- “联系房务”“查看已配房”等已有按钮不受影响。