From b5b18f01d7575a333e53d0d6a13956b7624d108c Mon Sep 17 00:00:00 2001
From: API Changelog Bot <changelog@hulalv.com>
Date: Thu, 23 Jul 2026 10:14:39 +0800
Subject: [PATCH] docs(frontend): hand off vehicle urgency contract (#5178)

---
 ...Žæ´¾è½¦çœ‹æ�¿çŠ¶æ€�颜色-新增接å�£-å‰�端待处ç�†-管ç�†å�Žå�°.md | 148 ++++++++++++++++++
 1 file changed, 148 insertions(+)
 create mode 100644 changelogs-v2/2026-07/89_5178_用车手动加急与派车看�状�颜色-新增接�-�端待处�-管���.md

diff --git a/changelogs-v2/2026-07/89_5178_用车手动加急与派车看�状�颜色-新增接�-�端待处�-管���.md b/changelogs-v2/2026-07/89_5178_用车手动加急与派车看�状�颜色-新增接�-�端待处�-管���.md
new file mode 100644
index 0000000..1619206
--- /dev/null
+++ b/changelogs-v2/2026-07/89_5178_用车手动加急与派车看�状�颜色-新增接�-�端待处�-管���.md
@@ -0,0 +1,148 @@
+---
+schema: "hl-changelog/v1"
+ticket: "5178"
+title: "用车手动加急与派车看�状�颜色"
+consumer: "admin"
+backend: "verified"
+gateway: "pending"
+frontend: "pending"
+base: "dev-v3"
+generated: "2026-07-23T10:00:00+08:00"
+---
+
+# �新增接�·�端待处�·管���】用车手动加急与派车看�状�颜色
+
+## 目标�端
+
+- 端类型：管���（Web）
+- 目标仓库：`mmg/hl-ui`
+- 目标分支：`v2.1`
+- �调/验收环境：<http://192.168.100.160:9527>
+- �程�：无需处�
+
+> **�务**: hl-order-service-v3�hl-fleet-service
+>
+> **�端 PR**: �并�补充
+>
+> **工�**: [wx/HL#5178](https://git.1814.love:8443/wx/HL/issues/5178)
+>
+> **影�范围**: 订�详情“行程安排�用车�片�车务派车看�列表�派�详情
+
+## 业务�径
+
+- 用车需求的“加急/�消加急�与房务需求��一致：�改�优先级和页��示，�修改需求状��派�状���机车辆�用��险或费用。
+- 手动加急优先于临近出团�等待回�等自动紧急规则；�消�由�端��现有自动紧急度。
+- �端�得根�日期自行推断是�加急，也�得�观修改本地状�；�作�功��新拉�订�详情和派车看�。
+- 已完�或已失效需求�能加急。按钮按�端�许状� `PENDING`�`PROCESSING` 显示。
+
+## �更接�
+
+| 方法 | 路径 | �� | 说明 |
+| --- | --- | --- | --- |
+| POST | `/v3/admin/order/vehicle-requirement/{requirementId}/urgent` | 本�定制师或超级管�员 | 手动加急；��调用幂等 |
+| POST | `/v3/admin/order/vehicle-requirement/{requirementId}/urgent/cancel` | 本�定制师或超级管�员 | �消手动加急；��调用幂等 |
+
+请求无 Body，�功统一返回：
+
+```json
+{
+  "code": 200,
+  "data": null,
+  "msg": "success"
+}
+```
+
+需�明确处�的业务错误：
+
+| code | �义 | 建议�示 |
+| --- | --- | --- |
+| `582084` | 当�账��是本�定制师且�是超级管�员 | 仅本�定制师��作用车加急 |
+| `582087` | 需求已完��已失效或状�已�化 | 当�用车需求状�已�化，请刷新��试 |
+
+## 订�详情新增字段
+
+订�详情 `data.itinerary.vehicleGroup.requirement` 新增：
+
+```json
+{
+  "requirementId": "2046400000000000001",
+  "status": "PENDING",
+  "manualUrgent": true
+}
+```
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| `manualUrgent` | `Boolean` | `true` 显示“�消加急�，`false` 显示“加急� |
+
+订�详情“行程安排 → 用车安排��片应�用房务�片的交互：
+
+- 当�有效需求存在且状�为 `PENDING/PROCESSING` 时，在“�系车务��显示“加急�或“�消加急�。
+- 点击�调用对应接�；�功��拉订�详情，并让派车看�列表失效/刷新。
+- �交中�用按钮，防止连续点击；接�错误显示�端业务文案。
+
+## 派车看�列表契约
+
+`GET /admin/fleet/board/orders` �� `data.records[]` 新增/统一返回：
+
+```json
+{
+  "assignmentStatus": "unassigned_urgent",
+  "assignmentStatusLabel": "待派车（加急）",
+  "manualUrgent": true,
+  "urgentBadge": "手动加急"
+}
+```
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| `assignmentStatus` | `String` | �端计算�的��状�� |
+| `assignmentStatusLabel` | `String` | �端统一中文状�文案，页�直接展示 |
+| `manualUrgent` | `Boolean` | 是�由定制师手动加急 |
+| `urgentBadge` | `String/null` | 手动加急固定为“手动加急�；自动加急返回既有 T-N 文案 |
+
+�一状�内，�端已把手动加急订�排在自动加急和普通订�之�，�端�需��次排�。
+
+## 派�详情新增字段
+
+`GET /admin/fleet/board/orders/{orderId}` 新增：
+
+- `data.manualUrgent`
+- `data.currentAssignment.manualUrgent`
+- `data.activeAssignments[].manualUrgent`
+
+当�派�的 `assignmentStatus/assignmentStatusLabel/urgentBadge` �样是�端计算�的有效状�，详情页�得自行按日期覆盖。
+
+## 页�颜色映射
+
+派车看��片�照房务�片形�清晰的状�色，优先使用现有设计 Token；���给状�标签上色。
+
+| 判定顺� | �片语义 | 推�底色 / 边框 | 标签 |
+| --- | --- | --- | --- |
+| `manualUrgent=true` | 定制师手动加急 | 淡红 `#FFF1F0` / 红 `#FF4D4F` | `urgentBadge` |
+| `assignmentStatus=unassigned_urgent/holding_urgent` | 系统自动加急 | 淡橙 `#FFF7E6` / 橙 `#FA8C16` | `urgentBadge` |
+| `assignmentStatus=unassigned` | 待派车 | 淡黄 `#FFFBE6` / 黄 `#FAAD14` | `assignmentStatusLabel` |
+| `assignmentStatus=holding` | 待�机/车务确认 | 淡� `#E6F4FF` / � `#1677FF` | `assignmentStatusLabel` |
+| `assignmentStatus=assigned` | 已确认执行 | 淡绿 `#F6FFED` / 绿 `#52C41A` | `assignmentStatusLabel` |
+| 完���消等终� | 已结� | � `#F5F5F5` / � `#BFBFBF` | `assignmentStatusLabel` |
+
+样�优先级必须是 `manualUrgent` > 自动紧急状� > 普通状�。�片左侧强调边�背景和状�标签应�步�化，效果与房务“已回�/待处���片一致。
+
+## �端处�清�
+
+- [ ] `VehicleArrangeCard.vue` 在“�系车务��增加“加急/�消加急�，交互和按钮状��用 `RoomArrangeCard.vue`。
+- [ ] `ArrangementTab.vue` 和订�详情父组件�传 `urgent/cancel-urgent` 事件，新增用车加急 API 方法。
+- [ ] �作�功��新拉�订�详情和派车看�，�在�端直接翻转 `manualUrgent`。
+- [ ] 派车看��片按上表给整��色，优先读� `manualUrgent`，状�文案读� `assignmentStatusLabel`。
+- [ ] 手动加急与自动加急用��颜色和标签，�显示英文状��。
+- [ ] 派�详情读�顶层�当�/有效派�的 `manualUrgent`，�根�出团日期�推。
+- [ ] 雪花 ID 继续按字符串处�。
+
+## 验���
+
+- 用车加急/�消加急的���状�门控和幂等覆盖�元测试。
+- order-v3 订�详情与 order-v3 → fleet 共享契约�覆盖 `manualUrgent`。
+- fleet 有效状��排��列表和详情映射覆盖手动加急优先规则。
+- fleet `spotless:check`�`verify` 与测试环境网关验�完��补充最终��。
+
+> 本文是�端接入通知，�代表已修改或�布 `mmg/hl-ui`；�端按“�端处�清��接入��。