订单详情 brief 补 manualUrgent 加急状态回显（补 #4342，#4354/#4355）

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` 有则显「取消加急」、无则显「加急」)可保留——补字段后「取消加急」态即保真,不再依赖字段缺省。