From 54eafe458f7d9d2bc27916d3ef9100cfb14b73ed Mon Sep 17 00:00:00 2001
From: API Changelog Bot <changelog@hulalv.com>
Date: Wed, 25 Mar 2026 13:59:00 +0800
Subject: [PATCH] =?UTF-8?q?=E8=AE=A2=E5=8D=95=E4=BA=A4=E9=80=9A=E4=BF=A1?=
 =?UTF-8?q?=E6=81=AF=EF=BC=88=E6=8E=A5=E9=80=81=E7=AB=99=EF=BC=89API=20?=
 =?UTF-8?q?=E2=80=94=20=E9=A3=9E=E5=B8=B8=E5=87=86=E5=AF=B9=E6=8E=A5?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../2026-03/2026-03-25_order_transport.md     | 97 +++++++++++++++++++
 1 file changed, 97 insertions(+)
 create mode 100644 changelogs/2026-03/2026-03-25_order_transport.md

diff --git a/changelogs/2026-03/2026-03-25_order_transport.md b/changelogs/2026-03/2026-03-25_order_transport.md
new file mode 100644
index 0000000..a0b1e4d
--- /dev/null
+++ b/changelogs/2026-03/2026-03-25_order_transport.md
@@ -0,0 +1,97 @@
+# 订单交通信息（接送站）— 航班/火车实时动态
+
+> 为订单添加去程接站/回程送站的航班或火车信息，查询时自动从飞常准API获取实时动态（到达时间、延误状态等）。
+
+---
+
+## 一、管理端接口
+
+### 1.1 添加交通信息
+```
+POST /admin/order/{orderId}/transport
+```
+
+| 字段 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| legType | String | 是 | OUTBOUND=去程接站, RETURN=回程送站 |
+| transportType | String | 是 | FLIGHT=航班, TRAIN=火车 |
+| transportNo | String | 是 | 航班号(如CA1234)或车次(如G71) |
+| departureStation | String | 否 | 出发站/机场 |
+| arrivalStation | String | 否 | 到达站/机场 |
+| travelDate | String | 是 | 乘坐日期(yyyy-MM-dd) |
+| remark | String | 否 | 备注 |
+
+### 1.2 编辑交通信息
+```
+PUT /admin/order/transport/{transportId}
+```
+请求体同上（所有字段可选更新）
+
+### 1.3 删除交通信息
+```
+DELETE /admin/order/transport/{transportId}
+```
+
+### 1.4 查询订单交通信息（含实时动态）
+```
+GET /admin/order/{orderId}/transports
+```
+
+---
+
+## 二、小程序端接口
+
+### 2.1 填写交通信息
+```
+POST /mp/order/{orderId}/transport
+```
+请求体同管理端
+
+### 2.2 查看交通信息
+```
+GET /mp/order/{orderId}/transports
+```
+
+---
+
+## 三、响应结构 OrderTransportVO
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| transportId | String | 交通信息ID |
+| orderId | String | 订单ID |
+| legType | String | OUTBOUND/RETURN |
+| transportType | String | FLIGHT/TRAIN |
+| transportNo | String | 航班号或车次 |
+| departureStation | String | 出发站 |
+| arrivalStation | String | 到达站 |
+| travelDate | String | 乘坐日期 |
+| remark | String | 备注 |
+| createdByType | String | ADMIN=管理员填, USER=用户填 |
+| **planDepartTime** | String | 计划出发时间（实时） |
+| **planArriveTime** | String | 计划到达时间（实时） |
+| **actualDepartTime** | String | 实际/预计出发时间（实时） |
+| **actualArriveTime** | String | 实际/预计到达时间（实时） |
+| **liveStatus** | String | 状态：计划/起飞/到达/延误/晚点等（实时） |
+| **extraInfo** | Map | 额外信息（航站楼/登机口/出口等） |
+
+**加粗字段**为查询时从飞常准API实时获取，不存数据库。
+
+---
+
+## 四、使用场景
+
+```
+1. 订单确认后，管理员在订单详情填写客人的去程航班/火车
+2. 或者客人自己在小程序"补充信息"时填写
+3. 司机/管理员查看时，自动显示实时到达时间和延误状态
+4. 接站时间有变（延误等），页面自动反映最新状态
+```
+
+## 五、涉及服务
+
+需重启：**hl-order-service、hl-transport-service、hl-mp-service**
+
+## 六、数据库变更
+
+新增表 `order_transport`（DDL: `sql/order_transport.sql`），测试环境已执行。