From 9b32c2e2e0a9778453e3f9f12a83a3436ac29147 Mon Sep 17 00:00:00 2001
From: API Changelog Bot <changelog@hulalv.com>
Date: Thu, 23 Jul 2026 17:06:15 +0800
Subject: [PATCH] docs(fleet): specify mobile itinerary link copy flow

---
 ...¦ä¸­è®¢å�•æ�¢å¤�派车派人入å�£-修改接å�£-管ç�†å�Žå�°.md | 70 ++++++++++++++++---
 1 file changed, 59 insertions(+), 11 deletions(-)

diff --git a/changelogs-v2/2026-07/23_5186_排车中订���派车派人入�-修改接�-管���.md b/changelogs-v2/2026-07/23_5186_排车中订���派车派人入�-修改接�-管���.md
index 30d8e76..82e0ce1 100644
--- a/changelogs-v2/2026-07/23_5186_排车中订���派车派人入�-修改接�-管���.md
+++ b/changelogs-v2/2026-07/23_5186_排车中订���派车派人入�-修改接�-管���.md
@@ -103,22 +103,66 @@ generated: "2026-07-23T16:10:00+08:00"
 - `confirmHold` 根��端 `stageCode/driverConfirmedAt` ���程：等待�机回�时进入第 3 步“待确认�，已登记�机确认时进入第 4 步“确认执行�；
 - `availableActionCodes` 包� `CHANGE_ASSIGNMENT` 时�行显示“改派�，点击进入第 2 步�新选择车辆或�机；
 - 两个按钮�得互相替代：“继续派车�推进当�有效派�，“改派�修改当�有效派�；
-- “打�行程��是独立�读能力，直接�用订�详情现有打�预览，��与派�状��转。
+- “�制行程�链接�是独立�读能力，�制�端为当�有效派�签�的�机 H5 链接，��与派�状��转。
 
 当� `v2.1@6e6a11bf` 的 `resolveBoardRowActions()` �检查已�废弃的 `CONFIRM` 动作�，而�端生命周期实际下� `RECORD_DRIVER_CONFIRMATION`，因此截图中“继续派车/�机已确认�按钮没有渲染。�端改为消费真实动作���，无需�端增加兼容别�。
 
-### 看��用“打�行程��
+### 看��制�机 H5 行程�链接
 
-看���维护独立的“�行程��抽屉，也�在�端模拟���功。订�详情已��供完整且��的打�能力，看��增加�能力入�：
+看���维护独立的“�行程��抽屉，也�在�端模拟���功。这里�是打开订�详情的“打�行程��，而是把�端已�为当�有效派�签�的 H5 链接�制到剪贴�，车务�通过微信等渠��给�机。�机�在手机�览器中独立打开，�需�登录管���。
 
-- 将看�按钮文案由“�行程��改为“打�行程��；
-- 直接�用 `src/views/order-v2/detail/modals/PrintItineraryModal.vue`；
-- 继续调用既有 `getPrintItinerary(orderId)`，� `GET /v3/admin/order/{orderId}/print-itinerary`；
-- `orderId` 使用 `resolveBoardOrderId(order)` 的字符串结果，�止传团��订��或� `Number()` 转�；
+- 将看�按钮文案由“�行程��改为“�制行程�链接�，事件��步改为 `copy-itinerary-link`，��继续表达�“���；
+- 点击时先调用既有看�详情接� `GET /admin/fleet/board/orders/{orderId}`，��调用订�打�接�；
+- 默认�制 `currentAssignment.itineraryUrl`；如果入�明确针对�一�有效派�，则�制对应 `activeAssignments[].itineraryUrl`；
+- 链接必须直接使用�端返回值，�端�得自行拼接 H5 地��token�订� ID 或派� ID；
+- 优先使用 `navigator.clipboard.writeText(itineraryUrl)`；当�管����能�行在 HTTP 内网环境，必须�时�供临时 `textarea + document.execCommand('copy')` �级实现；
+- �制�功�示“行程�链接已�制，���给�机�；
+- `itineraryUrl` 为空时�得�制或�示�功，应�示“行程�链接暂��用，请确认已派车且 H5 �置正常�；
 - 删除/�用看�自己的 `ItinerarySendSheet.vue`�消�模�和本地 `message.success('已��行程�')` ��程；
-- 打�内容�彩色/黑白切��加载失败�试���和�端数��与订�详情完全一致，�续�维护一套。
+- ��用 `PrintItineraryModal.vue`，�调用 `GET /v3/admin/order/{orderId}/print-itinerary`；订�详情的“打�行程��继续作为��车务的独立打�能力�留；
+- 链接包�签� token，�端日志�埋点和错误�示�得记录或展示完整 URL；
+- 改派�功�必须�新拉�详情并使用新派�的 `itineraryUrl`，�能继续缓存或�制旧派�链接。
 
-该打�入��改�派�状�，也��赖订�处于待派车�待确认或已派车；是�展示�按订�打���和有效订� ID 判断。
+�端链接已绑定当�订�与具体派�，有效期至行程结�� 7 天；公开 H5 接�会校验签��有效期和派�归属，并实时读�行程数�。�制动作本身�改�派�状�，也�产生“已���记录。
+
+建议�端按以下逻辑�地（函数��按现有工程调整）：
+
+```ts
+async function onCopyItineraryLink(order: BoardOrder) {
+  const orderId = resolveBoardOrderId(order)
+  const detail = await getBoardOrderDetail(orderId)
+  const itineraryUrl = detail.currentAssignment?.itineraryUrl?.trim()
+
+  if (!itineraryUrl) {
+    message.error('行程�链接暂��用，请确认已派车且 H5 �置正常')
+    return
+  }
+
+  try {
+    if (navigator.clipboard && window.isSecureContext) {
+      await navigator.clipboard.writeText(itineraryUrl)
+    } else {
+      copyTextByTextarea(itineraryUrl)
+    }
+    message.success('行程�链接已�制，���给�机')
+  } catch {
+    message.error('�制失败，请���试')
+  }
+}
+
+function copyTextByTextarea(text: string) {
+  const textarea = document.createElement('textarea')
+  textarea.value = text
+  textarea.setAttribute('readonly', '')
+  textarea.style.position = 'fixed'
+  textarea.style.opacity = '0'
+  document.body.appendChild(textarea)
+  textarea.select()
+  const copied = document.execCommand('copy')
+  document.body.removeChild(textarea)
+  if (!copied) throw new Error('copy failed')
+}
+```
 
 ## 三��影�范围
 
@@ -136,8 +180,12 @@ generated: "2026-07-23T16:10:00+08:00"
 - [ ] 技术状�值�为 `holding`，改派��机确认和超时判断�因文案�化而改�。
 - [ ] 待确认订�在 `RECORD_DRIVER_CONFIRMATION` �用时显示“继续派车�，点击以 `confirmHold` ��第 3/4 步。
 - [ ] “继续派车�和“改派��时存在且�责分离；�端��检查�存在的 `CONFIRM` 动作�。
-- [ ] 看�显示“打�行程��，打开内容与订�详情的打�预览完全一致。
-- [ ] 看���使用 `ItinerarySendSheet` 或模拟“已��行程��，Network �调用既有打�接�。
+- [ ] 待确认或已派车且存在当�有效派�时，看�显示“�制行程�链接�。
+- [ ] 点击�通过看�详情�得并�制 `currentAssignment.itineraryUrl`，�调用订�打�接���在�端拼接链接。
+- [ ] HTTPS/localhost 使用 Clipboard API，HTTP 内网环境�通过�级方案正常�制。
+- [ ] �制�功�示“行程�链接已�制，���给�机�；链接为空或�制失败时给出明确错误且�误报�功。
+- [ ] �制出的链接�由�机在手机�览器中独立打开，无需登录管���，并展示当�派�的实时行程。
+- [ ] 看���使用 `ItinerarySendSheet` 或模拟“已��行程��，改派��会�制旧派�链接。
 - [ ] 打开排车步骤时，候选请求�时�带字符串 `orderId`�`requirementId` 和当� `fleetItemIndex`，��出现“改派候选查询必须�带当�订�ID�用车需求ID和车型项索引�。
 - [ ] �交时调用既有 `changeAssignment`，�调用创建派�接�。
 - [ ] `assigned`�`completed`�`canceled` �误显示入�。