feat: 来料检处置项实体与复检、日排产达成对比、PLC/WMS 传输日志

- WMS 新增「检验处置项」实体(schema + ent 生成码),配套检验记录实体调整与复检接口,完善来料检/不良退货/入库检验前端
- MES 日排产:新增达成率统计与计划对比逻辑,调整日排产前端与流程卡/工序流
- 日志与传输:MES 新增 PLC 日志与 WMS 客户端传输日志,WMS 新增 MES 客户端传输日志
- MES 其他:扫码、工单/工件、AGV 客户端与告警、产品导入等逻辑完善及前端调整
- 工位终端:上线面板/作业面板、工件 handler 与 MES 客户端调整
- 配置与文档:更新 mes-api.yaml、三端构建产物与问题记录文档
This commit is contained in:
SunYF
2026-11-16 16:42:44 +08:00
parent b32ec7c03d
commit d92ca803d5
72 changed files with 5135 additions and 1526 deletions
+11 -7
View File
@@ -14,7 +14,7 @@ export const helpProductType = P('成品档案', '这里是成品型号的源头
{ k: 'confuse', t: '三个编号别混', text: '产品工号是工单号(一批一个);产品编码是成品型号(多个工单可以是同一个型号);产品序号(SN) 是每台工件自己的号。MES 页面叫「成品档案」,不显示「图号」——成品没有图号,也没有物料编码;这两个字段属于原材料,是 WMS 物料档案的事。改产品编码会让已建工单找不到原来的型号,追溯也跟着断。' },
{ k: 'states', t: '停用不是删除', text: '停用后新建工单的下拉里选不到它,但已经建好的工单、库存、追溯记录都还在,也还能查。这是唯一的下架方式,系统不物理删型号。' },
{ k: 'confuse', t: '「序列号=是」决定什么', text: '它决定这台工件是按批次数量记账,还是一台一个号逐件扫。选「是」时,上线建档必须扫已在 WMS 入库登记过的来料 SN,不能让系统发号。产品分类只是个默认值,跟这件事没有绑定关系。新建成品时不需要选「类型」,表虽然和原材料共用,页面上不做这个选择。' },
{ k: 'complex', t: '同步失败时两种表现不一样', text: '单条建档或编辑即使 WMS 暂时不通,本系统也会先保存下来、标上待同步,之后点「重推」补上;Excel 批量导入则是整批一起成功或一起失败,不会出现半张表进去了的情况。导入模板和模板说明与 WMS 完全同款,改模板必须两端一起改。' },
{ k: 'complex', t: '同步失败时两种表现不一样', text: '单条建档或编辑即使 WMS 暂时不通,本系统也会先保存下来、标上待同步,之后点「重推」补上;Excel 批量导入则是整批一起成功或一起失败,不会出现半张表进去了的情况。导入模板与 WMS 大体同款(MES 无「类型」列、列名一致,均按表头名识别),改模板必须两端一起改。' },
{ k: 'links', t: '上游下游', text: '上游是 WMS 物料档案(按编码互推);下游是产品工艺、工单管理、成品试验和工件追溯。' }
], [
{ name: '产品工艺', path: '/process-flow', hint: '给型号定工序' },
@@ -49,16 +49,20 @@ export const helpWorkOrder = P('工单管理', '一张工单从建单到收尾
export const helpDailyPlan = P('日排产', '排产是算料和叫料的开关,不是一张待办清单。', [
{ k: 'role', t: '这页解决什么', text: '把工单总台数摊到每一天,系统据此算「今天该领多少料」并生成叫料需求。没排产的工单不参与算料。' },
{ k: 'states', t: '排产状态与「已启用」', items: [
'PENDING 未确认 → CONFIRMED 已确认 → PROCESSING 执行中 → DONE 已完成;CANCELLED 是已取消。',
'「已启用」是算料开关:只有已确认/执行中的排产会参与备料清单和叫料需求计算。未启用不等于已取消,只是暂时不算料。',
'列表默认筛「未完成(排除已完成/已取消)」,是为了只看还要干活的日子,不是把历史数据删了。'
{ k: 'states', t: '执行状态各值的意思', items: [
'全部:不过滤,所有排产都显示。',
'未完成:不是一种状态,是组合筛选——「已完成」和「已取消」以外的都算(未启用/已启用/执行中都会显示)。列表默认选它,是为了只看还要干活的日子。',
'未启用(PENDING):新建或批量排产后的初始状态,只是计划,不参与算料。',
'已启用(CONFIRMED):人工点「启用」且工单已在进行中才能到这一态;只有已启用的排产参与备料清单和叫料需求计算。',
'执行中(PROCESSING):工单开工或当天首台完工后自动进入;工位终端能看到这一天的活,但目前不参与叫料需求计算。',
'已完成(DONE):这一天计划量做满,或所属工单完工且足额。',
'已取消(CANCELLED):工单取消,或工单已完工但这天没排满。'
] },
{ k: 'confuse', t: '「显示历史」和状态筛选各管各的', text: '默认只看今天起 30 天。想看过去,勾「显示历史」并把日期范围清空;状态选「全部」才不会被「未完成」过滤掉。两个筛选互不影响,只改一个会以为没数据。' },
{ k: 'confuse', t: '送达接驳台为什么显示中文', text: '列里显示的是「左 / 右」这样的中文接驳台名称,不是 DOCK 编码。工位 2、4、6、8、10 的左右按操作员「背向主线」的视角统一,和图纸上顺向看是反的,这是现场约定。' },
{ k: 'irreversible', t: '停用 vs 删除', text: '停用只是让这一天不参与算料;删除会把这一天从计划里拿掉,已生成的备料与叫料需求会跟着变。调整前先看这一天的备料单是否已经发出。' },
{ k: 'confuse', t: '数量为什么加不上去', text: '同一张工单各天的计划数量加起来不能超过工单总台数,系统会按累计量卡住。要加量得先改工单数量或补料审批,不是在排产里硬填。排产量可以大于当前库存,系统只预警不拦截。' },
{ k: 'complex', t: '历史透视与对比', text: '历史排产也能透视、能导出,导出的规划可以和历史规划做对比;「逐日消耗模拟」和「各工单排产支撑」都带分页,逐日消耗按实时库存变化算,别拿一次导出当永久快照。' }
{ k: 'complex', t: '透视与对比目前只覆盖未完成', text: '「按日期透视」和「按工单折叠」强制只显示未完成的工单,已完工/已取消的历史排产进不了透视;「对比/导出差异」算的是计划数与已完成数的差额账,不是两份规划快照的对比。想看历史完工情况,把日期范围调到过去、状态选「全部」看列表。历史排产的整体透视、规划导出与规划对比尚未实现,属待实现需求。「逐日消耗模拟」和「各工单排产支撑」都带分页,逐日消耗按实时库存变化算,别拿一次导出当永久快照。' }
], [
{ name: '工单管理', path: '/work-order' },
{ name: '叫料单', path: '/material-request', hint: '排产算出来的需求' },
@@ -322,7 +326,7 @@ export const helpPlc = P('工位下发', '把某张工单要经过的工位组
export const helpPlcMonitor = P('PLC管理', '本页手动写点位,按钮按下去就真下发给 PLC 了。', [
{ k: 'role', t: '这页解决什么', text: '设备联调、异常处置时给维护人员一个直接读写 PLC 点位、看在途指令的入口。日常生产不需要在这里操作。' },
{ k: 'states', t: '在途与模拟数据', text: '在途=MW 寄存器非 0,同一工位有在途指令时新的手动下发会被互斥挡掉。页面标了「模拟数据」时,看到的是 mock 点位状态,别拿它判断现场实物。本页不自动刷新,要看最新状态得手动刷新。' },
{ k: 'irreversible', t: '强制清零', text: '二次确认 + 勾选现场安全后才执行,只清 PLC 的在途标记,不回滚 MES 台账、不撤销已经报过的工。清零之前务必在实物上确认工件位置。' },
{ k: 'irreversible', t: '强制清零到底动了什么', text: '它改的是 PLC 内存里的一条「搬运任务便签」:把约定好的在途指令寄存器(M 区一个字)写成 0,不是删 PLC 程序、不动 DB 块和传感器位,PLC 不会因此停机或损坏;MES 侧只留一条操作日志,不回滚台账、不撤销已报的工。真正的危险是清早了——托盘还在搬运中就把它清零,上位机会误判这趟搬运已完成,可能接着下发新指令,两个动作撞在一起。所以必须现场确认工件真卡住、PLC 已经不动作了再点。矫正对象是 PLC 本身,不是 MES 数据库;越界地址一律拒绝,只允许清约定范围内的在途指令字。' },
{ k: 'complex', t: '被拦下来时先分清是谁拦的', text: '「已有在途指令」和「多工单缓存策略=严格隔离」是两道不同的检查。前一种无论哪种策略都会先拦,看起来像策略问题其实不是。' },
{ k: 'complex', t: '多工单缓存策略在这页会看到什么', text: '这个策略除了管报工后的自动流转(详见「基础设置」帮助),也管本页手动下发:目标必须是 C 类主线位置、而且是可缓存位(C2/C3/C5/C6/C8/C9/C11/C12/C14),MES 台账显示被别的工单占着时,严格隔离会拒绝这次下发并报出占用的 SN 和工单号。切回物理优先就能下发,改完立刻生效。' }
], [
+97 -4
View File
@@ -22,7 +22,7 @@
<el-form-item label="执行状态">
<el-select v-model="query.status" style="width:170px" placeholder="请选择状态" @change="load">
<el-option label="全部" value="all" />
<el-option label="未完成(排除已完成/已取消)" value="active" />
<el-option label="未完成" value="active" />
<el-option label="未启用" value="PENDING" />
<el-option label="已启用" value="CONFIRMED" />
<el-option label="执行中" value="PROCESSING" />
@@ -58,6 +58,7 @@
<el-button type="primary" @click="load">查询</el-button>
<el-button @click="resetFilters">重置</el-button>
<el-button @click="openCompare">对比</el-button>
<el-button @click="openAttain">计划vs实际</el-button>
<el-button v-if="can('produce.workorder:dailyplan')" type="success" @click="openAdd()">新建排产</el-button>
</el-form-item>
</el-form>
@@ -303,6 +304,31 @@
计划合计:<b>{{ compare.summary.planTotal ?? 0 }}</b> 完成合计:<b>{{ compare.summary.doneTotal ?? 0 }}</b> 差异合计:<b>{{ compare.summary.diffTotal ?? 0 }}</b> 工单数:<b>{{ compare.summary.orderCount ?? 0 }}</b>
</div>
</el-drawer>
<!-- 计划vs实际(2026-11-16 死结6:完工流水汇聚,不建新表) -->
<el-drawer v-model="attain.show" title="计划 vs 实际(按完工流水汇聚)" size="62%">
<div style="margin-bottom:12px;display:flex;align-items:center;gap:12px;flex-wrap:wrap">
<el-date-picker v-model="attain.range" type="daterange" value-format="YYYY-MM-DD" range-separator="至" start-placeholder="开始日期" end-placeholder="结束日期" style="width:260px" @change="loadAttain" />
<el-button type="primary" @click="loadAttain">查询</el-button>
<el-button @click="exportAttain">导出</el-button>
<span style="color:#909399;font-size:12px">实际完成=完工流水(与生产流程卡同源)按天聚合;负差异=欠产</span>
</div>
<el-table :data="attain.items" border size="small" v-loading="attain.loading" empty-text="该日期范围暂无数据">
<el-table-column prop="date" label="日期" width="120" />
<el-table-column prop="orderNo" label="工单号(产品工号)" min-width="150" />
<el-table-column prop="planQty" label="计划数量" width="100" />
<el-table-column prop="doneQty" label="实际完成" width="100" />
<el-table-column prop="diff" label="差异" width="90">
<template #default="{ row }">
<span :style="row.diff < 0 ? 'color:#f56c6c' : row.diff > 0 ? 'color:#67c23a' : ''">{{ row.diff }}</span>
</template>
</el-table-column>
<el-table-column label="明细" width="90">
<template #default="{ row }">
<el-button size="small" link type="primary" @click="goAttainDetail(row)">看流程卡</el-button>
</template>
</el-table-column>
</el-table>
</el-drawer>
</el-card>
<PageHelp :data="helpDailyPlan" page="DailyPlan" />
</template>
@@ -316,6 +342,7 @@
<script setup>
import { reactive, ref, computed, onMounted } from 'vue'
import { useRouter } from 'vue-router'
import { ElMessage, ElMessageBox } from 'element-plus'
import request from '../utils/request'
import { can } from '../utils/perm'
@@ -336,8 +363,8 @@ function addDays(n) {
const query = reactive({
orderNos: [],
dateRange: [todayStr(), addDays(30)],
// 2026-11-10:默认「全部」,不再默认排除已完成/已取消(用户看不懂 active 语义)
status: 'all',
// 2026-11-16 用户定案:执行状态默认「未完成」;「未完成」=排除已完成/已取消的组合筛选(非状态值)
status: 'active',
product: '',
operator: '',
docks: [],
@@ -348,7 +375,7 @@ const query = reactive({
})
function resetFilters() {
Object.assign(query, {
orderNos: [], dateRange: [todayStr(), addDays(30)], status: 'all',
orderNos: [], dateRange: [todayStr(), addDays(30)], status: 'active',
product: '', operator: '', docks: [], qtyMin: null, qtyMax: null, showHistory: false, sort: 'asc'
})
load()
@@ -757,6 +784,72 @@ async function exportCompare() {
ElMessage.error('导出差异失败')
}
}
// ---------- 计划 vs 实际(2026-11-16 死结6:完工流水汇聚,不建新表)----------
const attain = reactive({ show: false, loading: false, items: [], range: [] })
const router = useRouter()
function attainRange() {
const r = attain.range
return {
start: r && r[0] ? r[0] : compareRange().start,
end: r && r[1] ? r[1] : compareRange().end
}
}
async function openAttain() {
attain.show = true
if (!attain.range || !attain.range[0]) attain.range = [compareRange().start, compareRange().end]
await loadAttain()
}
async function loadAttain() {
const { start, end } = attainRange()
attain.loading = true
try {
const data = await request.get('/daily-plans/attainment', { params: { start, end } })
attain.items = Array.isArray(data) ? data : []
} catch {
attain.items = []
} finally {
attain.loading = false
}
}
// 明细:跳生产流程卡并自动带入工单号查询(用户拍板:要看明细就跳流程卡,不在此页堆明细)
function goAttainDetail(row) {
attain.show = false
router.push({ name: 'ProcessCard', query: { orderNo: row.orderNo } })
}
// 导出:后端直出 xlsx(同 exportCompare 方式)
async function exportAttain() {
const { start, end } = attainRange()
const params = new URLSearchParams()
params.set('start', start)
params.set('end', end)
try {
const resp = await fetch('/api/v1/daily-plans/attainment/export?' + params.toString(), {
headers: { Authorization: 'Bearer ' + getToken() }
})
if (!resp.ok) { ElMessage.error('导出失败'); return }
const blob = await resp.blob()
const disp = resp.headers.get('Content-Disposition') || ''
let filename = '计划vs实际.xlsx'
const key = "filename*=UTF-8''"
const i = disp.indexOf(key)
if (i >= 0) {
let v = disp.slice(i + key.length)
const semi = v.indexOf(';')
if (semi >= 0) v = v.slice(0, semi)
v = v.trim()
if (v.charAt(0) === '"' && v.charAt(v.length - 1) === '"') v = v.slice(1, -1)
try { filename = decodeURIComponent(v) } catch { filename = v }
}
const url = URL.createObjectURL(blob)
const a = document.createElement('a')
a.href = url
a.download = filename
a.click()
URL.revokeObjectURL(url)
} catch {
ElMessage.error('导出失败')
}
}
onMounted(async () => {
searchWorkOrders('') // 首屏只拉最近 50 条供下拉,其余走远程搜索
productTypes.value = (await request.get('/product-types')) || []
@@ -45,7 +45,7 @@
<el-card class="block">
<template #header><span>在途指令(PLC 当前未清零的路径指令)</span></template>
<el-alert type="info" :closable="false" class="tip">
仅显示 PLC 中仍记录为「在途」(MW 非 0)的路径指令,解析为「源 → 目标」。若该指令已实际卡住、PLC 未自动清零,可手动「强制清零」。正常自动线不应出现长期在途。传感器位无需也不可人工改动(PLC 会覆盖)。
仅显示 PLC 中仍记录为「在途」(MW 非 0)的路径指令,解析为「源 → 目标」。若该指令已实际卡住、PLC 未自动清零,可手动「强制清零」(只把这一条指令字写 0,不会影响 PLC 程序运行,也不会改动 MES 数据)。正常自动线不应出现长期在途。传感器位无需也不可人工改动(PLC 会覆盖)。
</el-alert>
<el-table v-if="inTransit.length" :data="inTransit" border size="small" max-height="320">
<el-table-column label="在途指令" min-width="200">
@@ -97,7 +97,7 @@
<!-- 强制清零确认弹窗 -->
<el-dialog v-model="clearDialog.visible" title="强制清零在途指令" width="480px" :close-on-click-modal="false">
<el-alert type="error" :closable="false" class="tip">
将清除 PLC 中该指令的记录。仅在指令卡住(PLC 未清零)时使用。若 PLC 仍在执行该指令,强制清零会导致状态不一致。
将把 PLC 内存里这条路径指令字写 0(只动这一个握手字,不会影响 PLC 程序运行,也不会改动 MES 数据库)。仅在指令真卡住(PLC 未自动清零)时使用;若托盘还在搬运中就清零,上位机会误判任务完成并可能重复下发,造成动作冲突。请先到现场确认工件位置。
</el-alert>
<div class="clear-body">
当前指令:<b>{{ transitLabel(clearDialog.row) }}</b>
@@ -275,12 +275,15 @@
<script setup>
import { ref, reactive, computed, onMounted } from 'vue'
import { useRoute } from 'vue-router'
import { ElMessage } from 'element-plus'
import request from '../utils/request'
import { openPrintableHtml, openMergedPrintWindow } from '../utils/print'
import PageHelp from '../components/PageHelp.vue'
import { helpProcessCard } from '../help'
const route = useRoute()
// ===== 流程卡列表(单页主视图) =====
const listLoading = ref(false)
const listQuery = reactive({ orderNo: '', productCode: '', keyword: '' })
@@ -660,6 +663,9 @@ function buildSnCsv(c) {
}
onMounted(() => {
// 2026-11-16 日排产「计划vs实际」明细跳转:支持 ?orderNo= 预填产品工号并自动查询
const qn = route.query.orderNo
if (qn) listQuery.orderNo = String(qn)
loadList()
})
</script>
+31 -61
View File
@@ -1,7 +1,6 @@
<template>
<el-card>
<el-form inline>
<el-form-item label="图号"><el-input v-model="filters.code" clearable placeholder="图号(不区分大小写)" style="width:160px" @keyup.enter="search" /></el-form-item>
<el-form-item label="名称"><el-input v-model="filters.name" clearable placeholder="名称(不区分大小写)" style="width:160px" @keyup.enter="search" /></el-form-item>
<el-form-item label="规格"><el-input v-model="filters.spec" clearable placeholder="规格(不区分大小写)" style="width:160px" @keyup.enter="search" /></el-form-item>
<el-form-item label="启用">
@@ -11,6 +10,7 @@
</el-select>
</el-form-item>
<!-- 2026-11-13 拍板:成品档案不需要「类型 / 序列号」维度,查询与列表均不展示;后端按成品逻辑默认。 -->
<!-- 2026-11-16 用户定案:成品档案界面不再出现图号/物料编码(筛选、列表、表单、说明一律不显示);编码由后端自动生成。 -->
<el-form-item label="起始时间"><el-date-picker v-model="filters.startDate" type="date" value-format="YYYY-MM-DD" style="width:140px" /></el-form-item>
<el-form-item label="结束时间"><el-date-picker v-model="filters.endDate" type="date" value-format="YYYY-MM-DD" style="width:140px" /></el-form-item>
<el-form-item>
@@ -18,7 +18,9 @@
<el-button @click="resetFilters">重置</el-button>
<el-button v-if="can('produce.product:add')" type="primary" plain @click="openAdd">新增成品档案</el-button>
<!-- 2026-11-10 按 WMS 同样式:导入按钮与悬浮气泡分开——按钮点击直接选文件上传;
说明走按钮旁 hover 悬浮气泡(WMS BaseData.vue:1095-1128 同款:字段说明 + 常见错误 + 下载模板)。 -->
说明走按钮旁 hover 悬浮气泡(WMS BaseData.vue 同款:字段说明 + 常见错误 + 下载模板)。
2026-11-16 拍板:模板删除「图号」「物料编码」两列(编码自动生成/统一为空),
本端导入仅限成品,原材料在 WMS 物料档案维护。 -->
<el-button v-if="can('produce.product:add')" type="warning" :loading="importing" @click="triggerImport">导入</el-button>
<el-button @click="exportXlsx">导出</el-button>
<el-popover v-if="can('produce.product:add')" placement="bottom-start" :width="680" trigger="hover">
@@ -26,28 +28,24 @@
<el-icon style="margin-left:6px;cursor:pointer;color:#909399;font-size:17px;vertical-align:middle"><InfoFilled /></el-icon>
</template>
<div style="max-height:62vh;overflow:auto">
<div style="font-weight:600;margin-bottom:6px">一、字段说明(成品档案模板 9 列;Excel 首行表头按名称识别,请勿改动表头文字)</div>
<div style="font-weight:600;margin-bottom:6px">一、字段说明(成品档案模板 7 列;Excel 首行表头按名称识别,请勿改动表头文字)</div>
<table style="width:100%;border-collapse:collapse;font-size:12px" border>
<thead><tr style="background:#f5f7fa"><th>列</th><th>字段</th><th>必填</th><th>格式</th><th>说明</th></tr></thead>
<tbody>
<tr><td style="text-align:center">1</td><td>图号</td><td style="text-align:center">是</td><td>字符串,唯一</td><td>物料唯一标识(两库同步业务键);成品可留空自动生成 PROD-YYYYMMDD-流水,原材料必填</td></tr>
<tr><td style="text-align:center">2</td><td>物料编码</td><td style="text-align:center">否</td><td>字符串</td><td>普通档案字段(如 WL-0001),不参与业务与必填校验</td></tr>
<tr><td style="text-align:center">3</td><td>名称</td><td style="text-align:center">是</td><td>字符串</td><td>物料名称</td></tr>
<tr><td style="text-align:center">4</td><td>规格</td><td style="text-align:center">是</td><td>字符串</td><td>规格型号</td></tr>
<tr><td style="text-align:center">5</td><td>单位</td><td style="text-align:center">是</td><td>字符串</td><td>如「个」「件」「套」</td></tr>
<tr><td style="text-align:center">6</td><td>类别</td><td style="text-align:center">否</td><td>成品/原材料</td><td>默认成品(MES 口径;WMS 侧叫「物料类别」,留空默认原材料)</td></tr>
<tr><td style="text-align:center">7</td><td>序列号</td><td style="text-align:center">否</td><td>是/否</td><td>成品强制是,原材料可选(WMS 导入忽略本列,按类型自动派生)</td></tr>
<tr><td style="text-align:center">8</td><td>启用</td><td style="text-align:center">否</td><td>是/否</td><td>默认是(WMS 导入忽略本列,默认启用)</td></tr>
<tr><td style="text-align:center">9</td><td>说明</td><td style="text-align:center">否</td><td>字符串</td><td>备注</td></tr>
<tr><td style="text-align:center">1</td><td>名称</td><td style="text-align:center">是</td><td>字符串</td><td>物料名称</td></tr>
<tr><td style="text-align:center">2</td><td>规格</td><td style="text-align:center">是</td><td>字符串</td><td>规格型号</td></tr>
<tr><td style="text-align:center">3</td><td>单位</td><td style="text-align:center">是</td><td>字符串</td><td>如「个」「件」「套」</td></tr>
<tr><td style="text-align:center">4</td><td>类别</td><td style="text-align:center">否</td><td>成品</td><td>只能填「成品」;原材料请在 WMS 物料档案维护(不在本端导入)</td></tr>
<tr><td style="text-align:center">5</td><td>序列号</td><td style="text-align:center">否</td><td>—</td><td>成品强制「是」,无需填写</td></tr>
<tr><td style="text-align:center">6</td><td>启用</td><td style="text-align:center">否</td><td>是/否</td><td>默认是</td></tr>
<tr><td style="text-align:center">7</td><td>说明</td><td style="text-align:center">否</td><td>字符串</td><td>备注</td></tr>
</tbody>
</table>
<div style="font-size:12px;color:#909399;margin-top:4px">下载模板含 2 行示例数据(导入前请删除)与「填写说明」页逐列说明。</div>
<div style="font-size:12px;color:#909399;margin-top:4px">成品编码(图号)由系统自动生成(PROD-年月日-流水,递增且唯一),物料编码统一为空,均无需填写。下载模板含 1 行示例数据(导入前请删除)与「填写说明」页逐列说明。</div>
<div style="font-weight:600;margin:10px 0 4px">二、常见错误</div>
<div style="font-size:12px;color:#606266;line-height:1.9">
· 图号重复:系统中已存在相同图号,该行被拒绝<br/>
· 类别填了「原材料」:MES 成品导入仅限成品,请在 WMS 物料档案维护原材料<br/>
· 物料类型不出现在模板中:系统一律按成品逻辑默认(类型=其他、序列号=是)<br/>
· 类别不在枚举内:只能填「成品」或「原材料」<br/>
· 名称/规格/单位为空:必填列不可为空;任一行出错则整批回退,一行不写<br/>
· WMS 不可达:本端导入先逐行写 WMS,WMS 失败整批取消
</div>
@@ -60,8 +58,7 @@
</el-form>
<el-table :data="list" border size="small">
<el-table-column prop="id" label="ID" width="60" />
<el-table-column prop="code" label="图号" min-width="140" />
<!-- 2026-11-13:成品档案视图适配——物料编码不展示(与物料档案共用一张表,但业务层面显示不一样) -->
<!-- 2026-11-16 用户定案:列表不再显示图号列(编码仅作系统内部唯一键与附件挂靠) -->
<el-table-column prop="name" label="名称" min-width="120" />
<el-table-column prop="spec" label="规格" min-width="120">
<template #default="{row}">{{ row.spec || '-' }}</template>
@@ -103,32 +100,13 @@
<el-dialog v-model="dialog.show" :title="dialog.id?'编辑成品档案':'新增成品档案'" width="460px">
<el-form :model="dialog" label-width="80px">
<el-alert type="info" :closable="false" title="成品档案:图号(唯一码)由系统自动生成,类型与序列号由系统固定,无需填写;成品没有物料编码。" style="margin-bottom:10px" />
<el-form-item label="图号" required v-if="false">
<el-input v-model="dialog.code" :disabled="!!dialog.id" placeholder="图号,如 DX-100(创建后不可改)" />
</el-form-item>
<el-form-item label="物料编码" v-if="false"><el-input v-model="dialog.materialCode" placeholder="选填,物料编码" clearable /></el-form-item>
<el-alert type="info" :closable="false" title="成品档案:编码与类型、序列号均由系统自动设定,无需填写。" style="margin-bottom:10px" />
<el-form-item label="名称"><el-input v-model="dialog.name" /></el-form-item>
<el-form-item label="规格"><el-input v-model="dialog.spec" placeholder="如 500×300×200" /></el-form-item>
<el-form-item label="单位"><el-input v-model="dialog.unit" placeholder="如 台/套" /></el-form-item>
<el-form-item label="说明">
<el-input v-model="dialog.description" type="textarea" :rows="2" placeholder="说明(可空)" />
</el-form-item>
<el-form-item label="类型" required v-if="false">
<el-select v-model="dialog.manageMode" style="width:100%" placeholder="请选择类型" @change="onTypeChange">
<el-option :value="0" label="请选择" disabled />
<el-option :value="1" label="结构件" />
<el-option :value="2" label="电气件" />
<el-option :value="3" label="其他" />
</el-select>
</el-form-item>
<el-form-item label="序列号" required v-if="false">
<el-radio-group v-model="dialog.snMode">
<el-radio :label="1">是</el-radio>
<el-radio :label="2">否</el-radio>
</el-radio-group>
<span style="margin-left:8px;color:#909399;font-size:12px">是=逐件录序列号,否=按数量(不录序列号)</span>
</el-form-item>
<el-form-item label="启用"><el-switch v-model="dialog.isActive" /></el-form-item>
</el-form>
<AttachmentPanel v-if="dialog.id" biz-type="material" :biz-id="dialog.code" title="附件(图纸 / 资料)" />
@@ -166,16 +144,13 @@ const list = ref([])
const total = ref(0)
const page = ref(1)
const pageSize = ref(20)
const filters = reactive({ code: '', name: '', spec: '', isActive: '', manageMode: '', snMode: '', startDate: '', endDate: '' })
// 类型(manageMode)与是否逐件SN管理(snMode)解耦(2026-09-30):
// snMode 必选(0=未选择不可保存);选类型自动带默认(电气件→序列号=是,结构件/其他→序列号=否),可手改
const dialog = reactive({ show: false, id: 0, name: '', code: '', materialCode: '', spec: '', unit: '', manageMode: 3, snMode: 1, description: '', isActive: true })
const filters = reactive({ name: '', spec: '', isActive: '', startDate: '', endDate: '' })
// 2026-11-16 用户定案:界面不再出现图号/物料编码/类型/序列号,全部由后端注入或自动生成
//(类型=3 其他、序列号=是、编码留空由 genProductTypeCode 生成 PROD-YYYYMMDD-流水、物料编码强制空串)。
// dialog.code 仅保留用于附件挂靠(biz-id=编码)。
const dialog = reactive({ show: false, id: 0, name: '', code: '', spec: '', unit: '', description: '', isActive: true })
const attachDrawer = reactive({ visible: false, code: '', name: '' })
function onTypeChange(v) {
dialog.snMode = v === 2 ? 1 : 2
}
function defaultRange() {
const d = new Date()
const p = (n) => String(n).padStart(2, '0')
@@ -186,18 +161,15 @@ function defaultRange() {
}
Object.assign(filters, defaultRange())
// 2026-09-08 禁止关键字混搜:编码/名称各筛选框独立传参,后端各自模糊匹配
// 禁止关键字混搜:名称/规格各筛选框独立传参,后端各自模糊匹配
function trim(s) { return (s || '').trim() }
async function load() {
const params = {
page: page.value,
pageSize: pageSize.value,
code: trim(filters.code),
name: trim(filters.name),
spec: trim(filters.spec),
manageMode: filters.manageMode,
snMode: filters.snMode,
isActive: filters.isActive,
startDate: filters.startDate,
endDate: filters.endDate
@@ -224,34 +196,32 @@ async function retrySync(row) {
}
function resetFilters() {
Object.assign(filters, { code: '', name: '', spec: '', isActive: '', manageMode: '', snMode: '' }, defaultRange())
Object.assign(filters, { name: '', spec: '', isActive: '' }, defaultRange())
page.value = 1
load()
}
async function openAdd() {
Object.assign(dialog, { show: true, id: 0, name: '', code: '', materialCode: '', spec: '', unit: '', manageMode: 3, snMode: 1, description: '', isActive: true })
Object.assign(dialog, { show: true, id: 0, name: '', code: '', spec: '', unit: '', description: '', isActive: true })
}
function openEdit(row) {
Object.assign(dialog, {
show: true, id: row.id, name: row.name, code: row.code, materialCode: row.materialCode || '', spec: row.spec || '', unit: row.unit || '',
manageMode: row.manageMode ?? 0, snMode: row.snMode ?? 0, description: row.description || '', isActive: row.isActive
show: true, id: row.id, name: row.name, code: row.code, spec: row.spec || '', unit: row.unit || '',
description: row.description || '', isActive: row.isActive
})
}
async function save() {
// 必填口径:名称/规格/单位/图号(图号仅新建必填、编辑不可改;MES 图号不允许为空,与 WMS 成品可空自动生成不同)+ 类型 + 序列号(序列号=是/否)
// 必填口径(2026-11-16 用户定案):仅名称/规格/单位必填;编码由后端留空自动生成(logic/product.go:117-123),
// 类型/序列号由后端按成品注入默认值(logic/product.go:108-113);物料编码强制空字符串(不参与两库互推,product_import.go:307)。
if (!trim(dialog.name)) return ElMessage.warning('名称为必填项')
if (!trim(dialog.spec)) return ElMessage.warning('规格型号为必填项')
if (!trim(dialog.unit)) return ElMessage.warning('单位为必填项')
if (!dialog.id && !trim(dialog.code)) return ElMessage.warning('图号为必填项(创建后不可改)')
if (![1, 2, 3].includes(dialog.manageMode)) return ElMessage.warning('请选择类型')
if (dialog.snMode !== 1 && dialog.snMode !== 2) return ElMessage.warning('请选择序列号(是=逐件录序列号 / 否=按数量(不录序列号))')
const body = {
name: trim(dialog.name), spec: trim(dialog.spec), unit: trim(dialog.unit), description: dialog.description,
materialCode: dialog.materialCode, manageMode: dialog.manageMode, snMode: dialog.snMode, isActive: dialog.isActive
materialCode: '', manageMode: 3, snMode: 1, isActive: dialog.isActive
}
if (dialog.id) await request.put('/product-types', { id: dialog.id, ...body })
else await request.post('/product-types', { code: trim(dialog.code), ...body })
else await request.post('/product-types', body)
ElMessage.success('保存成功')
dialog.show = false
load()
@@ -346,7 +316,7 @@ async function exportXlsx() {
filters.endDate = r.end
}
const params = {
code: trim(filters.code), name: trim(filters.name),
name: trim(filters.name),
spec: trim(filters.spec),
isActive: filters.isActive,
startDate: filters.startDate, endDate: filters.endDate