# PRD · 订单主流程（模块 3）

## 1. Summary

把一票物流需求从创建走到完成，收成一条主流程。业务员驳回和客户驳回只出现在订单状态上，不放进流程节点。有短驳时，订单同时显示出主流程状态和短驳状态。

客户自己创建时，公司已定好且不能改。业务员创建时要先选公司。集装箱确认时，公司开了价格开关并且价格管理有这一档，客户价用销售价，报价记为成本。没有这一档时，报价同时作为客户价。

## 2. Contacts

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

## 3. Background

创建页和业务员确认页已经有一版字段说明。创建页当时只有客户本人使用，没有公司选择。确认页把短驳运费当成必填，集装箱确认后一律等客户点价。

公司模块已经能代建没有登录账号的需求公司。公司配置把发端、到端分开，协议车队只指定车队。报价是成本，销售价在价格管理。一次性车队只在订单上填名称，不建公司。

现网用一个待办用户字段决定这票出现在谁的列表里，并用司机的每一步卡住后面的状态。新流程里同一票会同时有客户、业务员和短驳，司机操作也不再是往下走的条件。

## 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：** 在表格里另记一套进度。选这条主流程，是因为订单状态和短驳状态分得开，又出现在同一行。

价值陈述：一票订单沿主流程推进；短驳旁边跟着走。交给客户的价格只有各段客户价的合计。

## 7. Solution

### 7.1 状态

订单状态和流程位置分开记。平常两者相同。驳回时只改订单状态，流程位置停在驳回发生的那个节点上。

流程位置按这个顺序：

提交需求 → 业务员确认 → 待提报 → 待起票 → 待发火车 → 火车运输中 → 火车到站 → 完成

订单状态在这八个之外，还可以是「业务员驳回」「客户驳回」。这两个只显示在订单状态上，流程里不单列一步。

| 订单状态 | 怎么来的 |
| --- | --- |
| 提交需求 | 客户或业务员提交 |
| 业务员驳回 | 业务员驳回。流程位置不动 |
| 业务员确认 | 业务员已确认，且这票还要等客户点价格 |
| 客户驳回 | 客户驳回。流程位置停在业务员确认 |
| 待提报 | 不需要客户点价，或客户已经同意。集装箱里还有箱子没写需求号。整车还有一批没写上车数 |
| 待起票 | 集装箱每一箱都有需求号，还有箱子没写运单号。整车不单走这一档，车数写上就表示这批已经起票 |
| 待发火车 | 集装箱每一箱都有运单号，还有箱子没写发车时间。整车每一批都有车数，还有一批没写发车时间 |
| 火车运输中 | 集装箱每一箱都有发车时间，还有箱子没写到站时间。整车每一批都有发车时间，还有一批没写到站时间 |
| 火车到站 | 集装箱每一箱都有到站时间，或整车每一批都有到站时间。业务员还没点完成 |
| 完成 | 业务员标记完成 |

集装箱的订单状态取最慢的那一箱。整车取最慢的那一批预约。页面同时写出各箱或各批走到哪一档。

箱号、需求号、运单号、发车时间、到站时间写在箱子上。没有箱号，不能填需求号和运单号。两个 20 尺放在同一个火车号上时，两行箱子写同一个需求号和运单号。

整车按预约号加行，一行是一批。这一批记下预约号、车数、重量、发车时间、到站时间。同一票分两天发，就有两行，两行的车数和重量都加进这一票。预估车数和预估重量仍留在订单上。

到站不会自动变成完成。完成后保持完成，再改这些值不会把状态退回去。

业务员只能在「提交需求」上驳回。订单状态变为「业务员驳回」，流程位置停在提交需求。客户只能在「业务员确认」上驳回。订单状态变为「客户驳回」，流程位置停在业务员确认。客户驳回表示信息或价格不对。业务员改完后可以再次确认，订单状态回到「业务员确认」，客户再同意后进入待提报。

待提报以及之后没有驳回。这票不继续，就改数据，或者删除。

业务员可以删除订单。删除是逻辑删除，订单还在，列表里不显示。删除时备注必填，写入操作记录。还原后回到删除前的订单状态和流程位置，还原也写入操作记录。

短驳不进入上面这条线。有发端、有到端就各有一段，状态为：待安排、进行中、已完成。系统车队派车后进入进行中。第三方在业务员确认时就是进行中。业务员不把系统车队改成进行中，可以把短驳标成已完成。没有短驳的站到站不显示短驳状态。

列表上的订单状态，有短驳时把主流程和短驳写在一起。例如「待提报 · 发端进行中」。两端都有，就两段都显示。

进度按流程位置的固定顺序排。同一次保存写入的节点用同一个时间，已提过的节点不因为这次保存改时间。短驳节点画在各自的分支上，不插进主流程。驳回不产生流程节点。

待办不再使用现网那个待办用户字段。客户看自己公司还停在「业务员确认」或「客户驳回」的票。业务员看待确认、被驳回和待推进进度的票。车队和司机的待办到短驳模块再定，第三方车队不进待办。

### 7.2 创建

字段沿用已有创建页：集装箱或整车、品名、计划发车、门到站和站到门。整车也可以门到站、站到门、门到门。品名从这家公司的常用品名里选。混装时品名填「混装货物」，并可以上传品名清单。清单不是提交的必填项。没传时，创建页和业务员确认页都提醒，业务员可以代传。

数量是一个字段。集装箱填预估箱数，整车填预估车数。整车再填预估重量。集装箱不知道箱型时，改为填件数、体积、重量，不填箱型。这些都是预估，起票后不覆盖。

公司放在最上面。

- 客户创建：显示自己所属的需求公司，不能改。
- 业务员创建：必须选择一家已确认的需求公司。没有登录账号的公司也能选。

订单记下单时的公司名称。公司后来改名，不回写这一票。提交后订单状态为提交需求。

### 7.3 业务员确认

从「提交需求」进入。公司只读。客户已填的计划发车、车数、箱型默认只读，点编辑才改。

车站在这页填写。铁路客户价必填。集装箱在公司打开铁路价格开关、并且 [价格管理](./PRD-价格管理.md) 有这个箱型时，用那里的单价乘预估箱数带出。带不出，或是整车，由业务员填写。铁路这一期只记客户价，不另记成本。

发端、到端按公司配置处理。有这一端时，各记客户价和成本。集装箱的报价、手填车队价都按单箱计，写入时乘预估箱数。整车不乘箱数，也不查价格管理。

- 业务员确认：这一端选择系统内车队，或改成第三方并只填名称。名称可以后补。手填的是单箱成本。有销售价时它只记成本；没有销售价时，它同时是客户价。
- 协议车队：带出配置里的那一家。成本用选择报价填写，选择框同时可以输入这一票的单箱成本。报价按站点、箱型和里程取最新价，见 [报价管理](./PRD-报价管理.md)。这一票仍可以改成第三方，只填名称。
- 竞价车队：这页不选车队。竞价过程不在本模块做。有销售价时，中标前成本可以空着。没有销售价时，客户价等中标价或业务员手填。

集装箱要使用价格管理的那一段，里程从这一段已有的里程档里选，再按箱型取单价。公司没开这一段、价格管理没开这一段、或格子是空的，页面标明「这段没有销售价，客户价等于车队价」。已选定里程后，成本只取这一里程的报价，或手填这一票的单箱成本。不走价格管理时，选了报价就把报价上的里程记到这一端；只手填时里程可空。

确认页以后可以加快捷输入，例如这个客户用过的箱型、用过的报价。这一期先不放，等功能定下来再加。

业务员可以改这一票带出的客户价，不回写价格管理，也不回写报价。确认前改了预估箱数，还没手改过的客户价按新箱数重算。

客户要确认价格时，这一票用到的各段客户价都要先有数。有发端就含发端客户价，有到端就含到端客户价，铁路客户价始终包含。有销售价时，这一段成本可以先空着。没有销售价时，客户价就是车队价，车队价还没有就不算齐。缺了就留在提交需求。客户确认价格关掉时，到端客户价和到端成本可以先空着，待提报之后再补。整车沿用车队价同时作为客户价和成本，不查价格管理。

客户确认价格开着，且是集装箱：上述客户价齐了，提交后订单状态为「业务员确认」。关掉，或是整车：订单状态为待提报。

客户只看到一个价格，等于用到的各段客户价之和。没有的那一端不加。不把三段拆开给客户看，也不把成本给客户看。客户价可以和成本不同。车队名称可以显示，金额只显示合计。同意后进入待提报。第一期不因为后来改金额再请客户确认一次。客户再次打开时，看到的仍是当前各段客户价之和。

驳回要填写原因，并且只发生在待提报之前。业务员在提交需求上驳回，订单状态为「业务员驳回」。客户在业务员确认上驳回，订单状态为「客户驳回」。客户驳回后，业务员修改信息和价格，再次确认，状态回到「业务员确认」，由客户再次同意。

### 7.4 假设

- 报价是单箱成本。销售价按发到站、箱型、里程取，见价格管理。整车不使用这套销售价。
- 短驳三档是待安排、进行中、已完成。系统车队派车后进入进行中。第三方确认时就是进行中。司机上传和派车在短驳模块。
- 进入待提报之后再改客户价，客户看到的合计跟着变。第一期不再请客户重新确认。

## 7.5 设计稿与原型

字段与创建页布局沿用 [物流需求创建 PRD](../PRD-创建物流需求.md) 与 [创建页 Figma](https://www.figma.com/design/vgbQhiHpNfxj76eILfORby/物流需求列表?node-id=82-4377)。广珠差异见本 PRD 与下列稿。

- Figma 文件：[广珠-订单与公司配置](https://www.figma.com/design/waF0AXKFXvm6Ev9KgW0SjQ)
- [订单列表参考](https://www.figma.com/design/waF0AXKFXvm6Ev9KgW0SjQ?node-id=1-56)
- [业务员确认](https://www.figma.com/design/waF0AXKFXvm6Ev9KgW0SjQ?node-id=1-76)
- [客户确认](https://www.figma.com/design/waF0AXKFXvm6Ev9KgW0SjQ?node-id=1-102)
- [填写进度](https://www.figma.com/design/waF0AXKFXvm6Ev9KgW0SjQ?node-id=1-114)
- [主流程说明](https://www.figma.com/design/waF0AXKFXvm6Ev9KgW0SjQ?node-id=1-133)
- 可点参考：`docs/广珠PRD/ux/order-reference.html`

待提报之后，集装箱按箱子填写箱号、需求号、运单号和发车、到站时间。整车按预约批次填写车数、重量和发车、到站时间。

## 8. Release

**这一期要有的**

- 客户创建时公司锁定，业务员创建时选择公司。
- 上面这条主流程，以及两个只出现在订单状态上的驳回。
- 集装箱按最慢的一箱推进状态。箱号、需求号、运单号在箱子上。
- 整车按预约批次记车数、重量和发到站时间。同一票的多批都要相加。预估数保留。
- 混装品名写「混装货物」，品名清单可上传，不上传也能提交。
- 发端、到端的短驳状态与主流程同时显示。
- 协议车队在确认页选择报价，选择框可以输入这一票的单箱成本。
- 集装箱按公司的价格开关取销售价。有销售价时报价只记成本。没有销售价时，车队价就是客户价。
- 发端、到端在要取销售价时选择里程。
- 第三方车队只填名称。不需要客户确认的票，到端客户价和到端成本可以后补。
- 业务员逻辑删除和还原。删除必填备注，删除和还原都写入操作记录。
- 客户看到的价格只有各段客户价的合计。

**这一期不做**

- 竞价的发布、报价和中标。
- 整车使用价格管理，以及按重量计价。
- 确认页的快捷输入，例如客户历史箱型、历史报价。
- 待提报及之后的驳回。
- 到端客户价补上之后的第二次客户确认。
- 把分项运费展示给客户。
- 司机操作作为主流程的必经步骤。
- 短驳的派车页面。
- 新建 95306 运单表。继续用现网 `biz_train_bill`。

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

新表以 `qh_biz` 开头。不改现网需求表，也不把待办用户写进新订单。报价不在本模块建表。

### 9.1 订单 `qh_biz_order`

| 字段 | 说明 |
| --- | --- |
| `id` | 主键 |
| `order_no` | 订单号 |
| `company_id` | 需求公司 |
| `company_name` | 下单时的公司名称 |
| `order_status` | 订单状态。含业务员驳回、客户驳回 |
| `process_node` | 流程位置。驳回时不改成驳回 |
| `waybill_type` | 集装箱或整车 |
| `transport_type` | 运输类型，沿用一个字段。`1` 门到门，`2` 门到站，`3` 站到站，`4` 站到门。集装箱和整车都可用这四种。页面上的两个勾选只用来填这个字段 |
| `del_flag` | `0` 正常，`1` 已删除。删除不物理去掉这一行 |
| `goods_name` | 品名。混装填「混装货物」 |
| `quantity` | 预估数量。集装箱是箱数，整车是车数 |
| `weight` | 预估重量。整车填写。集装箱在不知道箱型时填写 |
| `volume` | 预估体积。集装箱不知道箱型时填写 |
| `piece_count` | 预估件数。集装箱不知道箱型时填写 |
| `box_category` / `box_category_detail` / `box_type` | 箱类、箱类明细、箱型。仅集装箱，且客户指定了箱型 |
| `plan_date` | 计划发车日期 |
| `load_name` / `load_contact` / `load_phone` / `load_address` | 装货方。门到站、门到门时填写 |
| `unload_name` / `unload_contact` / `unload_phone` / `unload_address` | 收货方。站到门、门到门时填写 |
| `depart_station` / `arrive_station` | 发站、到站。确认时写下 |
| `empty_box_reservation_no` | 空箱预定号。一批箱子一个，只留档 |
| `rail_unit_price` | 铁路单箱销售价。从价格管理带出时填写。手填客户价时为空 |
| `rail_freight` | 铁路客户价。集装箱是单箱价乘预估箱数，整车是业务员填写的金额 |
| `rail_source` | `price` 价格管理，`manual` 这一票手填 |
| `reject_reason` | 最近一次驳回原因。可空 |
| `create_by` / `create_time` | 谁在何时创建 |

箱数一旦确定，就生成同样行数的箱子。客户还不知道箱型、只填了体积和重量时，先不生成，等业务员补上箱数再生成。

订单状态从待提报往后按上文的表重算。完成和驳回不参与这套重算。品名清单放在订单文件里，文件种类为品名清单。

### 9.1.1 箱子 `qh_biz_order_box`

只用于集装箱。一行一个箱子，用来挂箱号、需求号、运单号，以及这一箱的司机。整车不建行。

| 字段 | 说明 |
| --- | --- |
| `id` | 主键 |
| `order_id` | 订单 |
| `sort_no` | 这一票里的顺序 |
| `box_no` | 箱号。调度、司机或业务员填写 |
| `demand_no` | 需求号。没有箱号不能填 |
| `waybill_no` | 运单号。没有箱号不能填 |
| `depart_at` / `arrive_at` | 这一箱的发车时间、到站时间 |
| `create_by` / `create_time` | 谁在何时生成这一行 |

两个 20 尺共用一个火车号时，两行的需求号、运单号相同，箱号各记各的。

### 9.1.2 预约批次 `qh_biz_order_batch`

只用于整车。一行是一个预约号，不是一个火车车。业务员添加，一天发不完就再加一行。

| 字段 | 说明 |
| --- | --- |
| `id` | 主键 |
| `order_id` | 订单 |
| `sort_no` | 这一票里的顺序 |
| `reservation_no` | 预约号。同一订单里不重复 |
| `quantity` | 这一批的实际车数 |
| `weight` | 这一批的实际重量 |
| `depart_at` / `arrive_at` | 这一批的发车时间、到站时间 |
| `create_by` / `create_time` | 谁在何时添加 |

这一票的实际车数、实际重量是各行相加，不另存一份。预估车数和预估重量仍在订单上。派车不指向这张表。

### 9.2 短驳 `qh_biz_order_leg`

一票最多两行：发端、到端。站到站没有行。

| 字段 | 说明 |
| --- | --- |
| `id` | 主键 |
| `order_id` | 订单 |
| `leg` | `origin` 发端，`dest` 到端 |
| `fleet_kind` | `system` 系统车队，`third_party` 第三方。可空，表示还没指定 |
| `fleet_company_id` | 系统车队。第三方时为空 |
| `fleet_name` | 车队名称。系统车队记下当时的名称，第三方记下所填名称 |
| `kilometers` | 里程，单位公里。取销售价时必填。只手填成本、又没选报价时可以空 |
| `sell_unit_price` | 单箱客户价。从价格管理带出、或用单箱车队价作为客户价时填写。整车和手改合计时为空 |
| `sell_freight` | 这一端客户价。集装箱按单箱价乘预估箱数。整车等于成本 |
| `cost_freight` | 这一端成本。可空。有销售价时可以后补 |
| `sell_source` | `price` 价格管理，`fleet` 车队价同时作为客户价，`manual` 这一票手改的客户价 |
| `leg_status` | `pending` 待安排，`doing` 进行中，`done` 已完成 |
| `update_by` / `update_time` | 谁在何时改的 |

同一订单、同一端只有一行。

### 9.3 进度节点 `qh_biz_order_node`

| 字段 | 说明 |
| --- | --- |
| `id` | 主键 |
| `order_id` | 订单 |
| `lane` | `main` 主流程，`origin` 发端，`dest` 到端 |
| `node` | 节点名，与流程位置或短驳状态一致 |
| `event_time` | 到达这个节点的时间 |
| `update_by` | 谁写入的 |

同一订单、同一条线、同一个节点只有一条。同一次保存新写入的节点使用同一个时间。展示时主流程按流程顺序排，不按时间早晚穿插。驳回、删除、还原不写节点。

这张表只记节点时间。短驳照片不挂在这里，一个节点会有多张图，删掉一张也不能把节点删掉。图片用短驳模块的订单文件表。

### 9.4 操作记录 `qh_biz_order_log`

现网把进度写在 `biz_lgct_feedback`。那张表跟着状态走，撤回、上传照片会记一笔。删除只把需求单的删除标记改成已删除，不写备注。还原只把标记改回来，也不留记录。

新订单不继续用那张表。进度节点只管流程上每个节点的时间。操作记录另建一张表，从客户提交开始追加，短驳上的操作、业务员改数据、完成、删除、还原都写在这里。只追加，不改已有记录。

| 字段 | 说明 |
| --- | --- |
| `id` | 主键 |
| `order_id` | 订单 |
| `action` | 做了什么。如提交、业务员驳回、业务员确认、客户驳回、客户同意、修改、填写进度、短驳更新、完成、删除、还原 |
| `leg` | 短驳操作时写 `origin` 或 `dest`。其他动作为空 |
| `remark` | 备注。删除时必填。驳回时写下驳回原因 |
| `create_by` / `create_time` | 谁在何时操作 |

删除不改变删除前的订单状态和流程位置，只把 `del_flag` 标成已删除。还原把 `del_flag` 改回正常，并追加一条还原记录。
