# 系统命名规则与用户术语规范

**千路产品**：分为 **询价管理系统**（询价、报价、回询、订货、采购、报价对比等）与 **出入库管理系统**（仓储实物流、核销等，**仍在开发中**）。**本文档仅覆盖询价管理系统**的术语与命名；出入库侧名词与界面以 WMS 相关文档为准，勿与本文混用。

本文档统一「询价管理系统」中的**业务术语**、**UI 用词**与**文件名规范**，避免各需求文档之间的歧义与冲突。开发与文档均以此为准。

**完整 Excel 表头、别名与列顺序**以同目录 **[REFERENCE.md](REFERENCE.md)** 为准；本节侧重**叫什么、文件怎么命名**，不重复罗列整张表。

*（本文件为 kam-qianlu-doc-standards SKILL 内冗余副本，便于独立打包后使用；与项目 `apps/inquiry-server/docs/naming-and-terminology.md` 宜保持同步。）*

---

## 1. 单据与业务实体（用户术语）

| 术语 | 含义 | 方向/场景 | 备注 |
|------|------|-----------|------|
| **询价单** | 我方向多家供应商发起的询价请求，包含待报价明细（品牌、零件号、数量）。对应数据：`rfq` + `rfq_item`。 | 我方建立，可 Excel 导入 | 无 PRICE 列，价格由报价单回填 |
| **问价单** | 从询价单按**问价单组**（品牌子集）拆出、发给**某一供货商**的 Excel **模板**；供应商填价后回传，再按**报价单**导入。 | 我方 → 下游供货商 | **≠ 询价单本身**；文件名多为组名或 `问价单-供货商名-日期.xlsx`。表头与报价单导入可识别列对齐，含 **MOQ、MPQ**，**无「状态」列**；第 1 行为说明（合并整行），第 2 行为表头。详见 REFERENCE §4。 |
| **报价单** | 某家**供应商**针对某张询价单的报价结果（Excel 导入）。对应数据：`quotation` + `quotation_item`。 | 供货商回传，我方导入 | 表头含品牌、零件号、替换号、中文名称、数量、报价含税、**MOQ、MPQ**、备注等（见 REFERENCE §3） |
| **回询单** | 我方根据**报价单**比价结果整理后、发给**上游客户**的报价清单；价格可修改，修改后保存到系统（回询单表），关联询价单。客户据此确认并制作订货单。一条条记录为「品牌 + 零件号 + 货物单价」等；**订货单无替换号**，订货单行与回询单行用「品牌 + 零件号 + 货物单价」匹配。 | 我方 → 上游客户（报价用） | 由「报价单入库后」在系统中生成，价格可编辑并落库；与询价单 N:1 |
| **订货单** | **国外/上游客户**给我方的正式订单（客户确认后发来的订货文件）。与询价单 N:1（多张订货单可对应同一询价单）；与回询单 N:N，关联约束在某一询价单下。 | 最上游 → 我方（中间商） | 文件名：`订货单-XXXX-日期.xlsx`；录入时必选询价单，行与回询单行匹配（品牌+零件号+单价），匹配不到则提示、订货单不对 |
| **采购单** | 我方根据订货单与报价结果，向**下游供货商**下达的订货需求（发给供应商的采购文件）。 | 我方（中间商）→ 下游供应商 | 文件名：`采购单-供货商名-单号.xlsx`；与「采购订单」同义，**统一用「采购单」**。系统内常区分：**采购单生成**（工作台草稿，可含 localStorage）与 **确认入库** 后的 **已确认采购**（`confirmed_purchase`，按 `order_id` 与订货单隔离） |

---

## 2. 字段与 UI 标签统一

### 2.1 报价单相关（导入/列表/详情）

| 数据/字段 | UI 展示名称（用户术语） | 说明 |
|-----------|-------------------------|------|
| `quotation_no` | **报价单名** | 整张报价单的标识，= 文件名去掉 .xlsx；**不得使用「零件号」作为该字段的标签**（易与明细列「零件号」混淆）。 |
| `brand_name` | **品牌名** | 该报价单所属品牌/供应商侧标识。 |
| 供应商 | **供应商** | 下拉选择，必选；对应 `supplier_id`。 |
| 报价日期 | **报价日期** | 对应 `quotation_date`。 |
| 关联询价单 | **关联询价单** | 报价单所属的询价单（rfq）。 |

### 2.2 明细列（Excel / 表格列名）

| 数据/列 | UI/表头名称 | 说明 |
|---------|-------------|------|
| `part_number` | **零件号** | 明细行中的零件编号（Excel 列 PARTS / 零件号）。 |
| `cn_part_number` | **替换号** | 中国零件号/替换号；**全系统统一用「替换号」**，不再使用「中国零件号」作为用户可见名称。 |
| `brand` | **品牌** | 明细行品牌（表头可用「品牌」）。 |
| 数量 / 件数 | **数量** 或 **件数** | 询价/问价/报价常用「数量」；订货单、采购单导出等按 REFERENCE 可能用「件数」等列名。 |
| 报价含税 | **报价含税** 或 **含税单价** | 单价（人民币含税）。 |
| `moq` | **MOQ** | 最小起订量；问价单模板与报价单均预留该列，供供应商填写。 |
| `mpq` | **MPQ** | 最小包装量；与 MOQ 并列，含义不同。 |

### 2.3 询价单相关

| 数据/字段 | UI 展示名称 | 说明 |
|-----------|-------------|------|
| `rfq_no` | **询价单号** | 询价单唯一标识。 |
| 标题、日期、备注 | **标题** / **询价日期** / **备注** | 主表信息。 |

### 2.4 界面常用 Tab 用语（询价单工作台）

| 用户可见名称 | 含义（简） |
|--------------|------------|
| **问价单与供应商** | 维护问价单组、生成/打包问价单 Excel。 |
| **报价回收** | 导入与管理报价单。 |
| **回询单** | 生成与导出给客户的回询清单。 |
| **订货单匹配** | 导入订货单、**订单校对**（含与已确认采购对齐的「待订单校对」提示）。 |
| **采购单生成** | 采购工作台、确认入库、已确认采购与导出。 |

---

## 3. 文件名规范（统一约定）

| 单据类型 | 文件名格式 | 示例 |
|----------|------------|------|
| **报价单** | `报价单-XXX-日期.xlsx` 或 `报价单-XXX日期.xlsx`；日期支持 YYYYMMDD 或 YYYY-MM-DD | `报价单-ROLF001-20260304.xlsx`、`报价单-BOSCH20260209.xlsx` |
| **询价单** | `询价单-XXXXX-日期.xlsx`，日期 6 位或 8 位 | `询价单-RFQ202603-20260304.xlsx` |
| **问价单** | 多为组名或 `问价单-供货商名-日期.xlsx` | `问价单-北方通宝-20260305.xlsx` |
| **订货单** | `订货单-XXXX-日期.xlsx` | `订货单-YUDA2301-20260305.xlsx` |
| **采购单** | `采购单-供货商名-单号.xlsx` | `采购单-北方通宝-QL0202.xlsx` |
| **采购单回传校对** | `校对-采购单-{供应商名或自由文本}.xlsx` | `校对-采购单-北方通宝.xlsx` |
| **订货单校对版导出** | `订货单-{订单号}-校对版.xlsx` | `订货单-YUDA2301-校对版.xlsx` |
| **订货单入库完整版导出** | `订货单入库版-{订单号}.xlsx` | `订货单入库版-YUDA2301.xlsx` |

---

## 4. 易混点与历史歧义（已统一）

| 问题 | 约定 | 依据 |
|------|------|------|
| 报价单主表曾用 `inquiry` | 已全量改为 **quotation**（表、API、前端）；用户术语一律「报价单」。 | finished-requirement-0304-2126 |
| `quotation_no` 在 UI 曾称「零件号」 | **统一为「报价单名」**；「零件号」仅指标识明细行的 part_number 列。 | requirements-0305-0931 |
| 中国零件号 vs 替换号 | **统一用「替换号」**；文档与 UI 不再使用「中国零件号」。 | 0305 需求与 Excel 表头 |
| 采购订单 vs 采购单 | **统一用「采购单」**；与「采购订单」同义时也写「采购单」。 | requirements-0305-1119 |
| 回询单 | **回询单**：我方给客户的报价清单，由报价单比价后生成、价格可改并落库，关联询价单；订货单行与回询单行按「品牌+零件号+货物单价」匹配（订货单无替换号）。 | requirements-0305-1119 |
| **询价单 vs 问价单** | **询价单**=系统内整张 RFQ；**问价单**=按组导出给**某一供应商**的 Excel 模板，用于对方填价后再当**报价单**导入。 | REFERENCE §2 / §4 |
| **MOQ vs MPQ** | **MOQ**=最小起订量；**MPQ**=最小包装量；两列并存，勿混用或合并表述。 | 报价单 / 问价单表头 |

---

## 5. 与各需求文档的对应关系

- **requirements-0305-0931.md**：报价单名、品牌名、供应商必选、报价单文件名规范。
- **requirements-0305-1119.md**：订货单、采购单、**回询单**定义；订货单与询价单 N:1、与回询单 N:N；订货单行与回询单行匹配（品牌+零件号+货物单价）；订货单/采购单文件名与格式。
- **finished-requirement-0304-2126.md**：inquiry → quotation 全量重命名已实施；UI 以「报价单」为准。
- **requirements-overview.md**：部分仍写「询价单 inquiry」「中国零件号」「采购订单」——**以本规范为准**：报价单对应 quotation；替换号；采购单。
- **requirements-0309-1122.md**：问价单导出第 1 行合并、表头与 `QUOTE_REQUEST_HEADERS` 一致（见 `rfq_quote_group_service.py`）。

后续若需求文档与本规范不一致，以**本规范**及 **REFERENCE.md 表头细则**为准，并建议在对应需求文档中加注「以 naming-and-terminology.md / REFERENCE.md 为准」。

---

## 变更记录

| 日期 | 说明 |
|------|------|
| 2025-03-05 | 初稿：汇总 requirements-* 与 finished-requirement-* 中的命名与术语，统一单据名、UI 标签、文件名规范及易混点。 |
| 2025-03-05 | 新增**回询单**定义：我方给客户的报价清单，由报价单入库后生成、价格可编辑落库，关联询价单（N:1）；订货单与询价单 N:1、与回询单 N:N（约束在询价单下）；订货单行与回询单行按「品牌+零件号+货物单价」匹配。 |
| 2026-03-29 | 问价单：与报价单列对齐，明确含 **MOQ、MPQ**、无「状态」列；补充询价/问价区别、MOQ/MPQ 区别；文件名表增加采购回传校对、订货校对版/入库版；增加工作台 Tab 用语与「已确认采购」说明；指向 REFERENCE 为表头权威。 |