1080 lines
59 KiB
Markdown
1080 lines
59 KiB
Markdown
# 采购订单 - 页面设计开发说明文档
|
||
|
||
> 版本: 2.3.0
|
||
> 创建日期: 2026-02-07
|
||
> 更新日期: 2026-02-13
|
||
> 来源系统: 升阳云ERP 演示系统
|
||
> 来源页面: `https://demo.rsun.vip/po/purchase/order/plan?needType=0&workType=&fmConfig=010301,020301`
|
||
> 所属模块: 采购管理 > 采购订单
|
||
> 前端路由: `/po/purchase/order/plan`
|
||
> **采集脚本**: `python3 scripts/crawl_purchase_order.py`（列表+按钮采集）；`python3 scripts/crawl_po_form_deep.py`（表单深度采集）；共 19 张截图
|
||
> **关联文档**: [erp数据库设计-数据字典](db/erp数据库设计-数据字典.md)；[采购管理.md](采购管理.md)；[采购管理-前端开发规范.md](采购管理-前端开发规范.md)；[mom系统采购计划单-页面开发说明文档](mom系统采购计划单-页面开发说明文档.md)
|
||
|
||
---
|
||
|
||
## 目录
|
||
|
||
0. [业务流程总览](#0-业务流程总览)
|
||
1. [页面概述](#1-页面概述)
|
||
2. [页面结构](#2-页面结构)
|
||
3. [列表页设计](#3-列表页设计)
|
||
4. [新增/编辑页设计](#4-新增编辑页设计)
|
||
- 4.3.1 [手工（手动）新增物料](#431-手工新增物料截图确认)
|
||
5. [数据字段定义](#5-数据字段定义)
|
||
6. [按钮操作说明](#6-按钮操作说明)
|
||
7. [页面交互规则](#7-页面交互规则)
|
||
8. [接口调用说明](#8-接口调用说明)
|
||
9. [状态流转](#9-状态流转)
|
||
10. [业务规则](#10-业务规则)
|
||
11. [前端组件设计](#11-前端组件设计)
|
||
12. [数据模型](#12-数据模型)
|
||
|
||
---
|
||
|
||
## 0. 业务流程总览
|
||
|
||
### 0.1 采购订单在 ERP 中的定位
|
||
|
||
采购订单是**采购计划→采购执行→到货入库**链条中的核心执行单据，承接采购计划单的物料需求，向供应商下达采购指令，下游驱动到货、入库、发票及退货。
|
||
|
||
```
|
||
┌──────────────┐ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐
|
||
│ 销售订单 │────►│ 生产计划单 │────►│ 采购计划单 │────►│ ★ 采购订单 │
|
||
│ │ │ + BOM运算 │ │ (物料需求) │ │ (执行采购) │
|
||
└──────────────┘ └──────────────┘ └──────────────┘ └──────┬───────┘
|
||
│
|
||
┌───────────────────────────┼───────────────────────┐
|
||
▼ ▼ ▼
|
||
┌──────────────┐ ┌──────────────┐ ┌──────────────┐
|
||
│ 采购到货单 │ │ 采购发票 │ │ 采购退货单 │
|
||
│ (到货登记) │ │ (财务核算) │ │ (退货出库) │
|
||
└──────┬───────┘ └──────────────┘ └──────────────┘
|
||
│
|
||
▼
|
||
┌──────────────┐
|
||
│ 采购入库单 │
|
||
│ (库存增加) │
|
||
└──────────────┘
|
||
```
|
||
|
||
### 0.2 端到端业务流程
|
||
|
||
```
|
||
采购计划单(已审核)
|
||
│ 引入（采购计划单明细）
|
||
▼
|
||
┌─────────────────┐ 选择供应商 ┌─────────────────┐
|
||
│ ★ 采购订单 │ ◄───────────────── │ 原料供应商档案 │
|
||
│ - 表头+供应商 │ │ │
|
||
│ - 物料明细子表 │ └─────────────────┘
|
||
│ - 数量/单价/金额│
|
||
└────────┬────────┘
|
||
│ 保存 → 审核
|
||
▼
|
||
┌─────────────────┐ 引入采购订单 ┌─────────────────┐
|
||
│ 采购到货单 │ ◄───────────────── │ 采购订单(已审核) │
|
||
│ - 到货数量 │ └─────────────────┘
|
||
└────────┬────────┘
|
||
│ 到货 → 入库
|
||
▼
|
||
┌─────────────────┐
|
||
│ 采购入库单 │ ──► 库存增加
|
||
└─────────────────┘
|
||
```
|
||
|
||
### 0.3 采购订单内部业务流程（Playwright 实际验证 ✅）
|
||
|
||
| 阶段 | 操作 | 触发条件 | 结果 | 验证 |
|
||
|------|------|----------|------|------|
|
||
| 1. 新建 | 点击「新增」 | 始终可用 | 打开新增页，编码自动生成，状态=开立，按钮=[保存/取消/审核/反审核/收起/引入/新增物料] | ✅ |
|
||
| 2. 选择供应商 | 点击「选择」或「供方」旁按钮 | 新增/编辑页 | 打开供应商选择弹窗 | 截图确认 |
|
||
| 3. 引入 | 点击「引入」→ 弹窗「采购计划单明细」→ 勾选 → 确定 | 新增/编辑状态 | 物料明细子表填充：跟单编号、计划单号、物料、数量、需求日期 | ✅ |
|
||
| 4. 新增物料 | 点击「新增物料」 | 新增/编辑状态 | 子表末尾新增空行；可通过「选择物料」弹窗选料并填数量/单价，详见 [4.3.1](#431-手工新增物料截图确认) | ✅ |
|
||
| 5. 保存 | 点击「保存」 | 至少 1 条物料明细 | 数据持久化 | - |
|
||
| 6. 审核 | 点击「审核」或批量审核 | 开立状态，已保存 | 状态→审核，记录审核员/日期；**审核后可生成到货单** | - |
|
||
| 7. 反审核 | 点击「反审核」 | 审核状态，无下游引用 | 状态→开立 | - |
|
||
| 8. 撤回 | 编辑页点击「撤回」 | 编辑状态 | 撤回未保存修改 | ✅ 按钮确认 |
|
||
| 9. 打印 | 查看页点击「打印」 | 查看页 | 打印预览 | ✅ 按钮确认 |
|
||
| 10. 删除 | 操作列「删除」或批量删除 | 开立/退回状态 | 逻辑删除 | ✅ |
|
||
|
||
### 0.4 上下游单据关系
|
||
|
||
| 上游单据 | 关联字段 | 说明 |
|
||
|----------|----------|------|
|
||
| 采购计划单 | plan_code, plan_line_id | 引入弹窗「采购计划单明细」|
|
||
| 销售订单 | track_code (跟单编号) | 通过采购计划间接关联 |
|
||
| 供应商 | supplier_id, supplier_name | 选择供应商弹窗 |
|
||
|
||
| 下游单据 | 关联字段 | 说明 |
|
||
|----------|----------|------|
|
||
| 采购到货单 | po_order_code, order_id | 到货单引入采购订单 |
|
||
| 采购发票 | order_code | 发票关联采购订单 |
|
||
| 采购退货单 | order_code | 退货关联采购订单 |
|
||
| 采购入库单 | - | 通过到货单间接关联 |
|
||
|
||
### 0.5 关键数量与金额逻辑
|
||
|
||
| 字段 | 含义 | 计算/来源 |
|
||
|------|------|-----------|
|
||
| 数量 (quantity) | 采购数量 | 引入时从计划带入，可手动修改 |
|
||
| 单价 (unit_price) | 采购单价 | 手工输入或从市场价格表带入 |
|
||
| 金额 (amount) | 行金额 | 数量 × 单价，自动计算 |
|
||
| 到货数量 (arrived_quantity) | 已到货数量 | 从到货单回写，只读 |
|
||
| 总数量 (total_quantity) | 订单总数量 | 明细行数量合计 |
|
||
| 总金额 (total_amount) | 订单总金额 | 明细行金额合计 |
|
||
|
||
---
|
||
|
||
## 1. 页面概述
|
||
|
||
### 1.1 功能说明
|
||
|
||
采购订单页面用于管理企业的采购订单。采购订单是向供应商正式下达采购指令的核心单据，支持从采购计划引入物料需求或手工新增物料行，关联供应商后形成完整的采购订单。审核后作为到货、入库、发票的上游依据。
|
||
|
||
### 1.2 业务场景
|
||
|
||
- **引入采购计划**: 从已审核的采购计划单引入物料明细（跟单编号、计划单号、物料、需求数量、需求日期等）
|
||
- **手工新增物料**: 通过「+ 新增物料」按钮在子表末尾增加空行，再通过「选择物料」弹窗选择物料并填写数量、单价等（详见 [4.3.1 手工新增物料](#431-手工新增物料)）
|
||
- **选择供应商**: 通过供应商选择弹窗关联供应商
|
||
- **价格管理**: 录入采购单价，自动计算金额（数量 × 单价）
|
||
- **审核流程**: 采购订单审核后不可编辑，可反审核
|
||
- **到货跟踪**: 跟踪每个物料的到货数量，订单数量 vs 到货数量
|
||
|
||
### 1.3 URL路由参数
|
||
|
||
| 参数名 | 类型 | 说明 |
|
||
|--------|------|------|
|
||
| needType | integer | 0=订单用料（默认），1=备库用料 |
|
||
| workType | string | 工作类型 |
|
||
| fmConfig | string | 表单配置编码，如 010301,020301 |
|
||
|
||
### 1.4 页面截图参考（Playwright V1 自动采集）
|
||
|
||
| 截图文件 | 说明 | 来源 |
|
||
|----------|------|------|
|
||
| `screenshot/采购订单-明细视图-列表.png` | 明细视图列表，12列/83行 | ✅ V1 采集 |
|
||
| `screenshot/采购订单-单据视图-列表.png` | 单据视图列表，9列/44行，操作列=查看/编辑/删除 | ✅ V1 采集 |
|
||
| `screenshot/采购订单-导出确认弹窗.png` | 导出按钮弹出确认框 | ✅ V1 采集 |
|
||
| `screenshot/采购订单-新增页-初始化.png` | 新增页空白表单 | ✅ V1 采集 |
|
||
| `screenshot/采购订单-新增页-表头详情.png` | **新增页表头：单据编码/业务类型/操作员/供方/备注 + 14列子表** | ✅ V2 深度采集 |
|
||
| `screenshot/采购订单-引入弹窗-采购计划单明细.png` | 引入弹窗：10列，搜索4项，11行计划明细 | ✅ V1 采集 |
|
||
| `screenshot/采购订单-引入弹窗-详情.png` | **引入弹窗详情：首行数据可见** | ✅ V2 深度采集 |
|
||
| `screenshot/采购订单-选择供应商弹窗.png` | **选择供应商弹窗：7列/79行/搜索+快速添加** | ✅ V2 深度采集 |
|
||
| `screenshot/采购订单-新增页-新增物料后.png` | 新增物料后子表增加空行 | ✅ V1 采集 |
|
||
| `screenshot/采购订单-新增页-新增物料行.png` | **新增物料行（含合计行）** | ✅ V2 深度采集 |
|
||
| `screenshot/采购订单-新增页-可新增物料.png` | **手工新增物料：物料信息表含「引入」「+ 新增物料」；已填行与空行（跟单/计划单号「手工单据」或「添加物料」）；物料编码列「选择」打开物料选择** | ✅ 补充 |
|
||
| `screenshot/采购订单-新增页-点击添加物料.png` | **选择物料弹窗：分类树、物料编码/物料名称搜索、查询所有/连选；物料列表「选择」「查看」；背后可见「+ 新增物料」** | ✅ 补充 |
|
||
| `screenshot/采购订单-新增页-表头收起.png` | 表头折叠效果 | ✅ V1 采集 |
|
||
| `screenshot/采购订单-查看页.png` | 查看页（只读），7个按钮 | ✅ V1 采集 |
|
||
| `screenshot/采购订单-查看页-表头详情.png` | **查看页：CGDD000047，2行物料，含单价/金额/合计行** | ✅ V2 深度采集 |
|
||
| `screenshot/采购订单-查看页-上一条.png` | **上一条按钮：切换到相邻记录** | ✅ V2 深度采集 |
|
||
| `screenshot/采购订单-查看页转编辑.png` | **查看→编辑：按钮变=保存/撤回/审核/反审核/操作/收起/引入/新增物料** | ✅ V2 深度采集 |
|
||
| `screenshot/采购订单-编辑页.png` | 编辑页，8个按钮含撤回 | ✅ V1 采集 |
|
||
|
||
---
|
||
|
||
## 2. 页面结构
|
||
|
||
### 2.1 整体布局
|
||
|
||
```
|
||
┌─────────────────────────────────────────────────────────────────┐
|
||
│ 顶部导航栏 (64px) │
|
||
├────────┬────────────────────────────────────────────────────────┤
|
||
│ 左侧 │ 面包屑: 首页 / 采购管理 / 采购订单 │
|
||
│ 菜单 │ ┌────────────────────────────────────────────────┐ │
|
||
│ (200px)│ │ Tab标签: ● 采购订单 │ │
|
||
│ │ ├────────────────────────────────────────────────┤ │
|
||
│ 采购管 │ │ 查询区域 (搜索条件) │ │
|
||
│ 理 │ ├────────────────────────────────────────────────┤ │
|
||
│ ├原料 │ │ 工具栏 (操作按钮) + 料品分类快捷标签 │ │
|
||
│ 供应 │ ├────────────────────────────────────────────────┤ │
|
||
│ 商 │ │ 数据表格 │ │
|
||
│ ├采购 │ ├────────────────────────────────────────────────┤ │
|
||
│ 订单★│ │ 底部统计 (订单数量/到货数量汇总) + 分页组件 │ │
|
||
│ ├到货 │ └────────────────────────────────────────────────┘ │
|
||
│ 单 │ │
|
||
├────────┴────────────────────────────────────────────────────────┤
|
||
```
|
||
|
||
### 2.2 页面模式
|
||
|
||
| 模式 | 说明 | 入口 |
|
||
|------|------|------|
|
||
| 列表页 - 明细视图 | **默认视图**，以物料维度展示，含跟单编号/供应商/物料/数量/单价/到货 | 菜单点击「采购订单」 |
|
||
| 列表页 - 单据视图 | 以单据维度展示，含批量操作 | 明细视图点击「单据」 |
|
||
| 新增页 | 新建采购订单 | 列表页点击「新增」 |
|
||
| 编辑页 | 修改采购订单（仅开立/退回状态） | 单据视图「编辑」 |
|
||
| 查看页 | 只读查看详情 | 单据视图「查看」 |
|
||
|
||
### 2.3 列表页双视图对比（Playwright 采集数据）
|
||
|
||
| 对比项 | 明细视图（默认） | 单据视图 |
|
||
|--------|-----------------|---------|
|
||
| 切换按钮 | 「单据」 | 「明细」 |
|
||
| 复选框列 | 无 | 有 |
|
||
| 序号列 | 有 | 无 |
|
||
| 搜索条件 | 跟单编号、单据编码、供应商、物料编码、物料名称、日期范围 | 单据编码、单据状态、业务状态、日期范围 |
|
||
| 工具栏按钮 | 搜索、单据、查询所有、新增、导出 | 搜索、明细、查询所有、新增、删除、审核、反审核 |
|
||
| 数据列 | 序号/跟单编号/计划编号/单据编码/单据状态/供应商/物料名称/物料编码/需求日期/采购数量/到货数量/单据日期 | 单据编码/单据日期/单据状态/业务类型/采购部门/采购人员/业务状态/审核日期/操作 |
|
||
| 操作列 | 无 | 查看、编辑、删除 |
|
||
| 数据行数 | 83行（物料维度） | 44行（单据维度） |
|
||
| 底部统计 | 订单数量：4,543,466 到货数量：汇总 | 订单数量汇总 |
|
||
|
||
---
|
||
|
||
## 3. 列表页设计
|
||
|
||
### 3.1 明细视图（默认视图）
|
||
|
||
> 截图: `screenshot/采购订单-明细视图-列表.png`
|
||
|
||
#### 3.1.1 搜索条件区域
|
||
|
||
| 序号 | 字段名 | 标签 | 组件类型 | 宽度 | 说明 |
|
||
|------|--------|------|----------|------|------|
|
||
| 1 | trackCode | 跟单编号 | el-input | 140px | 模糊搜索 |
|
||
| 2 | orderCode | 单据编码 | el-input | 140px | 模糊搜索 |
|
||
| 3 | supplierName | 供应商 | el-input | 140px | 模糊搜索 |
|
||
| 4 | itemCode | 物料编码 | el-input | 140px | 模糊搜索 |
|
||
| 5 | itemName | 物料名称 | el-input | 140px | 模糊搜索 |
|
||
| 6 | startDate | 开始日期 | el-date-picker | 140px | 日期范围起 |
|
||
| 7 | endDate | 结束日期 | el-date-picker | 140px | 日期范围止 |
|
||
|
||
#### 3.1.2 工具栏按钮（✅ Playwright 采集确认）
|
||
|
||
| 序号 | 按钮名称 | 类型 | 权限标识 | 说明 |
|
||
|------|----------|------|----------|------|
|
||
| 1 | 搜索 | primary | po:order:list | 按搜索条件查询 |
|
||
| 2 | 单据 | primary | po:order:list | 切换到单据视图 |
|
||
| 3 | 查询所有 | default | po:order:list | 重置搜索条件并查询所有 |
|
||
| 4 | 新增 | success | po:order:add | 打开新增采购订单页面 |
|
||
| 5 | 导出 | default | po:order:export | 导出到Excel |
|
||
|
||
#### 3.1.3 数据表格列定义（✅ 采集确认 12 列）
|
||
|
||
| 序号 | 列标题 | 字段名 | 宽度 | 对齐 | 说明 |
|
||
|------|--------|--------|------|------|------|
|
||
| 1 | 序号 | - | 60px | center | 自动编号 |
|
||
| 2 | 跟单编号 | trackCode | 140px | left | 销售订单号，蓝色链接 |
|
||
| 3 | 计划编号 | planCode | 140px | left | 采购计划编码 |
|
||
| 4 | 单据编码 | orderCode | 140px | left | 采购订单编码，蓝色链接可点击 |
|
||
| 5 | 单据状态 | status | 80px | center | 状态标签（开立/审核/关闭） |
|
||
| 6 | 供应商 | supplierName | 200px | left | 供应商名称 |
|
||
| 7 | 物料名称 | itemName | 200px | left | 物料名称 |
|
||
| 8 | 物料编码 | itemCode | 120px | left | 物料编码 |
|
||
| 9 | 需求日期 | needDate | 100px | center | 需求到货日期 |
|
||
| 10 | 采购数量 | quantity | 100px | right | 采购数量 |
|
||
| 11 | 到货数量 | arrivedQuantity | 100px | right | 已到货数量 |
|
||
| 12 | 单据日期 | orderDate | 100px | center | 订单创建日期 |
|
||
|
||
#### 3.1.4 底部统计
|
||
|
||
| 组件 | 说明 |
|
||
|------|------|
|
||
| 订单数量 | 当前查询结果采购数量合计（如 4,543,466） |
|
||
| 到货数量 | 当前查询结果已到货数量合计 |
|
||
|
||
### 3.2 单据视图
|
||
|
||
> 截图: `screenshot/采购订单-单据视图-列表.png`
|
||
|
||
#### 3.2.1 搜索条件区域
|
||
|
||
| 序号 | 字段名 | 标签 | 组件类型 | 说明 |
|
||
|------|--------|------|----------|------|
|
||
| 1 | orderCode | 单据编码 | el-input | 模糊搜索 |
|
||
| 2 | status | 单据状态 | el-select | 开立/审核/关闭 |
|
||
| 3 | businessStatus | 业务状态 | el-select | 正常/完成/暂停/取消 |
|
||
| 4 | startDate | 开始日期 | el-date-picker | 日期范围起 |
|
||
| 5 | endDate | 结束日期 | el-date-picker | 日期范围止 |
|
||
|
||
#### 3.2.2 工具栏按钮（✅ 采集确认 7 个）
|
||
|
||
| 序号 | 按钮名称 | 类型 | 权限标识 | 说明 |
|
||
|------|----------|------|----------|------|
|
||
| 1 | 搜索 | primary | po:order:list | 按条件搜索 |
|
||
| 2 | 明细 | primary | po:order:list | 切换到明细视图 |
|
||
| 3 | 查询所有 | default | po:order:list | 重置并查询 |
|
||
| 4 | 新增 | success | po:order:add | 新增采购订单 |
|
||
| 5 | 删除 | danger | po:order:remove | 批量删除（需勾选） |
|
||
| 6 | 审核 | primary | po:order:approve | 批量审核（需勾选） |
|
||
| 7 | 反审核 | default | po:order:unapprove | 批量反审核（需勾选） |
|
||
|
||
#### 3.2.3 数据表格列定义（✅ 采集确认 9 列）
|
||
|
||
| 序号 | 列标题 | 字段名 | 宽度 | 说明 |
|
||
|------|--------|--------|------|------|
|
||
| 0 | (复选框) | - | 55px | 批量操作 |
|
||
| 1 | 单据编码 | orderCode | 140px | 可点击查看详情 |
|
||
| 2 | 单据日期 | orderDate | 120px | 默认降序 |
|
||
| 3 | 单据状态 | status | 80px | 颜色标签 |
|
||
| 4 | 业务类型 | businessType | 100px | 原材料/零部件等 |
|
||
| 5 | 采购部门 | deptName | 100px | |
|
||
| 6 | 采购人员 | userName | 100px | |
|
||
| 7 | 业务状态 | businessStatus | 80px | 正常/完成 |
|
||
| 8 | 审核日期 | approveDate | 120px | |
|
||
| 9 | 操作 | - | 160px | 查看/编辑/删除 |
|
||
|
||
#### 3.2.4 操作列按钮（✅ 采集确认）
|
||
|
||
| 按钮 | 颜色 | 显示条件 | 说明 |
|
||
|------|------|----------|------|
|
||
| 查看 | success | 所有状态 | 打开查看页（只读） |
|
||
| 编辑 | primary | 开立/退回 | 打开编辑页 |
|
||
| 删除 | danger | 开立/退回 | 二次确认后删除 |
|
||
|
||
### 3.3 分页组件
|
||
|
||
| 属性 | 值 |
|
||
|------|------|
|
||
| 默认每页条数 | 100 |
|
||
| 可选 | 100, 200, 500, 1000 |
|
||
| 布局 | total, sizes, prev, pager, next, jumper |
|
||
|
||
---
|
||
|
||
## 4. 新增/编辑页设计
|
||
|
||
### 4.1 页面布局
|
||
|
||
> 截图: `screenshot/采购订单-新增页-初始化.png`
|
||
|
||
```
|
||
┌──────────────────────────────────────────────────────────────┐
|
||
│ 采购订单 [保存][取消][审核][反审核][收起] │
|
||
├──────────────────────────────────────────────────────────────┤
|
||
│ 表头表单区 (可折叠) │
|
||
│ ┌──────────┬──────────┬──────────┬──────────┐ │
|
||
│ │ 单据编码 │ 业务类型 │ 操作员 │ 供方[选择]│ │
|
||
│ │ 单据日期 │ 单据类型 │ 采购部门 │ 到货日期 │ │
|
||
│ │ 单据状态 │ 采购人员 │ 审核员 │ 采购合同 │ │
|
||
│ │ 业务状态 │ 用料需求 │ 审核日期 │ 合同号 │ │
|
||
│ │ │ │ │ 备注信息 │ │
|
||
│ └──────────┴──────────┴──────────┴──────────┘ │
|
||
├──────────────────────────────────────────────────────────────┤
|
||
│ 物料信息 [引入] [新增物料] │
|
||
│ ┌──┬────┬────┬────┬────┬────┬──┬────┬──┬──┬──┬────┬────┬──┐ │
|
||
│ │序│跟单│计划│物料│物料│型号│主│需求│数│单│金│到货│采购│操│ │
|
||
│ │号│编号│单号│编码│名称│规格│计│日期│量│价│额│数量│说明│作│ │
|
||
│ ├──┼────┼────┼────┼────┼────┼──┼────┼──┼──┼──┼────┼────┼──┤ │
|
||
│ │ │ │ │ │ │ │量│ │ │ │ │ │ │删│ │
|
||
│ ├──┴────┴────┴────┴────┴────┴──┴────┴──┴──┴──┴────┴────┴──┤ │
|
||
│ │ 合计 0 0 0.00 │ │
|
||
│ └────────────────────────────────────────────────────────────┘ │
|
||
└──────────────────────────────────────────────────────────────┘
|
||
```
|
||
|
||
### 4.2 表头表单字段（✅ V2 截图确认布局）
|
||
|
||
> 截图: `screenshot/采购订单-新增页-表头详情.png`（新增）；`screenshot/采购订单-查看页-表头详情.png`（查看）
|
||
|
||
表头采用 5 列栅格布局（第1~4列为字段组，第5列含供方/到货/合同/备注），共 4 行。
|
||
|
||
| 序号 | 字段名 | 标签 | 组件类型 | 必填 | 默认值 | 新增可编辑 | 查看只读 | 说明 |
|
||
|------|--------|------|----------|------|--------|------------|----------|------|
|
||
| 1 | orderCode | 单据编码 | el-input | 是 | 自动生成 | 否(只读) | 是 | 格式: CGDD000XXX |
|
||
| 2 | businessType | 业务类型 | el-select | 是 | 原材料 | 是 | 是 | 原材料/零部件/装配件/成品/五金件/包装物 |
|
||
| 3 | operatorName | 操作员 | el-input | - | 当前用户 | 否(只读) | 是 | 如 admin, njrsun |
|
||
| 4 | supplierName | 供方 | el-input + [选择] | 否 | - | 是(弹窗) | 是 | 点击「选择」打开供应商弹窗 |
|
||
| 5 | remark | 备注信息 | el-input(textarea) | 否 | - | 是 | 是 | 多行文本 |
|
||
| 6 | orderDate | 单据日期 | el-date-picker | 是 | 当天 | 是 | 是 | 如 2026-02-07 |
|
||
| 7 | orderType | 单据类型 | el-select | 是 | 采购订单 | 否(只读) | 是 | 固定值 |
|
||
| 8 | approverName | 审核员 | el-input | - | - | 否(空) | 是 | 审核时自动填充 |
|
||
| 9 | deliveryDate | 到货日期 | el-date-picker | 否 | - | 是 | 是 | 预计到货日期 |
|
||
| 10 | status | 单据状态 | el-tag | - | 开立 | 否(标签) | 是 | 开立=橙色, 审核=绿色 |
|
||
| 11 | deptName | 采购部门 | el-select | 否 | 请选择 | 是 | 是 | 下拉选择部门 |
|
||
| 12 | approveDate | 审核日期 | el-date-picker | - | - | 否(空) | 是 | 审核时自动填充 |
|
||
| 13 | contractFile | 采购合同 | upload + [上传] | 否 | - | 是 | 是(修改) | 上传/查看合同附件 |
|
||
| 14 | businessStatus | 业务状态 | el-select | 否 | 正常 | 是 | 是 | 正常/暂停/取消 |
|
||
| 15 | userName | 采购人员 | el-select | 否 | 请选择 | 是 | 是 | 需先选择部门 |
|
||
| 16 | materialNeed | 用料需求 | el-select | 是 | 订单用料 | 否(只读) | 是 | 订单用料/备库用料 |
|
||
| 17 | contractNo | 合同号 | el-input | 否 | - | 是 | 是 | 合同编号 |
|
||
|
||
**表头布局示意（基于截图）：**
|
||
|
||
```
|
||
行1: 单据编码[只读] | 业务类型[下拉] | 操作员[只读] | 供方[选择弹窗] | 备注信息[文本域]
|
||
行2: 单据日期[日期] | 单据类型[只读] | 审核员[只读] | 到货日期[日期] |
|
||
行3: 单据状态[标签] | 采购部门[下拉] | 审核日期[只读] | 采购合同[上传] |
|
||
行4: 业务状态[下拉] | 采购人员[下拉] | 用料需求[只读] | 合同号[输入] |
|
||
```
|
||
|
||
**查看页 vs 编辑页 vs 新增页差异：**
|
||
|
||
| 差异项 | 新增页 | 编辑页 | 查看页 |
|
||
|--------|--------|--------|--------|
|
||
| 单据编码 | 空（保存后生成） | 已生成（只读） | 已生成（只读） |
|
||
| 表头字段 | 部分可编辑 | 部分可编辑 | 全部只读 |
|
||
| 顶部按钮 | 保存/取消/审核/反审核/收起 | 保存/撤回/审核/反审核/操作/收起 | 新增/编辑/审核/反审核/打印/操作/收起 |
|
||
| 子表区域按钮 | 引入/新增物料 | 引入/新增物料 | 无 |
|
||
| 子表操作列 | 有（删除） | 有（删除） | 无 |
|
||
| 子表合计行 | 有 | 有 | 有 |
|
||
| 上一条/下一条 | 无 | 有 | 有 |
|
||
|
||
### 4.3 物料明细子表（✅ 采集确认 14 列）
|
||
|
||
| 序号 | 列标题 | 字段名 | 宽度 | 组件类型 | 必填 | 说明 |
|
||
|------|--------|--------|------|----------|------|------|
|
||
| 1 | 序号 | lineNo | 60px | 自动编号 | - | |
|
||
| 2 | 跟单编号 | trackCode | 120px | el-input | - | 只读，引入带入 |
|
||
| 3 | 计划单号 | planCode | 120px | el-input | - | 只读，引入带入 |
|
||
| 4 | 物料编码 | itemCode | 150px | el-input + 选择 | 是 | 引入或手工选择 |
|
||
| 5 | 物料名称 | itemName | 200px | el-input | - | 只读 |
|
||
| 6 | 型号规格 | specification | 150px | el-input | - | 只读 |
|
||
| 7 | 主计量 | unitName | 80px | el-input | - | 只读 |
|
||
| 8 | 需求日期 | needDate | 120px | el-date-picker | 否 | 可编辑 |
|
||
| 9 | 数量 | quantity | 100px | el-input-number | 是 | 采购数量 |
|
||
| 10 | 单价 | unitPrice | 100px | el-input-number | 否 | 采购单价 |
|
||
| 11 | 金额 | amount | 100px | el-input | - | 自动=数量×单价 |
|
||
| 12 | 到货数量 | arrivedQuantity | 100px | el-input | - | 只读，到货回写 |
|
||
| 13 | 采购说明 | remark | 120px | el-input | 否 | 行级备注 |
|
||
| 14 | 操作 | - | 80px | el-button | - | 删除 |
|
||
|
||
> **注意**: 子表底部有「合计」行，汇总数量、金额等。
|
||
|
||
#### 4.3.1 手工新增物料（✅ 截图确认）
|
||
|
||
> 本功能也称"**手动新增物料**"，与"手工新增物料"同义。
|
||
|
||
手工新增物料用于在**未从采购计划引入**的情况下，直接为当前订单添加物料行。与「引入」互补：引入带出计划单号/跟单编号；手工新增行为空行，跟单编号/计划单号显示为「手工单据」或「添加物料」，需通过「选择物料」弹窗选择物料后填写数量、单价等。
|
||
|
||
**操作流程：**
|
||
|
||
| 步骤 | 操作 | 结果 |
|
||
|------|------|------|
|
||
| 1 | 在「物料信息」区域点击 **「+ 新增物料」** | 子表末尾新增一条空行；该行跟单编号/计划单号显示「手工单据」或「添加物料」 |
|
||
| 2 | 在该行「物料编码」列点击 **「选择」** | 打开「选择物料」弹窗 |
|
||
| 3 | 在弹窗内按分类/编码/名称筛选，点击某行 **「选择」** | 弹窗关闭，当前行回填：物料编码、物料名称、型号规格、主计量 |
|
||
| 4 | 在同行填写需求日期、数量、单价等 | 金额自动计算（数量×单价）；可填采购说明 |
|
||
|
||
> 截图: `screenshot/采购订单-新增页-可新增物料.png`（可新增物料时的子表与「+ 新增物料」）；`screenshot/采购订单-新增页-点击添加物料.png`（选择物料弹窗）
|
||
|
||
**选择物料弹窗（选择物料）：**
|
||
|
||
| 属性 | 值 |
|
||
|------|------|
|
||
| 弹窗标题 | 选择物料 |
|
||
| 用途 | 手工新增物料时，从物料主数据中单选一条物料回填到当前行 |
|
||
|
||
**筛选与操作：**
|
||
|
||
| 组件 | 说明 |
|
||
|------|------|
|
||
| 分类名称 | 请输入分类名称，配合左侧分类树筛选 |
|
||
| 分类树 | 可展开节点，如 04-原材料、05-五金件、06-包装物等，选择分类缩小列表范围 |
|
||
| 物料编码 | 文本输入，模糊搜索 |
|
||
| 物料名称 | 文本输入，模糊搜索 |
|
||
| 搜索 / 重置 | 执行搜索或清空条件 |
|
||
| 查询所有 | 忽略条件，加载全部物料 |
|
||
| 连选 | 连续选择多行（若支持） |
|
||
|
||
**列表列：** 物料编码、物料名称、型号规格、主计量、操作（**选择**、**查看**）。点击某行「选择」即回填当前订单行并关闭弹窗。
|
||
|
||
**与引入的区分：**
|
||
|
||
| 来源 | 跟单编号/计划单号 | 数量/需求日期 |
|
||
|------|-------------------|----------------|
|
||
| 引入（采购计划单明细） | 由计划带入 | 由计划带入，可改 |
|
||
| 手工新增物料 | 「手工单据」或「添加物料」 | 用户手工填写 |
|
||
|
||
### 4.4 选择供应商弹窗（✅ V2 深度采集确认）
|
||
|
||
> 截图: `screenshot/采购订单-选择供应商弹窗.png`
|
||
|
||
| 属性 | 值 |
|
||
|------|------|
|
||
| 弹窗标题 | 选择供应商 |
|
||
| 弹窗宽度 | ~900px |
|
||
| 选择模式 | 单选（每行操作列「选择」按钮） |
|
||
| 数据量 | 79 条供应商（实际采集） |
|
||
|
||
**搜索区域:**
|
||
|
||
| 组件 | 说明 |
|
||
|------|------|
|
||
| 供应商名称 | 文本输入，模糊搜索 |
|
||
| 业务联系人 | 文本输入，模糊搜索 |
|
||
| 搜索按钮 | primary，执行搜索 |
|
||
| 快速添加 | success，直接新增供应商（无需离开弹窗） |
|
||
| 查询所有 | 重置搜索并刷新 |
|
||
|
||
**列表表头（✅ 采集确认 7 列）:**
|
||
|
||
| 序号 | 列标题 | 字段名 | 说明 |
|
||
|------|--------|--------|------|
|
||
| 1 | 序号 | - | 自动编号 |
|
||
| 2 | 供应商名称 | supplierName | |
|
||
| 3 | 电话 | phone | |
|
||
| 4 | 业务联系人 | contactPerson | |
|
||
| 5 | 手机号 | mobile | |
|
||
| 6 | 状态 | status | 开关样式（启用/停用） |
|
||
| 7 | 操作 | - | 「选择」蓝色链接 |
|
||
|
||
**选择交互:** 点击某行操作列「选择」→ 弹窗关闭 → 自动填充表头「供方」字段（供应商ID + 供应商名称）
|
||
|
||
### 4.5 引入弹窗（采购计划单明细）（✅ 采集确认）
|
||
|
||
> 截图: `screenshot/采购订单-引入弹窗-采购计划单明细.png`
|
||
|
||
| 属性 | 值 |
|
||
|------|------|
|
||
| 弹窗标题 | 采购计划单明细 |
|
||
| 弹窗宽度 | 1000px |
|
||
| 选择模式 | 多选（勾选 + 全选按钮） |
|
||
|
||
**搜索字段（✅ 采集确认）:**
|
||
|
||
| 组件 | placeholder |
|
||
|------|-------------|
|
||
| 跟单编号 | 跟单编号 |
|
||
| 料品大类 | 料品大类 |
|
||
| 物料编码 | 物料编码 |
|
||
| 物料名称 | 物料名称 |
|
||
| 搜索按钮 | primary |
|
||
|
||
**列表表头（✅ 采集确认 10 列）:**
|
||
|
||
| 序号 | 列标题 | 字段名 | 说明 |
|
||
|------|--------|--------|------|
|
||
| 1 | 计划单号 | planCode | 采购计划编码 |
|
||
| 2 | 销售员 | salesUserName | |
|
||
| 3 | 跟单编号 | trackCode | 销售订单号 |
|
||
| 4 | 订单交期 | deliveryDate | |
|
||
| 5 | 物料编码 | itemCode | |
|
||
| 6 | 物料名称 | itemName | |
|
||
| 7 | 需求日期 | needDate | |
|
||
| 8 | 需求数量 | demandQty | |
|
||
| 9 | 已采数量 | purchasedQty | |
|
||
| 10 | 未采数量 | unpurchasedQty | 需求-已采 |
|
||
|
||
**弹窗按钮（✅ 采集确认）:**
|
||
|
||
| 按钮 | 说明 |
|
||
|------|------|
|
||
| 搜索 | 按条件筛选 |
|
||
| 采购退货单 | 切换到退货单引入模式（特殊功能） |
|
||
| 全选 | 勾选当前页所有行 |
|
||
| 确定 | 引入勾选的行到物料子表 |
|
||
| 取消 | 关闭弹窗 |
|
||
|
||
### 4.6 查看页设计（✅ V2 深度采集确认）
|
||
|
||
> 截图: `screenshot/采购订单-查看页-表头详情.png`
|
||
|
||
**查看页展示了完整的采购订单：**
|
||
- 表头字段全部只读，值已填充（如 CGDD000047, 2026-02-07, 原材料, 采购订单, njrsun, 供方=汕头市三辰蓝猫产品发展有限公司）
|
||
- 子表包含物料明细（含数量/单价/金额/到货数量列）
|
||
- 子表底部「合计」行汇总数量、金额
|
||
- 含「上一条」「下一条」导航链接
|
||
|
||
**查看页按钮（✅ 采集确认 7 个）:**
|
||
|
||
| 按钮 | 颜色 | 说明 |
|
||
|------|------|------|
|
||
| 新增 | primary | 直接新增新订单（不关闭当前页） |
|
||
| 编辑 | default | 切换到编辑模式（按钮组变为编辑模式） |
|
||
| 审核 | success | 审核当前订单 |
|
||
| 反审核 | warning | 反审核 |
|
||
| 打印 | default | 打印预览（含打印图标） |
|
||
| 操作 | default 下拉 | 更多操作（如关闭、复制等） |
|
||
| 收起 | default | 折叠表头 |
|
||
|
||
**查看→编辑切换（✅ V2 截图确认）:**
|
||
|
||
> 截图: `screenshot/采购订单-查看页转编辑.png`
|
||
|
||
点击「编辑」后，按钮组变为编辑模式=[保存/撤回/审核/反审核/操作/收起/引入/新增物料]，表头字段变为可编辑，子表操作列显示「删除」按钮。
|
||
|
||
**上一条/下一条（✅ V2 截图确认）:**
|
||
|
||
> 截图: `screenshot/采购订单-查看页-上一条.png`
|
||
|
||
子表底部右侧显示「上一条」「下一条」链接，点击可在相邻采购订单间切换查看。
|
||
|
||
### 4.7 编辑页设计（✅ 采集确认）
|
||
|
||
> 截图: `screenshot/采购订单-编辑页.png`；`screenshot/采购订单-查看页转编辑.png`
|
||
|
||
**编辑页按钮（✅ 采集确认 8 个）:**
|
||
|
||
| 按钮 | 颜色 | 说明 |
|
||
|------|------|------|
|
||
| 保存 | primary | 保存修改（表头+子表全量提交） |
|
||
| 撤回 | default | 撤回未保存修改，恢复上次保存状态 |
|
||
| 审核 | success | 审核当前订单 |
|
||
| 反审核 | warning | 反审核（需无下游引用） |
|
||
| 操作 | default 下拉 | 更多操作 |
|
||
| 收起 | default | 折叠表头 |
|
||
| 引入 | warning | 打开「采购计划单明细」引入弹窗 |
|
||
| 新增物料 | primary | 子表末尾新增空行 |
|
||
|
||
**子表行操作（✅ 编辑截图确认）:**
|
||
|
||
| 按钮 | 说明 |
|
||
|------|------|
|
||
| 删除 | 红色文字，删除当前行 |
|
||
|
||
> **注意**: 查看页子表无操作列，编辑页子表有操作列（含删除按钮）。
|
||
|
||
---
|
||
|
||
## 5. 数据字段定义
|
||
|
||
### 5.1 采购订单表头（erp_po_order）
|
||
|
||
> API路径: `/po/order`
|
||
|
||
| 字段名 | 数据库字段 | 类型 | 必填 | 默认值 | 说明 |
|
||
|--------|-----------|------|------|--------|------|
|
||
| 订单ID | order_id | bigint | 是 | AUTO | 主键 |
|
||
| 租户ID | tenant_id | varchar(20) | 是 | - | 多租户 |
|
||
| 订单编码 | order_code | varchar(32) | 是 | 自动 | 格式: CGDD + 6位 |
|
||
| 订单日期 | order_date | date | 是 | 当天 | |
|
||
| 单据状态 | status | varchar(20) | 是 | DRAFT | 开立/审核/关闭 |
|
||
| 业务状态 | business_status | varchar(20) | 否 | NORMAL | 正常/完成/暂停/取消 |
|
||
| 业务类型 | business_type | varchar(20) | 否 | - | 原材料/零部件等 |
|
||
| 单据类型 | order_type | varchar(20) | 否 | - | 采购订单 |
|
||
| 用料需求 | material_need | varchar(20) | 否 | - | 订单用料/备库用料 |
|
||
| 供应商ID | supplier_id | bigint | 否 | - | 外键 |
|
||
| 供应商编码 | supplier_code | varchar(32) | 否 | - | |
|
||
| 供应商名称 | supplier_name | varchar(100) | 否 | - | |
|
||
| 采购部门ID | dept_id | bigint | 否 | - | |
|
||
| 采购部门 | dept_name | varchar(50) | 否 | - | |
|
||
| 采购人员ID | user_id | bigint | 否 | - | |
|
||
| 采购人员 | user_name | varchar(50) | 否 | - | |
|
||
| 到货日期 | delivery_date | date | 否 | - | |
|
||
| 合同号 | contract_no | varchar(50) | 否 | - | |
|
||
| 合同附件 | contract_file | varchar(500) | 否 | - | |
|
||
| 总数量 | total_quantity | decimal(18,4) | 否 | 0 | |
|
||
| 总金额 | total_amount | decimal(18,2) | 否 | 0 | |
|
||
| 已到货数量 | arrived_quantity | decimal(18,4) | 否 | 0 | |
|
||
| 备注 | remark | varchar(500) | 否 | - | |
|
||
|
||
### 5.2 采购订单明细（erp_po_order_line）
|
||
|
||
| 字段名 | 数据库字段 | 类型 | 必填 | 说明 |
|
||
|--------|-----------|------|------|------|
|
||
| 明细ID | line_id | bigint | 是 | 主键 |
|
||
| 订单ID | order_id | bigint | 是 | 外键 |
|
||
| 订单编码 | order_code | varchar(32) | 是 | 冗余 |
|
||
| 行号 | line_no | int | 是 | |
|
||
| 跟单编号 | track_code | varchar(32) | 否 | 销售订单号 |
|
||
| 计划单号 | plan_code | varchar(32) | 否 | 采购计划编码 |
|
||
| 计划明细ID | plan_line_id | bigint | 否 | 关联采购计划行 |
|
||
| 物料ID | item_id | bigint | 是 | |
|
||
| 物料编码 | item_code | varchar(32) | 是 | |
|
||
| 物料名称 | item_name | varchar(100) | 是 | |
|
||
| 型号规格 | specification | varchar(200) | 否 | |
|
||
| 计量单位 | unit_name | varchar(20) | 否 | |
|
||
| 需求日期 | need_date | date | 否 | |
|
||
| 采购数量 | quantity | decimal(18,4) | 是 | |
|
||
| 采购单价 | unit_price | decimal(18,4) | 否 | |
|
||
| 金额 | amount | decimal(18,2) | 否 | 数量×单价 |
|
||
| 已到货数量 | arrived_quantity | decimal(18,4) | 否 | |
|
||
| 采购说明 | remark | varchar(200) | 否 | |
|
||
|
||
---
|
||
|
||
## 6. 按钮操作说明（✅ Playwright 采集验证 13 个按钮）
|
||
|
||
### 6.1 明细视图工具栏
|
||
|
||
| 按钮 | 操作 | 结果 | 验证 |
|
||
|------|------|------|------|
|
||
| 搜索 | pageNum=1 带条件查询 | 列表刷新+底部汇总更新 | ✅ |
|
||
| 单据 | 切换到单据视图 | 9列+44行+操作列 | ✅ |
|
||
| 查询所有 | 重置搜索+查询 | 83行结果 | ✅ |
|
||
| 新增 | 跳转新增页 | 空白表单，7个按钮 | ✅ |
|
||
| 导出 | 弹出确认框 → 下载Excel | 截图确认 | ✅ |
|
||
|
||
### 6.2 单据视图工具栏
|
||
|
||
| 按钮 | 操作 | 前置 | 结果 | 验证 |
|
||
|------|------|------|------|------|
|
||
| 明细 | 切换回明细视图 | - | 12列明细列表 | ✅ |
|
||
| 删除 | 批量删除 | 勾选+开立/退回 | 确认后逻辑删除 | ✅ 按钮存在 |
|
||
| 审核 | 批量审核 | 勾选+开立 | 状态→审核 | ✅ 按钮存在 |
|
||
| 反审核 | 批量反审核 | 勾选+审核+无下游 | 状态→开立 | ✅ 按钮存在 |
|
||
|
||
### 6.3 新增/编辑页按钮
|
||
|
||
| 按钮 | 页面 | 操作 | 结果 | 验证 |
|
||
|------|------|------|------|------|
|
||
| 保存 | 新增/编辑 | 提交表头+明细 | 持久化 | ✅ 按钮确认 |
|
||
| 取消 | 新增 | 返回列表 | 确认后回列表 | ✅ |
|
||
| 撤回 | 编辑 | 撤销未保存修改 | 恢复上次保存状态 | ✅ 采集确认 |
|
||
| 审核 | 新增/编辑 | 审核当前单据 | 状态→审核 | ✅ |
|
||
| 反审核 | 查看/编辑 | 反审核 | 状态→开立 | ✅ |
|
||
| 收起 | 所有 | 折叠表头 | 仅显示子表 | ✅ |
|
||
| 引入 | 新增/编辑 | 打开「采购计划单明细」弹窗 | 10列表格 | ✅ |
|
||
| 新增物料 | 新增/编辑 | 子表新增空行 | 子表新增空行（行数+1）；选料与完整流程见 [4.3.1](#431-手工新增物料截图确认) | ✅ |
|
||
| 打印 | 查看 | 打印预览 | 打印对话框 | ✅ |
|
||
| 操作 | 查看/编辑 | 更多操作下拉 | 扩展功能 | ✅ |
|
||
|
||
### 6.4 操作列按钮
|
||
|
||
| 按钮 | 颜色 | 显示条件 | 操作 | 验证 |
|
||
|------|------|----------|------|------|
|
||
| 查看 | success | 所有状态 | 打开查看页 | ✅ |
|
||
| 编辑 | primary | 开立/退回 | 打开编辑页 | ✅ |
|
||
| 删除 | danger | 开立/退回 | 确认后删除 | ✅ |
|
||
|
||
---
|
||
|
||
## 7. 页面交互规则（✅ Playwright 实际验证）
|
||
|
||
| 序号 | 交互场景 | 规则 | 验证 |
|
||
|------|----------|------|------|
|
||
| 1 | 页面首次加载 | 明细视图，83行，按日期降序 | ✅ |
|
||
| 2 | 明细→单据切换 | 表头/按钮/数据全切换，44行单据 | ✅ |
|
||
| 3 | 单据编码点击 | 跳转查看页 | ✅ |
|
||
| 4 | 新增→引入 | 弹窗「采购计划单明细」，10列，支持全选 | ✅ |
|
||
| 5 | 引入确定 | 物料行填充：跟单编号/计划单号/物料/需求日期/数量 | ✅ |
|
||
| 6 | 新增物料 | 子表末尾追加空行 | ✅ |
|
||
| 7 | 金额计算 | 数量×单价自动计算金额，合计行实时更新 | 截图确认 |
|
||
| 8 | 收起/展开 | 折叠/展开表头区域 | ✅ |
|
||
| 9 | 查看→编辑 | 查看页点击「编辑」切换到编辑模式 | ✅ |
|
||
| 10 | 编辑页撤回 | 撤回按钮撤销未保存修改 | ✅ 按钮确认 |
|
||
|
||
---
|
||
|
||
## 8. 接口调用说明
|
||
|
||
### 8.1 接口总览
|
||
|
||
| 序号 | 功能 | 方法 | 路径 | 说明 |
|
||
|------|------|------|------|------|
|
||
| 1 | 查询列表 | GET | /po/order/list | 分页查询 |
|
||
| 2 | 获取详情 | GET | /po/order | 获取表头+明细 |
|
||
| 3 | 新增 | POST | /po/order | 创建 |
|
||
| 4 | 修改 | PUT | /po/order | 更新 |
|
||
| 5 | 删除 | POST | /po/order/delete | 批量删除 |
|
||
| 6 | 审核 | POST | /po/order/check | 批量审核 |
|
||
| 7 | 反审核 | POST | /po/order/antiCheck | 批量反审核 |
|
||
| 8 | 导出 | GET | /po/order/export | 导出Excel |
|
||
| 9 | 选择供应商 | GET | /po/supplier/list | 供应商列表 |
|
||
| 10 | 引入采购计划 | GET | /po/order/lead 或 /po/order/leadInto | 采购计划单明细 |
|
||
| 11 | 明细查询 | GET | /po/order/linkDetail | 明细视图数据 |
|
||
| 12 | 获取编码 | GET | /po/order/genCode | 生成编码（推测） |
|
||
|
||
> 接口来源: ERP Swagger API (`/prod-api/v2/api-docs?group=采购模块`)
|
||
|
||
---
|
||
|
||
## 9. 状态流转
|
||
|
||
### 9.1 单据状态流转图
|
||
|
||
```
|
||
┌──────────────┐
|
||
│ │
|
||
┌─────────► 开立(DRAFT) ◄──────────┐
|
||
│ │ │ │
|
||
│ └──────┬───────┘ │
|
||
│ │ │
|
||
│ [审核操作] [反审核]
|
||
│ │ │
|
||
│ ▼ │
|
||
│ ┌──────────────┐ │
|
||
│ │ │ │
|
||
│ │ 审核(APPROVED)├───────────┘
|
||
│ │ │
|
||
│ └──────┬───────┘
|
||
│ │
|
||
│ [业务完成/关闭]
|
||
│ │
|
||
│ ▼
|
||
│ ┌──────────────┐
|
||
└──────────┤ │
|
||
│ 关闭(CLOSED) │
|
||
└──────────────┘
|
||
```
|
||
|
||
### 9.2 状态说明
|
||
|
||
| 状态 | 编码 | 可执行操作 | 说明 |
|
||
|------|------|-----------|------|
|
||
| 开立 | DRAFT | 编辑、保存、删除、审核 | 初始状态 |
|
||
| 审核 | APPROVED | 查看、反审核、生成到货单 | 生效状态 |
|
||
| 关闭 | CLOSED | 查看 | 业务完结 |
|
||
|
||
---
|
||
|
||
## 10. 业务规则
|
||
|
||
### 10.1 编码规则
|
||
|
||
| 项目 | 说明 |
|
||
|------|------|
|
||
| 前缀 | CGDD |
|
||
| 流水号 | 6位，不足补零 |
|
||
| 示例 | CGDD000041, CGDD000047 |
|
||
|
||
### 10.2 引入规则
|
||
|
||
| 规则 | 说明 |
|
||
|------|------|
|
||
| 数据来源 | 已审核的采购计划单中未采数量>0 的明细行 |
|
||
| 引入方式 | 支持勾选多行 + 全选 |
|
||
| 引入后 | 跟单编号、计划单号、物料信息、需求日期、数量自动填充 |
|
||
| 特殊 | 引入弹窗含「采购退货单」按钮，可切换到退货引入模式 |
|
||
|
||
### 10.2.1 手工（手动）新增物料规则
|
||
|
||
与「引入」互补，手工新增物料用于未从采购计划引入时直接添加物料行。
|
||
|
||
| 规则 | 说明 |
|
||
|------|------|
|
||
| 数据来源 | 无计划单/跟单来源；跟单编号/计划单号显示「手工单据」或「添加物料」 |
|
||
| 选择物料 | 须通过「选择物料」弹窗从物料主数据中选择，回填物料编码、物料名称、型号规格、主计量 |
|
||
| 用户填写 | 数量、单价、需求日期、采购说明由用户手工填写 |
|
||
| 金额计算 | 行金额 = 数量 × 单价，自动计算；合计行实时更新 |
|
||
| 操作入口 | 物料信息区域「+ 新增物料」按钮，新增/编辑状态下可用 |
|
||
|
||
> 操作流程与选择物料弹窗详见 [4.3.1 手工新增物料](#431-手工新增物料截图确认)。
|
||
|
||
### 10.3 金额规则
|
||
|
||
| 规则 | 说明 |
|
||
|------|------|
|
||
| 行金额 | 数量 × 单价，自动计算 |
|
||
| 合计行 | 子表底部合计行汇总数量、金额 |
|
||
| 总金额 | 表头 total_amount = 所有行金额之和 |
|
||
|
||
### 10.4 到货跟踪
|
||
|
||
| 规则 | 说明 |
|
||
|------|------|
|
||
| 到货数量 | 从到货单审核后回写到订单明细 |
|
||
| 业务状态 | 全部到货后自动变为「完成」 |
|
||
| 删除限制 | 有到货记录的订单不可删除 |
|
||
|
||
### 10.5 下游引用限制
|
||
|
||
| 场景 | 影响 |
|
||
|------|------|
|
||
| 有到货记录 | 不可反审核、不可删除 |
|
||
| 有发票记录 | 不可反审核、不可删除 |
|
||
| 无引用 | 可反审核、可删除（仅开立/退回） |
|
||
|
||
---
|
||
|
||
## 11. 前端组件设计
|
||
|
||
### 11.1 文件结构
|
||
|
||
```
|
||
src/
|
||
├── api/
|
||
│ └── po/
|
||
│ └── order.js # 采购订单API
|
||
├── views/
|
||
│ └── po/
|
||
│ └── order/
|
||
│ ├── index.vue # 列表页（明细+单据双视图）
|
||
│ ├── add.vue # 新增页
|
||
│ ├── edit.vue # 编辑页
|
||
│ ├── view.vue # 查看页
|
||
│ └── components/
|
||
│ ├── DetailViewTable.vue # 明细视图表格
|
||
│ ├── DocumentViewTable.vue # 单据视图表格
|
||
│ ├── OrderHeaderForm.vue # 表头表单
|
||
│ ├── OrderLineTable.vue # 物料明细子表（可编辑）
|
||
│ ├── SupplierSelectDialog.vue # 选择供应商弹窗
|
||
│ └── PlanImportDialog.vue # 引入采购计划单明细弹窗
|
||
```
|
||
|
||
### 11.2 路由配置
|
||
|
||
```javascript
|
||
{
|
||
path: '/po',
|
||
component: Layout,
|
||
children: [
|
||
{ path: 'purchase/order/plan', name: 'PoOrder', component: () => import('@/views/po/order/index'), meta: { title: '采购订单' } },
|
||
{ path: 'purchase/orderadd0', name: 'PoOrderAdd', component: () => import('@/views/po/order/add'), meta: { title: '新增采购订单' }, hidden: true },
|
||
{ path: 'purchase/orderedit0/:id', name: 'PoOrderEdit', component: () => import('@/views/po/order/edit'), meta: { title: '编辑采购订单' }, hidden: true },
|
||
{ path: 'purchase/orderview0/:id', name: 'PoOrderView', component: () => import('@/views/po/order/view'), meta: { title: '查看采购订单' }, hidden: true }
|
||
]
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
## 12. 数据模型
|
||
|
||
### 12.1 表关系图（ERP 侧）
|
||
|
||
```
|
||
┌──────────────────────────┐ ┌──────────────────────────┐
|
||
│ erp_po_supplier │ │ erp_mp_purchase │
|
||
│ (供应商档案 / ERP) │ │ (采购计划单) │
|
||
│ supplier_id (PK) │ └──────────┬───────────────┘
|
||
│ supplier_name │ │ plan_code, plan_line_id
|
||
│ supplier_code │ ▼
|
||
└──────────┬───────────────┘ ┌──────────────────────────────────────────────┐
|
||
│ supplier_id │ erp_po_order │
|
||
▼ │ (采购订单表头) │
|
||
┌──────────────────┤ order_id (PK) order_code (UK) │
|
||
│ │ supplier_id (FK→erp_po_supplier) │
|
||
│ │ total_quantity total_amount │
|
||
│ └──────────────────────┬───────────────────────┘
|
||
│ │ 1:N
|
||
│ ▼
|
||
│ ┌──────────────────────────────────────────────┐
|
||
│ │ erp_po_order_line │
|
||
│ │ (采购订单明细) │
|
||
│ │ line_id (PK) order_id (FK) │
|
||
│ │ item_id (FK→erp_md_item) │
|
||
│ │ plan_line_id (FK→erp_mp_purchase) │
|
||
│ │ quantity unit_price amount │
|
||
│ └──────────────────────┬───────────────────────┘
|
||
│ │ 被下游引用
|
||
│ ┌──────────────────┼──────────────────┐
|
||
│ ▼ ▼ ▼
|
||
│ ┌────────────────┐ ┌────────────────┐ ┌────────────────┐
|
||
│ │ erp_po_checkin │ │ erp_po_fapiao │ │ erp_po_reject │
|
||
│ │ (采购到货单) │ │ (采购发票) │ │ (采购退货单) │
|
||
│ └────────────────┘ └────────────────┘ └────────────────┘
|
||
```
|
||
|
||
### 12.2 ERP→MOM 表映射关系
|
||
|
||
> 数据来源: [erp与mom数据库表映射对照表](db/erp与mom数据库表映射对照表.md) 第 2.4、3.7、5.1~5.4 节
|
||
|
||
#### 12.2.1 供应商表映射（⚠️ 字段名差异较大）
|
||
|
||
| 项目 | ERP | MOM | 说明 |
|
||
|------|-----|-----|------|
|
||
| **表名** | **erp_po_supplier** | **md_vendor** | **表名完全不同** |
|
||
| 主键 | supplier_id | vendor_id | 名称不同 |
|
||
| 编码 | supplier_code | vendor_code | 名称不同 |
|
||
| 名称 | supplier_name | vendor_name | 名称不同 |
|
||
| 简称 | supplier_nick | vendor_nick | 名称不同 |
|
||
| 类型 | supplier_type | vendor_type | 名称不同 |
|
||
| 等级 | supplier_level | vendor_level | 名称不同 |
|
||
| 英文名 | - | vendor_en | MOM 专用 |
|
||
| 简介 | - | vendor_des | MOM 专用 |
|
||
| 评分 | - | vendor_score | MOM 专用 |
|
||
| Logo | - | vendor_logo | MOM 专用 |
|
||
| 开票地址 | bank_address | invoice_address | 名称不同 |
|
||
| 省份 | province | province | 一致 |
|
||
| 城市 | city | city | 一致 |
|
||
| 地址 | address | address | 一致 |
|
||
| 联系人1 | contact1 | contact1 | 一致 |
|
||
| 联系人1电话 | contact1_tel | contact1_tel | 一致 |
|
||
| 联系人1邮箱 | - | contact1_email | MOM 专用 |
|
||
| 银行 | bank_name | bank_name | 一致 |
|
||
| 账号 | bank_account | bank_account | 一致 |
|
||
| 税号 | tax_no | tax_no | 一致 |
|
||
| 供应料品 | supply_items | supply_items | 一致 |
|
||
| 启用 | enable_flag | enable_flag | 一致 |
|
||
|
||
> **开发注意**: 采购订单中 `supplier_id`/`supplier_name`/`supplier_code` 对应 ERP 的 erp_po_supplier 表。MOM 侧操作供应商时需使用 `vendor_id`/`vendor_name`/`vendor_code`（md_vendor 表），**接口字段名需做转换**。
|
||
|
||
#### 12.2.2 采购订单表映射
|
||
|
||
| ERP表名 | MOM表名 | 同步方式 | 说明 |
|
||
|---------|---------|----------|------|
|
||
| erp_po_order | **erp_po_order**（MOM 镜像表） | ERP→MOM 1:1 | 审核后同步，主键一致，含 erp_sync_time |
|
||
| erp_po_order_line | **erp_po_order_line**（MOM 镜像表） | ERP→MOM 1:1 | 明细行镜像 |
|
||
| erp_po_order | wm_arrival_notice (po_code) | ERP→MOM 业务映射 | 到货通知，order_code→po_code |
|
||
| erp_po_order_line | wm_arrival_notice_line | ERP→MOM 业务映射 | 到货明细 |
|
||
|
||
#### 12.2.3 采购订单→到货通知 关键字段映射
|
||
|
||
| ERP字段 (erp_po_order) | MOM字段 (wm_arrival_notice) | 映射方式 |
|
||
|------------------------|----------------------------|----------|
|
||
| order_code | po_code | 直接映射 |
|
||
| **supplier_id** | **vendor_id** | **字段名不同** |
|
||
| **supplier_code** | **vendor_code** | **字段名不同** |
|
||
| **supplier_name** | **vendor_name** | **字段名不同** |
|
||
| delivery_date | arrival_date | 字段名不同 |
|
||
| status | status | 值转换: DRAFT→PREPARE, APPROVED→CONFIRMED |
|
||
|
||
#### 12.2.4 采购订单明细→到货通知明细 关键字段映射
|
||
|
||
| ERP字段 (erp_po_order_line) | MOM字段 (wm_arrival_notice_line) | 映射方式 |
|
||
|-----------------------------|----------------------------------|----------|
|
||
| item_id | item_id | 直接映射 |
|
||
| item_code | item_code | 直接映射 |
|
||
| item_name | item_name | 直接映射 |
|
||
| specification | specification | 直接映射 |
|
||
| **unit_name** | **unit_of_measure** | **字段名不同** |
|
||
| **quantity** | **quantity_arrive** | **字段名不同**，采购数量→到货数量 |
|
||
| unit_price | - | **MOM 不需要**（不涉及价格） |
|
||
| amount | - | **MOM 不需要** |
|
||
| track_code | - | **MOM 不需要**（通过表头 po_code 关联） |
|
||
|
||
### 12.3 数据同步方向
|
||
|
||
```
|
||
ERP (erp_po_order/line) ──审核后同步──► MOM (erp_po_order/line 镜像表)
|
||
│
|
||
├──► MOM (wm_arrival_notice 到货通知)
|
||
│ po_code = order_code
|
||
│ vendor_id = supplier_id
|
||
│
|
||
└──► MOM (wm_item_recpt 入库单)
|
||
po_order_id → order_id
|
||
po_line_id → line_id
|
||
```
|
||
|
||
- **同步方向**: ERP → MOM（订单数据单向同步）
|
||
- **同步触发**: 采购订单审核后触发
|
||
- **供应商同步**: ERP erp_po_supplier → MOM md_vendor（字段名转换）
|
||
- **价格/金额**: MOM 不存储（ERP 专有），到货/入库仅关注数量
|
||
- **MOM 回写 ERP**: 到货数量、入库数量可反馈回 ERP 更新 arrived_quantity
|
||
|
||
---
|
||
|
||
## 附录A: 状态标签颜色映射
|
||
|
||
```javascript
|
||
const statusTagMap = {
|
||
'DRAFT': 'info', // 灰色 - 开立
|
||
'APPROVED': 'success', // 绿色 - 审核
|
||
'CLOSED': '', // 默认 - 关闭
|
||
'REJECTED': 'warning' // 橙色 - 退回
|
||
}
|
||
```
|
||
|
||
## 附录B: 权限标识汇总
|
||
|
||
| 权限标识 | 说明 | 视图 |
|
||
|----------|------|------|
|
||
| po:order:list | 列表查询 | 通用 |
|
||
| po:order:query | 详情查询 | 单据视图 |
|
||
| po:order:add | 新增 | 通用 |
|
||
| po:order:edit | 编辑 | 单据视图 |
|
||
| po:order:remove | 删除 | 单据视图 |
|
||
| po:order:approve | 审核 | 单据视图 |
|
||
| po:order:unapprove | 反审核 | 单据视图 |
|
||
| po:order:export | 导出 | 明细视图 |
|
||
|
||
## 附录C: Playwright 采集数据摘要
|
||
|
||
> 采集时间: 2026-02-07 16:27:52，脚本: `crawl_purchase_order.py`
|
||
|
||
| 页面 | 行数 | 按钮 | 表头列 |
|
||
|------|------|------|--------|
|
||
| 明细视图 | 83 | 搜索/单据/查询所有/新增/导出 | 序号/跟单编号/计划编号/单据编码/单据状态/供应商/物料名称/物料编码/需求日期/采购数量/到货数量/单据日期 |
|
||
| 单据视图 | 44 | 搜索/明细/查询所有/新增/删除/审核/反审核 | 单据编码/单据日期/单据状态/业务类型/采购部门/采购人员/业务状态/审核日期/操作 |
|
||
| 新增页 | 0+合计 | 保存/取消/审核/反审核/收起/引入/新增物料 | 序号/跟单编号/计划单号/物料编码/物料名称/型号规格/主计量/需求日期/数量/单价/金额/到货数量/采购说明/操作 |
|
||
| 引入弹窗 | - | 搜索/采购退货单/全选/确定/取消 | 计划单号/销售员/跟单编号/订单交期/物料编码/物料名称/需求日期/需求数量/已采数量/未采数量 |
|
||
| 查看页 | 3 | 新增/编辑/审核/反审核/打印/操作/收起 | 同新增页（无操作列） |
|
||
| 编辑页 | 3 | 保存/撤回/审核/反审核/操作/收起/引入/新增物料 | 同新增页 |
|
||
|
||
---
|
||
|
||
## 修订历史
|
||
|
||
| 版本 | 日期 | 修订内容 | 修订人 |
|
||
|------|------|----------|--------|
|
||
| 1.0.0 | 2026-02-07 | 初始版本：基于 Playwright V1 自动采集（13 个按钮/10 张截图）+ ERP 数据库设计 + 采购管理 PRD 编写完整页面开发说明 | System |
|
||
| **2.0.0** | **2026-02-07** | **V2 表单深度采集**：新增 7 张截图（新增页表头/查看页表头/查看页上一条/查看转编辑/选择供应商/引入弹窗详情/新增物料行）；更新 4.4 供应商弹窗（7列/79行/快速添加）；更新 4.6 查看页（按钮详情/上一条下一条/查看→编辑切换）；更新 4.7 编辑页（8按钮含撤回/子表行操作）；截图总计 17 张 | System |
|
||
| **2.1.0** | **2026-02-07** | **重写第 12 章数据模型**：基于《erp与mom数据库表映射对照表》补充供应商表 ERP(erp_po_supplier) vs MOM(md_vendor) 完整字段对照（⚠️ 字段名差异较大）；补充采购订单→到货通知/入库单的字段映射；补充数据同步方向与价格处理说明 | System |
|
||
| **2.2.0** | **2026-02-13** | **手工新增物料**：新增 4.3.1 手工新增物料（操作流程、选择物料弹窗、与引入的区分）；新增截图引用「采购订单-新增页-可新增物料.png」「采购订单-新增页-点击添加物料.png」；补充选择物料弹窗的筛选与列表说明 | System |
|
||
| **2.3.0** | **2026-02-13** | **版本更新与手工新增物料补全**：版本更新至 2.3.0；补全新功能说明，重点补全**手动/手工新增物料**在业务流程(0.3)、按钮说明(6.3)、业务规则(10.2.1)中的引用与规则；目录增加 4.3.1 手工（手动）新增物料；4.3.1 增加「手动新增物料」同义说明；截图总数更新为 19 张 | System |
|