diff --git a/changelogs-v2/2026-07/18_订单详情已配房后缺少修改需求入口-前端待处理-管理后台.md b/changelogs-v2/2026-07/18_订单详情已配房后缺少修改需求入口-前端待处理-管理后台.md new file mode 100644 index 0000000..3d6702b --- /dev/null +++ b/changelogs-v2/2026-07/18_订单详情已配房后缺少修改需求入口-前端待处理-管理后台.md @@ -0,0 +1,60 @@ +# 订单详情已配房后缺少“修改需求”入口(前端待处理) + +- 日期:2026-07-03 +- 端:管理后台 +- 页面:订单详情 v2 / 住宿安排卡片 +- 示例订单:`HL20260703140009401` +- 订单 ID:`2072923329412427777` +- 当前状态:住宿已回配,流程节点展示“配房已完成” +- 当前结论:后端已支持已配置/已回配后继续提出修改需求,前端需要保留或补回入口。 + +## 现象 + +在订单详情页的「行程安排」页签中,住宿安排已显示为“已回配/配房已完成”,但页面上没有“修改需求”按钮。 + +截图复现口径: + +- 订单:`HL20260703140009401` +- 页面 URL:`/order-v2/detail/2072923329412427777` +- 当前卡片只看到「联系房务」和「查看已配房」等入口。 +- 业务期望:即使房务已经配置/回配完成,定制师仍然可以再次发起“修改需求”。 + +## 业务口径 + +配置完成后也可以提出修改需求。 + +“已配房 / 配房已完成”不代表需求不可再调整。定制师在订单未进入后续不可改阶段前,应仍可从住宿安排区域发起修改需求,用于触发房务重新处理。 + +## 前端处理要求 + +请在订单详情住宿安排模块补回“修改需求”入口: + +1. 当订单存在住宿需求,且住宿卡片处于已配房/已回配/配房完成展示态时,仍显示“修改需求”按钮。 +2. 点击“修改需求”后复用现有需求编辑/调整弹窗或跳转逻辑。 +3. 提交后走现有后端需求提交/调整接口,不需要新增后端接口。 +4. 不要因为 `roomControlStatus=DONE`、`houseStatus=CONFIRMED`、页面展示“配房已完成”就隐藏修改需求入口。 + +## 后端接口说明 + +本次无后端接口变更。 + +后端已有兼容接口支持提交/修改/调整房型需求: + +```http +PUT /v3/admin/order/{id}/hotel-requirement +``` + +接口语义: + +- 无 active 需求:首次提交。 +- active 需求待处理:编辑当前需求。 +- 已完成/已回配需求:提交修改需求,生成新版本或触发房务重新处理。 + +前端只需要恢复入口和调用现有提交流程。 + +## 验收标准 + +- `HL20260703140009401` 这类已配房订单,在住宿安排卡片可看到“修改需求”入口。 +- 点击后可打开现有需求编辑/调整弹窗。 +- 提交修改后页面能看到新需求/修改记录,房务侧进入重新处理链路。 +- “联系房务”“查看已配房”等已有按钮不受影响。