feat: 新增收集式校验错误弹窗及工位报警语音播报

新增 ErrorListDialog 组件用于统一展示结构化校验错误信息,实现报错一次收全;新增工位报警语音播报功能,通过浏览器 SpeechSynthesis 播放本工位相关报警;调整物料类别及序列号字段文案,移除「其他」类别;新增工单实际开始字段及采集方式配置;优化 AGV 及 PlcSend 页签刷新逻辑;新增看板物料追溯及工位报警接口;删除 PLC 强制写 M 位及相关测试代码;同步数据库字段注释及补丁。
This commit is contained in:
SunYF
2026-10-20 16:36:26 +08:00
parent f743cf21fb
commit b0c048d9aa
126 changed files with 4603 additions and 1639 deletions
+6
View File
@@ -1,7 +1,13 @@
<template>
<router-view />
<!-- 收集式校验错误弹窗(报错一次收全,全局唯一挂载) -->
<ErrorListDialog />
</template>
<script setup>
import ErrorListDialog from './components/ErrorListDialog.vue'
</script>
<style>
html, body, #app { height: 100%; margin: 0; font-family: -apple-system, "PingFang SC", "Microsoft YaHei", sans-serif; }
body { background: #f0f2f5; }
@@ -0,0 +1,57 @@
<template>
<el-dialog
v-model="state.show"
:title="`保存失败,共 ${state.errors.length} 项需要处理`"
width="560px"
:close-on-click-modal="false"
>
<div class="ve-list">
<div v-for="(e, i) in state.errors" :key="i" class="ve-item">
<div class="ve-msg">{{ i + 1 }}. {{ e.message }}</div>
<div v-if="e.suggestion" class="ve-sug">→ {{ e.suggestion }}</div>
<el-button v-if="e.action && e.action.url" size="small" type="primary" plain class="ve-btn" @click="go(e.action)">
{{ e.action.label }}
</el-button>
</div>
</div>
<template #footer>
<el-button @click="state.show = false">关闭</el-button>
</template>
</el-dialog>
</template>
<script setup>
// 收集式校验错误弹窗(报错一次收全 + 每条带怎么办,2026-10-20):
// 请求拦截器识别 code=3015(data.errors 结构化清单)→ showValidationErrors() → 本弹窗一次列全;
// 每条 = 现象(粗体)+ 建议(灰色)+ 可选跳转按钮。
// action 跳转用新开标签页(window.open):当前页表单草稿保留,不丢上下文(已裁定方案)。
import { state } from '../utils/verror'
function go(action) {
state.show = false
window.open(action.url, '_blank')
}
</script>
<style scoped>
.ve-item {
padding: 8px 4px;
border-bottom: 1px dashed var(--el-border-color-lighter, #ebeef5);
}
.ve-item:last-child {
border-bottom: none;
}
.ve-msg {
font-weight: 600;
line-height: 1.5;
}
.ve-sug {
color: #909399;
font-size: 12px;
margin-top: 2px;
line-height: 1.5;
}
.ve-btn {
margin-top: 6px;
}
</style>
@@ -10,8 +10,8 @@ const props = defineProps({
modelValue: { type: [String, Array], default: '' },
multiple: { type: Boolean, default: false },
manageMode: { type: Number, default: 0 }, // 0=全部 1=结构件 2=电气件
itemType: { type: Number, default: 0 }, // 0=全部 1原材料 2半成品 3成品 4其他
excludeItemType: { type: Number, default: 0 }, // 排除指定物料类别,如结构件/电气件入库排除「其他」(4)
itemType: { type: Number, default: 0 }, // 0=全部 1原材料 3成品(「其他」类别已按 2026-10-19 裁决移除)
excludeItemType: { type: Number, default: 0 }, // 排除指定物料类别(按管理粒度过滤下拉时用)
onlyActive: { type: Boolean, default: true }, // 下拉默认仅显示启用物料(停用物料不在新建入库/备料等下拉出现)
placeholder: { type: String, default: '选择物料' },
clearable: { type: Boolean, default: true },
+4 -4
View File
@@ -79,7 +79,7 @@ export const helpOutbound = {
{ name: '备料出库-工单号', source: '下拉选择 + 模糊搜索。数据来自 MES 实时工单(未完成优先,无输入默认前 20 条)。', purpose: '出库挂靠的工单,决定可领料总量与需求缺口', fill: '下拉选工单号(或输入关键字模糊搜索;MES 不可达时可手输兜底),选中即查询该工单的物料台账' },
{ name: '备料出库-目标工位', source: '下拉选择 DOCK01~DOCK20(选填,可过滤搜索)。', purpose: 'AGV 配送送达的接驳台(toDock 参数)', fill: '选择如 DOCK05;不选默认运到产线入口 DOCK01' },
{ name: '备料出库-一键分配出库', source: '系统自动按 FIFO 分配。数据来自合格区Z02的批次库存。', purpose: '从合格区按先进先出凑够缺口并出库', fill: '点按钮,系统自动算批次并二次确认' },
{ name: '通用出库-物料', source: '下拉选择(全项目统一组件)。', purpose: '选定要出库的物料', fill: '下拉显示 编码/图号/类型(电气件/结构件/其他)/物料类别(原材料/半成品/成品/其他),支持远程搜索' },
{ name: '通用出库-物料', source: '下拉选择(全项目统一组件)。', purpose: '选定要出库的物料', fill: '下拉显示 编码/图号/类型(电气件/结构件/其他)/物料类别(原材料/成品),支持远程搜索' },
{ name: '通用出库-序列号', source: '系统自动判定(来自物料档案的「序列号=是(按 SN 记账)」设置 sn_mode)。', purpose: '决定走批次扣减还是 SN 扣减(2026-09-30 与物料类型解耦)', fill: '只读:选物料后自动显示序列号=否(按批次记账)或序列号=是(按 SN 记账),无需也不允许手选' },
{ name: '通用出库-出库类别', source: '下拉点选(纯标签记录,不联动任何地方)。', purpose: '区分退料/退货/样品/报废/发货/其他,列表与出库单均显示', fill: '必选;选「其他」时需在备注填写具体原因' },
{ name: '通用出库-归属', source: '下拉选归属类型 + 手填归属编号。', purpose: '记录出库归属(合同号/科技项目号/其他),仅追溯不联动 MES', fill: '默认「其他」;选合同号/科技项目号时归属编号必填,长度≤64' },
@@ -104,7 +104,7 @@ export const helpInventory = {
{ name: '图号 / 物料名称', source: '筛选条件(物料汇总、库位明细视图生效)。', purpose: '只看某个物料', fill: '输入图号或名称,可空=全部' },
{ name: '库存类型', source: '单选(全部/结构件/电气件/其他)。结构件=类型1且排除「其他」;电气件=类型2;其他=类型3(辅料/工装/试验设备)。', purpose: '纯分类筛选(2026-09-30 类型与序列号(sn_mode)解耦):类型不再决定批次/SN 行为,序列号(sn_mode)由物料档案「序列号=是(按 SN 记账)」(sn_mode)独立决定', fill: '全部 / 结构件 / 电气件 / 其他;物料汇总与库位明细视图生效' },
{ name: '归属单号', source: '筛选条件(物料汇总、库位明细视图生效)。归属编号来自入库时登记的「归属」(合同号/科技项目号/其他编号)。', purpose: '库存按归属查(问题8):物料汇总是先按归属模糊过滤库存行、再按物料聚合,总数量/批次数/SN数与质量分布均只统计归属命中的行,口径与库位明细一致', fill: '模糊输入合同号/科技项目号等归属编号(大小写不敏感),回车或点【查询】生效;清空后查询恢复全量' },
{ name: '物料类别', source: '单选(全部/原材料/半成品/成品/其他)。', purpose: '按物料类别过滤:原材料=采购到货入库;半成品=MES 工位暂存退库;成品=MES 完工自动回流(成品 SN 系统生成,入库单号形如 MES:工单号);其他=辅料/工装/试验设备(ITEM_TYPE=4)。注意:选「全部」时三个聚合视图默认排除半成品(半成品在「半成品管理」单独记录),需显式选「半成品」才会纳入', fill: '全部 / 原材料 / 半成品 / 成品 / 其他;物料汇总与库位明细视图生效' },
{ name: '物料类别', source: '单选(全部/原材料/半成品/成品)。', purpose: '按物料类别过滤:原材料=采购到货入库;半成品=MES 工位暂存退库;成品=MES 完工自动回流(成品 SN 系统生成,入库单号形如 MES:工单号)。注意:选「全部」时三个聚合视图默认排除半成品(半成品在「半成品管理」单独记录),需显式选「半成品」才会纳入', fill: '全部 / 原材料 / 半成品 / 成品;物料汇总与库位明细视图生效' },
{ name: '库位明细-区域/货架/层/位置', source: '四级联动下拉(仅「库位明细」视图生效)。区域来自"区域维护";选区域后联动出货架、选货架联动出层、选层联动出位置,上级清空自动清空下级。', purpose: '精确到货位筛选库存,与入库/出库库位四级贯通', fill: '逐级选择;只选区域也可只按大区筛;切换上级自动清空下级' },
{ name: '库位明细-质量状态', source: '单选(全部/未检/合格/不合格,仅「库位明细」生效)。', purpose: '不合格品一屏定位(需求A5)', fill: '选「不合格」直接看所有隔离中的不良库存' },
{ name: '库位明细-入库时间', source: '仅「库位明细」生效的日期筛选(默认近3个月起)。', purpose: '按入库时间收窄', fill: '可与区域/质量组合' },
@@ -318,13 +318,13 @@ export const helpAttachment = {
export const helpMaterial = {
title: '物料档案',
overview:
'定义每一种物料的字典:叫什么、什么规格、什么物料类别(原材料/成品/其他)、什么类型(结构件/电气件/其他),以及是【序列号=是(按 SN 记账)】还是【序列号=否(按批次记账)】。\n此处维护的物料会作为下拉选项出现在入库/出库/装箱等页面;「类型」仅用于分类统计/筛选/页签归属;「序列号=是(按 SN 记账)」(sn_mode) 决定出入库的序列号(sn_mode)——序列号=是(按 SN 记账)走 SN 逐件扫码(单件追溯)、序列号=否(按批次记账)按数量一批多件。两者相互独立(2026-09-30 解耦定稿):选类型时自动带默认(电气件→序列号=是(按 SN 记账),结构件/其他→序列号=否(按批次记账)),可手动更改。\n\n物料类别来源:原材料=进货来的(外购);成品=自己生产的;其他=辅料/工装/试验设备等。成品还可以作为零部件,放进另一个成品的物料清单里被再次加工成新的成品。\n\n物料类别说明:1=原材料(默认) / 3=成品 / 4=其他(辅料/工装/试验设备)。半成品不是物料物料类别(2026-09-22 定稿)——半成品是工件状态,由统一库存主表物料类别 category=2 承载,物料档案不再有半成品行。编码主数据单一来源在本表:MES 的「物料档案」页面即是本表中"成品"物料类别的视图(实时拉取本表,不双录)——两系统的「物料档案」指向同一份主数据,以本表为准。库存主表 inventories 的物料类别与其呼应。列表支持按物料类别筛选,导出含物料类别列。\n\n物料档案是库房的另一道地基:先建好物料,入库时才能选到;「序列号=是(按 SN 记账)」未选择(0)的物料不能出入库。\n\n命名说明:本档案维护的物料在出库/看板等页面统一以"图号"展示(客户口径)。安全库存在本档案维护,可用量低于它时会在「库房看板」首页触发缺货预警。',
'定义每一种物料的字典:叫什么、什么规格、什么物料类别(原材料/成品)、什么类型(结构件/电气件/其他),以及是【序列号=是(按 SN 记账)】还是【序列号=否(按批次记账)】。\n此处维护的物料会作为下拉选项出现在入库/出库/装箱等页面;「类型」仅用于分类统计/筛选/页签归属;「序列号=是(按 SN 记账)」(sn_mode) 决定出入库的序列号(sn_mode)——序列号=是(按 SN 记账)走 SN 逐件扫码(单件追溯)、序列号=否(按批次记账)按数量一批多件。两者相互独立(2026-09-30 解耦定稿):选类型时自动带默认(电气件→序列号=是(按 SN 记账),结构件/其他→序列号=否(按批次记账)),可手动更改。\n\n物料类别来源:原材料=进货来的(外购);成品=自己生产的。成品还可以作为零部件,放进另一个成品的物料清单里被再次加工成新的成品。\n\n物料类别说明:1=原材料(默认) / 3=成品(「其他」类别已按 2026-10-19 用户裁决全项目取消)。半成品不是物料物料类别(2026-09-22 定稿)——半成品是工件状态,由统一库存主表物料类别 category=2 承载,物料档案不再有半成品行。编码主数据单一来源在本表:MES 的「物料档案」页面即是本表中"成品"物料类别的视图(实时拉取本表,不双录)——两系统的「物料档案」指向同一份主数据,以本表为准。库存主表 inventories 的物料类别与其呼应。列表支持按物料类别筛选,导出含物料类别列。\n\n物料档案是库房的另一道地基:先建好物料,入库时才能选到;「序列号=是(按 SN 记账)」未选择(0)的物料不能出入库。\n\n命名说明:本档案维护的物料在出库/看板等页面统一以"图号"展示(客户口径)。安全库存在本档案维护,可用量低于它时会在「库房看板」首页触发缺货预警。',
fields: [
{ name: '图号', source: '手工填写,仓库自定义(新增后不可改)。在出库/看板等页面显示为"图号"。', purpose: '物料唯一编号(即图号)', fill: '如 SCREW-M3;新增后不可改编码' },
{ name: '名称', source: '手工填写(必填)。', purpose: '物料名称', fill: '如 螺丝 M3' },
{ name: '规格', source: '手工填写(必填)。', purpose: '规格型号', fill: '如 M3×8' },
{ name: '单位', source: '手工填写(必填)。', purpose: '计量单位', fill: '如 个/套' },
{ name: '物料类别', source: '必填。创建时默认"原材料";成品物料类别也可在 MES 的「物料档案」页维护(两系统同一份主数据,以本表为准)。', purpose: '区分原材料/成品/其他,与统一库存主表物料类别对应;原材料为进货、成品为自产(半成品不是物料物料类别,由库存 category=2 承载)', fill: '查询区可选 原材料/成品/其他' },
{ name: '物料类别', source: '必填。创建时默认"原材料";成品物料类别也可在 MES 的「物料档案」页维护(两系统同一份主数据,以本表为准)。', purpose: '区分原材料/成品,与统一库存主表物料类别对应;原材料为进货、成品为自产(半成品不是物料物料类别,由库存 category=2 承载)', fill: '查询区可选 原材料/成品' },
{ name: '类型', source: '必填(与「物料类别」「序列号」相互独立)。选择:结构件 / 电气件 / 其他(辅料/工装/试验设备)。', purpose: '纯分类维度(2026-09-30 解耦定稿):仅用于分类统计、筛选与入库页签归属,不再决定批次/SN 行为', fill: '结构件 / 电气件 / 其他' },
{ name: '序列号', source: '必选单选(是/否,描述「是否有序列号」,与「类型」相互独立,2026-09-30 解耦定稿)。选择类型时自动带默认:电气件→是,结构件/其他→否;可手动更改。', purpose: '决定出入库序列号(sn_mode):是(序列号=是(按 SN 记账))=逐件录 SN 单件追溯;否(序列号=否(按批次记账))=按数量一批多件;未选择(0)的物料不能出入库', fill: '是(序列号=是(按 SN 记账),逐件录SN) / 否(序列号=否(按批次记账),按数量,不录SN)' },
{ name: '安全库存', source: '必填整数(默认0)。', purpose: '该物料的最低库存警戒线;可用量低于它会在「库房看板」首页触发缺货预警', fill: '如 100;0=不预警' },
+13 -8
View File
@@ -320,8 +320,13 @@ const mForm = reactive({
})
const mSaving = ref(false)
// 类型默认联动(2026-09-30 类型与SN行为解耦):电气件→序列号=是(逐件录SN),结构件/其他→序列号=否(按批次数量);用户可手动改
// 序列号默认联动(2026-10-19 拍板规则):
// 成品(item_type=3)→序列号强制「是」且不可改;原材料(1)→默认「否」;类型为电气件(2)→默认「是」;其余默认「否」。用户可手动改(成品除外)
function onMatTypeChange() {
if (Number(mForm.itemType) === 3) {
mForm.snMode = 1
return
}
mForm.snMode = Number(mForm.manageMode) === 2 ? 1 : 2
}
@@ -402,7 +407,7 @@ function openMatEdit(row) {
async function saveMaterial() {
// 必填口径(2026-09-19 用户裁决):除「说明」外全部必填。
// 图号只在新增时必填(编辑不可改);「其他」类不做 SN,类型由后端收敛。
// 图号只在新增时必填(编辑不可改);「序列号(是/否)」由后端按物料类别规则收敛。
if (!mEditingId.value && !String(mForm.code || '').trim()) {
ElMessage.warning('图号为必填项')
return
@@ -473,7 +478,7 @@ function openMatAttach(row) {
Object.assign(attachDrawer, { visible: true, code: row.code, name: row.name })
}
// 物料类别显示(1原材料/3成品/4其他;半成品不是物料类别,防御性保留显示)
// 物料类别显示(1原材料/3成品;「其他」类别已按 2026-10-19 裁决全项目移除,防御性保留历史值显示)
function itemTypeText(t) {
return t === 3 ? '成品' : t === 4 ? '其他' : '原材料'
}
@@ -951,7 +956,6 @@ async function onMaterialFile(e) {
<el-select v-model="matFilter.itemType" placeholder="全部" clearable style="width:120px" @change="searchMaterials">
<el-option label="原材料" :value="1" />
<el-option label="成品" :value="3" />
<el-option label="其他" :value="4" />
</el-select>
</el-form-item>
<el-form-item label="启用">
@@ -1053,10 +1057,9 @@ async function onMaterialFile(e) {
<el-input v-model="mForm.unit" placeholder="如 个/套" clearable />
</el-form-item>
<el-form-item label="物料类别" required>
<el-select v-model="mForm.itemType" placeholder="请选择" style="width:100%">
<el-select v-model="mForm.itemType" placeholder="请选择" style="width:100%" @change="onMatTypeChange">
<el-option :value="1" label="原材料" />
<el-option :value="3" label="成品" />
<el-option :value="4" label="其他(辅料/工装/试验设备)" />
</el-select>
</el-form-item>
<el-form-item label="类型" required>
@@ -1068,11 +1071,13 @@ async function onMaterialFile(e) {
</el-form-item>
<el-form-item label="序列号" required>
<div>
<el-radio-group v-model="mForm.snMode">
<el-radio-group v-model="mForm.snMode" :disabled="Number(mForm.itemType) === 3">
<el-radio :value="1">是</el-radio>
<el-radio :value="2">否</el-radio>
</el-radio-group>
<span style="color:#909399;font-size:12px;margin-left:8px">是=逐件录SN,否=按数量(不录SN)</span>
<span style="color:#909399;font-size:12px;margin-left:8px">
{{ Number(mForm.itemType) === 3 ? '成品序列号必须为「是」,不可修改' : '是=逐件录SN,否=按数量(不录SN)' }}
</span>
</div>
</el-form-item>
<el-form-item label="安全库存" required>
@@ -1,6 +1,7 @@
import axios from 'axios'
import { ElMessage } from 'element-plus'
import { getToken } from './auth'
import { showValidationErrors } from './verror'
// 统一请求实例:baseURL /api,响应为 { code, message, data }
const request = axios.create({ baseURL: '/api', timeout: 30000 })
@@ -32,6 +33,15 @@ request.interceptors.response.use(
const body = resp.data
if (body && typeof body === 'object' && 'code' in body) {
if (body.code !== 0) {
// 收集式校验错误(code=3015,报错一次收全,2026-10-20):
// data.errors 结构化清单 → ErrorListDialog 一次弹全,不走 ElMessage 单条
if (body.code === 3015 && Array.isArray(body.data?.errors) && body.data.errors.length) {
showValidationErrors(body.data.errors)
const e = new Error(body.message || '保存失败')
e.code = 3015
e.errors = body.data.errors
return Promise.reject(e)
}
const msg = friendlyMsg(body.message || '操作失败')
ElMessage.error(msg)
return Promise.reject(new Error(msg))
+15
View File
@@ -0,0 +1,15 @@
import { reactive } from 'vue'
// 收集式校验错误全局状态(报错一次收全,2026-10-20):
// 请求拦截器识别 code=3015 后调 showValidationErrors(errors),
// App.vue 挂载的 ErrorListDialog 读取本状态一次弹全,不再 ElMessage 单条挤牙膏。
export const state = reactive({ show: false, errors: [] })
export function showValidationErrors(errors) {
state.errors = Array.isArray(errors) ? errors : []
state.show = state.errors.length > 0
}
export function closeValidationErrors() {
state.show = false
}