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
+2 -2
View File
@@ -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"`
+3 -3
View File
@@ -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: "货架号(与入库同口径)"},
+1 -1
View File
@@ -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"`
+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
}
+5
View File
@@ -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 {
-3
View File
@@ -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 成品)。
+177 -52
View File
@@ -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().
+24
View File
@@ -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())
}
+4 -2
View File
@@ -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))},
+67
View File
@@ -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))
}
+5 -4
View File
@@ -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 派生)"),
// 所属物料模板(种类)
+1 -1
View File
@@ -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("出库区域(大区)"),
+2 -2
View File
@@ -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>