feat: 新增收集式校验错误弹窗及工位报警语音播报
新增 ErrorListDialog 组件用于统一展示结构化校验错误信息,实现报错一次收全;新增工位报警语音播报功能,通过浏览器 SpeechSynthesis 播放本工位相关报警;调整物料类别及序列号字段文案,移除「其他」类别;新增工单实际开始字段及采集方式配置;优化 AGV 及 PlcSend 页签刷新逻辑;新增看板物料追溯及工位报警接口;删除 PLC 强制写 M 位及相关测试代码;同步数据库字段注释及补丁。
This commit is contained in:
@@ -26,11 +26,11 @@ type Material struct {
|
||||
Unit string `json:"unit,omitempty"`
|
||||
// 描述
|
||||
Description string `json:"description,omitempty"`
|
||||
// 物料类别 1原材料/3成品/4其他(半成品不是物料类别,由库存 category=2 承载)
|
||||
// 物料类别 1原材料/3成品(半成品不是物料类别,由库存 category=2 承载)
|
||||
ItemType int `json:"itemType,omitempty"`
|
||||
// 类型 1结构件/2电气件/3其他
|
||||
ManageMode int `json:"manageMode,omitempty"`
|
||||
// SN管理 1序列号=是(逐件SN)/2序列号=否(数量)/0未选择
|
||||
// 序列号 1=是(逐件录SN)/2=否(按数量)/0未选择
|
||||
SnMode int `json:"snMode,omitempty"`
|
||||
// 是否批次管理(按 sn_mode=2 派生)
|
||||
IsBatchManaged bool `json:"isBatchManaged,omitempty"`
|
||||
|
||||
@@ -366,9 +366,9 @@ var (
|
||||
{Name: "spec", Type: field.TypeString, Nullable: true, Comment: "规格型号"},
|
||||
{Name: "unit", Type: field.TypeString, Nullable: true, Comment: "单位"},
|
||||
{Name: "description", Type: field.TypeString, Nullable: true, Comment: "描述"},
|
||||
{Name: "item_type", Type: field.TypeInt, Comment: "物料类别 1原材料/3成品/4其他(半成品不是物料类别,由库存 category=2 承载)", Default: 1},
|
||||
{Name: "item_type", Type: field.TypeInt, Comment: "物料类别 1原材料/3成品(半成品不是物料类别,由库存 category=2 承载)", Default: 1},
|
||||
{Name: "manage_mode", Type: field.TypeInt, Comment: "类型 1结构件/2电气件/3其他", Default: 1},
|
||||
{Name: "sn_mode", Type: field.TypeInt, Comment: "SN管理 1序列号=是(逐件SN)/2序列号=否(数量)/0未选择", Default: 0},
|
||||
{Name: "sn_mode", Type: field.TypeInt, Comment: "序列号 1=是(逐件录SN)/2=否(按数量)/0未选择", Default: 0},
|
||||
{Name: "is_batch_managed", Type: field.TypeBool, Comment: "是否批次管理(按 sn_mode=2 派生)", Default: false},
|
||||
{Name: "is_serial_managed", Type: field.TypeBool, Comment: "是否序列号管理(按 sn_mode=1 派生)", Default: false},
|
||||
{Name: "template_code", Type: field.TypeString, Nullable: true, Comment: "物料模板编码(物料种类)"},
|
||||
@@ -501,7 +501,7 @@ var (
|
||||
{Name: "material_code", Type: field.TypeString, Comment: "物料编码"},
|
||||
{Name: "material_name", Type: field.TypeString, Nullable: true, Comment: "物料名称(冗余)"},
|
||||
{Name: "manage_mode", Type: field.TypeInt, Comment: "类型 1结构件/2电气件/3其他", Default: 1},
|
||||
{Name: "sn_mode", Type: field.TypeInt, Comment: "SN管理 1序列号=是(逐件SN)/2序列号=否(数量)/0未选择", Default: 0},
|
||||
{Name: "sn_mode", Type: field.TypeInt, Comment: "序列号 1=是(逐件SN)/2=否(按数量)/0未选择", Default: 0},
|
||||
{Name: "batch_no", Type: field.TypeString, Nullable: true, Comment: "批次号(结构件)"},
|
||||
{Name: "zone_code", Type: field.TypeString, Nullable: true, Comment: "出库区域(大区)"},
|
||||
{Name: "shelf_no", Type: field.TypeString, Nullable: true, Comment: "货架号(与入库同口径)"},
|
||||
|
||||
@@ -40,7 +40,7 @@ type OutboundOrder struct {
|
||||
MaterialName string `json:"materialName,omitempty"`
|
||||
// 类型 1结构件/2电气件/3其他
|
||||
ManageMode int `json:"manageMode,omitempty"`
|
||||
// SN管理 1序列号=是(逐件SN)/2序列号=否(数量)/0未选择
|
||||
// 序列号 1=是(逐件SN)/2=否(按数量)/0未选择
|
||||
SnMode int `json:"snMode,omitempty"`
|
||||
// 批次号(结构件)
|
||||
BatchNo string `json:"batchNo,omitempty"`
|
||||
|
||||
@@ -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 },
|
||||
|
||||
@@ -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=不预警' },
|
||||
|
||||
@@ -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))
|
||||
|
||||
@@ -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
|
||||
}
|
||||
@@ -325,6 +325,11 @@ func applyColumnPatches(ctx context.Context) {
|
||||
`CREATE UNIQUE INDEX IF NOT EXISTS ux_inventories_batch_no ON inventories (batch_no) WHERE sn_mode = 2 AND batch_no IS NOT NULL AND batch_no <> ''`,
|
||||
// sn_mode 高频过滤索引
|
||||
`CREATE INDEX CONCURRENTLY IF NOT EXISTS idx_inventories_sn_mode ON inventories (sn_mode)`,
|
||||
// 注释同步(2026-10-19):物料类别删「其他」+ sn_mode 文案统一「序列号(是/否)」;
|
||||
// 显式 COMMENT ON 保证存量库列注释与 ent schema 一致(幂等,可重复执行)。
|
||||
`COMMENT ON COLUMN materials.item_type IS '物料类别 1原材料/3成品(半成品不是物料类别,由库存 category=2 承载)'`,
|
||||
`COMMENT ON COLUMN materials.sn_mode IS '序列号 1=是(逐件录SN)/2=否(按数量)/0未选择'`,
|
||||
`COMMENT ON COLUMN outbound_orders.sn_mode IS '序列号 1=是(逐件SN)/2=否(按数量)/0未选择'`,
|
||||
}
|
||||
for _, s := range stmts {
|
||||
if _, err := rawDB.ExecContext(ctx, s); err != nil {
|
||||
|
||||
@@ -19,9 +19,6 @@ import (
|
||||
"github.com/zeromicro/go-zero/core/logx"
|
||||
)
|
||||
|
||||
// 物料类别:4=其他(辅料/工装/试验设备),与 schema/material.go 的 item_type 保持一致
|
||||
const invItemOther = 4
|
||||
|
||||
// 类型(分类)第三值:3=其他(辅料/工装/试验设备),与结构件(1)/电气件(2) 同级。
|
||||
// 客户裁决(2026-09-21):结构件/电气件/其他 同属「类型」维度,独立于「物料类别」,编号 1/2/3。
|
||||
// 2026-09-30 解耦:类型仅用于分类统计/筛选/页签归属,SN 行为改读 sn_mode。
|
||||
|
||||
@@ -2,11 +2,16 @@ package handler
|
||||
|
||||
import (
|
||||
"net/http"
|
||||
"sort"
|
||||
"strings"
|
||||
"time"
|
||||
|
||||
"bj_power_wms/ent"
|
||||
"bj_power_wms/ent/inboundorder"
|
||||
"bj_power_wms/ent/inventory"
|
||||
"bj_power_wms/ent/material"
|
||||
"bj_power_wms/ent/outboundorder"
|
||||
"bj_power_wms/ent/zone"
|
||||
"bj_power_wms/internal/svc"
|
||||
)
|
||||
|
||||
@@ -46,6 +51,68 @@ func internalDisplayHandler(ctx *svc.ServiceContext) http.HandlerFunc {
|
||||
outToday, _ := ctx.EntClient.OutboundOrder.Query().
|
||||
Where(outboundorder.CreatedAtGTE(dayStart)).Count(ctx0())
|
||||
|
||||
// ---- 库位利用率:库位 = 货架(区域→货架→层→位置 中的「货架」物理存储单元)----
|
||||
locTotal := 0
|
||||
if n, e := ctx.EntClient.Zone.Query().Where(zone.LevelEQ(2)).Count(ctx0()); e == nil {
|
||||
locTotal = n
|
||||
}
|
||||
usedKeys := map[string]bool{}
|
||||
if invs, e := ctx.EntClient.Inventory.Query().Where(inventory.QuantityGT(0)).All(ctx0()); e == nil {
|
||||
for _, iv := range invs {
|
||||
usedKeys[locKey(iv.ZoneCode, iv.ShelfNo, "", "")] = true
|
||||
}
|
||||
}
|
||||
locUsed := len(usedKeys)
|
||||
|
||||
// ---- 待处理出入库任务 ----
|
||||
// 入库待处理 = 入库检未闭环(质量状态 空/未检 且未作废);出库待处理 = 已出库待送达。
|
||||
pendingInbound := 0
|
||||
if n, e := ctx.EntClient.InboundOrder.Query().
|
||||
Where(inboundorder.Voided(false), inboundorder.QualityStatusIn("未检", "")).Count(ctx0()); e == nil {
|
||||
pendingInbound = n
|
||||
}
|
||||
pendingOutbound := 0
|
||||
if n, e := ctx.EntClient.OutboundOrder.Query().
|
||||
Where(outboundorder.StatusEQ("已出库")).Count(ctx0()); e == nil {
|
||||
pendingOutbound = n
|
||||
}
|
||||
|
||||
// ---- 出入库动态(带批次号,最近各 15 单合并取前 20)----
|
||||
movements := []map[string]any{}
|
||||
inb, _ := ctx.EntClient.InboundOrder.Query().Where(inboundorder.Voided(false)).
|
||||
Order(ent.Desc(inboundorder.FieldCreatedAt)).Limit(15).All(ctx0())
|
||||
outb, _ := ctx.EntClient.OutboundOrder.Query().
|
||||
Order(ent.Desc(outboundorder.FieldCreatedAt)).Limit(15).All(ctx0())
|
||||
type mv struct{ t int64; m map[string]any }
|
||||
all := make([]mv, 0, len(inb)+len(outb))
|
||||
for _, o := range inb {
|
||||
mat := o.MaterialName
|
||||
if mat == "" {
|
||||
mat = o.MaterialCode
|
||||
}
|
||||
all = append(all, mv{t: o.CreatedAt, m: map[string]any{
|
||||
"id": o.InboundNo, "time": time.Unix(o.CreatedAt, 0).Format("2006-01-02 15:04:05"),
|
||||
"type": "in", "material": mat, "qty": o.Quantity, "operator": o.Operator, "batch": o.BatchNo,
|
||||
}})
|
||||
}
|
||||
for _, o := range outb {
|
||||
mat := o.MaterialName
|
||||
if mat == "" {
|
||||
mat = o.MaterialCode
|
||||
}
|
||||
all = append(all, mv{t: o.CreatedAt, m: map[string]any{
|
||||
"id": o.OutboundNo, "time": time.Unix(o.CreatedAt, 0).Format("2006-01-02 15:04:05"),
|
||||
"type": "out", "material": mat, "qty": o.Quantity, "operator": o.Operator, "batch": o.BatchNo,
|
||||
}})
|
||||
}
|
||||
sort.Slice(all, func(i, j int) bool { return all[i].t > all[j].t })
|
||||
if len(all) > 20 {
|
||||
all = all[:20]
|
||||
}
|
||||
for _, x := range all {
|
||||
movements = append(movements, x.m)
|
||||
}
|
||||
|
||||
ok(w, map[string]any{
|
||||
"batchCount": batchCount,
|
||||
"totalQty": totalQty,
|
||||
@@ -58,11 +125,55 @@ func internalDisplayHandler(ctx *svc.ServiceContext) http.HandlerFunc {
|
||||
"inToday": inToday,
|
||||
"outToday": outToday,
|
||||
"zoneDetail": zones,
|
||||
"locationUsed": locUsed,
|
||||
"locationTotal": locTotal,
|
||||
"pendingInbound": pendingInbound,
|
||||
"pendingOutbound": pendingOutbound,
|
||||
"movements": movements,
|
||||
"time": time.Now().Format("2006-01-02 15:04:05"),
|
||||
})
|
||||
}
|
||||
}
|
||||
|
||||
// materialQueryInternalHandler 物料档案 + 库存查询(看板物料追溯入口复用,X-API-TOKEN 内部接口)
|
||||
//
|
||||
// 入参:code(物料编码,必填)/ batch(批次号,可选)。
|
||||
// 返回:found(档案是否存在)+ material(档案字段)+ inventory(在库库存行,含批次/库位/质量状态)。
|
||||
func materialQueryInternalHandler(ctx *svc.ServiceContext) http.HandlerFunc {
|
||||
return func(w http.ResponseWriter, r *http.Request) {
|
||||
code := strings.TrimSpace(r.URL.Query().Get("code"))
|
||||
batch := strings.TrimSpace(r.URL.Query().Get("batch"))
|
||||
resp := map[string]any{"code": code, "found": false, "material": nil, "inventory": []map[string]any{}}
|
||||
if code == "" {
|
||||
ok(w, resp)
|
||||
return
|
||||
}
|
||||
if m, e := ctx.EntClient.Material.Query().Where(material.CodeEQ(code)).First(ctx0()); e == nil && m != nil {
|
||||
resp["found"] = true
|
||||
resp["material"] = map[string]any{
|
||||
"code": m.Code, "name": m.Name, "spec": m.Spec, "itemType": m.ItemType,
|
||||
"unit": m.Unit, "manageMode": m.ManageMode, "snMode": m.SnMode,
|
||||
}
|
||||
}
|
||||
iq := ctx.EntClient.Inventory.Query().Where(inventory.MaterialCodeEQ(code))
|
||||
if batch != "" {
|
||||
iq = iq.Where(inventory.BatchNoEQ(batch))
|
||||
}
|
||||
if invs, e := iq.Where(inventory.QuantityGT(0)).
|
||||
Order(ent.Desc(inventory.FieldCreatedAt)).Limit(50).All(ctx0()); e == nil {
|
||||
rows := make([]map[string]any, 0, len(invs))
|
||||
for _, iv := range invs {
|
||||
rows = append(rows, map[string]any{
|
||||
"zone": iv.ZoneCode, "shelf": iv.ShelfNo, "layer": iv.LayerNo, "position": iv.PositionNo,
|
||||
"quality": iv.QualityStatus, "qty": iv.Quantity, "batch": iv.BatchNo,
|
||||
})
|
||||
}
|
||||
resp["inventory"] = rows
|
||||
}
|
||||
ok(w, resp)
|
||||
}
|
||||
}
|
||||
|
||||
// finishedInboundRequest 成品入库请求(MES 完工回流内部接口 与 WMS 手工成品入库页 共用契约)
|
||||
// 定稿(2026-09-07):成品 SN 由 MES 系统生成(系统必发号,实物可不贴码,允许手填覆盖),
|
||||
// SN 与实物码解耦;完工品落 WMS 统一库存主表(sn_mode=1 序列号=是SN单件, category=3 成品)。
|
||||
|
||||
@@ -7,9 +7,12 @@ import (
|
||||
"time"
|
||||
|
||||
"bj_power_wms/ent"
|
||||
"bj_power_wms/ent/inventory"
|
||||
"bj_power_wms/ent/material"
|
||||
"bj_power_wms/ent/ordermaterialledger"
|
||||
"bj_power_wms/internal/mesclient"
|
||||
"bj_power_wms/internal/svc"
|
||||
"bj_power_wms/internal/verr"
|
||||
|
||||
"github.com/xuri/excelize/v2"
|
||||
"github.com/zeromicro/go-zero/core/logx"
|
||||
@@ -35,15 +38,14 @@ func pushMaterialToMES(ctx *svc.ServiceContext, m *ent.Material) {
|
||||
}()
|
||||
}
|
||||
|
||||
// itemTypeLabel 物料类别标签:1原材料/3成品/4其他(半成品类别已下线,防御性保留 2 的显示)
|
||||
// itemTypeLabel 物料类别标签:1原材料/3成品(「其他」类别已按 2026-10-19 裁决全项目移除,
|
||||
// 半成品类别早已下线,2 仅为历史存量数据防御性显示)
|
||||
func itemTypeLabel(t int) string {
|
||||
switch t {
|
||||
case invCatSemi:
|
||||
return "半成品"
|
||||
case invCatFinished:
|
||||
return "成品"
|
||||
case invItemOther:
|
||||
return "其他"
|
||||
default:
|
||||
return "原材料"
|
||||
}
|
||||
@@ -66,8 +68,8 @@ func validateMaterialRequired(name, spec, unit string, itemType, manageMode, snM
|
||||
case itemType == invCatSemi:
|
||||
// 2026-09-22 定稿:半成品是工件状态(由库存 category=2 承载),不再是物料类别
|
||||
return "半成品不再是物料类别,请选择成品档案并在库存中记录工序状态"
|
||||
case itemType != invCatRaw && itemType != invCatFinished && itemType != invItemOther:
|
||||
return "物料类别为必填项(原材料 / 成品 / 其他)"
|
||||
case itemType != invCatRaw && itemType != invCatFinished:
|
||||
return "物料类别为必填项(原材料 / 成品)"
|
||||
case manageMode != 1 && manageMode != 2 && manageMode != invManageOther:
|
||||
return "类型为必填项(结构件 / 电气件 / 其他)"
|
||||
case snMode != snModeSN && snMode != snModeBatch:
|
||||
@@ -85,6 +87,33 @@ func snModeByType(manageMode int) int {
|
||||
return snModeBatch
|
||||
}
|
||||
|
||||
// collectMaterialRequired 物料档案必填校验·收集式(2026-10-20 报错规范):
|
||||
// 逐条收集不短路,仅物料表单保存(新增/编辑)路径使用;MES 同步/Excel 导入仍用 validateMaterialRequired。
|
||||
// 必填口径(2026-09-19 用户裁决):除「说明」外全部必填;图号(code) 由调用方单独校验。
|
||||
func collectMaterialRequired(ve *verr.ValidationError, name, spec, unit string, itemType, manageMode, snMode int) {
|
||||
if strings.TrimSpace(name) == "" {
|
||||
ve.Add("name", "名称为必填项", "请填写物料名称")
|
||||
}
|
||||
if strings.TrimSpace(spec) == "" {
|
||||
ve.Add("spec", "规格型号为必填项", "请填写规格型号")
|
||||
}
|
||||
if strings.TrimSpace(unit) == "" {
|
||||
ve.Add("unit", "单位为必填项", "请填写计量单位(如 件 / 个 / 米)")
|
||||
}
|
||||
if itemType == invCatSemi {
|
||||
// 2026-09-22 定稿:半成品是工件状态(由库存 category=2 承载),不再是物料类别
|
||||
ve.Add("itemType", "半成品不再是物料类别", "请选择「成品」档案;半成品在库存中记录工序状态")
|
||||
} else if itemType != invCatRaw && itemType != invCatFinished {
|
||||
ve.Add("itemType", "物料类别为必填项", "在「物料类别」里选择 原材料 或 成品")
|
||||
}
|
||||
if manageMode != 1 && manageMode != 2 && manageMode != invManageOther {
|
||||
ve.Add("manageMode", "类型为必填项", "在「类型」里选择 结构件 / 电气件 / 其他")
|
||||
}
|
||||
if snMode != snModeSN && snMode != snModeBatch {
|
||||
ve.Add("snMode", "请选择是否有序列号", "在「序列号」里选择 序列号=是 或 序列号=否")
|
||||
}
|
||||
}
|
||||
|
||||
// createMaterialHandler 创建物料档案
|
||||
func createMaterialHandler(ctx *svc.ServiceContext) http.HandlerFunc {
|
||||
return func(w http.ResponseWriter, r *http.Request) {
|
||||
@@ -97,7 +126,7 @@ func createMaterialHandler(ctx *svc.ServiceContext) http.HandlerFunc {
|
||||
ManageMode int `json:"manageMode"` // 类型 1结构件/2电气件/3其他
|
||||
SnMode int `json:"snMode"` // 序列号 1序列号=是/2序列号=否(0未选择不可保存)
|
||||
TemplateCode string `json:"templateCode"`
|
||||
ItemType int `json:"itemType"` // 1原材料/3成品/4其他(半成品不是物料类别)
|
||||
ItemType int `json:"itemType"` // 1原材料/3成品(半成品不是物料类别)
|
||||
SafetyStock int `json:"safetyStock"` // 安全库存(低于触发缺货预警)
|
||||
IsActive *bool `json:"isActive"` // 启用状态(nil 视为启用)
|
||||
}
|
||||
@@ -105,32 +134,41 @@ func createMaterialHandler(ctx *svc.ServiceContext) http.HandlerFunc {
|
||||
fail(w, http.StatusBadRequest, "参数错误")
|
||||
return
|
||||
}
|
||||
// 必填口径(2026-09-19 用户裁决):除「说明」外全部必填。
|
||||
// 必填口径(2026-09-19 用户裁决):除「说明」外全部必填 —— 收集式一次列全(2026-10-20 报错规范)
|
||||
ve := verr.New()
|
||||
if strings.TrimSpace(req.Code) == "" {
|
||||
fail(w, http.StatusBadRequest, "图号为必填项")
|
||||
return
|
||||
ve.Add("code", "图号为必填项", "请填写物料图号(图号即物料编码)")
|
||||
}
|
||||
if msg := validateMaterialRequired(req.Name, req.Spec, req.Unit, req.ItemType, req.ManageMode, req.SnMode); msg != "" {
|
||||
fail(w, http.StatusBadRequest, msg)
|
||||
collectMaterialRequired(ve, req.Name, req.Spec, req.Unit, req.ItemType, req.ManageMode, req.SnMode)
|
||||
if req.ItemType == invCatFinished && req.SnMode != snModeSN {
|
||||
ve.Add("snMode", "成品物料的序列号必须为「是」", "成品逐件追溯、SN 由系统兜底生成;把序列号改为「序列号=是」")
|
||||
}
|
||||
// 校验编码唯一(与其他校验相互独立,一并收集)
|
||||
if strings.TrimSpace(req.Code) != "" {
|
||||
exists, err := ctx.EntClient.Material.Query().
|
||||
Where(material.CodeEQ(req.Code)).
|
||||
Exist(ctx0())
|
||||
if err != nil {
|
||||
fail(w, http.StatusInternalServerError, err.Error())
|
||||
return
|
||||
}
|
||||
if exists {
|
||||
ve.AddAction("code", "图号 "+req.Code+" 已存在", "改用其他图号;或到物料列表搜索该图号查看已有档案", "查看物料列表", "/material")
|
||||
}
|
||||
}
|
||||
if err := ve.OrNil(); err != nil {
|
||||
FailErr(w, err)
|
||||
return
|
||||
}
|
||||
|
||||
// 校验编码唯一
|
||||
exists, err := ctx.EntClient.Material.Query().
|
||||
Where(material.CodeEQ(req.Code)).
|
||||
Exist(ctx0())
|
||||
if err != nil {
|
||||
fail(w, http.StatusInternalServerError, err.Error())
|
||||
return
|
||||
}
|
||||
if exists {
|
||||
fail(w, http.StatusConflict, "图号已存在: "+req.Code)
|
||||
return
|
||||
}
|
||||
|
||||
// 物料类别/类型已在上方校验,原样落库(类型 1结构件/2电气件/3其他 相互独立,不再由物料类别收敛)
|
||||
manageMode := req.ManageMode
|
||||
itemType := req.ItemType
|
||||
// 物料类别/类型已在上方校验,原样落库(类型 1结构件/2电气件/3其他 相互独立,不再由物料类别收敛)
|
||||
manageMode := req.ManageMode
|
||||
itemType := req.ItemType
|
||||
// 成品(item_type=3)序列号强制「是」(2026-10-19 拍板:成品 SN 系统兜底生成、逐件追溯)
|
||||
snMode := req.SnMode
|
||||
if itemType == invCatFinished {
|
||||
snMode = snModeSN
|
||||
}
|
||||
|
||||
m, err := ctx.EntClient.Material.Create().
|
||||
SetCode(req.Code).
|
||||
@@ -138,11 +176,11 @@ func createMaterialHandler(ctx *svc.ServiceContext) http.HandlerFunc {
|
||||
SetNillableSpec(strPtr(req.Spec)).
|
||||
SetNillableUnit(strPtr(req.Unit)).
|
||||
SetNillableDescription(strPtr(req.Description)).
|
||||
SetManageMode(manageMode).
|
||||
SetSnMode(req.SnMode).
|
||||
SetIsBatchManaged(req.SnMode == snModeBatch).
|
||||
SetIsSerialManaged(req.SnMode == snModeSN).
|
||||
SetNillableTemplateCode(strPtr(req.TemplateCode)).
|
||||
SetManageMode(manageMode).
|
||||
SetSnMode(snMode).
|
||||
SetIsBatchManaged(snMode == snModeBatch).
|
||||
SetIsSerialManaged(snMode == snModeSN).
|
||||
SetNillableTemplateCode(strPtr(req.TemplateCode)).
|
||||
SetItemType(itemType).
|
||||
SetSafetyStock(req.SafetyStock).
|
||||
SetIsActive(req.IsActive == nil || *req.IsActive).
|
||||
@@ -179,17 +217,57 @@ func updateMaterialHandler(ctx *svc.ServiceContext) http.HandlerFunc {
|
||||
fail(w, http.StatusBadRequest, "参数错误")
|
||||
return
|
||||
}
|
||||
// 必填口径(2026-09-19 用户裁决):除「说明」外全部必填
|
||||
if msg := validateMaterialRequired(req.Name, req.Spec, req.Unit, req.ItemType, req.ManageMode, req.SnMode); msg != "" {
|
||||
fail(w, http.StatusBadRequest, msg)
|
||||
return
|
||||
}
|
||||
// 必填口径(2026-09-19 用户裁决):除「说明」外全部必填 —— 收集式一次列全(2026-10-20 报错规范)
|
||||
ve := verr.New()
|
||||
collectMaterialRequired(ve, req.Name, req.Spec, req.Unit, req.ItemType, req.ManageMode, req.SnMode)
|
||||
cur, gerr := ctx.EntClient.Material.Get(ctx0(), req.ID)
|
||||
if gerr != nil {
|
||||
fail(w, http.StatusNotFound, "物料不存在")
|
||||
return
|
||||
}
|
||||
|
||||
// ---------- 物料类别/序列号规则(2026-10-19 用户拍板;收集式并列校验 2026-10-20) ----------
|
||||
// ① 成品(item_type=3)序列号强制为「是」且不可改(成品 SN 系统兜底生成、逐件追溯);
|
||||
// ② 已有工件引用(库存存在 SN 记账行=已有实物按件流转)→ 序列号锁死,禁止改;
|
||||
// ③ 已有工单引用(工单用料台账有该物料行)→ 物料类别锁死,禁止改;
|
||||
// ④ 类型(结构件/电气件/其他)已被库存引用 → 锁死(2026-10-20 拍板:三字段已使用不可修改)。
|
||||
if req.ItemType == invCatFinished && req.SnMode != snModeSN {
|
||||
ve.Add("snMode", "成品物料的序列号必须为「是」,不可修改", "成品逐件追溯、SN 由系统兜底生成;把序列号改回「序列号=是」")
|
||||
}
|
||||
if req.SnMode != cur.SnMode {
|
||||
snRef, cerr := ctx.EntClient.Inventory.Query().
|
||||
Where(inventory.MaterialCodeEQ(cur.Code), inventory.SnModeEQ(snModeSN)).
|
||||
Exist(ctx0())
|
||||
if cerr == nil && snRef {
|
||||
ve.Add("snMode", "该物料已有工件按序列号引用,序列号不可修改", "已有库存实物按「序列号=是」流转;保持原序列号设置不变")
|
||||
}
|
||||
}
|
||||
if req.ItemType != cur.ItemType {
|
||||
woRef, werr := ctx.EntClient.OrderMaterialLedger.Query().
|
||||
Where(ordermaterialledger.MaterialCodeEQ(cur.Code)).
|
||||
Exist(ctx0())
|
||||
if werr == nil && woRef {
|
||||
ve.Add("itemType", "该物料已被工单用料引用,物料类别不可修改", "先清理相关工单用料记录;或保持原物料类别不变")
|
||||
}
|
||||
}
|
||||
if req.ManageMode != cur.ManageMode {
|
||||
invRef, ierr := ctx.EntClient.Inventory.Query().
|
||||
Where(inventory.MaterialCodeEQ(cur.Code)).
|
||||
Exist(ctx0())
|
||||
if ierr == nil && invRef {
|
||||
ve.Add("manageMode", "该物料已有库存记录,类型不可修改", "已有库存按原类型记账;保持原类型不变,或先处理完库存再调整")
|
||||
}
|
||||
}
|
||||
if err := ve.OrNil(); err != nil {
|
||||
FailErr(w, err)
|
||||
return
|
||||
}
|
||||
// 成品强制落「序列号=是」(防历史脏值经本接口翻案)
|
||||
snMode := req.SnMode
|
||||
if req.ItemType == invCatFinished {
|
||||
snMode = snModeSN
|
||||
}
|
||||
|
||||
manageMode := req.ManageMode
|
||||
m, err := ctx.EntClient.Material.UpdateOneID(req.ID).
|
||||
SetName(req.Name).
|
||||
@@ -200,9 +278,9 @@ func updateMaterialHandler(ctx *svc.ServiceContext) http.HandlerFunc {
|
||||
SetSafetyStock(req.SafetyStock).
|
||||
SetIsActive(req.IsActive == nil || *req.IsActive).
|
||||
SetManageMode(manageMode).
|
||||
SetSnMode(req.SnMode).
|
||||
SetIsBatchManaged(req.SnMode == snModeBatch).
|
||||
SetIsSerialManaged(req.SnMode == snModeSN).
|
||||
SetSnMode(snMode).
|
||||
SetIsBatchManaged(snMode == snModeBatch).
|
||||
SetIsSerialManaged(snMode == snModeSN).
|
||||
Save(ctx0())
|
||||
if err != nil {
|
||||
fail(w, http.StatusInternalServerError, "更新物料失败: "+err.Error())
|
||||
@@ -264,6 +342,43 @@ func upsertMaterialInternalHandler(ctx *svc.ServiceContext) http.HandlerFunc {
|
||||
}
|
||||
existing, gerr := ctx.EntClient.Material.Query().Where(material.CodeEQ(req.Code)).Only(ctx0())
|
||||
if gerr == nil {
|
||||
// ---------- 类别/序列号规则(2026-10-19 拍板,与编辑接口同口径) ----------
|
||||
// 成品(3)序列号强制「是」;已有工件引用(inventory SN 行)→序列号锁死;
|
||||
// 已有工单引用(order_material_ledgers)→类别锁死。
|
||||
if req.ItemType == invCatFinished && req.SnMode != snModeSN && req.SnMode != 0 {
|
||||
fail(w, http.StatusBadRequest, "成品物料的序列号必须为「是」")
|
||||
return
|
||||
}
|
||||
if req.SnMode == snModeSN || req.SnMode == snModeBatch {
|
||||
if req.SnMode != existing.SnMode {
|
||||
snRef, cerr := ctx.EntClient.Inventory.Query().
|
||||
Where(inventory.MaterialCodeEQ(existing.Code), inventory.SnModeEQ(snModeSN)).
|
||||
Exist(ctx0())
|
||||
if cerr == nil && snRef {
|
||||
fail(w, http.StatusBadRequest, "该物料已有工件按序列号引用,序列号不可修改")
|
||||
return
|
||||
}
|
||||
}
|
||||
}
|
||||
if req.ItemType != existing.ItemType {
|
||||
woRef, werr := ctx.EntClient.OrderMaterialLedger.Query().
|
||||
Where(ordermaterialledger.MaterialCodeEQ(existing.Code)).
|
||||
Exist(ctx0())
|
||||
if werr == nil && woRef {
|
||||
fail(w, http.StatusBadRequest, "该物料已被工单用料引用,物料类别不可修改")
|
||||
return
|
||||
}
|
||||
}
|
||||
// 类型已被库存引用 → 锁死(与编辑接口同口径,2026-10-20)
|
||||
if req.ManageMode != existing.ManageMode {
|
||||
invRef, ierr := ctx.EntClient.Inventory.Query().
|
||||
Where(inventory.MaterialCodeEQ(existing.Code)).
|
||||
Exist(ctx0())
|
||||
if ierr == nil && invRef {
|
||||
fail(w, http.StatusBadRequest, "该物料已有库存记录,类型不可修改")
|
||||
return
|
||||
}
|
||||
}
|
||||
// sn_mode(2026-09-30 契约对齐):MES 传 1/2 时同步落库;传 0(未选择)保留现值防清零
|
||||
upd := ctx.EntClient.Material.UpdateOneID(existing.ID).
|
||||
SetName(req.Name).
|
||||
@@ -275,7 +390,12 @@ func upsertMaterialInternalHandler(ctx *svc.ServiceContext) http.HandlerFunc {
|
||||
SetNillableTemplateCode(strPtr(req.TemplateCode)).
|
||||
SetSafetyStock(req.SafetyStock).
|
||||
SetIsActive(active)
|
||||
if req.SnMode == snModeSN || req.SnMode == snModeBatch {
|
||||
if req.ItemType == invCatFinished {
|
||||
// 成品强制「序列号=是」(防历史脏值经同步翻案)
|
||||
upd = upd.SetSnMode(snModeSN).
|
||||
SetIsBatchManaged(false).
|
||||
SetIsSerialManaged(true)
|
||||
} else if req.SnMode == snModeSN || req.SnMode == snModeBatch {
|
||||
upd = upd.SetSnMode(req.SnMode).
|
||||
SetIsBatchManaged(req.SnMode == snModeBatch).
|
||||
SetIsSerialManaged(req.SnMode == snModeSN)
|
||||
@@ -290,9 +410,12 @@ func upsertMaterialInternalHandler(ctx *svc.ServiceContext) http.HandlerFunc {
|
||||
ok(w, map[string]any{"created": false, "id": m.ID})
|
||||
return
|
||||
}
|
||||
// sn_mode:MES 传 1/2 用 MES 值;未传(0)按类型默认联动派生(电气件→序列号=是,其余→序列号=否)
|
||||
// sn_mode:MES 传 1/2 用 MES 值;未传(0)按类型默认联动派生(电气件→序列号=是,其余→序列号=否);
|
||||
// 成品(3)强制「序列号=是」(2026-10-19 拍板)
|
||||
newSnMode := req.SnMode
|
||||
if newSnMode != snModeSN && newSnMode != snModeBatch {
|
||||
if req.ItemType == invCatFinished {
|
||||
newSnMode = snModeSN
|
||||
} else if newSnMode != snModeSN && newSnMode != snModeBatch {
|
||||
newSnMode = snModeByType(req.ManageMode)
|
||||
}
|
||||
if msg := validateMaterialRequired(req.Name, req.Spec, req.Unit, req.ItemType, req.ManageMode, newSnMode); msg != "" {
|
||||
@@ -334,8 +457,8 @@ func queryMaterialsHandler(ctx *svc.ServiceContext) http.HandlerFunc {
|
||||
spec := r.URL.Query().Get("spec")
|
||||
manageMode := atoi(r.URL.Query().Get("manageMode"), 0)
|
||||
itemType := atoi(r.URL.Query().Get("itemType"), 0)
|
||||
// 排除物料类别:入库各页签按管理粒度过滤时,需把「其他」类别(item_type=4)排除,
|
||||
// 否则档案里选「其他」时 manage_mode 保留默认值 1,会漏进结构件入库的下拉。
|
||||
// 排除物料类别:入库各页签按管理粒度过滤时可按需排除指定物料类别,
|
||||
// 避免档案里某类别混进其他管理粒度的下拉。
|
||||
excludeItemType := atoi(r.URL.Query().Get("excludeItemType"), 0)
|
||||
startDate := r.URL.Query().Get("startDate")
|
||||
endDate := r.URL.Query().Get("endDate")
|
||||
@@ -665,8 +788,9 @@ func parseManageMode(s string) int {
|
||||
return 0
|
||||
}
|
||||
|
||||
// parseItemType 解析导入模板"物料类别"列(兼容旧模板"品类"列名):原材料/成品/其他(兼容 1/3/4);无法识别返回 0。
|
||||
// 注意:"半成品"不再是物料类别(2026-09-22),且含"成品"子串,必须先排除再判成品。
|
||||
// parseItemType 解析导入模板"物料类别"列(兼容旧模板"品类"列名):原材料/成品(兼容 1/3);无法识别返回 0。
|
||||
// 注意:"半成品"不再是物料类别(2026-09-22),且含"成品"子串,必须先排除再判成品;
|
||||
// 「其他」类别已按 2026-10-19 裁决全项目移除,历史含"其他"的导入行按无法识别整体拒绝。
|
||||
func parseItemType(s string) int {
|
||||
s = strings.TrimSpace(s)
|
||||
if s == "" {
|
||||
@@ -679,10 +803,8 @@ func parseItemType(s string) int {
|
||||
return 0 // 半成品已不是物料类别,导入该行按"物料类别无法识别"整体拒绝
|
||||
case strings.Contains(s, "成品"):
|
||||
return 3
|
||||
case strings.Contains(s, "其他"):
|
||||
return 4
|
||||
}
|
||||
if n := atoi(s, 0); n == 1 || n == 3 || n == 4 {
|
||||
if n := atoi(s, 0); n == 1 || n == 3 {
|
||||
return n
|
||||
}
|
||||
return 0
|
||||
@@ -795,8 +917,11 @@ func excelMaterialImportHandler(ctx *svc.ServiceContext) http.HandlerFunc {
|
||||
pr.spec = cell(specCol)
|
||||
pr.unit = cell(unitCol)
|
||||
pr.manageMode = parseManageMode(cell(typeCol))
|
||||
pr.snMode = snModeByType(pr.manageMode)
|
||||
pr.itemType = parseItemType(cell(catCol))
|
||||
pr.snMode = snModeByType(pr.manageMode)
|
||||
if pr.itemType == invCatFinished {
|
||||
pr.snMode = snModeSN // 成品强制「序列号=是」(与编辑/同步同口径,2026-10-19 拍板)
|
||||
}
|
||||
pr.description = cell(descCol)
|
||||
|
||||
if pr.code == "" {
|
||||
@@ -820,7 +945,7 @@ func excelMaterialImportHandler(ctx *svc.ServiceContext) http.HandlerFunc {
|
||||
continue
|
||||
}
|
||||
if catCol >= 0 && cell(catCol) != "" && pr.itemType == 0 {
|
||||
errs = append(errs, importErr{pr.row, pr.code, "物料类别无法识别,请填写「原材料/成品/其他」(兼容 1/3/4;半成品不是物料类别)"})
|
||||
errs = append(errs, importErr{pr.row, pr.code, "物料类别无法识别,请填写「原材料/成品」(兼容 1/3;半成品不是物料类别,「其他」已取消)"})
|
||||
continue
|
||||
}
|
||||
exists, _ := ctx.EntClient.Material.Query().
|
||||
|
||||
@@ -1,8 +1,12 @@
|
||||
package handler
|
||||
|
||||
import (
|
||||
"errors"
|
||||
"fmt"
|
||||
"net/http"
|
||||
|
||||
"bj_power_wms/internal/verr"
|
||||
|
||||
"github.com/zeromicro/go-zero/rest/httpx"
|
||||
)
|
||||
|
||||
@@ -24,3 +28,23 @@ func fail(w http.ResponseWriter, httpStatus int, message string) {
|
||||
func failCode(w http.ResponseWriter, httpStatus, code int, message string) {
|
||||
httpx.WriteJson(w, httpStatus, Response{Code: code, Message: message})
|
||||
}
|
||||
|
||||
// FailValidation 收集式校验失败(2026-10-20 报错规范):HTTP 200,code=3015,
|
||||
// data.errors 结构化清单;前端拦截器识别 3015 后用 ErrorListDialog 一次弹全,不用 ElMessage 单条。
|
||||
func FailValidation(w http.ResponseWriter, errs []verr.FieldError) {
|
||||
httpx.WriteJson(w, http.StatusOK, Response{
|
||||
Code: 3015,
|
||||
Message: fmt.Sprintf("保存失败,共 %d 项需要处理", len(errs)),
|
||||
Data: map[string]any{"errors": errs},
|
||||
})
|
||||
}
|
||||
|
||||
// FailErr 统一错误出口:*verr.ValidationError → FailValidation 结构化;其他 error → 普通 fail(500)。
|
||||
func FailErr(w http.ResponseWriter, err error) {
|
||||
var ve *verr.ValidationError
|
||||
if errors.As(err, &ve) {
|
||||
FailValidation(w, ve.Errors)
|
||||
return
|
||||
}
|
||||
fail(w, http.StatusInternalServerError, err.Error())
|
||||
}
|
||||
|
||||
@@ -247,8 +247,10 @@ func RegisterHandlers(server *rest.Server, ctx *svc.ServiceContext) {
|
||||
{Method: http.MethodGet, Path: "/api/internal/product-types/export", Handler: wrapInternal(ctx)(exportProductTypesInternalHandler(ctx))},
|
||||
// 物料两库对等(需求一 M3/M5):MES→WMS 推送落点,按 code 幂等 upsert(删除=停用 isActive=false)
|
||||
{Method: http.MethodPost, Path: "/api/internal/materials/upsert", Handler: wrapInternal(ctx)(upsertMaterialInternalHandler(ctx))},
|
||||
{Method: http.MethodPost, Path: "/api/internal/material/exists", Handler: wrapInternal(ctx)(materialExistsHandler(ctx))},
|
||||
{Method: http.MethodPost, Path: "/api/internal/material/types", Handler: wrapInternal(ctx)(materialTypesHandler(ctx))},
|
||||
{Method: http.MethodPost, Path: "/api/internal/material/exists", Handler: wrapInternal(ctx)(materialExistsHandler(ctx))},
|
||||
{Method: http.MethodPost, Path: "/api/internal/material/types", Handler: wrapInternal(ctx)(materialTypesHandler(ctx))},
|
||||
// 看板物料追溯入口复用:物料档案 + 库存查询(按编码/批次)
|
||||
{Method: http.MethodGet, Path: "/api/internal/material/query", Handler: wrapInternal(ctx)(materialQueryInternalHandler(ctx))},
|
||||
{Method: http.MethodPost, Path: "/api/internal/material/manage-modes", Handler: wrapInternal(ctx)(materialManageModesHandler(ctx))},
|
||||
// 物料分页查询(需求一 M7:MES 冷启动全量拉取用;MES 推送走上方 /upsert)
|
||||
{Method: http.MethodGet, Path: "/api/internal/materials", Handler: wrapInternal(ctx)(queryMaterialsHandler(ctx))},
|
||||
|
||||
@@ -0,0 +1,67 @@
|
||||
// Package verr 收集式校验错误(报错一次收全 + 每条带怎么办,2026-10-20 拍板):
|
||||
// 校验函数从「发现错就 return」改为逐条收集,收尾用 OrNil() 一次性返回全部问题,
|
||||
// 由 handler 层 FailErr 识别后输出 code=3015 + data.errors 结构化响应,
|
||||
// 前端拦截器识别后用 ErrorListDialog 一次弹全,不再挤牙膏。
|
||||
package verr
|
||||
|
||||
import "fmt"
|
||||
|
||||
// ErrAction 可跳转动作:前端渲染为按钮,点击新开标签页跳转 URL(当前页表单草稿保留)。
|
||||
type ErrAction struct {
|
||||
Label string `json:"label"`
|
||||
URL string `json:"url"`
|
||||
}
|
||||
|
||||
// FieldError 单条校验错误:现象(Message)+ 怎么办(Suggestion)+ 可选跳转(Action)。
|
||||
type FieldError struct {
|
||||
Field string `json:"field"`
|
||||
Message string `json:"message"`
|
||||
Suggestion string `json:"suggestion"`
|
||||
Action *ErrAction `json:"action,omitempty"`
|
||||
}
|
||||
|
||||
// ValidationError 收集容器:errors 非空时整体作为一个 error 返回。
|
||||
type ValidationError struct {
|
||||
Errors []FieldError
|
||||
}
|
||||
|
||||
// New 新建收集器。
|
||||
func New() *ValidationError { return &ValidationError{} }
|
||||
|
||||
// Add 追加一条「现象 + 怎么办」。
|
||||
func (e *ValidationError) Add(field, message, suggestion string) {
|
||||
e.Errors = append(e.Errors, FieldError{Field: field, Message: message, Suggestion: suggestion})
|
||||
}
|
||||
|
||||
// AddAction 追加一条带跳转按钮的错误(label=按钮文案,url=新标签页打开的路由)。
|
||||
func (e *ValidationError) AddAction(field, message, suggestion, label, url string) {
|
||||
e.Errors = append(e.Errors, FieldError{Field: field, Message: message, Suggestion: suggestion,
|
||||
Action: &ErrAction{Label: label, URL: url}})
|
||||
}
|
||||
|
||||
// Merge 把另一个收集器的条目并入本收集器。
|
||||
func (e *ValidationError) Merge(o *ValidationError) {
|
||||
if o != nil && len(o.Errors) > 0 {
|
||||
e.Errors = append(e.Errors, o.Errors...)
|
||||
}
|
||||
}
|
||||
|
||||
// Len 已收集条数。
|
||||
func (e *ValidationError) Len() int {
|
||||
if e == nil {
|
||||
return 0
|
||||
}
|
||||
return len(e.Errors)
|
||||
}
|
||||
|
||||
// OrNil 收尾:无错误返回 nil,有错误返回自身(校验函数统一调用)。
|
||||
func (e *ValidationError) OrNil() error {
|
||||
if e == nil || len(e.Errors) == 0 {
|
||||
return nil
|
||||
}
|
||||
return e
|
||||
}
|
||||
|
||||
func (e *ValidationError) Error() string {
|
||||
return fmt.Sprintf("保存失败,共 %d 项需要处理", len(e.Errors))
|
||||
}
|
||||
@@ -20,8 +20,9 @@ import (
|
||||
// - sn_mode=0 未选择(默认):物料档案必选后才能出入库(业务层校验)。
|
||||
//
|
||||
// 物料类别(与库存主表 inventories.category 对应,独立于类型):
|
||||
// - item_type=1 原材料 / 3 成品 / 4 其他(成品即"产品型号"档案,MES 实时从本表拉取,
|
||||
// - item_type=1 原材料 / 3 成品(成品即"产品型号"档案,MES 实时从本表拉取,
|
||||
// 消除两系统双录——2026-09-08 并表定稿)。
|
||||
// 「其他」类别已按 2026-10-19 用户裁决全项目移除(两库存量均为 0 行)。
|
||||
// 半成品不是物料类别(2026-09-22 定稿):半成品是工件状态,由库存 category=2 承载,
|
||||
// 物料档案不再有 item_type=2 行(存量由 internal/db 迁移补丁幂等清理)。
|
||||
//
|
||||
@@ -44,14 +45,14 @@ func (Material) Fields() []ent.Field {
|
||||
field.String("spec").Optional().Comment("规格型号"),
|
||||
field.String("unit").Optional().Comment("单位"),
|
||||
field.String("description").Optional().Comment("描述"),
|
||||
// 物料类别(独立于类型的维度):1=原材料 3=成品 4=其他(半成品不是物料类别,由库存承载)
|
||||
field.Int("item_type").Default(1).Comment("物料类别 1原材料/3成品/4其他(半成品不是物料类别,由库存 category=2 承载)"),
|
||||
// 物料类别(独立于类型的维度):1=原材料 3=成品(半成品不是物料类别,由库存承载)
|
||||
field.Int("item_type").Default(1).Comment("物料类别 1原材料/3成品(半成品不是物料类别,由库存 category=2 承载)"),
|
||||
// 类型(分类,入库「结构件/电气件/其他」三页签同源,仅用于分类统计/筛选/页签归属):
|
||||
// 1=结构件 2=电气件 3=其他(辅料/工装/试验设备);与 SN 行为无关(见 sn_mode)
|
||||
field.Int("manage_mode").Default(1).Comment("类型 1结构件/2电气件/3其他"),
|
||||
// 是否逐件 SN 管理(2026-09-30 与类型解耦):1=序列号=是(逐件SN) 2=序列号=否(数量) 0=未选择
|
||||
// 默认联动:电气件→1,结构件/其他→2;必选约束在业务层(0 不可出入库)
|
||||
field.Int("sn_mode").Default(0).Comment("SN管理 1序列号=是(逐件SN)/2序列号=否(数量)/0未选择"),
|
||||
field.Int("sn_mode").Default(0).Comment("序列号 1=是(逐件录SN)/2=否(按数量)/0未选择"),
|
||||
field.Bool("is_batch_managed").Default(false).Comment("是否批次管理(按 sn_mode=2 派生)"),
|
||||
field.Bool("is_serial_managed").Default(false).Comment("是否序列号管理(按 sn_mode=1 派生)"),
|
||||
// 所属物料模板(种类)
|
||||
|
||||
@@ -44,7 +44,7 @@ func (OutboundOrder) Fields() []ent.Field {
|
||||
// 类型(分类语境):1结构件/2电气件/3其他
|
||||
field.Int("manage_mode").Default(1).Comment("类型 1结构件/2电气件/3其他"),
|
||||
// 序列号(2026-09-30 解耦定稿):1序列号=是(逐件SN)/2序列号=否(数量)
|
||||
field.Int("sn_mode").Default(0).Comment("SN管理 1序列号=是(逐件SN)/2序列号=否(数量)/0未选择"),
|
||||
field.Int("sn_mode").Default(0).Comment("序列号 1=是(逐件SN)/2=否(按数量)/0未选择"),
|
||||
field.String("batch_no").Optional().Comment("批次号(结构件)"),
|
||||
// 出库库位四级(客户诉求:出库与入库同口径,2026-09-19 补齐)
|
||||
field.String("zone_code").Optional().Comment("出库区域(大区)"),
|
||||
|
||||
@@ -6,8 +6,8 @@
|
||||
<title>WMS库房管理</title>
|
||||
<!-- 系统图标:库房箱体(内联 SVG,避免依赖外部文件) -->
|
||||
<link rel="icon" type="image/svg+xml" href="data:image/svg+xml,<svg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 32 32'><rect width='32' height='32' rx='6' fill='%231668dc'/><path d='M16 7l9 4.5v9L16 25l-9-4.5v-9L16 7z' fill='none' stroke='%23fff' stroke-width='2' stroke-linejoin='round'/><path d='M7 11.5L16 16l9-4.5M16 16v9' fill='none' stroke='%23fff' stroke-width='2' stroke-linejoin='round'/></svg>">
|
||||
<script type="module" crossorigin src="/assets/index-DvYRtqzo.js"></script>
|
||||
<link rel="stylesheet" crossorigin href="/assets/index-D95eCOAJ.css">
|
||||
<script type="module" crossorigin src="/assets/index-DYK7TRzp.js"></script>
|
||||
<link rel="stylesheet" crossorigin href="/assets/index-BkxVJud_.css">
|
||||
</head>
|
||||
<body>
|
||||
<div id="app"></div>
|
||||
|
||||
Reference in New Issue
Block a user