# 订单数据流程

说明一票订单从创建到完成，数据写进哪张表。导入以后只是帮着填这些数，这一期的流程不靠它。

## 表各自存什么

| 表 | 存什么 | 一票有几行 |
| --- | --- | --- |
| `qh_biz_order` | 公司、运输类型、品名、预估箱数或车数、预估重量、空箱预定号、运费、地址 | 1 |
| `qh_biz_order_box` | 集装箱的箱号、需求号、运单号、这一箱的发车和到站时间 | 一箱一行。整车没有 |
| `qh_biz_order_batch` | 整车的一个预约号：车数、重量、这一批的发车和到站时间 | 一批一行。集装箱没有 |
| `qh_biz_order_leg` | 发端或到端的车队、运费、这段状态 | 有短驳才有，一端 1 行 |
| `qh_biz_order_dispatch` | 司机、汽车。集装箱再指向一行箱子 | 集装箱一箱一行，整车一端可多行 |
| `qh_biz_order_node` | 主流程和短驳状态到达的时间 | 一个节点 1 行 |
| `qh_biz_order_log` | 谁在何时做了什么，只追加 | 一次操作 1 行 |
| `qh_biz_order_file` | 短驳照片、品名清单 | 一张文件 1 行 |

箱号只在箱子上。调度已有空箱、司机提空箱、业务员直接改，写的都是这一行。派车只记下司机拉的是哪一行箱子。

## 流程

```mermaid
flowchart TD
  A[创建订单] --> B[订单一行]
  B --> C{集装箱且箱数已定}
  C -->|是| D[按箱数生成箱子]
  C -->|否| E[先不生成箱子]
  D --> F[业务员确认]
  E --> F
  F --> G[有短驳则写发端或到端]
  G --> H{要客户确认价格吗}
  H -->|集装箱且要| I[业务员确认]
  I -->|客户同意| J[待提报]
  I -->|客户驳回| K[客户驳回]
  H -->|关掉或整车| J
  J --> L{运单类型}
  L -->|集装箱| M[箱子上填箱号 需求号 运单号 发车 到站]
  M --> N[订单状态取最慢的一箱]
  L -->|整车| O[按预约号加一批]
  O --> P[这一批写车数 重量 发车 到站]
  P --> Q[订单状态取最慢的一批 车数重量跨批相加]
  G --> R[派车]
  R --> S{集装箱}
  S -->|是| T[派车指向一行箱子 箱号写入箱子]
  S -->|整车| U[只记汽车和司机 行数不是车数]
```

铁路进度和短驳并行。短驳没完成，订单仍可往待起票、待发火车、火车运输中、火车到站走。

## 每一步写哪里

**创建。** 新增订单。公司名称用下单当时的名称。集装箱箱数已定，就生成同样行数的空箱子。整车不生成箱子。状态为提交需求。

**业务员确认。** 车站写入订单。铁路客户价写入订单。集装箱能匹配价格管理时，带出销售价并乘预估箱数；匹配不上就手填。有发端或到端，各新增一行短驳，写上客户价和成本。有销售价时，报价只写入成本。空箱预定号有就写入订单，只留档。系统车队这段是待安排，第三方这段是进行中。需要客户确认价格的集装箱，客户价齐了之后订单状态改为业务员确认；否则改为待提报。整车不查价格管理。

**填写进度。** 集装箱在箱子上写。没有箱号，需求号和运单号存不进去。订单状态取最慢的一箱。整车由业务员按预约号加一行，写上这一批的车数、重量、发车时间、到站时间。分两天发就加两行，两行都算进这一票。订单状态取最慢的一批。列表上的实际车数和实际重量是各批相加，预估数不动。

**派车。** 新增派车，写上订单、短驳段、司机、车辆。集装箱再写上箱子。这段改为进行中。整车加汽车就加一行，行数不拿来算车数。

**照片。** 集装箱的照片写入订单文件，挂上短驳段、派车和节点。发端节点是提空箱、装货、回到发站、卸箱。到端节点是提重箱、空箱、空箱回到车站。两套节点都不是必填，也不按顺序解锁。整车这一期不上传司机照片。品名清单也写在这张表，不挂短驳。

**完成短驳。** 集装箱可由司机、调度或业务员完成这一端。整车由车队或业务员点一次完成本端。第三方没有派车，业务员点完成时弹出这一端的上传，可以不传。发端和到端各点一次。短驳完成不把订单改成完成。

**删除和还原。** 订单标成已删除。箱子、短驳、派车、文件都留着。操作记录追加删除，备注必填。还原再追加一条。

## 演示

下面两票都是门到门。数字只用来把表的走向走通。

### 集装箱：两个 20 尺

南沙木业提交一票。集装箱，20 尺，箱数 2，门到门，品名木材。系统生成订单，并生成箱子 1、箱子 2，箱号都空着。状态是提交需求。

业务员确认时写下发站南沙港、到站大朗、铁路运费，发端和到端各指定一家车队。空箱预定号 `KX001` 写在订单上，后面的匹配不用它。客户确认价格后，订单进入待提报。两行箱子都还没有需求号。

发端调度先派箱子 1，车上已有空箱，箱号写成 `TBJU0000001`，指定司机甲。再派箱子 2，当时还没有箱号，指定司机乙。两行派车分别指向箱子 1、箱子 2。发端变为进行中。

司机乙提空箱时，把箱子 2 的箱号写成 `TBJU0000002`。

业务员给两行都填上需求号。两行都有需求号、还没有运单号，订单变为待起票。两个箱子在同一个火车号上，业务员再给两行写上同一个运单号。两行都有运单号、还没有发车时间，订单变为待发火车。

发端司机上传提空箱、装货、回到发站、卸箱的照片。这些节点可以缺，也可以后补。调度确认后，发端已完成。主流程仍是待发火车。

业务员给两行箱子写上同一个发车时间。订单变为火车运输中。到端不必等这一步，火车还没到就可以派车。到端司机上传的是另一套：提重箱、空箱、空箱回到车站。上传完，到端已完成。

两行箱子都写上到站时间。订单变为火车到站。业务员点完成，订单完成。

这一票里，40 尺、45 尺、50 尺会简单一些：一行箱子对一条运单，不会出现两个箱号共用一个运单号。

### 整车：预估 30 车

同一家公司另提交一票。整车，预估 30 车，预估重量 6000 公斤，门到门。不生成箱子，也不生成预约批次。

业务员确认时写下发站、到站、铁路运费、发端和到端车队。整车不经过客户确认价格，订单直接待提报。

第一天发不完。业务员加两行预约批次：`YY001` 写 18 车、3500 公斤，发车是第一天；`YY002` 写 10 车、2300 公斤，发车是第二天。两行都算这一票，实际车数是 28，实际重量是 5800 公斤。预估的 30 车和 6000 公斤仍留在订单上。两行都还没有发车时间时，订单是待发火车。

发端派了 10 辆汽车。这 10 行派车不指向预约批次，也不等于 28 个火车车。车队点完成，发端已完成。没有司机上传。

`YY001` 写上第一天的发车时间后，订单仍看 `YY002`。`YY002` 还没发车，订单保持待发火车。两批都写上发车时间，订单变为火车运输中。到端另派汽车，车队点完成。两批都写上到站时间后，订单变为火车到站。业务员点完成，订单完成。
