98 行
2.8 KiB
Markdown
98 行
2.8 KiB
Markdown
# 订单交通信息（接送站）— 航班/火车实时动态
|
||
|
||
> 为订单添加去程接站/回程送站的航班或火车信息，查询时自动从飞常准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`），测试环境已执行。
|