feat: AGV点位锁与缓存迁移 + 工位终端去离线队列 + WMS出入库增强

【MES】
- AGV点位/线路点位/AGV任务/工单 ent schema 重构(全量重生成 ent 代码)
- 新增派车锁 agv_point_lock.go:目标点位占用即拒车,JBT21 库房接驳台卸货后保持锁定待库管手动解锁
- 新增进程内 TTL 缓存 cache.go,由 Redis 看板缓存迁移至内存(singleflight 防击穿,去除外部依赖)
- AGV 三段链安全机制、车辆状态/接驳台左右互换、补料损耗闭环完善
- 来料检/工序卡/工单/质检/日排产/AGV 前端与帮助文档更新
- 新增 migrations/、sql/ 目录

【WMS】
- 出库、Excel 导出、物料、路由处理增强
- 配置与 DB 初始化调整;基础数据/成品入库/入库前端调整

【工位终端】
- 移除离线同步队列(syncer 包、sync.go、SyncQueueDialog.vue),改为实时直连上报 MES(断网即失败报错),以本人身份操作
- 本地 SQLite 仅保留操作日志 + 内置账号 + 登录态;保留空闲自动登出

【文档】
- 删除 AGV海康litev1.5.md;案例.md 更新
This commit is contained in:
SunYF
2026-11-07 15:06:00 +08:00
parent 1d1dc1bdd8
commit 5e2640c13a
118 changed files with 4040 additions and 3594 deletions
+5 -5
View File
@@ -229,8 +229,8 @@ export const helpFinishedInbound = {
'提交成功后表单自动清空,页面下方「今日成品入库记录」展示当天双通道入库明细(来源列区分 手工 / MES回流),附件随 SN 归档。',
fields: [
{ name: 'SN', source: '扫码枪扫描成品 SN 条码回车即填,或手工输入。', purpose: '成品唯一追溯锚点,全局唯一(重复入库被 409 拒绝并提示「成品 SN 已存在库存」)', fill: '扫描或输入;SN 由系统/MES 发号,实物可不贴码允许手填' },
{ name: '产品序号', source: '远程搜索「物料档案」(仅成品物料类别 item_type=3),下拉显示 编码/名称。', purpose: '关联成品物料主数据,WMS 从档案自动补齐名称与类型', fill: '输入编码/名称关键字远程搜索后选择;档案缺失请先到「物料档案」建档' },
{ name: '产品名称', source: '选中产品序号后自动带出,可手动修改。', purpose: '展示名称;档案缺失时作为兜底展示', fill: '一般不改;与档案名称有出入时可手改' },
{ name: '图号', source: '远程搜索「物料档案」(仅成品物料类别 item_type=3),下拉显示 编码/名称。', purpose: '关联成品物料主数据,WMS 从档案自动补齐名称与类型', fill: '输入编码/名称关键字远程搜索后选择;档案缺失请先到「物料档案」建档' },
{ name: '产品名称', source: '选中图号后自动带出,可手动修改。', purpose: '展示名称;档案缺失时作为兜底展示', fill: '一般不改;与档案名称有出入时可手改' },
{ name: '归属类型 / 归属编号', source: '下拉选择:合同号 / 科技项目号 / 其他;编号手填。', purpose: '标记成品归属哪个合同或科技项目,与入库/半成品/检验同口径,可按归属贯通查询', fill: '可空;选合同号或科技项目号时归属编号必填,选「其他」可不填' },
{ name: '产品状态', source: '下拉选择:已通过 / 部分通过 / 返修(必填)。', purpose: '完工检质量结论快照,随库存行展示;MES 自动回流时按此映射质量状态(已通过→合格/部分通过→合格/返修→不合格)', fill: '必填,按完工检实际结论选择' },
{ name: '相关标准', source: '手工填写(可空)。', purpose: '试验方案号/检验细则,成品质量档案信息', fill: '如试验方案号,可空' },
@@ -300,13 +300,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=成品(「其他」类别已按 2026-10-19 用户裁决全项目取消)。半成品不是物料物料类别(2026-09-22 定稿)——半成品是工件状态,由统一库存主表物料类别 category=2 承载,物料档案不再有半成品行。编码主数据单一来源在本表:MES 的「物料档案」页面即是本表中"成品"物料类别的视图(实时拉取本表,不双录)——两系统的「物料档案」指向同一份主数据,以本表为准。库存主表 inventories 的物料类别与其呼应。列表支持按物料类别筛选,导出含物料类别列。\n\n物料档案是库房的另一道地基:先建好物料,入库时才能选到;「序列号=是(按 SN 记账)」未选择(0)的物料不能出入库。\n\n命名说明:本档案维护的物料在出库/看板等页面统一以"图号"展示(客户口径)。安全库存在本档案维护,可用量低于它时会在「库房看板」首页触发缺货预警。\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 的「物料档案」按物料编码幂等互推(任一侧新增/修改自动互推,失败置同步标记可手动重推),库存真源在本系统(备料校验由 MES 直查本系统库存)。库存主表 inventories 的物料类别与其呼应。列表支持按物料类别筛选,导出含物料类别列。\n\n物料档案是库房的另一道地基:先建好物料,入库时才能选到;「序列号=是(按 SN 记账)」未选择(0)的物料不能出入库。\n\n命名说明:本档案维护的物料在出库/看板等页面统一以"图号"展示(客户口径)。安全库存在本档案维护,可用量低于它时会在「库房看板」首页触发缺货预警。\n\n导入说明:导入按钮旁的 ⓘ 图标提供字段说明、常见错误和模板下载。建议先下载模板,按模板格式填写后导入。',
fields: [
{ name: '图号', source: '手工填写,仓库自定义(新增后不可改)。在出库/看板等页面显示为"图号"。', purpose: '物料唯一编号(即图号)', fill: '如 SCREW-M3;新增后不可改编码' },
{ 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=不预警' },
+25 -3
View File
@@ -600,13 +600,35 @@ async function onMaterialFile(e) {
const file = e.target.files?.[0]
e.target.value = '' // 允许重复选择同一文件
if (!file) return
const go = await confirmAction(`确认导入物料文件「${file.name}」?导入将批量写入物料档案(任一行错误则整体回退)。`, '批量导入确认')
if (!go) return
matImporting.value = true
try {
const fd = new FormData()
fd.append('file', file)
// 注意:token 是纯文本存储,不能用 JSON.parse(会对 JWT 抛 SyntaxError 误报"导入异常")
// 阶段1 预检(只读,不写任何数据):与写入端点同一套校验规则
const pres = await fetch('/api/material/import/preview', {
method: 'POST',
headers: { Authorization: 'Bearer ' + getToken() },
body: fd
})
const pbody = await pres.json().catch(() => null)
if (!pres.ok || pbody?.code !== 0) {
const httpText = pres.status === 401 ? '登录已过期,请重新登录' : `服务器错误(${pres.status})`
ElMessage.error('预检失败:' + (pbody?.message || httpText))
return
}
const p = pbody?.data || {}
const perrs = p.errors || []
if (perrs.length) {
const lines = perrs.slice(0, 10)
.map((x) => `第${x.row}行 ${x.materialCode || ''}:${x.message}`).join(';')
ElMessage.error(`预检未通过:共 ${p.total || 0} 行,失败 ${perrs.length} 行(未写入任何数据):` + lines + (perrs.length > 10 ? ' …' : ''))
return
}
// 阶段2 确认
const go = await confirmAction(`预检通过:共 ${p.total || 0} 行,将成功导入 ${p.success || 0} 行。正式写入为整批事务(全成功或全失败),确认导入「${file.name}」?`, '预检通过,确认导入')
if (!go) return
// 阶段3 正式写入
const res = await fetch('/api/material/import', {
method: 'POST',
headers: { Authorization: 'Bearer ' + getToken() },
@@ -623,7 +645,7 @@ async function onMaterialFile(e) {
if (d.errors && d.errors.length) {
const lines = d.errors.slice(0, 10)
.map((x) => `第${x.row}行 ${x.materialCode || ''}:${x.message}`).join(';')
ElMessage.error('导入失败:' + lines + (d.errors.length > 10 ? ' …' : ''))
ElMessage.error('导入被拒绝(未写入任何数据):' + lines + (d.errors.length > 10 ? ' …' : ''))
return
}
ElMessage.success(`导入成功 ${d.success || 0} 条`)
@@ -30,7 +30,7 @@ const form = reactive(newForm())
const staged = ref([]) // 暂存附件(提交成功后随 SN 上传,bizType=finished)
const submitting = ref(false)
// 选产品序号(物料档案远程搜索)自动带出名称,可手改
// 选图号(物料档案远程搜索)自动带出名称,可手改
function onMaterialChange(m) {
form.productName = m?.name || ''
}
@@ -55,7 +55,7 @@ async function uploadStaged(sn) {
async function submit() {
const sn = form.sn.trim()
if (!sn) { ElMessage.warning('请扫描或输入 SN'); return }
if (!form.productCode) { ElMessage.warning('请选择产品序号(物料档案)'); return }
if (!form.productCode) { ElMessage.warning('请选择图号(物料档案)'); return }
if (!form.productStatus) { ElMessage.warning('请选择产品状态(已通过/部分通过/返修)'); return }
if (!form.recordedBy.trim()) { ElMessage.warning('请填写记录员'); return }
if ((form.ownershipType === 'workorder' || form.ownershipType === 'project') && !form.ownershipNo.trim()) {
@@ -148,12 +148,12 @@ onMounted(loadList)
<el-input v-model="form.sn" autofocus clearable
placeholder="扫描或输入成品 SN(扫码枪回车即填),全局唯一" />
</el-form-item>
<el-form-item label="产品序号">
<el-form-item label="图号">
<MaterialSelect v-model="form.productCode" :item-type="3" placeholder="远程搜索成品档案(编码/名称)"
@item-change="onMaterialChange" />
</el-form-item>
<el-form-item label="产品名称">
<el-input v-model="form.productName" placeholder="选产品序号后自动带出,可修改" clearable />
<el-input v-model="form.productName" placeholder="选图号后自动带出,可修改" clearable />
</el-form-item>
<el-form-item label="归属">
<div style="display:flex;gap:8px;width:100%">
@@ -213,7 +213,7 @@ onMounted(loadList)
</template>
</el-table-column>
<el-table-column prop="sn" label="SN" min-width="160" />
<el-table-column prop="materialCode" label="产品序号" min-width="120" />
<el-table-column prop="materialCode" label="图号" min-width="120" />
<el-table-column prop="materialName" label="产品名称" min-width="110">
<template #default="{ row }">{{ row.materialName || '-' }}</template>
</el-table-column>
+22 -3
View File
@@ -44,12 +44,28 @@ function onExceed(files, which) {
async function importExcel(mode, which) {
const raw = pickRaw(which)
if (!raw) { ElMessage.warning('请先选择 .xlsx 文件'); return }
const fd = new FormData()
fd.append('file', raw)
fd.append('mode', mode)
importing.value = true
excelResult.value = null
try {
// 阶段1 预检(只读,不写任何数据):与写入端点同一套校验规则
const pfd = new FormData()
pfd.append('file', raw)
pfd.append('mode', mode)
const p = (await request.post('/inbound/batch-excel/preview', pfd)) || {}
const perrs = p.errors || []
if (perrs.length) {
const lines = perrs.slice(0, 10).map((x) => `第${x.row}行 ${x.materialCode || ''}:${x.message}`).join(';')
ElMessage.error(`预检未通过:共 ${p.total || 0} 行,失败 ${perrs.length} 行(未写入任何数据):` + lines + (perrs.length > 10 ? ' …' : ''))
return
}
// 阶段2 确认
await ElMessageBox.confirm(
`预检通过:共 ${p.total || 0} 行,将全部成功入库 ${p.success || 0} 行。正式写入为整批事务(全成功或全失败)。`,
'预检通过,确认导入', { type: 'info', confirmButtonText: '正式导入', cancelButtonText: '取消' })
// 阶段3 正式写入
const fd = new FormData()
fd.append('file', raw)
fd.append('mode', mode)
const data = await request.post('/inbound/batch-excel', fd)
excelResult.value = data || {}
if (data?.failed > 0) {
@@ -58,6 +74,9 @@ async function importExcel(mode, which) {
ElMessage.success(`批量导入成功:共 ${data?.success ?? 0} 行`)
await loadRecords()
}
} catch (err) {
if (err === 'cancel' || err === 'close') return // 用户取消确认弹窗
ElMessage.error('导入失败:网络异常或登录已过期,请重试')
} finally {
importing.value = false
}