From c0d07a0db4c3a057f6437dcd3c6c79526b32ccc0 Mon Sep 17 00:00:00 2001
From: API Changelog Bot <changelog@hulalv.com>
Date: Wed, 22 Jul 2026 10:33:02 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20=E8=A1=A5=E5=85=85=E8=BD=A6=E5=8A=A1?=
 =?UTF-8?q?=E6=B4=BE=E5=8D=95=E8=AF=A6=E6=83=85=E5=89=8D=E7=AB=AF=E5=A5=91?=
 =?UTF-8?q?=E7=BA=A6?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 ...§å“�行程节点与出行人-修改接å�£-å‰�端待处ç�†-管ç�†å�Žå�°.md | 209 ++++++++++++++++++
 1 file changed, 209 insertions(+)
 create mode 100644 changelogs-v2/2026-07/79_车务派�详情补全产�行程节点与出行人-修改接�-�端待处�-管���.md

diff --git a/changelogs-v2/2026-07/79_车务派�详情补全产�行程节点与出行人-修改接�-�端待处�-管���.md b/changelogs-v2/2026-07/79_车务派�详情补全产�行程节点与出行人-修改接�-�端待处�-管���.md
new file mode 100644
index 0000000..b8383b2
--- /dev/null
+++ b/changelogs-v2/2026-07/79_车务派�详情补全产�行程节点与出行人-修改接�-�端待处�-管���.md
@@ -0,0 +1,209 @@
+# �修改接�·�端待处�·管���】车务派�详情补全产��行程节点与出行人
+
+> **�务**: hl-order-service-v3 + hl-fleet-service  
+> **日期**: 2026-07-22  
+> **影�范围**: 管���车务管� / 派车看� / 派�弹窗 Step1「订�详情�
+
+---
+
+## 关键�化
+
+派�弹窗 Step1 �能��展示人数�日期和�日一�简介。`GET /admin/fleet/board/orders/{orderId}` 现一次返回：
+
+- `productName`：订�产��（原字段，�端本次必须展示）。
+- `itinerary.days[].nodes[]`：�日真实行程节点，�开始时间�时段�时长��称和简介。
+- `travelers[]`：出行人脱�基本信�，��生日和任何明文字段。
+- `transport`：抵达�返程�分批大交通信�（原字段，�端本次必须完整展示时间和�次，�能�显示站点）。
+
+行程数��以订�当� `order_itinerary_day` 和 `order_itinerary_node` 为���，�止从产�模��推。
+
+---
+
+## �更接�
+
+```http
+GET /admin/fleet/board/orders/{orderId}
+```
+
+�应 VO：`BoardOrderDetailVO`
+
+### 新增字段
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| `itinerary.days[].nodes` | Array | 当日节点，按 `sortOrder` ��；无节点返回 `[]` |
+| `itinerary.days[].nodes[].nodeId` | String | 节点雪花 ID，必须按字符串处� |
+| `itinerary.days[].nodes[].nodeType` | String/null | 节点类型，如 `SCENIC`�`RESTAURANT`�`ACTIVITY`�`SERVICE`�`CUSTOM` |
+| `itinerary.days[].nodes[].nodeName` | String/null | 节点展示�；节点�为空时�端回退资�� |
+| `itinerary.days[].nodes[].startTime` | String/null | 开始时间，格� `HH:mm` |
+| `itinerary.days[].nodes[].timePeriod` | String/null | 时段，如上��下��全天 |
+| `itinerary.days[].nodes[].durationMinutes` | Number/null | 时长，��分钟 |
+| `itinerary.days[].nodes[].description` | String/null | 节点简介 |
+| `itinerary.days[].nodes[].sortOrder` | Number/null | �天排� |
+| `travelers` | Array | 出行人脱�基本信�；无出行人或下游�级时返回 `[]` |
+| `travelers[].travelerId` | String | 出行人雪花 ID，必须按字符串处� |
+| `travelers[].travelerType` | String/null | `ADULT` / `CHILD` / `YOUNG_CHILD` / `BABY` |
+| `travelers[].nameMasked` | String/null | 脱�姓� |
+| `travelers[].gender` | String/null | 性别字典值 |
+| `travelers[].ageAtDeparture` | Number/null | 按订�出�日计算的周� |
+| `travelers[].idType` | String/null | �件类型字典值 |
+| `travelers[].idNoMasked` | String/null | 脱��件� |
+| `travelers[].phoneMasked` | String/null | 脱�手机� |
+| `travelers[].nationality` | String/null | 国� |
+| `travelers[].emergencyContactMasked` | String/null | 脱�紧急�系人姓� |
+| `travelers[].emergencyPhoneMasked` | String/null | 脱�紧急�系人电� |
+| `travelers[].profileStatus` | String/null | 资料状�：`PENDING` / `COMPLETED` |
+
+`productName` 是已有字段，结构��；本次页�必须消费，����存在 `normalizeBoardOrder().product` 而�展示。
+
+### 已有但本次必须完整展示的大交通字段
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| `transport.arrive` | Object/null | 抵达接团段 |
+| `transport.arrive.transportNo` | String/null | 抵达航��/车次� |
+| `transport.arrive.time` | String/null | 抵达时间，ISO `LocalDateTime` |
+| `transport.arrive.station` | String/null | 抵达机场/车站 |
+| `transport.arrive.remark` | String/null | 抵达备注 |
+| `transport.depart` | Object/null | 返程�站段 |
+| `transport.depart.transportNo` | String/null | 返程航��/车次� |
+| `transport.depart.time` | String/null | 返程时间，ISO `LocalDateTime` |
+| `transport.depart.station` | String/null | 返程机场/车站 |
+| `transport.depart.remark` | String/null | 返程备注 |
+| `transport.batches` | Array | 分批接�列表 |
+| `transport.batches[].travelerNames` | String/null | 本批出行人姓�摘� |
+| `transport.batches[].transportNo` | String/null | 本批航��/车次� |
+| `transport.batches[].time` | String/null | 本批抵达/返程时间 |
+| `transport.batches[].station` | String/null | 本批机场/车站 |
+| `transport.transferTimeHint` | String/null | 无任何大交通时间时的�端�示，当�为“暂无接�机时间� |
+| `transport.pickupRequired` | Boolean/null | 是�需�平�派车接� |
+
+### �应示例
+
+```json
+{
+  "code": 200,
+  "data": {
+    "orderNo": "HL20260721171011648",
+    "productName": "�原亲�三日游",
+    "itinerary": {
+      "theme": "�原亲�三日游",
+      "route": null,
+      "days": [
+        {
+          "dayNumber": 1,
+          "date": "2026-07-29",
+          "title": "接机",
+          "detail": "抵达�入�酒店",
+          "nodes": [
+            {
+              "nodeId": "2001",
+              "nodeType": "SERVICE",
+              "nodeName": "海拉尔机场接机",
+              "startTime": "10:30",
+              "timePeriod": "上�",
+              "durationMinutes": 60,
+              "description": "�机举牌接机",
+              "sortOrder": 1
+            }
+          ]
+        }
+      ]
+    },
+    "travelers": [
+      {
+        "travelerId": "3001",
+        "travelerType": "ADULT",
+        "nameMasked": "å­”**",
+        "gender": "2",
+        "ageAtDeparture": 35,
+        "idType": "ID_CARD",
+        "idNoMasked": "150***********1234",
+        "phoneMasked": "138****1234",
+        "nationality": "中国",
+        "emergencyContactMasked": "王*",
+        "emergencyPhoneMasked": "139****5678",
+        "profileStatus": "COMPLETED"
+      }
+    ],
+    "transport": {
+      "transferTimeHint": null,
+      "arrive": {
+        "transportNo": "CA1234",
+        "time": "2026-07-29T10:30:00",
+        "station": "海拉尔东山国际机场",
+        "remark": "T2 出�举牌接机"
+      },
+      "depart": {
+        "transportNo": "CA5678",
+        "time": "2026-07-31T17:20:00",
+        "station": "海拉尔东山国际机场",
+        "remark": "�� 2 �时�达"
+      },
+      "batches": [],
+      "pickupRequired": true
+    }
+  },
+  "success": true
+}
+```
+
+---
+
+## �端页�调整�求
+
+目标文件：`src/views/fleet/board/components/Step1OrderDetail.vue`。
+
+1. 顶部订�摘�展示产��，读� `order.productName || order.product`；产��为空�显示 `—`。
+2. 在顶部订�摘�下增加“大交通�信��，抵达与返程分�展示 `transportNo + time + station + remark`：
+   - 时间使用完整月日和时分，��展示日期。
+   - `arrive`�`depart` 独立判空，�有一段时�正常展示该段。
+   - `batches[]` �空时增加“分批接��，展示本批出行人��次�时间和站点。
+   - 无任何时间时展示 `transport.transferTimeHint`，�得伪造航�或时间。
+   - 当�顶部“接��统计��留站点摘�，但�能替代大交通详情�。
+3. 左侧“�日安排��留日标题和 `detail`，并在�一天下�渲染 `nodes[]`：
+   - 时间优先显示 `startTime`，为空时显示 `timePeriod`，两者都有�组�展示。
+   - 主文案显示 `nodeName`。
+   - `durationMinutes` 有值时显示易读时长。
+   - `description` 有值且与日简介���时显示节点简介。
+4. �侧新增“出行人信��区，默认展示脱�姓��人员类型�性别�出�时年龄�脱�手机�和资料状�；�件/紧急�系人�在行内展开或次�信�区展示。
+5. �止为了展示此页�调用明文接� `POST /admin/fleet/board/orders/{orderId}/travelers/plain`。Step1 �使用详情�应中的脱� `travelers[]`。
+6. 空�明确：无节点显示“暂无行程节点�，无出行人显示“暂未填写出行人信��；�得生�模拟节点或模拟出行人。
+7. 雪花 ID �止 `Number()` / `parseInt()`，统一按字符串处�。
+
+推�布局：顶部摘�下放横�“大交通��；左�继续承载�日节点时间线；��顺�为“出行人信� → 客人留言 → 特殊�求 → �作记录�。
+
+---
+
+## 兼容与�级
+
+- 仅新增�应字段，�修改请求�数，�影�旧调用方。
+- 历�行程没有节点时 `nodes=[]`，�日标题和简介�照常返回。
+- order-v3 ��上下文失败并回退 fleet 本地快照时，`relatedDetailReady=false`，`travelers=[]`，行程节点��用；�端显示真实空�。
+- 原独立脱�接� `GET /admin/fleet/board/orders/{orderId}/travelers` �留兼容，但此页�无需��第二次请求。
+- �返回 `birthday`�明文姓��明文�件��明文手机�或明文紧急�系人。
+
+---
+
+## 验收清�
+
+- [ ] 顶部�看到订�产��。
+- [ ] 大交通�分别展示抵达/返程的�次�完整时间�站点和备注。
+- [ ] 有分批接�时展示�批出行人��次�时间和站点；无大交通时间时展示真实空�。
+- [ ] �日安排按节点顺�展示时间�节点��时长和简介。
+- [ ] 节点无 `startTime` 时�回退显示 `timePeriod`，�会出现 `undefined`。
+- [ ] �侧�看到全部出行人的脱�基本信�。
+- [ ] 无节点/无出行人时展示真实空�，�生�模拟数�。
+- [ ] 页� Network �需现有详情请求，�调用出行人明文接�。
+- [ ] 现有留言�特殊�求�步骤�和�作记录��影�。
+
+---
+
+## �端验�记录
+
+- `ItineraryServiceTest`：覆盖节点�称�开始时间�时段�时长�简介和排�装�。
+- `OrderFleetProviderServiceTest`：覆盖节点�当�订�日期对�且出行人脱�进入��上下文。
+- `BoardOrderServiceTest`：覆盖 shared DTO 到管�端 VO 的节点和出行人映射。
+- `BoardControllerTest`：覆盖 `productName`�节点时间�String ID 与脱�出行人的 JSON 契约。
+
+> 本文是�端接入通知，�代表已修改或�布 `mmg/hl-ui`。