# PRD · 报价管理（模块 5）

## 1. Summary

业务员按站点、箱型向车队要短驳运费。一个站点加一个箱型只有一张报价。各家车队的运费都写在这张表上。截止时间写在每家邀请上。某一家再报一次，只改这家的截止时间，并在它提交后再加一行运费。其它公司的报价还在。

客户向我们询价不在本模块。本模块是我们让车队报价。报价是成本。集装箱的客户价在 [价格管理](./PRD-价格管理.md)。没有那一档销售价时，这份报价才同时作为客户价。

## 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：** 每票手填。报价留在车队和站点上，下一票还能用。

价值陈述：看全家报价，看的是这一张表上每家的最新价。一家公司的旧价留在它自己的运费行里，不另建历史表。

## 7. Solution

### 7.1 一张报价

业务员第一次为某个站点、某个箱型报价时新建一张。整车不填箱型，按站点单独成一张，不和 20 尺、40 尺混在一起。

填写：

- 站点、箱型。
- 一个或多个里程。每个里程的限价可空。
- 邀请全部当时已确认的车队，或指定一家、多家。
- 截止时间。必填。同一批邀请的车队写成同一个截止时间，记在每家邀请上，不记在报价主表上。

同一站点、同一箱型已经有一张时，不能再新建一张。之后都在这张上改，或让车队再报一次。之后新确认的车队不会自动出现，要再邀请。

### 7.2 车队报价

在自己的截止时间前，被邀请的车队看到这张报价的里程。

限价有数的里程，页面显示限价，填写的运费必须低于限价。限价为空的里程，页面不出现限价，运费没有上限。

每个里程填一个运费，一次提交。这一次的各行使用这家自己的下一个轮次。车队只看到自己的报价。过了自己的截止时间后不能再提交，也不能改。

提交后，业务员打开这个站点、箱型，这一家和其它已经报过价的公司排在一起。

### 7.3 业务员修改

业务员可以改里程、限价，也可以改某一家邀请上的截止时间，以及这家当前显示的运费。

改运费是改这一家、这个里程轮次最大的那一行，不新加一行。要留下改之前的价格，让这家再报一次。

### 7.4 再次报价

再次报价不新建站点、箱型。还是原来那一张。业务员写下新的截止时间，写到允许再报的那些邀请上。车队提交后，运费表为这家、每个里程新增一行。轮次是这家在这张报价上的下一次，不是整张表的轮次。

- 整个站点：这个站点下每一张报价（含整车那一张，如果有）里，每家邀请的截止时间都改成新的。当时已确认、还没邀请的车队，补一行邀请。
- 特定车队：只改指定那一张上这一家的截止时间。其它公司的截止时间不动，不能在这次提交。

其它公司没有新行，页面仍显示它们上次的运费。所以这一张上始终能看到所有已报价公司。

点开某一家，按它自己的轮次看到每一次运费。轮次小的是旧的。这就是历史，不另建表。

这一家还没提交这一次时，确认页和这张报价的总览都用它上一次的运费。提交后改用新的一行。

### 7.5 删除

删除拿掉的是报价上的现价和这家的旧价，不是只删最新一轮。只删最新一轮，上一次的价格会重新显示出来。

已经写入订单的运费不动。

- 删某一家：从当前这张报价去掉这家的邀请和它的全部运费行。其它公司、里程、限价都还在。这家没有邀请，就不能再报。要这家在这个站点的每个箱型都消失，就对每一张报价各删一次。
- 删整个站点：这个站点下每一张报价都删掉，整车那张也算。里程、限价、邀请和运费一起删。站点本身还在。

业务员改某一家当前显示的数字，不算删除。

### 7.6 用在订单上

协议车队的那一端，发端取发站，到端取到站。箱型用这一票的箱型，整车用空箱型那一张。报价上的金额是这一档的单价。

选择框列出这家车队在该站点、该箱型下每个里程的最新单价，显示站点、箱型、里程、金额。选择框可以改成直接输入。输入的单价只写在这一票上，不写回报价。没有可选项时就直接输入。

集装箱：公司这一端打开了价格管理，并且这一对发到站、这一箱型、这一里程有销售价时，报价乘以预估箱数后写入成本，客户价用价格管理。没有这档销售价，或公司没开这一段时，报价乘以预估箱数后同时作为客户价和成本。已经按价格管理选定里程时，成本只取这一里程。

整车不进价格管理。选中的报价或手输金额直接写入这一端，同时作为客户价和成本，不按箱数相乘。

这家车队还没有任何报价时，公司配置页已经有提示和「新建报价」。不新建也能保存车队。

### 7.7 流程

```mermaid
flowchart TD
  A[业务员为站点加箱型新建一张报价] --> B[里程和限价写在报价上]
  B --> C[每家邀请写上截止时间]
  C --> D[车队在自己的截止时间前报价]
  D --> E{限价有没有填}
  E -->|有| F[页面显示限价 运费必须更低]
  E -->|空| G[页面不显示限价]
  F --> H[这家每个里程新增一行 轮次是这家的下一次]
  G --> H
  H --> I[总览仍列出所有公司的最新运费]
  I --> J{业务员}
  J -->|改里程限价或当前运费| K[直接改这一张或最新一行]
  J -->|让一家再报| L[只改这家邀请的截止时间]
  J -->|整个站点再报| M[这个站点每张报价的每家邀请都改截止时间]
  J -->|删一家| N[删掉这家邀请和全部运费行]
  J -->|删整个站点| O[删掉该站点下每一张报价]
  L --> D
  M --> D
```

## 8. Release

**这一期要有的**

- 一个站点、一个箱型一张报价。整车不填箱型。主表不写轮次和截止时间。
- 总览同时显示各公司的最新运费。
- 里程限价可空。为空时车队看不到限价。
- 截止时间在每家邀请上。过了自己的截止时间，这家不能再报。
- 业务员可改报价，也可让整个站点或一家车队再报一次。
- 可删除某一家，或删除整个站点。已写入订单的运费不改。
- 确认页取这家车队的最新单价，也可以手输且不回写。集装箱有销售价时只记成本，没有销售价时同时作为客户价。

**这一期不做**

- 客户询价。
- 竞价的发布、压价和中标。现网竞价表不改。
- 车队自己改已提交的运费，以及改价审核。
- 为再次报价另建一张报价，或另建一张历史表。
- 业务员修改最新运费时再存一份改前内容。
- 只删最新一轮、让上一次价格重新显示。

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

新表以 `qh_biz` 开头。不改现网 `biz_lgct_ib`、`biz_lgct_ib_detail`、`biz_lgct_ib_bidding_record`。报价挂车队公司，不挂登录人。

同一个站点、同一个箱型只有一张报价。截止时间在邀请上。轮次在车队运费上，表示这家的第几次。总览取每家每个里程轮次最大的一行。

### 9.1 报价 `qh_biz_quote`

一行是一个站点加一个箱型。

| 字段 | 说明 |
| --- | --- |
| `id` | 主键 |
| `station` | 站点 |
| `box_type` | 箱型。整车为空。空值单独成一张 |
| `create_by` / `create_time` | 谁在何时建的这张报价 |
| `update_by` / `update_time` | 谁最后改了里程或限价 |

同一站点、同一箱型只有一行。不写截止时间，不写轮次。

### 9.2 里程 `qh_biz_quote_mileage`

| 字段 | 说明 |
| --- | --- |
| `id` | 主键 |
| `quote_id` | 哪一张报价 |
| `kilometers` | 里程 |
| `max_fee` | 限价。空表示没有上限，车队页面不显示限价 |

同一张报价里，同一里程只有一行。

### 9.3 邀请车队 `qh_biz_quote_invite`

一行是这家车队在这张报价上的邀请。截止时间写在这里。

| 字段 | 说明 |
| --- | --- |
| `id` | 主键 |
| `quote_id` | 哪一张报价 |
| `fleet_company_id` | 车队公司 |
| `deadline` | 这家可以提交的截止时间 |
| `update_by` / `update_time` | 谁最后改了这家的截止时间 |

同一张报价、同一家车队只有一行。第一次邀请全部车队时，按当时已确认的车队各插入一行，截止时间相同。再次报价给一家，只改这一行的截止时间。删除这家时，删掉这一行。

### 9.4 车队运费 `qh_biz_quote_fee`

一家、一个里程、一次提交是一行。再报一次就再插入一行，不覆盖旧行。

| 字段 | 说明 |
| --- | --- |
| `id` | 主键 |
| `quote_id` | 哪一张报价 |
| `mileage_id` | 哪一个里程 |
| `fleet_company_id` | 哪一家车队 |
| `round_no` | 这家在这张报价上的第几次。从 1 起，每次提交加 1。同一家同一次提交的各里程使用同一个轮次 |
| `fee` | 运费 |
| `create_by` / `create_time` | 谁在何时提交 |
| `update_by` / `update_time` | 业务员修正这家最新一行时写下 |

总览和订单确认用的最新运费，是这家、这个里程下 `round_no` 最大的那一行。业务员改当前运费，改的就是这一行。

打开某一家时，按 `round_no` 列出它的每一行。删除这家时，这些行和邀请一起删掉。其它公司没有这次的新行，总览仍显示它们各自最大轮次的运费。

删除整个站点时，按 `station` 删掉报价，并删掉这些报价下的里程、邀请和运费。
