# PRD · 价格管理（模块 6）

## 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：** 每票手填客户价。价格留在发到站上，下一票还能用。

价值陈述：销售价看发到站。车队报价只在没有这一档销售价时，才同时充当客户价。

## 7. Solution

### 7.1 一条发到站

列表按发站、到站展示。点一条进入编辑。同一对发站、到站不能再建第二条。

新增和编辑是同一页：

1. 选择发站、到站。两个都要选。
2. 填写铁路费用。至少一行，每行是箱型和单价。同一条里箱型不重复。
3. 发端、到端各有一个开关，默认关。打开后展开这一段的表。

铁路里的箱型是短驳表的行。短驳里不能另加箱型。在铁路里新增一个箱型，已打开的发端、到端各加一行空格子。删掉一个箱型，这两段里这个箱型的格子一起删掉。

发端、到端的里程各自添加，互不共用。加一个里程，这一段每个箱型加一列空格子。箱型列固定，里程多了横向滚动。格子里填单价，允许空着。空着就是这个箱型、这个里程没有销售价。

发端打开后可以先不填里程就保存。这一段这时还没有可用的销售价。关掉开关后，已填的里程和单价留在表里，确认页不再使用。再打开时还在。

单价是一箱的价格。乘预估箱数在订单确认时做，不写在这张表上。

```text
发站  南沙港          到站  大朗

铁路费用
箱型      单价
20尺      1200
40尺      2100

发端  [开]
里程      10公里    30公里
20尺       400       600
40尺       500

到端  [关]
```

上例里，40 尺、30 公里的发端没有销售价。

### 7.2 用在订单上

只用于集装箱，而且订单上已经有箱型。整车不查这张表。集装箱还没箱型、只填了件数、体积、重量时，也不查。

确认页用这一票的发站、到站找到这一条。找不到，就没有销售价。

公司配置里这一段的开关要是开的，才使用这里的价格。开关见 [公司业务配置](./PRD-公司业务配置.md)。

- 铁路：按箱型取单价，乘预估箱数，写入铁路客户价。这个箱型没有单价时，业务员在这一票手填铁路客户价。铁路这一期不另记成本。
- 发端、到端：这一票的运输类型用到这一段，并且这里的开关是开的，里程从这一段已有的里程档里选。选中的里程和箱型能取到单价时，单价乘预估箱数就是这一段客户价，车队报价或手填的车队价记为成本。格子空着、开关关着、或公司没开这一段，这一段没有销售价，车队价就是客户价。

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

已经写到订单上的客户价和成本，不随这里的修改、删除改变。

删除一条发到站时，铁路、里程和格子一起删。订单上已经写下的数不动。

### 7.3 流程

```mermaid
flowchart TD
  A[选择发站和到站] --> B[填写铁路箱型和单价]
  B --> C{打开某一段短驳}
  C -->|打开| D[行使用铁路里的箱型]
  D --> E[为这一段添加里程]
  E --> F[格子填单价 空着表示没有销售价]
  C -->|保持关闭| G[确认页不使用这一段]
  F --> H[保存这一对站]
  G --> H
```

## 7.4 假设

- 订单箱型、报价里程和这里的箱型、里程，要是同一个值才算匹配。价格管理有 30 公里、报价没有 30 公里时，这一段没有对应成本，由业务员手填。
- 某家需求公司不用这套价时，关掉公司配置里对应的段，不在这里按公司再维护一份。

## 8. Release

**这一期要有的**

- 一对发站、到站一条销售价。
- 铁路按箱型填单价，至少一行才能保存。
- 发端、到端可开关。打开后按箱型和里程填单价，格子可空。
- 短驳的箱型只来自铁路已填的箱型。
- 确认集装箱订单时，按公司配置取用。单价乘预估箱数后写入这一票。
- 已写入订单的价格不回写、也不被后来的修改覆盖。

**这一期不做**

- 整车，以及按重量计价。
- 只对一个站、不落到发到站的价格。
- 按需求公司各存一套销售价。
- 按门到门等四种运输类型各存一套价。
- 铁路成本。
- 价格的历史版本。改单价直接改当前格子。
- 竞价的发布和中标。中标价如何写入成本，等竞价模块。

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

新表以 `qh_biz` 开头。不挂需求公司，不挂车队。不改报价那几张表。

### 9.1 发到站 `qh_biz_price`

一行是一对发站、到站。

| 字段 | 说明 |
| --- | --- |
| `id` | 主键 |
| `depart_station` | 发站 |
| `arrive_station` | 到站 |
| `origin_open` | 发端开关。0 关，1 开。新建默认 0 |
| `dest_open` | 到端开关。0 关，1 开。新建默认 0 |
| `create_by` / `create_time` | 谁在何时新建 |
| `update_by` / `update_time` | 谁最后改的 |

同一发站、同一到站只有一行。

### 9.2 铁路单价 `qh_biz_price_rail`

| 字段 | 说明 |
| --- | --- |
| `id` | 主键 |
| `price_id` | 哪一对发到站 |
| `box_type` | 箱型 |
| `unit_price` | 单箱铁路销售价 |

同一条发到站里，同一箱型只有一行。保存时至少要有一行。

### 9.3 短驳里程 `qh_biz_price_mileage`

发端、到端的里程档。开关关掉后这些行仍保留。

| 字段 | 说明 |
| --- | --- |
| `id` | 主键 |
| `price_id` | 哪一对发到站 |
| `leg` | `origin` 发端，`dest` 到端 |
| `kilometers` | 里程，单位公里 |

同一条发到站、同一段、同一里程只有一行。

### 9.4 短驳单价 `qh_biz_price_fee`

一个里程、一个箱型有价时才有一行。格子空着就是没有这一行。

| 字段 | 说明 |
| --- | --- |
| `id` | 主键 |
| `mileage_id` | 哪一个里程 |
| `box_type` | 箱型，必须是这条发到站的铁路里已有的箱型 |
| `unit_price` | 单箱短驳销售价 |

同一里程、同一箱型只有一行。

删除发到站时，删掉它的铁路行、里程行和单价行。删除一个箱型时，删掉铁路上这一行，以及这两段里这个箱型的单价行。删除一个里程时，删掉这个里程和它下面的单价行。
