# PRD · 竞价（模块 7）

## 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 何时发布

业务员确认这一票时，竞价的那一端不选车队。弹出这场要填写的内容。

关掉不发布也可以。这一端车队和成本先空着。订单仍按 [订单主流程](./PRD-订单主流程.md) 走：有销售价就能继续，没有销售价就停在提交需求。之后从这一票仍可再发布。

发布前，这一端的站点和地址要已经有。发端用发站和装货地址。到端用到站和卸货地址。

同一票、同一端同时只有一场未结束的竞价。未结束包括进行中，以及已截止但还没中标、也没作废。

### 7.2 发布时填写

页面先带出车队要看的内容：

- 发端：装货地址、发站。到端：到站、卸货地址。
- 集装箱：有箱型时显示箱型和预估箱数。没有箱型时，显示订单上的重量、体积、件数。
- 整车：预估总重量、预估车数。不显示箱型。

业务员再填：

- 里程，单位公里，必填。这个数写在竞价上，也写在这一段短驳上。公司打开了这一段，并且 [价格管理](./PRD-价格管理.md) 有这个箱型和这个里程时，客户价用那一档。没有这一档时，页面标明这段没有销售价。车队自己按具体地址估价，这个里程是业务员给的参考。
- 最高限价，可空。空着时车队页面不显示限价。有数时，和车队填写的价同一个口径：集装箱是单箱价，整车是这一票的价。
- 截止时间，必填。可选 30 分钟、60 分钟，从点击发布起算，也可以指定一个时间。指定的时间要晚于发布当时。
- 谁能看。默认全部已确认、且类型包含车队的公司。改成指定时，至少选一家，可以多选。

发布后，里程、限价、截止时间、邀请范围不再改。要改就作废，再发一场。

自动按配置发布，这一期不做。

### 7.3 车队报价

进行中、还没到截止时间的场，被允许看到的车队可以填写。

邀请全部时，邀请表不插行。截止前新确认的车队也能看到。指定邀请时，只有被选中的公司能看到。

车队看到地址、站点、里程、货物。限价有数才显示，填写的价必须低于限价。限价为空时不显示，报价没有上限。报价必填，并且大于 0。

集装箱填单箱价。整车填这一票的价，不按车数拆开。

看不到其他车队的报价，也看不到客户价。一家一场只有一行。截止前可以改自己的价，改的是这一行。过了截止时间不能再填，也不能再改。

业务员在截止前可以打开这场，看到已经提交的报价。页面标明未截止。确定车队在截止之后。

### 7.4 截止和中标

过了截止时间，这场变为已截止。报价按价格从低到高排。价格相同的排在一起，由业务员选择，不自动分出先后。

业务员点一家确定车队。可以不选最低的那一家。

没有报价时不能中标。可以作废后再发一场，也可以把这一端改成手填车队，或改成第三方、只填名称。

自动按最低价中标，这一期不做。

### 7.5 写入订单

中标后写入这一段短驳，规则与协议报价写入订单相同，金额来自这场的中标价。

- 车队写成系统车队。名称用中标当时的公司名。这一段变为待安排，之后可以派车，不等待提报，也不等火车到站。见 [短驳执行](./PRD-短驳执行.md)。
- 集装箱：成本等于中标单价乘当时的预估箱数。之后改箱数，不改已经写入的成本。
- 整车：中标价直接写入这一段，不乘车数。
- 这一段已有销售价，或业务员已经手改过客户价时，客户价不动。中标价只记成本。
- 没有销售价、客户价也还没手改时，客户价写成和成本同一个数。集装箱同时记下单箱价。
- 客户仍只看到各段客户价的合计，能看到车队名称，看不到成本。

中标补上金额之后，订单状态按 [订单主流程](./PRD-订单主流程.md) 再判一次。要客户确认的集装箱，客户价这时齐了，并且订单还在提交需求，就进入业务员确认。已经进入业务员确认或更后面的，状态不退回，也不再请客户确认一次。

### 7.6 作废、再发、撤销

进行中或已截止、还没中标的场，业务员可以作废。报价行留着，状态改为已作废，不写入订单。作废后才能再发一场。再发是新的一行，上一场留着。

还没中标时，可以把这一端改成手填或第三方。进行中或已截止未中标的场同时作废。

中标后、这一段还没有派车时，可以撤销中标。这场回到已截止，报价还在，可以改点另一家，也可以再作废。撤销时清掉这场写上的车队和成本。客户价来自这场时一并清掉。来自价格管理，或业务员手改过的客户价，留在这一段上。

撤销后客户价不再齐，并且订单还停在业务员确认，订单回到提交需求。待提报及之后不退状态。客户价如果被清掉，合计按剩下的各段重算。

这一段已经有派车时，不能撤销中标。

### 7.7 流程

```mermaid
flowchart TD
  A[确认页打开竞价的这一端] --> B[带出地址 站点和货物]
  B --> C{业务员发布吗}
  C -->|先不发| D[车队和成本先空着 订单按主流程走]
  C -->|发布| E[写一场竞价 里程写入短驳]
  E --> F{这个里程有销售价吗}
  F -->|有| G[客户价用价格管理 成本先空着]
  F -->|没有| H[客户价等中标或手填]
  E --> I[车队在截止前填写或修改自己的价]
  I --> J[截止后按价格从低到高排]
  J --> K{业务员}
  K -->|点一家中标| L[系统车队写入短驳]
  K -->|作废或没人报价| M[作废后可再发 或改成手填或第三方]
  L --> N{客户价已经有了吗}
  N -->|有| O[中标价只记成本]
  N -->|没有| P[中标价同时写入客户价]
```

## 8. Release

**这一期要有的**

- 配置为竞价的发端、到端，确认时可以发布一场。先不发也能离开，之后从这一票再发。
- 一场只属于这一票的一端。地址和站点发布时抄下。里程由业务员填写，并写入短驳。
- 限价可空。为空时车队看不到限价。
- 截止时间可选 30 分钟、60 分钟或指定时间。
- 默认全部已确认车队可看。也可以指定多家。邀请全部时不写邀请行。
- 截止前车队可修改自己的报价。看不到其他车队的价。
- 截止后按价格从低到高排，业务员点一家中标。
- 有销售价时中标价只记成本。没有销售价时同时作为客户价。
- 未中标可作废再发。未派车可撤销中标。已派车不能撤销。

**这一期不做**

- 按配置自动发布，或截止后自动给最低价。
- 发布后再改里程、限价、截止时间、邀请范围。
- 业务员改车队已经提交的价。
- 和报价管理共用表。报价四张表不加字段。
- 改现网 `biz_lgct_ib`、`biz_lgct_ib_detail`、`biz_lgct_ib_bidding_record`。
- 铁路竞价，以及整车使用价格管理。
- 按地址自动计算里程。
- 客户查看各家报价。

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

新表以 `qh_biz` 开头。不改报价的 `qh_biz_quote`、`qh_biz_quote_mileage`、`qh_biz_quote_invite`、`qh_biz_quote_fee`。不改现网竞价表。

一场竞价的里程、限价、截止时间、邀请范围、状态都在主表上。竞价没有里程子表。

### 9.1 竞价 `qh_biz_bid`

一行是这一票的发端或到端的一场。

| 字段 | 说明 |
| --- | --- |
| `id` | 主键 |
| `order_id` | 订单 |
| `leg` | `origin` 发端，`dest` 到端 |
| `station` | 站点抄件。发端是发站，到端是到站 |
| `address` | 地址抄件。发端是装货地址，到端是卸货地址 |
| `kilometers` | 业务员填的里程，单位公里。同时写入这一段短驳 |
| `max_fee` | 限价。空表示没有上限，车队页面不显示。集装箱是单箱价，整车是这一票的价 |
| `deadline` | 截止时间 |
| `invite_scope` | `all` 全部已确认车队，`named` 指定邀请 |
| `status` | `open` 进行中，`closed` 已截止，`awarded` 已中标，`cancelled` 已作废 |
| `winner_fleet_company_id` | 中标车队。未中标时为空 |
| `create_by` / `create_time` | 谁在何时发布 |
| `update_by` / `update_time` | 谁最后改了状态 |

同一订单、同一端，`status` 为进行中的只有一场。已截止且未中标、未作废的也只有一场。再发一场时，上一场必须已经是已作废，或中标后又撤销回已截止再作废。

箱型、重量、箱数、车数不在这张表。展示和中标相乘时读订单。

### 9.2 邀请车队 `qh_biz_bid_invite`

只有指定邀请时才有行。邀请全部时，这张表没有这场的行。

| 字段 | 说明 |
| --- | --- |
| `id` | 主键 |
| `bid_id` | 哪一场 |
| `fleet_company_id` | 被指定的车队公司 |

同一场、同一家车队只有一行。不写截止时间。截止时间在主表上。

### 9.3 车队报价 `qh_biz_bid_offer`

一家在一场里的当前报价。截止前修改就改这一行，不另加行。

| 字段 | 说明 |
| --- | --- |
| `id` | 主键 |
| `bid_id` | 哪一场 |
| `fleet_company_id` | 哪一家车队 |
| `fee` | 当前报价。集装箱是单箱价，整车是这一票的价 |
| `create_by` / `create_time` | 谁在何时第一次提交 |
| `update_by` / `update_time` | 谁在何时最后改了这个价 |

同一场、同一家车队只有一行。中标价取这一行的 `fee`，再按 [7.5](#75-写入订单) 写入短驳。作废或撤销中标都不删这些行。
