diff --git a/changelogs-v2/2026-06/24_4354_订单详情brief补manualUrgent加急状态回显_管理后台.md b/changelogs-v2/2026-06/24_4354_订单详情brief补manualUrgent加急状态回显_管理后台.md new file mode 100644 index 0000000..6707c1a --- /dev/null +++ b/changelogs-v2/2026-06/24_4354_订单详情brief补manualUrgent加急状态回显_管理后台.md @@ -0,0 +1,31 @@ +# 订单详情配房需求 brief 补 manualUrgent(定制师侧加急状态回显,补 #4342,已上线测试服·可对接) + +> 变更类型:✅ 修改接口(新增字段,已部署测试服并 API round-trip 实证,可对接) +> 端类型:管理后台(定制师侧·订单详情「加急/取消加急」按钮) +> 日期:2026-06-24 | 工单:#4354 | PR:#4355 | 服务:hl-order-service-v3 +> 关联:补 #4342——#4342 只给抢单池列表项(HouseGrabPageItemRespVO)加了 manualUrgent,订单详情 brief 漏透传,定制师侧加急按钮在详情读不到当前加急态。 + +--- + +## ⚠️ 关键说明 +- **现象**:#4342 定制师侧「加急 / 取消加急」按钮要切换,需读当前加急状态,但订单详情接口的配房需求 brief 没返回 `manualUrgent`。前端只能防御性恒显「加急」,已加急单进详情的「取消加急」态失真。 +- **修复**:itinerary 接口的配房需求 brief 补 `manualUrgent`(Boolean),与抢单池列表项口径一致。entity 早有此字段(Integer 0/1),纯透传补齐。 + +## 1. 新增字段 +`GET /v3/admin/order/{id}/itinerary` → `data.hotelGroup.requirement`(`HotelRequirementBriefVO`)新增: + +| 字段 | 类型 | 说明 | +|---|---|---| +| `manualUrgent` | Boolean | 定制师是否手动加急。`true`=已加急(按钮显「取消加急」),`false`=未加急(显「加急」)。**不返回 null**(后端 Integer 0/1/null → Boolean)。 | + +## 2. 测试服 round-trip 实证(order 2069593503129636865) +| 步骤 | 操作 | brief.manualUrgent | +|---|---|---| +| ① 初始 | — | `false` | +| ② 加急 | `POST /v3/admin/order/hotel-requirement/{reqId}/urgent` | → `true` | +| ③ 取消 | `POST /v3/admin/order/hotel-requirement/{reqId}/urgent/cancel` | → `false` | + +加急 / 取消端点见 #4342 changelog(权限:该订单定制师本人 或 超管)。 + +## 3. 前端动作 +- 订单详情「加急 / 取消加急」按钮的当前态,改读 `requirement.manualUrgent`(此前该接口无此字段)。你已做的防御处理(`req.manualUrgent` 有则显「取消加急」、无则显「加急」)可保留——补字段后「取消加急」态即保真,不再依赖字段缺省。