From acb7c040bcf7d4c0087ed3aba103bca279cdabc5 Mon Sep 17 00:00:00 2001
From: API Changelog Bot <changelog@hulalv.com>
Date: Thu, 23 Jul 2026 16:49:25 +0800
Subject: [PATCH] docs(fleet): clarify pending dispatch UI fixes

---
 ...¦ä¸­è®¢å�•æ�¢å¤�派车派人入å�£-修改接å�£-管ç�†å�Žå�°.md | 28 +++++++++++++++++++
 ...§å“�行程节点与出行人-修改接å�£-å‰�端待处ç�†-管ç�†å�Žå�°.md | 10 ++++++-
 2 files changed, 37 insertions(+), 1 deletion(-)

diff --git a/changelogs-v2/2026-07/23_5186_排车中订���派车派人入�-修改接�-管���.md b/changelogs-v2/2026-07/23_5186_排车中订���派车派人入�-修改接�-管���.md
index ff3879d..329f7b9 100644
--- a/changelogs-v2/2026-07/23_5186_排车中订���派车派人入�-修改接�-管���.md
+++ b/changelogs-v2/2026-07/23_5186_排车中订���派车派人入�-修改接�-管���.md
@@ -83,6 +83,30 @@ generated: "2026-07-23T16:10:00+08:00"
 
 以上仅是�端状�机和展示文案调整，�端�新增接�或字段。
 
+### `holding` 的用户��状�文案
+
+`holding` 是�端技术状��，表示车辆和�机已��定�派�通知已��出，当�正在等待�机回�。��车务人员时�能继续显示“排车中�，应统一显示为“待确认�：
+
+- 看��片主状�：`holding` 显示“待确认�，`holding_urgent` 显示“待确认�将超时�；
+- 状�筛选�数�汇总和图例使用�一套“待确认�文案；
+- �片上的�机回执徽标�显示“待回��，用于补充说明，�能与主状�“排车中�形�两个���径；
+- 技术值��� `holding/holding_urgent`，接�请求�数�状�判断�颜色和改派动作���改�；
+- 首次尚未�定车辆和�机的 `unassigned` 继续显示“待派车�，确认完��的 `assigned` 继续显示“已派车�。
+
+当� `v2.1` 的 `ORDER_STATUS_META`�`FILTER_STATUS_OPTIONS` 以��端 `assignmentStatusLabel` ��“排车中�旧文案。管���应以本节用户�径覆盖展示；如直接消费�端 label，�端需按状��归一，���页出现“排车中�和“待确认�两套�称。
+
+### 待确认订�的“继续派车�入�
+
+待确认订�必须�时�留“继续派车�和“改派�两个入�：
+
+- `availableActionCodes` 包� `RECORD_DRIVER_CONFIRMATION` 时显示主按钮“继续派车�，点击�用现有 `onConfirmHold(order)`，以 `mode=confirmHold` 打开派�弹窗；
+- `confirmHold` 根��端 `stageCode/driverConfirmedAt` ���程：等待�机回�时进入第 3 步“待确认�，已登记�机确认时进入第 4 步“确认执行�；
+- `availableActionCodes` 包� `CHANGE_ASSIGNMENT` 时�行显示“改派�，点击进入第 2 步�新选择车辆或�机；
+- 两个按钮�得互相替代：“继续派车�推进当�有效派�，“改派�修改当�有效派�；
+- “�行程���按�端动作�和派�阶段决定是��用。
+
+当� `v2.1@6e6a11bf` 的 `resolveBoardRowActions()` �检查已�废弃的 `CONFIRM` 动作�，而�端生命周期实际下� `RECORD_DRIVER_CONFIRMATION`，因此截图中“继续派车/�机已确认�按钮没有渲染。�端改为消费真实动作���，无需�端增加兼容别�。
+
 ## 三��影�范围
 
 - `canRejectRequirement` ��在未派阶段�能为 `true`；排车中�得�新开放“驳回用车需求�。
@@ -95,6 +119,10 @@ generated: "2026-07-23T16:10:00+08:00"
 - [ ] `holding_urgent` �样显示“改派�并进入调整�程。
 - [ ] `holding/holding_urgent + CHANGE_ASSIGNMENT` �片按钮显示“改派�，打开�直接高亮第 2 步“排车�，第 1 步为已完�。
 - [ ] 首次待派车�从第 1 步开始；`confirmHold` ���第 3/4 步，三�入�互�串�。
+- [ ] `holding/holding_urgent` 在�片�筛选�汇总和图例统一显示“待确认/待确认�将超时�，页���出现“排车中�旧文案。
+- [ ] 技术状�值�为 `holding`，改派��机确认和超时判断�因文案�化而改�。
+- [ ] 待确认订�在 `RECORD_DRIVER_CONFIRMATION` �用时显示“继续派车�，点击以 `confirmHold` ��第 3/4 步。
+- [ ] “继续派车�和“改派��时存在且�责分离；�端��检查�存在的 `CONFIRM` 动作�。
 - [ ] 打开排车步骤时，候选请求�时�带字符串 `orderId`�`requirementId` 和当� `fleetItemIndex`，��出现“改派候选查询必须�带当�订�ID�用车需求ID和车型项索引�。
 - [ ] �交时调用既有 `changeAssignment`，�调用创建派�接�。
 - [ ] `assigned`�`completed`�`canceled` �误显示入�。
diff --git a/changelogs-v2/2026-07/79_车务派�详情补全产�行程节点与出行人-修改接�-�端待处�-管���.md b/changelogs-v2/2026-07/79_车务派�详情补全产�行程节点与出行人-修改接�-�端待处�-管���.md
index 39f3ce3..bbca3fc 100644
--- a/changelogs-v2/2026-07/79_车务派�详情补全产�行程节点与出行人-修改接�-�端待处�-管���.md
+++ b/changelogs-v2/2026-07/79_车务派�详情补全产�行程节点与出行人-修改接�-�端待处�-管���.md
@@ -214,8 +214,13 @@ GET /admin/fleet/board/orders/{orderId}
 5. �止为了展示此页�调用明文接� `POST /admin/fleet/board/orders/{orderId}/travelers/plain`。Step1 �使用详情�应中的脱� `travelers[]`。
 6. 空�明确：无节点显示“暂无行程节点�，无出行人显示“暂未填写出行人信��；�得生�模拟节点或模拟出行人。
 7. 雪花 ID �止 `Number()` / `parseInt()`，统一按字符串处�。
+8. 用车备注与通用特殊诉求必须按字段��分区展示，�能混在�一个“特殊�求�警示框：
+   - `requirementRemark` ��于定制师在“调整订� → 车辆安排 → 备注/其他诉求�填写的自由文本，应显示在“定制师备注�或更准确的“用车备注��片中；例如“�机会蒙语�。
+   - `specialTags[]` ��于“通用特殊诉求�的多选标签，�在“特殊�求�区域展示标签；例如“儿童安全座椅�“大行�空间�“中文�机�。
+   - `plannerNote` 是订�级定制师备注，与 `requirementRemark` �是�一字段；两者�时存在时分行展示并标明��，�得互相覆盖。
+   - `requirements` 仅作为历�订�兼容文本；当 `requirementRemark` 或 `specialTags[]` 已有值时，�得把它们��拼入 `requirements`。
 
-推�布局：顶部摘�下放横�“大交通��；左�继续承载�日节点时间线；��顺�为“出行人信� → 客人留言 → 特殊�求 → �作记录�。
+推�布局：顶部摘�下放横�“大交通��；左�继续承载�日节点时间线；��顺�为“出行人信� → 客人留言 → 定制师/用车备注 → 特殊�求 → �作记录�。
 
 ---
 
@@ -242,6 +247,8 @@ GET /admin/fleet/board/orders/{orderId}
 - [ ] ��出行人以“年龄 N ��的自然文案展示年龄，并�查看人员类型�性别��件�国�/民����分组�关�大交通�资料状�。
 - [ ] 无节点/无出行人时展示真实空�，�生�模拟数�。
 - [ ] 页� Network �需现有详情请求，�调用出行人明文接�。
+- [ ] “备注/其他诉求�读� `requirementRemark` 并显示在定制师/用车备注�片；“特殊�求��展示 `specialTags[]`，�会�把备注文本放入警示框。
+- [ ] `plannerNote` 与 `requirementRemark` �时存在时分别展示且�覆盖，历� `requirements` �造���文案。
 - [ ] 现有留言�特殊�求�步骤�和�作记录��影�。
 
 ---
@@ -257,6 +264,7 @@ GET /admin/fleet/board/orders/{orderId}
 - �一实测订�返回 2 个真实订�标签“自动化测试�“房务需求�，�包�颜色，`tagId` �为字符串；�应�� `bookingType`，�端无需也�得使用“�业包车�等硬编�兜底。
 - �一实测订�已返回抵达大交通的�次�抵达时间和站点；该订�无返程段�无分批接�，接�按真实数�返回空值或空数组。
 - 该订� 14 个节点的 `startTime` 与 `timePeriod` 在订�行程�数�中�为空，接�如实返回 `null`；�端须展示“时间待定�，若�显示具体钟点需先补录订�行程节点时间。
+- 测试环境团� `26-7042` 的调整�中，“备注/其他诉求�为“�机会蒙语�；详情接�已分别返回 `requirementRemark` 和 `specialTags[]`。截至 `v2.1@6e6a11bf`，`Step1OrderDetail.vue` �使用 `requirementRemark || requirements` 渲染“特殊�求�警示框，并仅用 `plannerNote` 渲染定制师留言，造�截图中的字段串�；按上方规则调整�端展示��，�端无需新增字段。
 - 网关��已由 `hl task` 登记，SHA-256：`8ff09cc804fb8d72fde6df3f338125b725c857d2c098b59f6b222f460da844a3`。
 
 > 本文是�端接入通知，�代表已修改或�布 `mmg/hl-ui`。