# PRD · 短驳执行（模块 4）

## 1. Summary

给已经指定车队的发端、到端派司机和车辆，并用照片记录这段短驳。派车之后这段进入进行中。司机可以不按步骤点，照片放在一个弹窗里上传。

集装箱和整车都可以门到门。集装箱一票多箱时，一端可以派多条，一条一个箱号。整车派出去的是汽车，汽车数不是火车车数，同一辆车可以跑几趟。整车这一期不让司机上传。司机不操作时，主流程不受影响。

## 2. Contacts

| 姓名 | 角色 | 说明 |
| --- | --- | --- |
| 建超 | 产品 | 本模块负责人 |

## 3. Background

主流程已经把短驳放在旁边。状态只有待安排、进行中、已完成。现网要司机按提空箱、装货、回站一步步点，点不完后面的铁路状态也不能走。

整车以前被限制成站到站。运输类型本身已经能表示门到门。整车上门仍要派汽车，但汽车趟数和 95306 的火车车数分开记。

车辆现网挂在登录人身上。新单按车队公司维护车辆。

## 4. Objective

车队能在火车到站之前就把到端派出去。集装箱发端派车时能记下已有空箱和箱号。司机、调度、业务员都能把这段标成已完成，避免车队不操作时状态一直挂着。

**Key Results（上线后用数据校准）**

- KR1：系统车队的一段，派车保存后状态为进行中，主流程状态不变。
- KR2：集装箱发端在默认「已有空箱」时，不填箱号不能保存派车。
- KR3：系统车队这一段，业务员不能改成进行中。第三方在业务员确认后就是进行中。两边都可以由业务员标成已完成。

## 5. Market Segment(s)

**车队调度。** 给本车队接到的发端或到端派司机和车辆，并在司机没点完成时代为完成。

**司机。** 集装箱上查看派给自己的活，上传各节点照片，或在照片没传完时直接完成。整车这一期没有司机上传。

**业务员。** 系统车队不派车、不把状态改成进行中，只在这段挂住时标成已完成。第三方没有车队账号，确认后这段就是进行中，由业务员在订单里点完成。

**客户。** 在订单里看到这段是进行中或已完成。不能派车，也不能点完成。

## 6. Value Proposition

**车队调度**

- **Who：** 已接到这一段的系统车队调度。
- **Why：** 要在到站前把车和司机定好，又不想被铁路状态拦住。
- **What before：** 到端要等订单到站才派得出去。司机每一步都得点，点漏了整票停住。
- **How：** 车队一指定就可以派车。派车后这段进行中。完成用和司机相同的照片弹窗，可以不上传直接完成。
- **What after：** 到端不用等火车到站。这段完成不依赖司机把每张照片传齐。
- **Alternatives：** 用微信通知司机。派车留在系统里，照片和完成写进操作记录。

**司机**

- **Who：** 被派到这一段的司机。
- **Why：** 要交现场照片，但不是每个节点都有照片，也不想一步步解锁。
- **What before：** 必须按提空箱、装货、回站的顺序点，缺一步就不能往后。
- **How：** 一个上传按钮打开全部节点。每个节点多张图片，都可以删，都不强制。另有完成按钮。
- **What after：** 照片可以后补、可以不传。传齐该传的节点时，系统再问要不要完成。
- **Alternatives：** 把照片发到群里。弹窗集中在这一段上，删除和新增都有记录。

**业务员**

- **Who：** 盯着短驳状态的业务员。
- **Why：** 车队不派车、司机不点完成时，这段会一直挂着。
- **What before：** 业务员要么干等，要么自己把状态改成进行中，和真实派车混在一起。
- **How：** 系统车队这一段，业务员不派车，也不改成进行中。第三方在确认时写成进行中。点完成都打开这一端的照片弹窗，可以上传，也可以不上传直接完成。
- **What after：** 没有人操作的短驳可以被收掉。第三方不出现在车队待办里。
- **Alternatives：** 让调度务必去点。系统车队仍由调度派车后才进入进行中。

价值陈述：派车只表示司机和车辆已经指定。照片随便哪个节点先传。这段可以在没人继续操作时由业务员或调度完成。

## 7. Solution

### 7.1 谁可以派车

系统车队被写上这一段之后就可以派，包含协议指定和竞价成功。不等待提报，也不等火车到站。

第三方只有名称，没有派车，也没有司机。业务员确认写入这一段时，状态就是进行中。客户和业务员在订单里能看到。车队列表和司机待办里没有这段。业务员点完成时弹出这一端的上传图片，可以不传直接完成。发端和到端仍各点一次。

集装箱一票一个箱子时，一端一名司机、一辆车。一票多箱时，一端可以派多条，一条一个箱号。整车的一端可以派多辆汽车。派了 10 辆，也可以对应 30 个火车车，因为同一辆汽车会来回跑。派车行数不拿来算车数和重量。

发端、到端按运输类型出现。站到站没有短驳。门到站只有发端，站到门只有到端，门到门两端都有。整车和集装箱用同一套规则。

### 7.2 派车字段

集装箱发端要选定一行箱子，再填是否已有空箱、司机、车辆。第一期默认已有空箱，选了已有空箱就必须填箱号。箱号写入这行箱子，不写在派车上。司机提空箱时，或业务员直接改箱子时，也可以填写或改掉这个箱号。一票多箱就多条派车，每条对应一行箱子。「是否已有空箱」只决定这一页箱号必填，不另存。选了司机后，如果某辆车的默认司机是这个人，车牌自动带出，仍可以改。同一个人是多辆车的默认司机时，不自动带出，由调度选择。

以后用系统配置决定默认是不是已有空箱。这一期不建这个配置，默认已有空箱。

到端，以及整车的发端，只选司机和车辆，没有空箱和箱号。

司机从本车队的司机里选。车辆从本车队的车辆里选。派车保存后，这段状态变为进行中。主流程状态不变。

改派是加行或换掉原来的司机和车辆，并写入操作记录。集装箱这一端要再加一个箱子，就再加一条派车。只有一条派车时，再派就是替换。

### 7.3 照片和完成

司机页面有一个上传按钮。点击后弹出这一段的全部节点，每个节点可以上传多张，可以删除，都不是必填。保存时，新增和删除已保存的图片都写入操作记录。

哪些节点必须有图片，到 H5 再定。PC 先把节点、上传、删除和保存做出来。保存时如果当前要求上传的节点都已有图片，询问司机是否完成工作。司机确认后，这段改为已完成。

另有一个完成按钮。图片没传完也能点。点开的是同一个弹窗，多一个完成。

车队调度和业务员的完成按钮与司机相同。业务员第一期不能派车，不能把状态改成进行中。

整车不让司机上传，也不按每一条派车完成。车队或业务员点完成，这一端直接已完成。发端和到端各点一次。点完成不把订单主流程改成完成。

### 7.4 车辆

车队维护自己的车辆：车号、车辆类型、头车或挂车、吨位、轴数、默认司机、车辆状态。默认司机用于派车时带出车牌。

沿用现网 `biz_vehicle`，增加车队公司。派车时按车队公司取车辆。现网用 `biz_user_vehicle` 把车挂到登录人上，新派车不再用这张关系。

### 7.5 假设

- 照片节点的名称，以及哪些节点可以不传，到 H5 再定。PC 按节点列表渲染。
- 整车不走客户确认价格。有短驳时，运费仍按订单主流程的规则填写，不在本模块另做确认。

## 8. Release

**这一期要有的**

- 集装箱、整车按运输类型出现发端和到端。
- 派车后进入进行中。到端不等火车到站。
- 集装箱一箱一条派车，箱号写在箱子上。整车可派多辆汽车，派车行数不是火车车数。
- 集装箱发端默认已有空箱，并填写箱号。选择默认司机的车辆时带出车牌。
- 集装箱用一个弹窗上传各节点照片，可多张、可删除，保存写入操作记录。
- 集装箱由司机、调度、业务员完成。整车由车队或业务员点一次完成本端。系统车队这段，业务员不改成进行中。
- 第三方确认后即为进行中。业务员点完成时弹出上传，可以不传。客户只能在订单里查看。
- 车队在现网车辆表上按公司维护车辆和默认司机。

**这一期不做**

- 竞价过程。
- 默认「已有空箱」的系统配置。
- 业务员派车，或业务员把短驳改成进行中。
- 司机操作挡住主流程。
- H5 上哪些节点可以不传图片。
- 整车司机按节点上传。

## 9. 数据库表设计参考

短驳段用订单主流程的 `qh_biz_order_leg`，一段一行，上面是车队和这段的状态。操作记录用 `qh_biz_order_log`。进度节点 `qh_biz_order_node` 只记时间，不存图片。

### 9.1 派车 `qh_biz_order_dispatch`

一段短驳要记下派了哪几名司机、哪几辆车。整车一端有多辆汽车，这些不能写进 `qh_biz_order_leg` 那一行。集装箱一票多箱时，每一条派车指向一行箱子。箱号在箱子上。

现网 `biz_lgct_vehicle_assign` 用需求单号挂派车。新表同时记下订单和短驳段，查一票的车不必先找段。

| 字段 | 说明 |
| --- | --- |
| `id` | 主键 |
| `order_id` | 订单，对应 `qh_biz_order.id` |
| `leg_id` | 短驳段，对应 `qh_biz_order_leg.id` |
| `driver_user_id` | 司机登录用户 |
| `vehicle_id` | 车辆，对应 `biz_vehicle` |
| `vehicle_no` | 派车时的车号 |
| `box_id` | 集装箱指向 `qh_biz_order_box`。整车为空 |
| `dispatch_status` | `doing` 进行中，`done` 该条派车已完成。整车不按这一行完成 |
| `create_by` / `create_time` | 谁在何时派的 |

派车保存后，所属短驳段的状态改为进行中。集装箱加一个箱子就新增一行，只有一行时再派是替换。整车加汽车时新增一行。集装箱一段下全部派车都完成，或调度、业务员直接完成这段时，短驳段改为已完成。整车由车队或业务员点一次，这一端改为已完成。

### 9.2 订单文件 `qh_biz_order_file`

现网图片在 `biz_lgct_attachment`。一行是一个文件，挂在需求单上，并用反馈记录对上当时的状态。新订单不写那张表。

不另建节点照片表。进度节点一行只有一个时间，放不下多张图。文件单独成表，短驳图片写明订单、短驳段、派车和节点。以后运单扫描件也可以放这里，那时短驳段和节点为空。

| 字段 | 说明 |
| --- | --- |
| `id` | 主键 |
| `order_id` | 订单 |
| `file_kind` | `photo` 短驳照片，`goods_list` 品名清单。以后运单扫描件再用别的种类 |
| `leg_id` | 短驳段。品名清单为空 |
| `dispatch_id` | 哪一条派车。品名清单为空 |
| `node` | 照片节点。品名清单为空 |
| `file_url` | 文件地址 |
| `create_by` / `create_time` | 谁在何时上传 |

删除文件时删掉这一行，并在操作记录里写下删除。节点是否必填不写死在表里。

### 9.3 车辆

不新建车辆表。沿用 `biz_vehicle`，增加 `company_id`，对应车队公司 `qh_biz_company.id`。车号、车辆类型、头车或挂车、吨位、轴数、默认司机、车辆状态仍用原字段。

同一车队内车号不重复。新派车按 `company_id` 取车，不使用 `biz_user_vehicle`。没有公司的旧车辆数据留在原表，不参与新派车。
