1573 lines
78 KiB
Markdown
1573 lines
78 KiB
Markdown
# 生产订单（生产工单）- 页面设计开发说明文档
|
||
|
||
> 版本: 3.1.0
|
||
> 创建日期: 2026-02-13
|
||
> 更新日期: 2026-02-13
|
||
> 所属模块: 生产管理 > 生产订单
|
||
> 前端路由: `/mes/pro/workorder`（MOM 端）；`/production/work-order`（ERP 前端）
|
||
> **关联文档**: [erp与mom数据库表映射对照表](db/erp与mom数据库表映射对照表.md)；[MOM系统数据升级方案-销售采购生产计划](db/mom系统数据升级方案-销售采购生产计划.md)；[生产计划.md](生产计划.md)；[mom系统生产领料单-页面开发说明文档](mom系统生产领料单-页面开发说明文档.md)
|
||
|
||
---
|
||
|
||
## 目录
|
||
|
||
0. [业务流程总览](#0-业务流程总览)
|
||
1. [页面概述](#1-页面概述)
|
||
2. [页面结构](#2-页面结构)
|
||
3. [列表页设计](#3-列表页设计)
|
||
4. [新增/编辑页设计](#4-新增编辑页设计)
|
||
5. [数据字段定义](#5-数据字段定义)
|
||
6. [按钮操作说明](#6-按钮操作说明)
|
||
7. [页面交互规则](#7-页面交互规则)
|
||
8. [接口调用说明](#8-接口调用说明)
|
||
9. [状态流转](#9-状态流转)
|
||
10. [业务规则](#10-业务规则)
|
||
11. [前端组件设计](#11-前端组件设计)
|
||
12. [数据模型](#12-数据模型)
|
||
|
||
---
|
||
|
||
## 0. 业务流程总览
|
||
|
||
### 0.1 生产订单在 MOM/ERP 中的定位
|
||
|
||
生产订单（生产工单）是 **生产计划 → 生产执行** 链条中的核心节点。生产计划单经过 BOM 运算并下发后，用户通过选择已审核的生产计划单来创建生产工单，工单驱动后续的生产任务排产、领料、报工、完工入库等生产执行环节。
|
||
|
||
> **重要约束**: 生产订单只能来源于生产计划单，不支持手动创建或从销售订单直接创建。新增生产订单时必须选择一个已审核的生产计划单，系统自动带入产品、客户、数量等信息。
|
||
|
||
```
|
||
┌──────────────┐ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐
|
||
│ 销售订单 │────►│ 生产计划单 │────►│ BOM运算/下发 │────►│ 物料清单MBOM │
|
||
│ (销售确认) │ │ (引入订单) │ │ (展开需求) │ │ (生产件等) │
|
||
└──────────────┘ └──────────────┘ └──────────────┘ └──────┬───────┘
|
||
│
|
||
选择计划单，创建工单
|
||
▼
|
||
┌──────────────┐ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐
|
||
│ 完工入库 │◄────│ 生产报工 │◄────│ 生产任务 │◄────│ ★ 生产工单 │
|
||
│ (库存增加) │ │ (工序报工) │ │ (排产执行) │ │ (当前页面) │
|
||
└──────────────┘ └──────────────┘ └──────────────┘ └──────┬───────┘
|
||
│
|
||
一键领料 / 手动领料
|
||
▼
|
||
┌──────────────┐
|
||
│ 生产领料单 │
|
||
│ (物料出库) │
|
||
└──────────────┘
|
||
```
|
||
|
||
### 0.2 端到端业务流程图
|
||
|
||
```
|
||
销售订单确认
|
||
│
|
||
▼
|
||
┌─────────────────┐ 引入订单 ┌─────────────────┐
|
||
│ 生产计划单 │ ◄───────────────── │ 销售订单/备货单 │
|
||
│ - 订单信息子表 │ │ │
|
||
└────────┬────────┘ └─────────────────┘
|
||
│ BOM运算、下发、审核
|
||
▼
|
||
┌─────────────────┐ 选择计划单号 ┌─────────────────┐
|
||
│ 已审核计划单 │ ──────────────── ► │ ★ 生产工单 │
|
||
│ - 产品信息 │ 自动带入产品/客户 │ - 工艺路线 │
|
||
│ - 生产数量 │ │ - BOM物料组成 │
|
||
└─────────────────┘ └────────┬────────┘
|
||
│
|
||
┌──────────────────────┤
|
||
│ │
|
||
▼ ▼
|
||
┌─────────────────┐ ┌─────────────────┐
|
||
│ 生产领料单 │ │ 生产任务 │
|
||
│ 一键领料/手动 │ │ - 工序排产 │
|
||
└────────┬────────┘ └────────┬────────┘
|
||
│ 出库 │ 报工
|
||
▼ ▼
|
||
┌─────────────────┐ ┌─────────────────┐
|
||
│ 库存扣减 │ │ 生产报工 │
|
||
└─────────────────┘ └────────┬────────┘
|
||
│ 完工
|
||
▼
|
||
┌─────────────────┐
|
||
│ 完工入库 │
|
||
│ - 产成品入库 │
|
||
└─────────────────┘
|
||
```
|
||
|
||
### 0.3 生产工单内部业务流程
|
||
|
||
| 阶段 | 操作 | 触发条件 | 结果 |
|
||
|------|------|----------|------|
|
||
| 1. 新建 | 点击「新增」 | 始终可用 | 打开新增页，状态=草稿(PREPARE) |
|
||
| 2. 选择计划单 | 选择生产计划单号 | 新增状态 | 弹窗选择已审核的生产计划单，自动带入产品、客户、数量等信息；自动根据产品 BOM 生成 BOM 物料组成行 |
|
||
| 3. 选择工艺路线 | 选择工艺路线 | 新增/编辑状态 | 弹窗选择产品对应的工艺路线，记录路线编码/名称 |
|
||
| 4. 填写信息 | 填写工单编码、工单名称、生产日期等 | 新增/编辑状态 | 可保存 |
|
||
| 5. 保存 | 点击「保存」 | 表单校验通过 | 数据持久化，自动生成 BOM 物料行 |
|
||
| 6. 确认/审核 | 点击确认 | 草稿状态，已保存 | 工单状态→已确认(CONFIRMED)，可进行排产和领料 |
|
||
| 7. 领料 | **一键领料**或**手动创建领料单** | 已确认状态，有 BOM 物料 | 一键领料：自动创建领料单并填充 BOM 物料行；手动领料：跳转领料单新增页 |
|
||
| 8. 排产 | 创建生产任务 | 已确认状态 | 生成生产任务，分配工序和工作站 |
|
||
| 9. 完工 | 点击「完工」 | 生产中/已确认状态 | 工单状态→已完成(FINISHED)，记录完成时间 |
|
||
| 10. 取消 | 点击「取消」 | 草稿/已确认状态 | 工单状态→已取消(CANCELED)，记录取消时间 |
|
||
| 11. 删除 | 点击「删除」 | 仅草稿(PREPARE)状态 | 物理删除工单及关联 BOM 行 |
|
||
|
||
### 0.4 上下游单据关系
|
||
|
||
| 上游单据 | 关联字段 | 说明 |
|
||
|----------|----------|------|
|
||
| 生产计划单 | source_code (计划单号) | **唯一来源**，新增时通过选择计划单弹窗关联 |
|
||
| 销售订单 | client_id, client_code, client_name | 客户信息，由生产计划自动带入 |
|
||
| 产品BOM | product_id | 产品的 BOM 组成自动展开为工单 BOM 行 |
|
||
| 工艺路线 | route_id, route_code, route_name | 选择产品对应的工艺路线 |
|
||
|
||
| 下游单据 | 关联字段 | 说明 |
|
||
|----------|----------|------|
|
||
| 生产领料单(wm_issue_header) | workorder_id, workorder_code | 一键领料或手动创建领料单 |
|
||
| 生产任务(pro_task) | workorder_id | 工单排产后生成的生产任务 |
|
||
| 完工入库单 | workorder_id | 产成品入库关联工单 |
|
||
|
||
### 0.5 工单类型（workorderType）
|
||
|
||
| 值 | 标签 | 说明 |
|
||
|----|------|------|
|
||
| SELF | 自产 | 企业自行生产（默认） |
|
||
| OUTSOURCE | 委外 | 委托外部供应商生产 |
|
||
|
||
### 0.6 来源类型（orderSource）
|
||
|
||
| 值 | 标签 | 说明 |
|
||
|----|------|------|
|
||
| PLAN | 生产计划 | 由生产计划单创建（**唯一来源**） |
|
||
|
||
> **注意**: 生产订单只支持从已审核的生产计划单创建，不支持手动创建或从销售订单直接创建。来源类型固定为 `PLAN`。
|
||
|
||
### 0.7 关键数量逻辑
|
||
|
||
| 数量字段 | 含义 | 计算/来源 |
|
||
|----------|------|-----------|
|
||
| 生产数量(quantity) | 计划生产数量 | 从生产计划单带入，可修改 |
|
||
| 已生产数量(quantityProduced) | 已完成报工数量 | 生产报工回写，只读 |
|
||
| 调整数量(quantityChanged) | 调整差额 | 手动调整时产生 |
|
||
| 已排产数量(quantityScheduled) | 已创建生产任务的数量 | 排产后回写，只读 |
|
||
|
||
### 0.8 领料方式说明
|
||
|
||
生产工单支持两种领料方式：
|
||
|
||
| 方式 | 操作 | 说明 |
|
||
|------|------|------|
|
||
| **一键领料** | 工单查看页点击「一键领料」按钮 | 系统自动根据工单 BOM 物料组成创建一张领料单（wm_issue_header），并将所有 BOM 物料自动填入领料行（wm_issue_line），领料数量=BOM 预计使用量。创建后跳转到领料单编辑页，用户可调整后执行出库 |
|
||
| **手动领料** | 工单查看页点击「创建领料单」按钮 | 跳转到生产领料单新增页面，自动携带工单 ID 和工单编码，用户手动选择物料并填写领料数量 |
|
||
|
||
### 0.9 典型操作路径（用户故事）
|
||
|
||
| 场景 | 路径 |
|
||
|------|------|
|
||
| **新建生产工单** | 列表 → 新增 → 选择计划单号（自动带入产品/客户） → 选择工艺路线 → 填写编码/名称/日期 → 保存 |
|
||
| **查看工单详情** | 列表 → 点击工单编码或操作列「查看」 → 查看页（只读） |
|
||
| **一键领料** | 列表 → 查看已确认工单 → 点击「一键领料」→ 自动创建领料单 → 跳转领料单编辑页 → 调整数量 → 执行出库 |
|
||
| **手动领料** | 列表 → 查看已确认工单 → 点击「创建领料单」→ 跳转领料单新增页（自动关联工单） → 添加物料 → 保存 → 执行出库 |
|
||
| **排产执行** | 列表 → 查看已确认工单 → 创建生产任务 → 分配工作站 |
|
||
| **完工结案** | 列表 → 查看工单 → 确认已生产数量 → 完工 |
|
||
| **取消工单** | 列表 → 查看草稿/已确认工单 → 取消 |
|
||
|
||
---
|
||
|
||
## 1. 页面概述
|
||
|
||
### 1.1 功能说明
|
||
|
||
生产订单（生产工单）页面用于管理企业的生产制造任务。生产工单来源于已审核的生产计划单，用户通过选择计划单号创建工单，系统自动带入产品信息和 BOM 物料组成。一张工单对应一个产品的一次生产任务，包含产品信息、工艺路线、生产数量、生产日期、BOM 物料组成等关键信息。工单确认后可进行一键领料或手动创建领料单，也可进行排产、报工、完工等操作。
|
||
|
||
### 1.2 业务场景
|
||
|
||
- **计划驱动生产**: 新增工单时选择已审核的生产计划单，自动带入产品、客户、数量等信息
|
||
- **选择工艺路线**: 工单表头可选择产品对应的工艺路线，指导后续工序排产
|
||
- **一键领料**: 工单确认后点击「一键领料」，系统自动根据 BOM 物料创建领料单
|
||
- **手动创建领料单**: 工单确认后点击「创建领料单」，跳转到领料单新增页手动添加物料
|
||
- **委外加工**: 支持委外类型工单，关联供应商信息
|
||
- **生产执行跟踪**: 记录生产数量、已生产数量、已排产数量，便于跟踪执行进度
|
||
|
||
### 1.3 页面截图参考
|
||
|
||
| 截图文件 | 说明 |
|
||
|----------|------|
|
||
| `screenshot/生产订单-列表页.png` | 列表页 - 工单列表，含搜索区、工具栏、数据表格 |
|
||
| `screenshot/生产订单-新增页.png` | 新增页 - 选择计划单后的表头表单 + BOM 物料组成子表 |
|
||
| `screenshot/生产订单-查看页.png` | 查看页 - 只读模式，含一键领料/创建领料单按钮 |
|
||
|
||
---
|
||
|
||
## 2. 页面结构
|
||
|
||
### 2.1 整体布局
|
||
|
||
```
|
||
┌─────────────────────────────────────────────────────────────────┐
|
||
│ 顶部导航栏 (64px) │
|
||
├────────┬────────────────────────────────────────────────────────┤
|
||
│ 左侧 │ 面包屑: 首页 / 生产管理 / 生产订单 │
|
||
│ 菜单 │ ┌────────────────────────────────────────────────┐ │
|
||
│ (200px │ │ Tab标签: ● 生产订单 │ │
|
||
│ /64px)│ ├────────────────────────────────────────────────┤ │
|
||
│ │ │ 查询区域 (搜索条件) │ │
|
||
│ 生产管 │ ├────────────────────────────────────────────────┤ │
|
||
│ 理 │ │ 工具栏 (操作按钮) │ │
|
||
│ ├生产 │ ├────────────────────────────────────────────────┤ │
|
||
│ 订单★ │ │ 数据表格 │ │
|
||
│ ├生产 │ │ │ │
|
||
│ 任务 │ ├────────────────────────────────────────────────┤ │
|
||
│ ├生产 │ │ 分页组件 │ │
|
||
│ 领料 │ └────────────────────────────────────────────────┘ │
|
||
├────────┴────────────────────────────────────────────────────────┤
|
||
```
|
||
|
||
### 2.2 页面模式
|
||
|
||
| 模式 | 说明 | 入口 |
|
||
|------|------|------|
|
||
| 列表页 | 默认视图，展示生产工单列表 | 菜单点击「生产订单」 |
|
||
| 新增页 | 新建生产工单，选择计划单号+选择工艺路线+填写表头 | 列表页点击「新增」按钮 |
|
||
| 编辑页 | 修改已有生产工单（仅草稿状态） | 列表页操作列点击「编辑」 |
|
||
| 查看页 | 只读查看工单详情，含 BOM 物料、一键领料/创建领料单按钮 | 列表页操作列点击「查看」或点击工单编码 |
|
||
|
||
---
|
||
|
||
## 3. 列表页设计
|
||
|
||
### 3.1 搜索条件区域
|
||
|
||
| 序号 | 字段名 | 标签 | 组件类型 | 宽度 | 说明 |
|
||
|------|--------|------|----------|------|------|
|
||
| 1 | workorderCode | 工单编码 | el-input | 160px | 模糊搜索 |
|
||
| 2 | workorderName | 工单名称 | el-input | 160px | 模糊搜索 |
|
||
| 3 | workorderType | 工单类型 | el-select | 120px | 下拉选择：自产/委外 |
|
||
| 4 | sourceCode | 计划单号 | el-input | 140px | 模糊搜索来源计划单号 |
|
||
| 5 | productCode | 产品编号 | el-input | 140px | 模糊搜索 |
|
||
| 6 | productName | 产品名称 | el-input | 160px | 模糊搜索 |
|
||
| 7 | status | 工单状态 | el-select | 120px | 下拉选择 |
|
||
| 8 | beginDate | 开始日期 | el-date-picker | 140px | 生产日期范围起 |
|
||
| 9 | endDate | 结束日期 | el-date-picker | 140px | 生产日期范围止 |
|
||
| 10 | - | 搜索 | el-button (primary) | - | 执行搜索 |
|
||
| 11 | - | 重置 | el-button (default) | - | 清空搜索条件 |
|
||
|
||
### 3.2 工具栏按钮
|
||
|
||
| 序号 | 按钮名称 | 图标 | 类型 | 权限标识 | 说明 |
|
||
|------|----------|------|------|----------|------|
|
||
| 1 | 新增 | el-icon-plus | success | mes:pro:workorder:add | 打开新增生产工单页面 |
|
||
| 2 | 修改 | el-icon-edit | primary | mes:pro:workorder:edit | 修改选中工单（需勾选） |
|
||
| 3 | 删除 | el-icon-delete | danger | mes:pro:workorder:remove | 批量删除选中工单（需勾选） |
|
||
| 4 | 导出 | el-icon-download | warning | mes:pro:workorder:export | 导出工单列表到Excel |
|
||
|
||
### 3.3 数据表格列定义
|
||
|
||
| 序号 | 列标题 | 字段名 | 宽度 | 对齐 | 说明 |
|
||
|------|--------|--------|------|------|------|
|
||
| 0 | (复选框) | - | 55px | center | 多选列，用于批量操作 |
|
||
| 1 | 工单编码 | workorderCode | 150px | left | 蓝色链接可点击打开详情 |
|
||
| 2 | 工单名称 | workorderName | 200px | left | 工单名称 |
|
||
| 3 | 工单类型 | workorderType | 80px | center | 自产/委外 |
|
||
| 4 | 计划单号 | sourceCode | 140px | left | 来源生产计划单号 |
|
||
| 5 | 工艺路线 | routeName | 120px | left | 工艺路线名称 |
|
||
| 6 | 产品编号 | productCode | 140px | left | 产品编号 |
|
||
| 7 | 产品名称 | productName | 200px | left | 产品名称 |
|
||
| 8 | 规格型号 | productSpc | 150px | left | 产品规格型号 |
|
||
| 9 | 单位 | unitOfMeasure | 60px | center | 计量单位 |
|
||
| 10 | 生产数量 | quantity | 100px | right | 计划生产数量 |
|
||
| 11 | 已生产 | quantityProduced | 100px | right | 已完成报工数量 |
|
||
| 12 | 已排产 | quantityScheduled | 100px | right | 已排产数量 |
|
||
| 13 | 客户名称 | clientName | 150px | left | 客户名称（可为空） |
|
||
| 14 | 生产日期 | productionDate | 120px | center | 计划生产日期 |
|
||
| 15 | 状态 | status | 80px | center | 状态标签（颜色区分） |
|
||
| 16 | 操作 | - | 240px | center | 操作按钮组 |
|
||
|
||
### 3.4 操作列按钮
|
||
|
||
操作列按钮根据工单状态动态显隐：
|
||
|
||
**status = PREPARE（草稿）:**
|
||
|
||
| 按钮 | 颜色 | 权限 | 说明 |
|
||
|------|------|------|------|
|
||
| 查看 | success (绿色文字) | mes:pro:workorder:query | 打开查看页（只读） |
|
||
| 编辑 | primary (蓝色文字) | mes:pro:workorder:edit | 打开编辑页 |
|
||
| 确认 | success (绿色文字) | mes:pro:workorder:edit | 确认工单，状态→已确认(CONFIRMED) |
|
||
| 删除 | danger (红色文字) | mes:pro:workorder:remove | 确认后删除 |
|
||
|
||
**status = CONFIRMED（已确认）/ APPROVED（已审核）:**
|
||
|
||
| 按钮 | 颜色 | 权限 | 说明 |
|
||
|------|------|------|------|
|
||
| 查看 | success (绿色文字) | mes:pro:workorder:query | 打开查看页 |
|
||
| 一键领料 | primary (蓝色文字) | mes:wm:issueheader:add | 自动创建领料单 |
|
||
| 完工 | warning (橙色文字) | mes:pro:workorder:edit | 工单完工 |
|
||
| 取消 | danger (红色文字) | mes:pro:workorder:edit | 取消工单 |
|
||
|
||
**status = FINISHED（已完成）/ CANCELED（已取消）:**
|
||
|
||
| 按钮 | 颜色 | 权限 | 说明 |
|
||
|------|------|------|------|
|
||
| 查看 | success (绿色文字) | mes:pro:workorder:query | 打开查看页（只读） |
|
||
|
||
### 3.5 分页组件
|
||
|
||
| 属性 | 值 | 说明 |
|
||
|------|------|------|
|
||
| 默认每页条数 | 10 | 可选: 10, 20, 50, 100 |
|
||
| 布局 | total, sizes, prev, pager, next, jumper | 完整分页 |
|
||
| 总条数显示 | 共 {total} 条 | 右侧显示 |
|
||
|
||
---
|
||
|
||
## 4. 新增/编辑页设计
|
||
|
||
### 4.1 页面布局
|
||
|
||
新增/编辑页面为独立的全屏页面（非弹窗），包含表头表单区、BOM 物料组成表格区、领料明细区和完工明细区。
|
||
|
||
> **截图参考**: `screenshot/生产管理-生产工单表单-查看操作等.png` — 查看页完整布局，含所有操作按钮和三个子表区域。
|
||
|
||
```
|
||
┌──────────────────────────────────────────────────────────────────────────────────────┐
|
||
│ 生产订单 [新增][编辑][审核][反审核][打印][操作▼][收起] │
|
||
│ 操作下拉: 挂起/关闭/调整工期/调整产线 │
|
||
├──────────────────────────────────────────────────────────────────────────────────────┤
|
||
│ 表头表单区 (5列布局，可折叠) │
|
||
│ ┌──────────┬──────────┬──────────┬──────────┬──────────┐ │
|
||
│ │ 单据编码 │ 业务类型 │ 计划单号 │ 物料编码 │ 图纸号 │ │
|
||
│ │ 单据日期 │ 操作员 │ 跟单编号 │ 物料名称 │ 工艺路线 │ │
|
||
│ │ 单据状态 │ 审核员 │ 订单交期 │ 生产总数 │ 生产线 │ │
|
||
│ │ 业务状态 │ 审核日期 │ 需求日期 │ 备注信息 │ 生产日期 │ │
|
||
│ │ │ │ │ │ 加工时长 │ │
|
||
│ └──────────┴──────────┴──────────┴──────────┴──────────┘ │
|
||
├──────────────────────────────────────────────────────────────────────────────────────┤
|
||
│ [订单信息子表] 序号│物料编码│物料名称│主计量│生产数量│质量要求│备注 │
|
||
├──────────────────────────────────────────────────────────────────────────────────────┤
|
||
│ 领料明细 [一键领料][+ 领料] │
|
||
│ 序号│跟单编号│单据编码│单据状态│业务状态│生产订单号│物料编码│物料名称│领用数量│出库数量│日期 │
|
||
├──────────────────────────────────────────────────────────────────────────────────────┤
|
||
│ 完工明细 [一键报工][+ 报工] │
|
||
│ 序号│跟单编号│单据编码│单据状态│业务状态│生产订单号│物料编码│物料名称│完工数量│质量│日期 │
|
||
└──────────────────────────────────────────────────────────────────────────────────────┘
|
||
```
|
||
|
||
### 4.2 表头表单字段
|
||
|
||
表头采用 5 列栅格布局（参照截图），每行 5 个字段。
|
||
|
||
> **截图对照**: 截图中表头为 5 列，第 5 列包含图纸号、工艺路线、生产线、生产日期、加工时长等字段。
|
||
|
||
| 序号 | 字段名 | 标签 | 组件类型 | 必填 | 默认值 | 可编辑 | 说明 |
|
||
|------|--------|------|----------|------|--------|--------|------|
|
||
| **第1列** | | | | | | | |
|
||
| 1 | workorderCode | 单据编码 | el-input | 是 | 系统自动生成 | 否(只读) | 后端通过 `AutoCodeUtil.genSerialCode(WORKORDER_CODE)` 自动生成 |
|
||
| 2 | orderDate | 单据日期 | el-date-picker | 是 | 当天 | 是 | 工单创建日期 |
|
||
| 3 | status | 单据状态 | el-tag | - | PREPARE | 否(只读) | 状态标签显示 |
|
||
| 4 | businessStatus | 业务状态 | el-select | 是 | 正常 | 是 | 正常/暂停/取消 |
|
||
| **第2列** | | | | | | | |
|
||
| 5 | businessType | 业务类型 | el-select | 是 | - | 是 | 加工车间等（截图示例值："加工车间"） |
|
||
| 6 | operatorName | 操作员 | el-input | - | 当前用户 | 否(只读) | 自动填充当前登录用户 |
|
||
| 7 | approverName | 审核员 | el-input | - | - | 否(只读) | 审核时自动填充 |
|
||
| 8 | approveDate | 审核日期 | el-date-picker | - | - | 否(只读) | 审核时自动填充 |
|
||
| **第3列** | | | | | | | |
|
||
| 9 | sourceCode | 计划单号 | el-input + 选择按钮 | 是 | - | 是(新增) | **选择生产计划单弹窗**，选择后自动带入产品/客户信息 |
|
||
| 10 | salesOrderCode | 跟单编号 | el-input | - | - | 否(只读) | 选择计划单后自动带入的销售订单号 |
|
||
| 11 | deliveryDate | 订单交期 | el-date-picker | - | - | 否(只读) | 选择计划单后自动带入 |
|
||
| 12 | requestDate | 需求日期 | el-date-picker | 否 | - | 是 | 物料需求日期 |
|
||
| **第4列** | | | | | | | |
|
||
| 13 | productCode | 物料编码 | el-input | - | - | 否(只读) | 选择计划单后自动带入 |
|
||
| 14 | productName | 物料名称 | el-input | - | - | 否(只读) | 选择计划单后自动带入 |
|
||
| 15 | quantity | 生产总数 | el-input-number + 单位 | 是 | 0 | 是 | 从计划单带入可修改，必须>0；右侧显示单位 |
|
||
| 16 | remark | 备注信息 | el-input(textarea) | 否 | - | 是 | 多行文本 |
|
||
| **第5列** | | | | | | | |
|
||
| 17 | drawingNo | 图纸号 | el-input | 否 | - | 是 | 产品图纸编号 |
|
||
| 18 | routeName | 工艺路线 | el-input + 选择按钮 | 否 | - | 是 | **选择工艺路线弹窗**，显示格式如"铆钉=>焊接" |
|
||
| 19 | productionLine | 生产线 | el-select | 否 | - | 是 | 选择生产线/车间（如"2# 底架加工线"） |
|
||
| 20 | productionDate | 生产日期 | el-date-picker(datetime) | 是 | 当天 | 是 | 计划生产日期时间 |
|
||
| 21 | processTime | 加工时长 | el-input-number + "分钟" | 否 | - | 是 | 预计加工时长（分钟） |
|
||
|
||
**业务类型选项（businessType）:**
|
||
|
||
| 值 | 标签 |
|
||
|----|------|
|
||
| SELF | 自产 |
|
||
| OUTSOURCE | 委外 |
|
||
| PROCESSING | 加工车间 |
|
||
|
||
**业务状态选项（businessStatus）:**
|
||
|
||
| 值 | 标签 |
|
||
|----|------|
|
||
| NORMAL | 正常 |
|
||
| PAUSE | 暂停 |
|
||
| CANCEL | 取消 |
|
||
|
||
### 4.3 订单信息子表（BOM 物料组成）
|
||
|
||
> **截图对照**: 截图中标题为无标题表格区域，列为：序号、物料编码、物料名称、主计量、生产数量、质量要求、备注
|
||
|
||
订单信息子表位于表头下方，展示工单关联的产品/物料信息。选择计划单号并保存后系统自动根据产品 BOM 展开生成物料行。
|
||
|
||
| 序号 | 列标题 | 字段名 | 宽度 | 组件类型 | 说明 |
|
||
|------|--------|--------|------|----------|------|
|
||
| 1 | 序号 | - | 60px | 自动编号 | 行序号，自动递增 |
|
||
| 2 | 物料编码 | itemCode | 150px | el-input | 只读，自动生成 |
|
||
| 3 | 物料名称 | itemName | 200px | el-input | 只读，含型号规格 |
|
||
| 4 | 主计量 | unitName | 80px | el-input | 只读 |
|
||
| 5 | 生产数量 | quantity | 120px | el-input-number | 可编辑（新增/编辑模式） |
|
||
| 6 | 质量要求 | qualityReq | 150px | el-input | 可编辑，如"国产一级品" |
|
||
| 7 | 备注 | remark | 150px | el-input | 可编辑 |
|
||
|
||
> **BOM 生成机制**: 后端 `ProWorkorderController.add()` 在保存工单后调用 `generateBomLine(workorderId)` 方法，该方法根据 `productId` 查找 `md_product_bom` 表获取产品 BOM 组成，然后按 `生产数量 × BOM单位用量` 计算每个物料的预计使用量，写入 `pro_workorder_bom` 表。修改工单时若产品或数量变化，自动删除旧 BOM 行并重新生成。物料行不支持手动添加/删除。
|
||
>
|
||
> **前端加载 BOM 列表**: 使用 `GET /mes/pro/workorderbom/list?workorderId={id}` 接口（`ProWorkorderBomController`）获取工单的**直接 BOM 组成行**，返回的是 `ProWorkorderBom` 实体，字段名与前端 `WorkOrderBom` 接口直接对应（`itemCode`、`itemName`、`itemSpc`、`unitOfMeasure`、`unitName`、`itemOrProduct`、`quantity`）。
|
||
>
|
||
> **注意**: 不要使用 `GET /mes/pro/workorder/listItems` 接口加载表单 BOM 子表。`listItems` 是递归展开到最底层物料并合并同编码数量的接口，返回的是 `MdProductBom` 格式（字段名为 `bomItemCode`/`bomItemName` 等），适用于物料需求分析场景，不适用于展示直接 BOM 组成。
|
||
|
||
### 4.4 领料明细子表
|
||
|
||
> **截图对照**: 截图中标题为"领料明细"，右上角有「一键领料」和「+ 领料」按钮。
|
||
|
||
领料明细子表展示该工单关联的所有生产领料单记录（只读），数据来源为 `wm_issue_header` + `wm_issue_line` 按 `workorder_id` 关联查询。
|
||
|
||
| 序号 | 列标题 | 字段名 | 宽度 | 说明 |
|
||
|------|--------|--------|------|------|
|
||
| 1 | 序号 | - | 60px | 自动编号 |
|
||
| 2 | 跟单编号 | salesOrderCode | 120px | 销售订单号 |
|
||
| 3 | 单据编码 | issueCode | 140px | 领料单编码 |
|
||
| 4 | 单据状态 | issueStatus | 80px | 领料单状态 |
|
||
| 5 | 业务状态 | businessStatus | 80px | 业务状态 |
|
||
| 6 | 生产订单号 | workorderCode | 140px | 关联的工单编码 |
|
||
| 7 | 物料编码 | itemCode | 140px | 领料物料编码 |
|
||
| 8 | 物料名称 | itemName | 180px | 领料物料名称 |
|
||
| 9 | 领用数量 | quantityIssued | 100px | 计划领料数量 |
|
||
| 10 | 出库数量 | quantityOut | 100px | 实际出库数量 |
|
||
| 11 | 单据日期 | issueDate | 120px | 领料日期 |
|
||
|
||
**数据加载**: 查看页加载工单详情后，按 `workorderId` 查询关联的领料明细记录。
|
||
|
||
### 4.5 完工明细子表
|
||
|
||
> **截图对照**: 截图中标题为"完工明细"，右上角有「一键报工」和「+ 报工」按钮。
|
||
|
||
完工明细子表展示该工单关联的所有完工/报工记录（只读）。
|
||
|
||
| 序号 | 列标题 | 字段名 | 宽度 | 说明 |
|
||
|------|--------|--------|------|------|
|
||
| 1 | 序号 | - | 60px | 自动编号 |
|
||
| 2 | 跟单编号 | salesOrderCode | 120px | 销售订单号 |
|
||
| 3 | 单据编码 | recordCode | 140px | 报工单编码 |
|
||
| 4 | 单据状态 | recordStatus | 80px | 报工单状态 |
|
||
| 5 | 业务状态 | businessStatus | 80px | 业务状态 |
|
||
| 6 | 生产订单号 | workorderCode | 140px | 关联的工单编码 |
|
||
| 7 | 物料编码 | itemCode | 140px | 物料编码 |
|
||
| 8 | 物料名称 | itemName | 180px | 物料名称 |
|
||
| 9 | 完工数量 | quantityFinished | 100px | 完工数量 |
|
||
| 10 | 质量 | qualityResult | 80px | 质量检验结果 |
|
||
| 11 | 单据日期 | recordDate | 120px | 报工日期 |
|
||
|
||
**数据加载**: 查看页加载工单详情后，按 `workorderId` 查询关联的完工/报工记录。
|
||
|
||
### 4.6 选择生产计划单弹窗
|
||
|
||
点击计划单号旁的「选择」按钮，打开生产计划单选择弹窗。
|
||
|
||
| 属性 | 值 |
|
||
|------|------|
|
||
| 弹窗标题 | 选择生产计划单 |
|
||
| 弹窗宽度 | 1000px |
|
||
| 弹窗高度 | 自适应，最大70vh |
|
||
| 选择模式 | 单选 |
|
||
| 数据筛选 | 仅显示已审核(APPROVED)的生产计划单 |
|
||
|
||
**弹窗搜索区:**
|
||
|
||
| 组件 | 说明 |
|
||
|------|------|
|
||
| 计划单号 | 模糊搜索计划编码 |
|
||
| 销售订单号 | 模糊搜索关联的销售订单号 |
|
||
| 物料名称 | 模糊搜索产品名称 |
|
||
| 搜索按钮 | primary 类型，执行搜索 |
|
||
| 重置按钮 | 清空条件并刷新列表 |
|
||
|
||
**弹窗列表结构:**
|
||
|
||
| 列 | 字段 | 说明 |
|
||
|----|------|------|
|
||
| (单选) | - | 单选列 |
|
||
| 计划单号 | planCode | 生产计划编码 |
|
||
| 单据日期 | planDate | 计划日期 |
|
||
| 销售订单号 | salesOrderCode | 关联的销售订单号 |
|
||
| 业务人员 | salesUserName | 业务人员名称 |
|
||
| 产品编码 | itemCode | 首行物料编码（主产品） |
|
||
| 产品名称 | itemName | 首行物料名称 |
|
||
| 数量 | totalQuantity | 生产总量 |
|
||
| 订单交期 | deliveryDate | 交货日期 |
|
||
|
||
**选择交互:**
|
||
- 单选一条计划单记录，点击「确定」按钮
|
||
- 选择后自动填充表头字段：
|
||
- `sourceCode` ← planCode（计划单号）
|
||
- `productId` / `productCode` / `productName` / `productSpc` ← 计划单首行产品信息
|
||
- `unitOfMeasure` ← 计划单首行单位
|
||
- `quantity` ← 计划单 totalQuantity
|
||
- `clientId` / `clientCode` / `clientName` ← 计划单关联的客户信息（来自销售订单）
|
||
- `orderSource` ← 自动设为 "PLAN"
|
||
- 保存时后端自动根据产品 BOM 生成 BOM 物料组成行
|
||
|
||
### 4.7 选择工艺路线弹窗
|
||
|
||
点击工艺路线旁的「选择」按钮，打开工艺路线选择弹窗。
|
||
|
||
| 属性 | 值 |
|
||
|------|------|
|
||
| 弹窗标题 | 选择工艺路线 |
|
||
| 弹窗宽度 | 800px |
|
||
| 弹窗高度 | 自适应，最大60vh |
|
||
| 选择模式 | 单选 |
|
||
| 数据筛选 | 仅显示已启用(enableFlag=Y)的工艺路线 |
|
||
|
||
**弹窗搜索区:**
|
||
|
||
| 组件 | 说明 |
|
||
|------|------|
|
||
| 路线编号 | 模糊搜索工艺路线编号 |
|
||
| 路线名称 | 模糊搜索工艺路线名称 |
|
||
| 搜索按钮 | primary 类型，执行搜索 |
|
||
| 重置按钮 | 清空条件并刷新列表 |
|
||
|
||
**弹窗列表结构:**
|
||
|
||
| 列 | 字段 | 说明 |
|
||
|----|------|------|
|
||
| (单选) | - | 单选列 |
|
||
| 路线编号 | routeCode | 工艺路线编号 |
|
||
| 路线名称 | routeName | 工艺路线名称 |
|
||
| 路线说明 | routeDesc | 工艺路线描述 |
|
||
| 是否启用 | enableFlag | Y=启用 / N=停用 |
|
||
|
||
**选择交互:**
|
||
- 单选一条工艺路线记录，点击「确定」按钮
|
||
- 选择后自动填充：routeId、routeCode、routeName
|
||
|
||
> **数据来源**: 工艺路线数据来自 `pro_route` 表，通过 `GET /mes/pro/proroute/list` 接口获取（无需权限注解即可访问）。
|
||
>
|
||
> **注意**: 前端调用 `/mes/pro/proroute/list` 时默认传递 `enableFlag=Y` 参数。应默认加载所有路线，让用户自行判断选择。后端 `ProRouteController.list()` 方法接受 `ProRoute` 实体作为查询参数，其中 `routeCode`、`routeName` 支持模糊搜索，`enableFlag` 支持精确匹配。
|
||
>
|
||
> 工艺路线与产品的关系通过 `pro_route_product` 表关联，可选根据已选产品过滤对应的工艺路线。
|
||
|
||
### 4.8 表头折叠
|
||
|
||
点击「收起」按钮，表头表单区域收起，仅显示 BOM 物料组成子表；点击「展开」恢复。
|
||
|
||
---
|
||
|
||
## 5. 数据字段定义
|
||
|
||
### 5.1 生产工单主表字段（pro_workorder）
|
||
|
||
| 字段名 | 数据库字段 | 类型 | 长度 | 必填 | 默认值 | 说明 |
|
||
|--------|-----------|------|------|------|--------|------|
|
||
| 工单ID | workorder_id | bigint | - | 是 | AUTO | 主键，自增 |
|
||
| 工单编码 | workorder_code | varchar | 64 | 是 | - | 唯一编码 |
|
||
| 工单名称 | workorder_name | varchar | 255 | 是 | - | 工单描述 |
|
||
| 工单类型 | workorder_type | varchar | 64 | 否 | SELF | 自产/委外 |
|
||
| 来源类型 | order_source | varchar | 64 | 是 | PLAN | 固定为 PLAN（生产计划） |
|
||
| 来源单据 | source_code | varchar | 64 | 是 | - | 生产计划单号（选择计划单弹窗） |
|
||
| 产品ID | product_id | bigint | - | 是 | - | 外键 → md_item，由计划单带入 |
|
||
| 产品编号 | product_code | varchar | 64 | 是 | - | 冗余，由计划单带入 |
|
||
| 产品名称 | product_name | varchar | 255 | 是 | - | 冗余，由计划单带入 |
|
||
| 规格型号 | product_spc | varchar | 255 | 否 | - | 由计划单带入 |
|
||
| 单位 | unit_of_measure | varchar | 64 | 是 | - | 由计划单带入 |
|
||
| 单位名称 | unit_name | varchar | 64 | 否 | - | |
|
||
| 工艺路线ID | route_id | bigint | - | 否 | - | 外键 → pro_route（**新增字段**） |
|
||
| 工艺路线编号 | route_code | varchar | 64 | 否 | - | 冗余（**新增字段**） |
|
||
| 工艺路线名称 | route_name | varchar | 255 | 否 | - | 冗余（**新增字段**） |
|
||
| 批次号 | batch_code | varchar | 64 | 否 | - | 生产批次号 |
|
||
| 生产数量 | quantity | double(14,2) | - | 是 | 0 | 计划生产数量，从计划单带入 |
|
||
| 已生产数量 | quantity_produced | double(14,2) | - | 否 | 0 | 报工回写 |
|
||
| 调整数量 | quantity_changed | double(14,2) | - | 否 | 0 | 手动调整 |
|
||
| 已排产数量 | quantity_scheduled | double(14,2) | - | 否 | 0 | 排产回写 |
|
||
| 客户ID | client_id | bigint | - | 否 | - | 由计划单带入 |
|
||
| 客户编码 | client_code | varchar | 64 | 否 | - | |
|
||
| 客户名称 | client_name | varchar | 255 | 否 | - | |
|
||
| 供应商ID | vendor_id | bigint | - | 否 | - | 仅委外工单 |
|
||
| 供应商编码 | vendor_code | varchar | 64 | 否 | - | |
|
||
| 供应商名称 | vendor_name | varchar | 255 | 否 | - | |
|
||
| 生产日期 | production_date | date | - | 是 | 当天 | 计划生产日期（**原 request_date 改名**） |
|
||
| 完成时间 | finish_date | datetime | - | 否 | - | 完工时自动填充 |
|
||
| 取消时间 | cancel_date | datetime | - | 否 | - | 取消时自动填充 |
|
||
| 父工单ID | parent_id | bigint | - | 否 | 0 | 父工单ID |
|
||
| 祖先节点 | ancestors | varchar | 500 | 是 | 0 | 所有父节点ID |
|
||
| 单据状态 | status | varchar | 64 | 否 | PREPARE | 草稿/已确认/已完成/已取消 |
|
||
| 备注 | remark | varchar | 500 | 否 | - | |
|
||
| 创建者 | create_by | varchar | 64 | 否 | - | |
|
||
| 创建时间 | create_time | datetime | - | 否 | - | |
|
||
| 更新者 | update_by | varchar | 64 | 否 | - | |
|
||
| 更新时间 | update_time | datetime | - | 否 | - | |
|
||
|
||
> **变更说明**:
|
||
> - `request_date` 改名为 `production_date`，语义从"需求日期"改为"生产日期"
|
||
> - 新增 `route_id`、`route_code`、`route_name` 三个工艺路线字段
|
||
> - `order_source` 固定为 PLAN，`source_code` 存储计划单号（必填）
|
||
|
||
### 5.2 BOM 物料组成表字段（pro_workorder_bom）
|
||
|
||
| 字段名 | 数据库字段 | 类型 | 长度 | 必填 | 说明 |
|
||
|--------|-----------|------|------|------|------|
|
||
| BOM行ID | line_id | bigint | - | 是 | 主键，自增 |
|
||
| 工单ID | workorder_id | bigint | - | 是 | 外键 → pro_workorder |
|
||
| 物料ID | item_id | bigint | - | 是 | 外键 → md_item |
|
||
| 物料编号 | item_code | varchar | 64 | 是 | 冗余 |
|
||
| 物料名称 | item_name | varchar | 255 | 是 | 冗余 |
|
||
| 规格型号 | item_spc | varchar | 255 | 否 | |
|
||
| 单位 | unit_of_measure | varchar | 64 | 否 | |
|
||
| 单位名称 | unit_name | varchar | 128 | 否 | |
|
||
| 物料/产品标识 | item_or_product | varchar | 64 | 否 | 标识物料还是半成品 |
|
||
| 预计使用量 | quantity | decimal(14,2) | - | 是 | =产品BOM用量 × 生产数量 |
|
||
| 备注 | remark | varchar | 500 | 否 | |
|
||
| 创建者 | create_by | varchar | 64 | 否 | |
|
||
| 创建时间 | create_time | datetime | - | 否 | |
|
||
| 更新者 | update_by | varchar | 64 | 否 | |
|
||
| 更新时间 | update_time | datetime | - | 否 | |
|
||
|
||
---
|
||
|
||
## 6. 按钮操作说明
|
||
|
||
### 6.1 列表页工具栏按钮
|
||
|
||
#### 6.1.1 新增按钮
|
||
|
||
| 项目 | 说明 |
|
||
|------|------|
|
||
| 触发条件 | 始终可用 |
|
||
| 操作 | 路由跳转到新增生产工单页面 |
|
||
| 权限 | mes:pro:workorder:add |
|
||
| 路由 | `/production/work-order/new` |
|
||
|
||
#### 6.1.2 修改按钮
|
||
|
||
| 项目 | 说明 |
|
||
|------|------|
|
||
| 触发条件 | 勾选一条记录 |
|
||
| 前置校验 | 仅草稿(PREPARE)状态允许修改 |
|
||
| 操作 | 路由跳转到编辑页面 |
|
||
| 权限 | mes:pro:workorder:edit |
|
||
|
||
#### 6.1.3 删除按钮（批量）
|
||
|
||
| 项目 | 说明 |
|
||
|------|------|
|
||
| 触发条件 | 勾选一条或多条记录 |
|
||
| 前置校验 | 仅草稿(PREPARE)状态允许删除 |
|
||
| 操作 | 弹出确认框，确认后调用删除接口 |
|
||
| 权限 | mes:pro:workorder:remove |
|
||
|
||
#### 6.1.4 导出按钮
|
||
|
||
| 项目 | 说明 |
|
||
|------|------|
|
||
| 触发条件 | 始终可用 |
|
||
| 操作 | 按当前搜索条件导出工单列表到Excel |
|
||
| 权限 | mes:pro:workorder:export |
|
||
|
||
### 6.2 操作列按钮
|
||
|
||
#### 6.2.1 查看按钮
|
||
|
||
| 项目 | 说明 |
|
||
|------|------|
|
||
| 显示条件 | 所有状态均显示 |
|
||
| 操作 | 路由跳转到查看页面（只读模式） |
|
||
| 权限 | mes:pro:workorder:query |
|
||
|
||
#### 6.2.2 编辑按钮
|
||
|
||
| 项目 | 说明 |
|
||
|------|------|
|
||
| 显示条件 | 仅 status = PREPARE（草稿） |
|
||
| 操作 | 路由跳转到编辑页面 |
|
||
| 权限 | mes:pro:workorder:edit |
|
||
|
||
#### 6.2.3 删除按钮（行操作）
|
||
|
||
| 项目 | 说明 |
|
||
|------|------|
|
||
| 显示条件 | 仅 status = PREPARE（草稿） |
|
||
| 操作 | 弹出确认框，确认后删除，同时删除关联 BOM 行 |
|
||
| 权限 | mes:pro:workorder:remove |
|
||
|
||
#### 6.2.4 确认按钮
|
||
|
||
| 项目 | 说明 |
|
||
|------|------|
|
||
| 显示条件 | 仅 status = PREPARE（草稿） |
|
||
| 前置条件 | 工单已保存，必须有产品信息（productId 不为空） |
|
||
| 操作 | 弹出确认框"确认此工单？确认后将不可编辑。"，确认后调用确认接口 |
|
||
| 权限 | mes:pro:workorder:edit |
|
||
| 结果 | status 从 PREPARE → CONFIRMED（已确认），确认后工单不可编辑，可进行领料、排产等后续操作 |
|
||
|
||
#### 6.2.5 一键领料按钮
|
||
|
||
| 项目 | 说明 |
|
||
|------|------|
|
||
| 显示条件 | status = CONFIRMED 或 APPROVED |
|
||
| 操作 | 确认后自动创建领料单（含全部BOM物料行），跳转领料单编辑页 |
|
||
| 权限 | mes:wm:issueheader:add |
|
||
| 详细逻辑 | 见 [10.6 一键领料规则](#106-一键领料规则) |
|
||
|
||
#### 6.2.6 完工按钮
|
||
|
||
| 项目 | 说明 |
|
||
|------|------|
|
||
| 显示条件 | status = CONFIRMED 或 APPROVED |
|
||
| 操作 | 弹出确认框，确认后调用完工接口 |
|
||
| 权限 | mes:pro:workorder:edit |
|
||
| 结果 | status → FINISHED，记录完成时间，所有关联生产任务也置为完成 |
|
||
|
||
#### 6.2.7 取消按钮
|
||
|
||
| 项目 | 说明 |
|
||
|------|------|
|
||
| 显示条件 | status = PREPARE 或 CONFIRMED |
|
||
| 操作 | 弹出确认框，确认后调用取消接口 |
|
||
| 权限 | mes:pro:workorder:edit |
|
||
| 结果 | status → CANCELED，记录取消时间，所有关联生产任务也置为取消 |
|
||
|
||
### 6.3 新增/编辑/查看页按钮
|
||
|
||
> **截图参考**: 截图中查看页右上角按钮从左到右依次为：**新增**、**编辑**、**审核**、**反审核**、**打印**、**操作**（下拉）、**收起**
|
||
|
||
#### 6.3.1 按钮总览（按截图从左到右排列）
|
||
|
||
| 序号 | 按钮 | 颜色/样式 | 显示条件 | 说明 |
|
||
|------|------|-----------|----------|------|
|
||
| 1 | 新增 | primary (蓝色) | 查看模式 | 跳转新增页面 |
|
||
| 2 | 编辑 | default (灰色) | 查看模式，status=PREPARE 时可点击，其他状态置灰 | 跳转编辑页面 |
|
||
| 3 | 审核 | success (绿色) | 查看模式或编辑模式（已保存），status=PREPARE | 调用审核接口，PREPARE→CONFIRMED |
|
||
| 4 | 反审核 | warning (黄色) | 查看模式，status=CONFIRMED 或 APPROVED | 调用反审核接口，CONFIRMED→PREPARE |
|
||
| 5 | 打印 | default + 打印图标 | 查看模式 | 打印工单 |
|
||
| 6 | 操作 | default 下拉按钮 | 查看模式 | 下拉菜单：挂起、关闭、调整工期、调整产线 |
|
||
| 7 | 收起/展开 | primary (蓝色) | 始终显示 | 折叠/展开表头表单区域 |
|
||
| - | 保存 | primary (蓝色) | 新增/编辑模式 | 保存工单数据 |
|
||
| - | 取消 | default (灰色) | 新增/编辑模式 | 返回列表页 |
|
||
|
||
#### 6.3.2 新增按钮
|
||
|
||
| 项目 | 说明 |
|
||
|------|------|
|
||
| 显示条件 | 查看模式 |
|
||
| 操作 | 路由跳转到新增页面 `/production/work-order/new` |
|
||
|
||
#### 6.3.3 编辑按钮
|
||
|
||
| 项目 | 说明 |
|
||
|------|------|
|
||
| 显示条件 | 查看模式 |
|
||
| 可点击条件 | 仅 status = PREPARE（草稿）时可点击，其他状态置灰(disabled) |
|
||
| 操作 | 路由跳转到编辑页面 `/production/work-order/edit/{id}` |
|
||
|
||
#### 6.3.4 审核按钮
|
||
|
||
| 项目 | 说明 |
|
||
|------|------|
|
||
| 显示条件 | 查看模式或编辑模式（已保存），status = PREPARE（草稿） |
|
||
| 前置条件 | 工单已保存（workorderId 不为空），产品信息已填写 |
|
||
| 操作 | 弹出确认框"确认审核此工单？审核后不可编辑。"→ 调用审核接口 |
|
||
| 结果 | status 从 PREPARE → CONFIRMED（已确认） |
|
||
| 成功提示 | "审核成功" |
|
||
| 成功后行为 | 页面刷新为查看模式，状态变为"审核"，编辑按钮置灰，显示反审核按钮 |
|
||
|
||
#### 6.3.5 反审核按钮
|
||
|
||
| 项目 | 说明 |
|
||
|------|------|
|
||
| 显示条件 | 查看模式，status = CONFIRMED 或 APPROVED |
|
||
| 前置条件 | 工单没有关联的已执行领料单或已完工记录（如有，需先处理） |
|
||
| 操作 | 弹出确认框"确认反审核？反审核后可重新编辑。"→ 调用反审核接口 |
|
||
| 结果 | status 从 CONFIRMED → PREPARE（草稿） |
|
||
| 成功提示 | "反审核成功" |
|
||
| 成功后行为 | 页面刷新，状态变为"开立"，编辑按钮可点击 |
|
||
|
||
#### 6.3.6 打印按钮
|
||
|
||
| 项目 | 说明 |
|
||
|------|------|
|
||
| 显示条件 | 查看模式 |
|
||
| 操作 | 触发浏览器打印预览，打印工单详情（含表头、BOM 物料） |
|
||
| 图标 | 打印机图标 |
|
||
|
||
#### 6.3.7 操作下拉按钮
|
||
|
||
| 项目 | 说明 |
|
||
|------|------|
|
||
| 显示条件 | 查看模式 |
|
||
| 组件 | el-dropdown 下拉菜单 |
|
||
|
||
**下拉菜单项:**
|
||
|
||
| 菜单项 | 显示条件 | 操作 | 说明 |
|
||
|--------|----------|------|------|
|
||
| 挂起 | status = CONFIRMED | 调用挂起接口，status → PAUSE（如支持） | 暂停工单执行 |
|
||
| 关闭 | status = CONFIRMED/FINISHED | 调用关闭接口 | 关闭/归档工单 |
|
||
| 调整工期 | status = CONFIRMED | 弹出弹窗修改订单交期/需求日期/生产日期 | 调整生产时间安排 |
|
||
| 调整产线 | status = CONFIRMED | 弹出弹窗修改生产线 | 切换生产线 |
|
||
|
||
#### 6.3.8 收起/展开按钮
|
||
|
||
| 项目 | 说明 |
|
||
|------|------|
|
||
| 位置 | 页面右上角最右侧 |
|
||
| 颜色 | primary (蓝色) |
|
||
| 操作 | 折叠/展开表头表单区域 |
|
||
|
||
#### 6.3.9 保存按钮（新增/编辑模式）
|
||
|
||
| 项目 | 说明 |
|
||
|------|------|
|
||
| 显示条件 | 新增/编辑模式 |
|
||
| 颜色 | primary (蓝色) |
|
||
| 触发条件 | 表单校验通过 |
|
||
| 操作 | 保存工单数据，后端自动生成/更新 BOM 物料行 |
|
||
| 成功提示 | "保存成功" |
|
||
|
||
#### 6.3.10 取消按钮（新增/编辑模式）
|
||
|
||
| 项目 | 说明 |
|
||
|------|------|
|
||
| 显示条件 | 新增/编辑模式 |
|
||
| 颜色 | default (灰色) |
|
||
| 操作 | 返回列表页 |
|
||
|
||
### 6.4 领料明细区按钮
|
||
|
||
> **截图参考**: 领料明细区域右上角有两个按钮：「一键领料」（绿色勾图标）和「+ 领料」（蓝色）
|
||
|
||
#### 6.4.1 一键领料按钮
|
||
|
||
| 项目 | 说明 |
|
||
|------|------|
|
||
| 位置 | 领料明细区域右上角 |
|
||
| 颜色 | success (绿色) + 勾图标 |
|
||
| 显示条件 | 查看模式，status = CONFIRMED 或 APPROVED |
|
||
| 操作 | 确认弹窗 → 调用一键领料接口（根据 BOM 物料自动创建领料单）→ 刷新领料明细列表 |
|
||
| 详细逻辑 | 见 [10.7 一键领料规则](#107-一键领料规则) |
|
||
|
||
#### 6.4.2 + 领料按钮
|
||
|
||
| 项目 | 说明 |
|
||
|------|------|
|
||
| 位置 | 一键领料按钮右侧 |
|
||
| 颜色 | primary (蓝色) |
|
||
| 显示条件 | 查看模式，status = CONFIRMED 或 APPROVED |
|
||
| 操作 | 跳转到生产领料单新增页面，URL 携带 workorderId 和 workorderCode 参数 |
|
||
| 路由 | `/warehouse/issue/new?workorderId={id}&workorderCode={code}` |
|
||
|
||
### 6.5 完工明细区按钮
|
||
|
||
> **截图参考**: 完工明细区域右上角有两个按钮：「一键报工」（绿色勾图标）和「+ 报工」（蓝色）
|
||
|
||
#### 6.5.1 一键报工按钮
|
||
|
||
| 项目 | 说明 |
|
||
|------|------|
|
||
| 位置 | 完工明细区域右上角 |
|
||
| 颜色 | success (绿色) + 勾图标 |
|
||
| 显示条件 | 查看模式，status = CONFIRMED 或 APPROVED |
|
||
| 操作 | 确认弹窗 → 调用一键报工接口（或弹出报工弹窗填写完工数量/质量）→ 刷新完工明细列表 |
|
||
|
||
#### 6.5.2 + 报工按钮
|
||
|
||
| 项目 | 说明 |
|
||
|------|------|
|
||
| 位置 | 一键报工按钮右侧 |
|
||
| 颜色 | primary (蓝色) |
|
||
| 显示条件 | 查看模式，status = CONFIRMED 或 APPROVED |
|
||
| 操作 | 跳转到报工页面或打开报工弹窗，手动填写完工数量和质量信息 |
|
||
|
||
---
|
||
|
||
## 7. 页面交互规则
|
||
|
||
### 7.1 列表页交互
|
||
|
||
| 序号 | 交互场景 | 交互规则 |
|
||
|------|----------|----------|
|
||
| 1 | 页面首次加载 | 默认加载第1页数据，按创建时间降序排列 |
|
||
| 2 | 搜索操作 | 点击搜索按钮，重置 pageNum=1，保持当前 pageSize 不变 |
|
||
| 3 | 工单编码点击 | 点击工单编码列蓝色链接文字，路由跳转到查看页面 |
|
||
| 4 | 状态标签 | 用 el-tag 组件渲染：草稿=info(灰), 已确认=primary(蓝), 已审核=success(绿), 已完成=success(绿), 已取消=danger(红) |
|
||
| 5 | 空数据状态 | 列表无数据时显示空状态图标和"暂无数据"文字 |
|
||
| 6 | 批量操作 | 勾选多条记录后，批量操作按钮（删除）启用；未勾选时置灰 |
|
||
| 7 | 删除校验 | 仅草稿状态允许删除，非草稿状态弹出提示"只能删除草稿状态单据！" |
|
||
| 8 | 确认工单 | 草稿状态行点击「确认」→ 确认弹窗 → 调用确认接口 → 状态变为已确认 → 刷新列表 |
|
||
| 9 | 一键领料 | 已确认/已审核状态行点击「一键领料」→ 确认弹窗 → 调用一键领料接口 → 跳转领料单编辑页 |
|
||
|
||
### 7.2 新增/编辑页交互
|
||
|
||
| 序号 | 交互场景 | 交互规则 |
|
||
|------|----------|----------|
|
||
| 1 | 页面加载(新增) | 空白表单，工单类型默认"自产"，来源类型固定为"生产计划"，生产日期默认当天 |
|
||
| 2 | 页面加载(编辑) | 调用详情接口加载工单数据和 BOM 物料行 |
|
||
| 3 | 选择计划单 | 点击「选择」→ 打开选择生产计划单弹窗（仅已审核）→ 选中计划单 → 确定 → 自动填充产品信息、客户信息、数量 |
|
||
| 4 | 选择工艺路线 | 点击「选择」→ 打开选择工艺路线弹窗（仅已启用）→ 选中路线 → 确定 → 填充 routeId/routeCode/routeName |
|
||
| 5 | 保存操作 | 前端表单校验 → 调用保存接口 → 后端自动生成 BOM 行 → 成功提示 |
|
||
| 6 | 产品/数量变化 | 编辑时若产品ID或生产数量发生变化，保存时后端会删除旧 BOM 行并重新生成 |
|
||
| 7 | 工单编码唯一 | 保存时后端校验工单编码唯一性，重复则提示"生产工单编号已存在！" |
|
||
| 8 | 表头折叠 | 点击「收起」→ 表头表单区域收起；点击「展开」→ 恢复 |
|
||
| 9 | 确认工单 | 编辑页保存后或查看页：点击「确认」→ 确认弹窗 → 调用确认接口 → 成功提示"确认成功" → 页面刷新为查看模式，状态变为"已确认" |
|
||
|
||
### 7.3 查看页交互
|
||
|
||
| 序号 | 交互场景 | 交互规则 |
|
||
|------|----------|----------|
|
||
| 1 | 审核工单 | status=PREPARE 时点击「审核」→ 确认弹窗"确认审核此工单？审核后不可编辑。" → 确认 → 调用审核接口 → 成功后页面刷新，状态变为"审核"，编辑按钮置灰，显示反审核和领料按钮 |
|
||
| 2 | 反审核 | status=CONFIRMED/APPROVED 时点击「反审核」→ 确认弹窗"确认反审核？反审核后可重新编辑。" → 确认 → 调用反审核接口 → 成功后页面刷新，状态回到"开立"，编辑按钮可点击 |
|
||
| 3 | 一键领料 | status=CONFIRMED/APPROVED 时在领料明细区点击「一键领料」→ 确认弹窗 → 调用一键领料接口 → 成功后刷新领料明细列表 |
|
||
| 4 | + 领料 | 点击「+ 领料」→ 跳转到领料单新增页，URL 携带 workorderId 和 workorderCode |
|
||
| 5 | 一键报工 | status=CONFIRMED/APPROVED 时在完工明细区点击「一键报工」→ 弹出报工弹窗或调用接口 → 刷新完工明细列表 |
|
||
| 6 | + 报工 | 点击「+ 报工」→ 跳转到报工页面或打开报工弹窗 |
|
||
| 7 | 打印 | 点击「打印」→ 触发浏览器打印预览 |
|
||
| 8 | 操作-挂起 | 点击操作下拉→「挂起」→ 暂停工单执行 |
|
||
| 9 | 操作-关闭 | 点击操作下拉→「关闭」→ 关闭/归档工单 |
|
||
| 10 | 操作-调整工期 | 点击操作下拉→「调整工期」→ 弹出弹窗修改日期 |
|
||
| 11 | 操作-调整产线 | 点击操作下拉→「调整产线」→ 弹出弹窗修改生产线 |
|
||
|
||
### 7.4 表单校验规则
|
||
|
||
#### 表头校验
|
||
|
||
| 字段 | 规则 | 提示信息 |
|
||
|------|------|----------|
|
||
| workorderCode | 系统自动生成，无需前端校验 | 后端自动生成并校验唯一性 |
|
||
| workorderName | 必填 | 工单名称不能为空 |
|
||
| sourceCode | 必填 | 请选择生产计划单 |
|
||
| productId | 必填 | 请先选择计划单号（产品信息由计划单带入） |
|
||
| quantity | 必填，min=0.01 | 生产数量必须大于0 |
|
||
| productionDate | 必填 | 生产日期不能为空 |
|
||
| unitOfMeasure | 必填 | 单位不能为空（选择计划单后自动带入） |
|
||
|
||
---
|
||
|
||
## 8. 接口调用说明
|
||
|
||
### 8.1 接口总览
|
||
|
||
| 序号 | 功能 | 方法 | 路径 | 说明 |
|
||
|------|------|------|------|------|
|
||
| 1 | 查询工单列表 | GET | /mes/pro/workorder/list | 分页查询生产工单列表 |
|
||
| 2 | 获取工单详情 | GET | /mes/pro/workorder/{workorderId} | 获取单条工单详情 |
|
||
| 3 | 新增工单 | POST | /mes/pro/workorder | 创建新工单，自动生成BOM行 |
|
||
| 4 | 修改工单 | PUT | /mes/pro/workorder | 更新工单，产品/数量变化时重新生成BOM |
|
||
| 5 | 删除工单 | DELETE | /mes/pro/workorder/{workorderIds} | 批量删除工单及关联BOM行 |
|
||
| 6 | 导出工单 | POST | /mes/pro/workorder/export | 导出工单列表到Excel |
|
||
| 7 | **审核工单** | PUT | /mes/pro/workorder/confirm/{workorderId} | 草稿→已确认（审核） |
|
||
| 8 | **反审核工单** | PUT | /mes/pro/workorder/unconfirm/{workorderId} | 已确认→草稿（反审核） |
|
||
| 9 | 完工工单 | PUT | /mes/pro/workorder/finish/{workorderId} | 工单完工，关联任务完成 |
|
||
| 10 | 取消工单 | PUT | /mes/pro/workorder/cancel/{workorderId} | 取消工单，关联任务取消 |
|
||
| 11 | **工单BOM组成列表** | GET | /mes/pro/workorderbom/list | **表单用**：获取工单直接BOM组成行 |
|
||
| 12 | 工单物料需求(递归) | GET | /mes/pro/workorder/listItems | 递归展开BOM到最底层物料（仅分析用） |
|
||
| 13 | **一键领料** | POST | /mes/pro/workorder/quickIssue/{workorderId} | 根据BOM自动创建领料单 |
|
||
| 14 | 生产计划单列表 | GET | /erp/mp/plan/list | 选择计划单弹窗数据源 |
|
||
| 15 | 生产计划单详情 | GET | /erp/mp/plan/{planId} | 获取计划单详情 |
|
||
| 16 | 工艺路线列表 | GET | /mes/pro/proroute/list | 选择工艺路线弹窗数据源 |
|
||
| 17 | 选择客户 | GET | /mes/md/client/list | 客户选择（备用） |
|
||
|
||
### 8.2 接口详细说明
|
||
|
||
#### 8.2.1 查询工单列表
|
||
|
||
```
|
||
GET /mes/pro/workorder/list
|
||
```
|
||
|
||
**请求参数:**
|
||
|
||
| 参数名 | 类型 | 必填 | 说明 |
|
||
|--------|------|------|------|
|
||
| pageNum | integer | 否 | 页码，默认1 |
|
||
| pageSize | integer | 否 | 每页数，默认10 |
|
||
| workorderCode | string | 否 | 工单编码（模糊） |
|
||
| workorderName | string | 否 | 工单名称（模糊） |
|
||
| workorderType | string | 否 | 工单类型 |
|
||
| sourceCode | string | 否 | 计划单号（模糊） |
|
||
| productCode | string | 否 | 产品编号（模糊） |
|
||
| productName | string | 否 | 产品名称（模糊） |
|
||
| status | string | 否 | 工单状态 |
|
||
| beginProductionDate | string | 否 | 生产日期起 (yyyy-MM-dd) |
|
||
| endProductionDate | string | 否 | 生产日期止 (yyyy-MM-dd) |
|
||
|
||
**响应示例:**
|
||
|
||
```json
|
||
{
|
||
"total": 25,
|
||
"rows": [
|
||
{
|
||
"workorderId": 1,
|
||
"workorderCode": "WO20260213001",
|
||
"workorderName": "组装电脑5400生产任务",
|
||
"workorderType": "SELF",
|
||
"orderSource": "PLAN",
|
||
"sourceCode": "SCJH000096",
|
||
"productId": 100,
|
||
"productCode": "0103000002",
|
||
"productName": "组装电脑5400",
|
||
"productSpc": "",
|
||
"unitOfMeasure": "台",
|
||
"routeId": 5,
|
||
"routeCode": "RT001",
|
||
"routeName": "电脑组装工艺路线",
|
||
"quantity": 170.00,
|
||
"quantityProduced": 50.00,
|
||
"quantityChanged": 0.00,
|
||
"quantityScheduled": 170.00,
|
||
"clientName": "客户A",
|
||
"productionDate": "2026-02-20",
|
||
"status": "CONFIRMED"
|
||
}
|
||
],
|
||
"code": 200,
|
||
"msg": "查询成功"
|
||
}
|
||
```
|
||
|
||
#### 8.2.2 获取工单详情
|
||
|
||
```
|
||
GET /mes/pro/workorder/{workorderId}
|
||
```
|
||
|
||
**响应:** 返回工单详情对象，含 routeId/routeCode/routeName 等新增字段。BOM 物料行需通过 `listItems` 接口单独获取。
|
||
|
||
#### 8.2.3 新增工单
|
||
|
||
```
|
||
POST /mes/pro/workorder
|
||
```
|
||
|
||
**请求体:**
|
||
|
||
```json
|
||
{
|
||
"workorderCode": "",
|
||
"workorderName": "组装电脑5400生产任务",
|
||
"workorderType": "SELF",
|
||
"orderSource": "PLAN",
|
||
"sourceCode": "SCJH000096",
|
||
"productId": 100,
|
||
"productCode": "0103000002",
|
||
"productName": "组装电脑5400",
|
||
"productSpc": "",
|
||
"unitOfMeasure": "台",
|
||
"routeId": 5,
|
||
"routeCode": "RT001",
|
||
"routeName": "电脑组装工艺路线",
|
||
"quantity": 170.00,
|
||
"productionDate": "2026-02-20",
|
||
"clientId": 1,
|
||
"clientCode": "KH001",
|
||
"clientName": "客户A",
|
||
"remark": ""
|
||
}
|
||
```
|
||
|
||
**说明:**
|
||
- `workorderCode` 传空字符串或不传，后端通过 `AutoCodeUtil.genSerialCode(SCGD_CODE, "")` 自动生成
|
||
- `orderSource` 固定为 "PLAN"，`sourceCode` 必须为有效的计划单号
|
||
- 后端自动根据 `productId` 查找产品 BOM（`md_product_bom`），生成 `pro_workorder_bom` 行记录
|
||
- BOM 用量计算: 每个 BOM 组件的 `quantity = 生产数量(workorder.quantity) × BOM单位用量(bom.quantity)`
|
||
|
||
#### 8.2.4 修改工单
|
||
|
||
```
|
||
PUT /mes/pro/workorder
|
||
```
|
||
|
||
**请求体:** 同新增，但包含 `workorderId`。若产品ID或生产数量变化，后端重新生成 BOM。
|
||
|
||
#### 8.2.5 删除工单
|
||
|
||
```
|
||
DELETE /mes/pro/workorder/{workorderIds}
|
||
```
|
||
|
||
**业务规则:** 仅允许删除草稿(PREPARE)状态；同时删除关联 `pro_workorder_bom` 行。
|
||
|
||
#### 8.2.6 审核工单
|
||
|
||
```
|
||
PUT /mes/pro/workorder/confirm/{workorderId}
|
||
```
|
||
|
||
**路径参数:**
|
||
|
||
| 参数名 | 类型 | 必填 | 说明 |
|
||
|--------|------|------|------|
|
||
| workorderId | integer | 是 | 工单ID |
|
||
|
||
**业务规则:**
|
||
- 仅允许草稿(PREPARE)状态的工单执行审核操作
|
||
- 工单必须有产品信息（productId 不为空）
|
||
- 审核后状态变为 CONFIRMED（已确认/审核）
|
||
- 审核后工单不可编辑，可进行领料、排产等后续操作
|
||
|
||
> **后端实现**: 需在 `ProWorkorderController` 中新增 `confirm` 端点，校验状态后将 `status` 设为 `UserConstants.ORDER_STATUS_CONFIRMED`。
|
||
|
||
#### 8.2.7 反审核工单
|
||
|
||
```
|
||
PUT /mes/pro/workorder/unconfirm/{workorderId}
|
||
```
|
||
|
||
**路径参数:**
|
||
|
||
| 参数名 | 类型 | 必填 | 说明 |
|
||
|--------|------|------|------|
|
||
| workorderId | integer | 是 | 工单ID |
|
||
|
||
**业务规则:**
|
||
- 仅允许已确认(CONFIRMED)或已审核(APPROVED)状态的工单执行反审核
|
||
- 反审核前需校验：工单没有已执行的领料单或已完工记录（如有则提示"存在已执行的下游单据，无法反审核"）
|
||
- 反审核后状态变为 PREPARE（草稿），可重新编辑
|
||
- 清空审核员和审核日期
|
||
|
||
> **后端实现**: 需在 `ProWorkorderController` 中新增 `unconfirm` 端点，校验状态和下游引用后将 `status` 设为 `UserConstants.ORDER_STATUS_PREPARE`。
|
||
|
||
#### 8.2.8 完工工单
|
||
|
||
```
|
||
PUT /mes/pro/workorder/finish/{workorderId}
|
||
```
|
||
|
||
**业务规则:** 将工单状态设为 FINISHED，记录完成时间；同时将该工单下所有生产任务状态设为 FINISHED。
|
||
|
||
#### 8.2.9 取消工单
|
||
|
||
```
|
||
PUT /mes/pro/workorder/cancel/{workorderId}
|
||
```
|
||
|
||
**业务规则:** 将工单状态设为 CANCELED，记录取消时间；同时将该工单下所有生产任务状态设为 CANCELED。
|
||
|
||
#### 8.2.10 一键领料
|
||
|
||
```
|
||
POST /mes/pro/workorder/quickIssue/{workorderId}
|
||
```
|
||
|
||
**说明:** 根据工单 BOM 物料组成自动创建一张生产领料单。
|
||
|
||
**业务逻辑:**
|
||
1. 查询工单详情及 BOM 物料列表
|
||
2. 创建 `wm_issue_header`：
|
||
- `issueCode`：自动生成领料单编号
|
||
- `issueName`：自动生成，如"WO20260213001-领料单"
|
||
- `workorderId` / `workorderCode`：关联本工单
|
||
- `clientId` / `clientCode` / `clientName`：从工单带入
|
||
- `status`：PREPARE（草稿）
|
||
3. 遍历工单 BOM 物料，为每条 BOM 行创建 `wm_issue_line`：
|
||
- `itemId` / `itemCode` / `itemName`：BOM 物料信息
|
||
- `specification`：BOM 物料规格
|
||
- `unitOfMeasure` / `unitName`：BOM 物料单位
|
||
- `quantityIssued`：= BOM 预计使用量（quantity）
|
||
4. 返回新建的领料单 ID（`issueId`），前端跳转到领料单编辑页
|
||
|
||
**响应示例:**
|
||
|
||
```json
|
||
{
|
||
"code": 200,
|
||
"msg": "操作成功",
|
||
"data": 123
|
||
}
|
||
```
|
||
|
||
其中 `data` 为新创建的领料单 ID。
|
||
|
||
#### 8.2.11 工单 BOM 组成列表（表单用）
|
||
|
||
```
|
||
GET /mes/pro/workorderbom/list
|
||
```
|
||
|
||
**请求参数:**
|
||
|
||
| 参数名 | 类型 | 必填 | 说明 |
|
||
|--------|------|------|------|
|
||
| workorderId | integer | 是 | 工单ID |
|
||
| pageNum | integer | 否 | 页码，默认1 |
|
||
| pageSize | integer | 否 | 每页数，默认100（建议设大以加载全部） |
|
||
|
||
**说明:** 直接查询 `pro_workorder_bom` 表，返回该工单的直接 BOM 组成行。**前端表单 BOM 子表应使用此接口**。
|
||
|
||
**响应字段:** 返回 `ProWorkorderBom` 实体，字段名与前端 `WorkOrderBom` 接口直接对应：
|
||
|
||
| 字段 | 说明 |
|
||
|------|------|
|
||
| lineId | BOM 行 ID |
|
||
| workorderId | 工单 ID |
|
||
| itemId | 物料 ID |
|
||
| itemCode | 物料编号 |
|
||
| itemName | 物料名称 |
|
||
| itemSpc | 规格型号 |
|
||
| unitOfMeasure | 单位编码 |
|
||
| unitName | 单位名称 |
|
||
| itemOrProduct | 物料/产品标识 |
|
||
| quantity | 预计使用量 |
|
||
| remark | 备注 |
|
||
|
||
#### 8.2.12 工单物料需求清单（递归展开，仅分析用）
|
||
|
||
```
|
||
GET /mes/pro/workorder/listItems
|
||
```
|
||
|
||
**请求参数:**
|
||
|
||
| 参数名 | 类型 | 必填 | 说明 |
|
||
|--------|------|------|------|
|
||
| workorderId | integer | 是 | 工单ID |
|
||
|
||
**说明:** 根据工单 BOM 递归展开（最多20层），返回最底层物料的汇总需求清单。同一物料编码的数量自动合并。返回 `MdProductBom` 格式（`bomItemCode`/`bomItemName` 等字段名），**不要用于表单 BOM 子表显示**。
|
||
|
||
#### 8.2.13 工艺路线列表
|
||
|
||
```
|
||
GET /mes/pro/proroute/list
|
||
```
|
||
|
||
**请求参数:**
|
||
|
||
| 参数名 | 类型 | 必填 | 说明 |
|
||
|--------|------|------|------|
|
||
| routeCode | string | 否 | 工艺路线编号（模糊） |
|
||
| routeName | string | 否 | 工艺路线名称（模糊） |
|
||
| enableFlag | string | 否 | 是否启用，默认 Y |
|
||
| pageNum | integer | 否 | 页码 |
|
||
| pageSize | integer | 否 | 每页条数 |
|
||
|
||
**响应:** 返回工艺路线列表，字段含 routeId、routeCode、routeName、routeDesc、enableFlag。
|
||
|
||
---
|
||
|
||
## 9. 状态流转
|
||
|
||
### 9.1 工单状态流转图
|
||
|
||
```
|
||
┌──────────────┐
|
||
│ │
|
||
┌─────────► 草稿(PREPARE) ◄─────────┐
|
||
│ │ │ │
|
||
│ └──────┬───────┘ │
|
||
│ │ │
|
||
│ [审核操作] [反审核操作]
|
||
│ │ │
|
||
│ ▼ │
|
||
│ ┌──────────────┐ │
|
||
│ │ │ │
|
||
│ │ 审核/已确认 ├───────────┘
|
||
│ │ (CONFIRMED) │ ── 可领料/报工/排产
|
||
│ │ │
|
||
│ └──────┬───────┘
|
||
│ │
|
||
│ ┌────────┼────────┐
|
||
│ │ │
|
||
│ [完工操作] [取消操作]
|
||
│ │ │
|
||
│ ▼ ▼
|
||
│ ┌──────────────┐ ┌──────────────┐
|
||
│ │ │ │ │
|
||
│ │ 已完成 │ │ 已取消 │
|
||
│ │ (FINISHED) │ │ (CANCELED) │
|
||
│ │ │ │ │
|
||
│ └──────────────┘ └──────────────┘
|
||
│ ▲
|
||
│ │
|
||
└──────────[取消操作]───────┘
|
||
```
|
||
|
||
### 9.2 状态说明
|
||
|
||
| 状态 | 编码 | 可执行操作 | 说明 |
|
||
|------|------|-----------|------|
|
||
| 草稿 | PREPARE | 编辑、保存、删除、**审核**、取消 | 初始状态，可自由编辑 |
|
||
| 审核/已确认 | CONFIRMED | 查看、**反审核**、完工、取消、排产、一键领料、手动领料、一键报工、报工 | 已审核，可进行生产执行 |
|
||
| 已审核 | APPROVED | 同 CONFIRMED | 审核生效（等同已确认） |
|
||
| 已完成 | FINISHED | 查看 | 工单结案，不可修改 |
|
||
| 已取消 | CANCELED | 查看 | 工单已取消，不可修改 |
|
||
|
||
---
|
||
|
||
## 10. 业务规则
|
||
|
||
### 10.1 编码规则
|
||
|
||
| 规则 | 说明 |
|
||
|------|------|
|
||
| 生成方式 | 后端自动生成，使用统一编码引擎 `AutoCodeUtil.genSerialCode()` |
|
||
| 编码规则常量 | `UserConstants.SCGD_CODE = "WORKORDER_CODE"`（Java 常量名 `SCGD_CODE`，值为数据库中已配置的规则编码 `WORKORDER_CODE`） |
|
||
| 调用位置 | `ProWorkorderController.add()` 方法中，保存前自动生成（**已实现**） |
|
||
| 前端表现 | 工单编码字段为只读，显示占位符"系统自动生成"（**已实现**） |
|
||
| 唯一性 | 工单编码全局唯一，后端校验 |
|
||
| 数据库配置 | `sys_auto_code_rule` 表中规则编码为 `WORKORDER_CODE`（**已在数据库中配置，无需新增**） |
|
||
|
||
> **实现状态**: 已完成。`ProWorkorderController.add()` 中注入了 `AutoCodeUtil`，在保存前自动生成编码：
|
||
> ```java
|
||
> if (StringUtils.isEmpty(proWorkorder.getWorkorderCode())) {
|
||
> proWorkorder.setWorkorderCode(autoCodeUtil.genSerialCode(UserConstants.SCGD_CODE, ""));
|
||
> }
|
||
> ```
|
||
> 其中 `UserConstants.SCGD_CODE` 的值为 `"WORKORDER_CODE"`，对应数据库中已配置的编码规则。
|
||
|
||
### 10.2 来源规则
|
||
|
||
| 规则 | 说明 |
|
||
|------|------|
|
||
| 唯一来源 | 生产订单只能来源于生产计划单，`order_source` 固定为 PLAN |
|
||
| 计划单选择 | 新增时必须选择一个已审核(APPROVED)的生产计划单 |
|
||
| 自动带入 | 选择计划单后自动带入：产品信息、客户信息、生产数量 |
|
||
| 不可变更 | 保存后来源计划单号不可变更 |
|
||
|
||
### 10.3 工艺路线规则
|
||
|
||
| 规则 | 说明 |
|
||
|------|------|
|
||
| 可选 | 工艺路线为非必填字段，可在新增/编辑时选择 |
|
||
| 数据来源 | 工艺路线来自 `pro_route` 表，通过 `GET /mes/pro/proroute/list` 获取 |
|
||
| 默认过滤 | 默认传 `enableFlag=Y` |
|
||
| 产品关联 | 可选：根据已选产品通过 `pro_route_product` 过滤对应的工艺路线 |
|
||
|
||
### 10.4 BOM 生成规则
|
||
|
||
| 规则 | 说明 |
|
||
|------|------|
|
||
| 触发条件 | 新增工单保存时自动生成 |
|
||
| 数据来源 | 产品的 BOM 组成（md_product_bom） |
|
||
| 用量计算 | 预计使用量 = 产品 BOM 单位用量 × 生产数量 |
|
||
| 递归展开 | 若 BOM 物料本身也有子 BOM，递归展开（最多20层） |
|
||
| 数量合并 | 同一物料编码的需求量自动合并 |
|
||
| 变更处理 | 修改时若产品或数量变化，删除旧 BOM 行并重新生成 |
|
||
|
||
### 10.5 删除规则
|
||
|
||
| 规则 | 说明 |
|
||
|------|------|
|
||
| 前置条件 | 仅草稿(PREPARE)状态允许删除 |
|
||
| 级联删除 | 删除工单时同时删除关联的 pro_workorder_bom 行 |
|
||
|
||
### 10.6 审核/反审核规则
|
||
|
||
**审核规则:**
|
||
|
||
| 规则 | 说明 |
|
||
|------|------|
|
||
| 前置条件 | 仅草稿(PREPARE)状态允许审核 |
|
||
| 前置条件 | 工单必须已保存（workorderId 不为空） |
|
||
| 前置条件 | 产品信息必须已填写（productId 不为空） |
|
||
| 状态变更 | status 从 PREPARE → CONFIRMED |
|
||
| 审核后效果 | 工单变为只读，不可编辑；自动填充审核员和审核日期 |
|
||
| 审核后操作 | 可进行：反审核、一键领料、手动领料、一键报工、报工、排产、完工、取消 |
|
||
|
||
**反审核规则:**
|
||
|
||
| 规则 | 说明 |
|
||
|------|------|
|
||
| 前置条件 | 仅已确认(CONFIRMED)或已审核(APPROVED)状态允许反审核 |
|
||
| 下游校验 | 反审核前校验：没有已执行（FINISHED）的领料单，没有完工记录 |
|
||
| 状态变更 | status 从 CONFIRMED → PREPARE |
|
||
| 反审核后效果 | 工单恢复可编辑，清空审核员和审核日期 |
|
||
| 按钮变化 | 编辑按钮恢复可点击，隐藏领料/报工按钮 |
|
||
|
||
### 10.7 一键领料规则
|
||
|
||
| 规则 | 说明 |
|
||
|------|------|
|
||
| 前置条件 | 工单状态为已确认(CONFIRMED)或已审核(APPROVED) |
|
||
| 前置条件 | 工单必须有至少一条 BOM 物料行 |
|
||
| 创建领料单头 | 自动创建 wm_issue_header，关联 workorderId/workorderCode，状态=PREPARE |
|
||
| 创建领料行 | 遍历工单 BOM 物料，为每条创建 wm_issue_line，领料数量=预计使用量 |
|
||
| 返回结果 | 返回新建的领料单 ID，前端跳转领料单编辑页 |
|
||
| 可重复 | 同一工单可多次执行一键领料（分批领料场景） |
|
||
| 用户可调整 | 领料单创建后为草稿状态，用户可调整数量后再执行出库 |
|
||
|
||
### 10.8 手动领料规则
|
||
|
||
| 规则 | 说明 |
|
||
|------|------|
|
||
| 前置条件 | 工单状态为已确认(CONFIRMED)或已审核(APPROVED) |
|
||
| 操作方式 | 跳转到领料单新增页面，URL 携带 workorderId 和 workorderCode |
|
||
| 自动关联 | 领料单新增页自动填充工单ID和工单编码 |
|
||
| 手动添加 | 用户手动选择物料并填写领料数量 |
|
||
|
||
### 10.9 完工/取消规则
|
||
|
||
| 操作 | 影响范围 | 说明 |
|
||
|------|----------|------|
|
||
| 完工 | 工单 + 所有生产任务 | 工单和所有关联生产任务状态都设为 FINISHED |
|
||
| 取消 | 工单 + 所有生产任务 | 工单和所有关联生产任务状态都设为 CANCELED |
|
||
|
||
---
|
||
|
||
## 11. 前端组件设计
|
||
|
||
### 11.1 文件结构
|
||
|
||
```
|
||
src/
|
||
├── api/
|
||
│ └── workOrder.ts # 生产工单相关API接口定义
|
||
├── views/
|
||
│ └── Production/
|
||
│ └── WorkOrder/
|
||
│ ├── index.vue # 生产工单列表页
|
||
│ ├── form.vue # 生产工单新增/编辑/查看页
|
||
│ └── components/
|
||
│ ├── PlanSelectDialog.vue # 选择生产计划单弹窗组件
|
||
│ ├── RouteSelectDialog.vue # 选择工艺路线弹窗组件
|
||
│ ├── WorkorderBomTable.vue # BOM物料组成子表组件
|
||
│ └── ClientSelectDialog.vue # 选择客户弹窗组件（备用）
|
||
```
|
||
|
||
### 11.2 路由配置
|
||
|
||
```javascript
|
||
// src/router/index.ts
|
||
{
|
||
path: '/production',
|
||
component: Layout,
|
||
meta: { title: '生产管理', icon: 'el-icon-setting' },
|
||
children: [
|
||
{
|
||
path: 'work-order',
|
||
name: 'WorkOrderList',
|
||
component: () => import('@/views/Production/WorkOrder/index.vue'),
|
||
meta: { title: '生产订单', icon: 'el-icon-tickets' }
|
||
},
|
||
{
|
||
path: 'work-order/new',
|
||
name: 'WorkOrderNew',
|
||
component: () => import('@/views/Production/WorkOrder/form.vue'),
|
||
meta: { title: '新增生产工单', activeMenu: '/production/work-order' },
|
||
hidden: true
|
||
},
|
||
{
|
||
path: 'work-order/edit/:id',
|
||
name: 'WorkOrderEdit',
|
||
component: () => import('@/views/Production/WorkOrder/form.vue'),
|
||
meta: { title: '编辑生产工单', activeMenu: '/production/work-order' },
|
||
hidden: true
|
||
},
|
||
{
|
||
path: 'work-order/view/:id',
|
||
name: 'WorkOrderView',
|
||
component: () => import('@/views/Production/WorkOrder/form.vue'),
|
||
meta: { title: '查看生产工单', activeMenu: '/production/work-order' },
|
||
hidden: true
|
||
}
|
||
]
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
## 12. 数据模型
|
||
|
||
### 12.1 表关系图
|
||
|
||
```
|
||
┌──────────────────────────┐
|
||
│ erp_mp_plan │
|
||
│ (生产计划单) │ ┌──────────────────────────┐
|
||
│ plan_id, plan_code ──────┼─────►│ pro_workorder │
|
||
│ 产品信息, 客户信息 │ │ (生产工单) │
|
||
└──────────────────────────┘ │ │
|
||
│ workorder_id (PK) │
|
||
┌──────────────────────────┐ │ source_code (计划单号) │
|
||
│ pro_route │ │ product_id, quantity │
|
||
│ (工艺路线) │ │ route_id (FK) ★ │
|
||
│ route_id ────────────────┼─────►│ production_date ★ │
|
||
│ route_code, route_name │ │ status │
|
||
└──────────────────────────┘ └──────────┬───────────────┘
|
||
│ 1:N
|
||
▼
|
||
┌──────────────────────────┐ ┌──────────────────────────┐
|
||
│ md_product_bom │ │ pro_workorder_bom │
|
||
│ (产品BOM组成) │─────►│ (工单BOM物料组成) │
|
||
│ │ │ │
|
||
│ item_id, bom_item_id │ │ workorder_id (FK) │
|
||
│ quantity │ │ item_id, quantity │
|
||
└──────────────────────────┘ └──────────────────────────┘
|
||
│
|
||
┌──────────────┼──────────────┐
|
||
│ │ │
|
||
▼ ▼ ▼
|
||
┌──────────────────┐ ┌──────────────┐ ┌──────────────┐
|
||
│ wm_issue_header │ │ pro_task │ │ 完工入库单 │
|
||
│ (生产领料单) │ │ (生产任务) │ │ │
|
||
│ workorder_id(FK) │ │ workorder_id │ │ workorder_id │
|
||
│ ★一键领料/手动 │ │ (FK) │ │ (FK) │
|
||
└──────────────────┘ └──────────────┘ └──────────────┘
|
||
```
|
||
|
||
### 12.2 数据同步方向
|
||
|
||
```
|
||
ERP (pro_workorder) ──同步──► MOM (pro_workorder)
|
||
```
|
||
|
||
- 同步方向: ERP → MOM（单向同步）
|
||
- 同步触发: 工单创建/修改/状态变更时同步
|
||
|
||
---
|
||
|
||
## 附录A: 状态标签颜色映射
|
||
|
||
```javascript
|
||
// 状态标签类型映射
|
||
const statusTagMap = {
|
||
'PREPARE': 'info', // 灰色 - 草稿
|
||
'CONFIRMED': 'primary', // 蓝色 - 已确认
|
||
'APPROVED': 'success', // 绿色 - 已审核
|
||
'FINISHED': 'success', // 绿色 - 已完成
|
||
'CANCELED': 'danger' // 红色 - 已取消
|
||
}
|
||
|
||
// 状态标签文字映射
|
||
const statusLabelMap = {
|
||
'PREPARE': '草稿',
|
||
'CONFIRMED': '已确认',
|
||
'APPROVED': '已审核',
|
||
'FINISHED': '已完成',
|
||
'CANCELED': '已取消'
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
## 附录B: 权限标识汇总
|
||
|
||
| 权限标识 | 说明 | 对应操作 |
|
||
|----------|------|----------|
|
||
| mes:pro:workorder:list | 列表查询 | 查看生产工单列表 |
|
||
| mes:pro:workorder:query | 详情查询 | 查看工单详情 |
|
||
| mes:pro:workorder:add | 新增 | 新增生产工单 |
|
||
| mes:pro:workorder:edit | 编辑 | 修改工单、确认、完工、取消 |
|
||
| mes:pro:workorder:remove | 删除 | 删除生产工单 |
|
||
| mes:pro:workorder:export | 导出 | 导出工单列表 |
|
||
| mes:wm:issueheader:add | 领料 | 一键领料、创建领料单 |
|
||
|
||
---
|
||
|
||
## 修订历史
|
||
|
||
| 版本 | 日期 | 修订内容 | 修订人 |
|
||
|------|------|----------|--------|
|
||
| 1.0.0 | 2026-02-13 | 初始版本，基于后端 ProWorkorder 实体类、ProWorkorderController 控制器及 pro_workorder 表结构编写完整页面开发说明 | System |
|
||
| **2.0.0** | **2026-02-13** | **重大业务逻辑调整**：(1) 生产订单只来源于生产计划单，新增时选择计划单号自动带入产品/客户信息，移除手动创建和销售订单直接创建；(2) 新增「一键领料」功能，根据 BOM 自动创建领料单；(3) 新增「创建领料单」按钮，支持手动跳转领料单页面；(4) 需求日期改为生产日期(production_date)；(5) 表头新增工艺路线选择（route_id/route_code/route_name），从 pro_route 表选取 | System |
|
||
| **2.1.0** | **2026-02-13** | **完善优化**：(1) 工单编码改为后端通过 AutoCodeUtil 自动生成（SCGD_CODE），前端只读；(2) 修复工艺路线弹窗列表为空：移除默认 enableFlag=Y 过滤；(3) 明确 BOM 子表使用 /mes/pro/workorderbom/list 接口（直接 BOM），而非 /listItems（递归展开格式不兼容） | System |
|
||
| **2.2.0** | **2026-02-13** | **补全确认状态处理**：新增确认按钮和接口 | System |
|
||
| **3.1.0** | **2026-02-13** | **根据截图全面完善**（参考 screenshot/生产管理-生产工单表单-查看操作等.png）：(1) 表头改为5列布局，新增字段：业务类型、操作员、审核员、审核日期、跟单编号、订单交期、需求日期、图纸号、生产线、加工时长；(2) 查看页按钮完整定义：新增→编辑→审核→反审核→打印→操作下拉(挂起/关闭/调整工期/调整产线)→收起；(3) 新增反审核接口 PUT /mes/pro/workorder/unconfirm/{id}，支持 CONFIRMED→PREPARE 并校验下游单据；(4) 新增领料明细子表（4.4）和完工明细子表（4.5），各含一键操作和手动操作按钮；(5) 新增6.4领料明细区按钮（一键领料+领料）和6.5完工明细区按钮（一键报工+报工）；(6) 完善状态流转图增加反审核路径；(7) 审核/反审核规则完整定义（10.6） | System |
|