feat: 解耦管理类型与SN管理方式,新增sn_mode字段实现全链路SN管理标准化

本次重构将原manage_mode字段拆分为独立的分类维度(manage_mode)和SN管理维度(sn_mode),实现全链路(MES/WMS/工位终端)的SN管理行为统一依据:
1. 新增sn_mode字段,定义1=序列号件、2=批次件、0=未选择,替代原manage_mode的SN判断逻辑
2. 移除冗余的manage_mode字段在多个实体中的使用,统一使用sn_mode决定业务行为
3. 新增工位接驳台配置,服务端固定接驳台,前端不可修改,确保AGV送达准确性
4. 优化检验记录导出,新增装配物料绑定明细,满足客户追溯需求
5. 修正前端提示文本,统一使用序列号件/批次件表述,与后端逻辑对齐
This commit is contained in:
SunYF
2026-09-30 17:33:11 +08:00
parent 58f67240d7
commit c33acab9c8
136 changed files with 3730 additions and 1174 deletions
+27 -13
View File
@@ -148,7 +148,7 @@ func displayWidth(s string) int {
return n
}
// manageModeLabel 类型中文名:1=结构件 2=电气件 3=其他
// manageModeLabel 类型中文名:1=结构件 2=电气件 3=其他(纯类型语境,2026-09-30 与SN行为解耦)
func manageModeLabel(m int) string {
switch m {
case 1:
@@ -161,6 +161,17 @@ func manageModeLabel(m int) string {
return "-"
}
// snModeLabel 记账方式中文名:1=序列号件 2=批次件(2026-09-30 解耦定稿)
func snModeLabel(v int) string {
switch v {
case snModeSN:
return "序列号件"
case snModeBatch:
return "批次件"
}
return "-"
}
// locLabel 拼接完整库位串:大区/货架/层/位置,跳过空段(方案 E 库位四级贯通)。
// 例:"Z01/A架/3层/12位";仅有大区时返回大区;全空返回 "-"。
func locLabel(zoneCode, shelfNo, layerNo, positionNo string) string {
@@ -212,8 +223,8 @@ type importErr struct {
}
// excelInboundHandler Excel 批量导入入库
// mode=batch(结构件):列头(首行忽略) 图号 | 批次号(可空自动生成) | 数量 | 生产日期 | 供应商 | 区域 | 备注
// mode=sn(电气件): 列头(首行忽略) 图号 | SN | 区域 | 生产日期 | 供应商
// mode=batch(批次件):列头(首行忽略) 图号 | 批次号(可空自动生成) | 数量 | 生产日期 | 供应商 | 区域 | 备注
// mode=sn(序列号件): 列头(首行忽略) 图号 | SN | 区域 | 生产日期 | 供应商
//
// 强约束:全成功或全失败(一次性全导入 or 全失败,禁止部分成功)。
// 流程:阶段1 逐行解析+校验(物料存在/数量>0/SN不重复/区域必填) → 任一错则整体拒绝并列出错误行(一行不写);
@@ -282,7 +293,7 @@ func excelInboundHandler(ctx *svc.ServiceContext) http.HandlerFunc {
pr.code = cell(0)
if mode == "sn" {
pr.sn = cell(1)
pr.zone = cell(2) // 电气件模板: 图号|SN|区域|生产日期|供应商
pr.zone = cell(2) // 序列号件模板: 图号|SN|区域|生产日期|供应商
pr.prodDate = cell(3)
pr.supplier = cell(4)
pr.remark = cell(4)
@@ -291,7 +302,7 @@ func excelInboundHandler(ctx *svc.ServiceContext) http.HandlerFunc {
pr.qty = atoi(cell(2), 0)
pr.prodDate = cell(3)
pr.supplier = cell(4)
pr.zone = cell(5) // 结构件模板: 图号|批次号|数量|生产日期|供应商|区域|备注
pr.zone = cell(5) // 批次件模板: 图号|批次号|数量|生产日期|供应商|区域|备注
pr.remark = cell(6)
}
@@ -305,8 +316,8 @@ func excelInboundHandler(ctx *svc.ServiceContext) http.HandlerFunc {
continue
}
if mode == "sn" {
if m.ManageMode != 2 {
errs = append(errs, importErr{pr.row, pr.code, "该物料为结构件,SN 导入仅支持电气件(按 SN 管理)"})
if m.SnMode != snModeSN {
errs = append(errs, importErr{pr.row, pr.code, "该物料为批次件,SN 导入仅支持序列号件(逐件SN)"})
continue
}
if pr.sn == "" {
@@ -319,14 +330,14 @@ func excelInboundHandler(ctx *svc.ServiceContext) http.HandlerFunc {
}
snSeen[pr.sn] = true
exists, _ := ctx.EntClient.Inventory.Query().
Where(inventory.ManageModeEQ(2), inventory.SnCodeEQ(pr.sn)).Exist(ctx0())
Where(inventory.SnModeEQ(snModeSN), inventory.SnCodeEQ(pr.sn)).Exist(ctx0())
if exists {
errs = append(errs, importErr{pr.row, pr.code, "SN 已存在: " + pr.sn})
continue
}
} else {
if m.ManageMode != 1 {
errs = append(errs, importErr{pr.row, pr.code, "该物料为电气件,请使用 SN 导入"})
if m.SnMode != snModeBatch {
errs = append(errs, importErr{pr.row, pr.code, "该物料为序列号件,请使用 SN 导入"})
continue
}
if pr.qty <= 0 {
@@ -367,7 +378,8 @@ func excelInboundHandler(ctx *svc.ServiceContext) http.HandlerFunc {
m, _ := tx.Material.Query().Where(material.CodeEQ(pr.code)).Only(ctx0())
if mode == "sn" {
if _, e = tx.Inventory.Create().
SetManageMode(2).
SetManageMode(m.ManageMode).
SetSnMode(m.SnMode).
SetMaterialCode(pr.code).
SetNillableMaterialName(strPtr(m.Name)).
SetSnCode(pr.sn).
@@ -395,7 +407,7 @@ func excelInboundHandler(ctx *svc.ServiceContext) http.HandlerFunc {
batchNo = genBatchNo(ctx, pr.code)
}
existing, e2 := tx.Inventory.Query().
Where(inventory.ManageModeEQ(1), inventory.BatchNoEQ(batchNo)).Only(ctx0())
Where(inventory.SnModeEQ(snModeBatch), inventory.BatchNoEQ(batchNo)).Only(ctx0())
if e2 == nil {
if _, e = tx.Inventory.UpdateOneID(existing.ID).
AddQuantity(pr.qty).
@@ -406,7 +418,8 @@ func excelInboundHandler(ctx *svc.ServiceContext) http.HandlerFunc {
}
} else {
if _, e = tx.Inventory.Create().
SetManageMode(1).
SetManageMode(m.ManageMode).
SetSnMode(m.SnMode).
SetBatchNo(batchNo).
SetMaterialCode(pr.code).
SetNillableMaterialName(strPtr(m.Name)).
@@ -435,6 +448,7 @@ func excelInboundHandler(ctx *svc.ServiceContext) http.HandlerFunc {
SetMaterialCode(pr.code).
SetNillableMaterialName(strPtr(m.Name)).
SetManageMode(m.ManageMode).
SetSnMode(m.SnMode).
SetNillableZoneCode(strPtr(pr.zone)).
SetQuantity(ternary(mode == "sn", 1, pr.qty)).
SetNillableRemark(strPtr(pr.remark)).