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:
@@ -22,10 +22,19 @@ import (
|
||||
// 物料品类:4=其他(辅料/工装/试验设备),与 schema/material.go 的 item_type 保持一致
|
||||
const invItemOther = 4
|
||||
|
||||
// 类型(管理粒度)第三值:3=其他(辅料/工装/试验设备),与结构件(1)/电气件(2) 同级。
|
||||
// 类型(分类)第三值:3=其他(辅料/工装/试验设备),与结构件(1)/电气件(2) 同级。
|
||||
// 客户裁决(2026-09-21):结构件/电气件/其他 同属「类型」维度,独立于「品类」,编号 1/2/3。
|
||||
// 2026-09-30 解耦:类型仅用于分类统计/筛选/页签归属,SN 行为改读 sn_mode。
|
||||
const invManageOther = 3
|
||||
|
||||
// sn_mode(2026-09-30 类型与SN行为解耦定稿):决定入库/出库/库存的记账方式。
|
||||
// 0=未选择(物料档案必选后才能出入库) 1=序列号件(逐件SN) 2=批次件(数量,不录SN)
|
||||
const (
|
||||
snModeUnset = 0
|
||||
snModeSN = 1
|
||||
snModeBatch = 2
|
||||
)
|
||||
|
||||
// nextDailyNo 生成日期+流水号,格式:IB/OB + YYYYMMDD + -NNN(如 IB20260921-001)。
|
||||
// 同一天内流水号递增,跨天重置为 001。并发冲突时自动重试最多 5 次。
|
||||
// 注意:历史旧单号(IB+UUID 片段)不受影响,仅新生成的用新格式。
|
||||
@@ -142,8 +151,9 @@ func validateInboundQuality(ctx *svc.ServiceContext, materialCode, batchNo strin
|
||||
}
|
||||
|
||||
// createInboundHandler 入库
|
||||
// 结构件: { inboundType, materialCode, batchNo, quantity, zoneCode, operator }
|
||||
// 电气件: { inboundType, materialCode, snList: [sn...], zoneCode, operator }
|
||||
// 批次件: { inboundType, materialCode, batchNo, quantity, zoneCode, operator }
|
||||
// 序列号件: { inboundType, materialCode, snList: [sn...], zoneCode, operator }
|
||||
// 记账方式按物料档案 sn_mode 分叉(2026-09-30 与类型 manage_mode 解耦)。
|
||||
//
|
||||
// 事务保证:入库单 + 库存行(inventory) + 入库明细 三者要么全成功,要么全回滚,杜绝半成品状态。
|
||||
func createInboundHandler(ctx *svc.ServiceContext) http.HandlerFunc {
|
||||
@@ -151,6 +161,7 @@ func createInboundHandler(ctx *svc.ServiceContext) http.HandlerFunc {
|
||||
var req struct {
|
||||
InboundNo string `json:"inboundNo"` // 可选:留空自动生成;填了必须唯一(如 IB20260921-001)
|
||||
InboundType string `json:"inboundType"` // purchase/semi/finished/return/other
|
||||
ManageMode int `json:"manageMode"` // 页签类型:1结构件/2电气件/3其他(防呆校验用,0=未传不校验)
|
||||
MaterialCode string `json:"materialCode"`
|
||||
BatchNo string `json:"batchNo"`
|
||||
Quantity int `json:"quantity"`
|
||||
@@ -194,6 +205,15 @@ func createInboundHandler(ctx *svc.ServiceContext) http.HandlerFunc {
|
||||
return
|
||||
}
|
||||
|
||||
// 类型防呆(2026-09-30):页签传了 manageMode(1结构件/2电气件/3其他)且物料已建档时,
|
||||
// 页签与档案类型不一致直接拒绝,防止把电气件错录到结构件页签(反之亦然)。
|
||||
// 未传 manageMode(0,兼容旧调用方/批量导入)不拦截;入库快照与页签取值此时天然一致。
|
||||
if req.ManageMode != 0 && req.ManageMode != m.ManageMode {
|
||||
fail(w, http.StatusConflict, fmt.Sprintf("物料 %s 档案类型为「%s」,与当前入库页签「%s」不符,请确认页签或先修正物料档案",
|
||||
req.MaterialCode, manageModeLabel(m.ManageMode), manageModeLabel(req.ManageMode)))
|
||||
return
|
||||
}
|
||||
|
||||
// 其他类物料(类型 manage_mode=3:辅料/工装/试验设备):规格强制必填(客户诉求 问题记录 L50)
|
||||
if m.ManageMode == invManageOther {
|
||||
if strings.TrimSpace(m.Spec) == "" {
|
||||
@@ -203,6 +223,12 @@ func createInboundHandler(ctx *svc.ServiceContext) http.HandlerFunc {
|
||||
req.InboundType = "other"
|
||||
}
|
||||
|
||||
// sn_mode 守卫(2026-09-30 解耦定稿):物料档案未选择序列号件/批次件,禁止入库
|
||||
if m.SnMode == snModeUnset {
|
||||
fail(w, http.StatusBadRequest, "请先在物料档案选择序列号件")
|
||||
return
|
||||
}
|
||||
|
||||
// 质量门禁(P0-2):已被判定不合格的批次/SN 禁止再入库——
|
||||
// 客户诉求 L135「不合格不入库、不上产线,仅合格品计入库存数量」。
|
||||
if qerr := validateInboundQuality(ctx, req.MaterialCode, req.BatchNo, req.SnList); qerr != nil {
|
||||
@@ -259,6 +285,7 @@ func createInboundHandler(ctx *svc.ServiceContext) http.HandlerFunc {
|
||||
SetMaterialCode(req.MaterialCode).
|
||||
SetNillableMaterialName(strPtr(m.Name)).
|
||||
SetManageMode(m.ManageMode).
|
||||
SetSnMode(m.SnMode).
|
||||
SetNillableZoneCode(strPtr(req.ZoneCode)).
|
||||
SetNillableShelfNo(strPtr(req.ShelfNo)).
|
||||
SetNillableLayerNo(strPtr(req.LayerNo)).
|
||||
@@ -279,11 +306,11 @@ func createInboundHandler(ctx *svc.ServiceContext) http.HandlerFunc {
|
||||
|
||||
totalQty := 0
|
||||
|
||||
// 结构件(批次管理)+ 其他(辅料/工装/试验设备,同为数量/批次管理)
|
||||
if m.ManageMode == 1 || m.ManageMode == invManageOther {
|
||||
// 结构件走批次入库,不允许携带 SN 清单
|
||||
// 批次件(sn_mode=2,按数量记账;类型可以是结构件/电气件/其他任意一种)
|
||||
if m.SnMode == snModeBatch {
|
||||
// 批次件按数量入库,不允许携带 SN 清单
|
||||
if len(req.SnList) > 0 {
|
||||
fail(w, http.StatusBadRequest, "该物料为结构件(按批次管理),不应提交 SN 清单,请使用『结构件入库』")
|
||||
fail(w, http.StatusBadRequest, "该物料为批次件(按数量管理),不应提交 SN 清单,请使用『批次件入库』")
|
||||
return
|
||||
}
|
||||
batchNo := req.BatchNo
|
||||
@@ -303,7 +330,7 @@ func createInboundHandler(ctx *svc.ServiceContext) http.HandlerFunc {
|
||||
|
||||
// 同批次追加(多批到货追加)
|
||||
existing, e := tx.Inventory.Query().
|
||||
Where(inventory.ManageModeEQ(1), inventory.BatchNoEQ(batchNo)).Only(ctx0())
|
||||
Where(inventory.SnModeEQ(snModeBatch), inventory.BatchNoEQ(batchNo)).Only(ctx0())
|
||||
if e == nil {
|
||||
// 盘点冻结守卫(问题2):盘点期间库存量冻结,禁止向已锁定批次追加入库。
|
||||
if existing.StocktakeNo != "" {
|
||||
@@ -320,7 +347,8 @@ func createInboundHandler(ctx *svc.ServiceContext) http.HandlerFunc {
|
||||
}
|
||||
} else {
|
||||
if _, err = tx.Inventory.Create().
|
||||
SetManageMode(1).
|
||||
SetManageMode(m.ManageMode).
|
||||
SetSnMode(m.SnMode).
|
||||
SetMaterialCode(req.MaterialCode).
|
||||
SetNillableMaterialName(strPtr(m.Name)).
|
||||
SetBatchNo(batchNo).
|
||||
@@ -354,10 +382,10 @@ func createInboundHandler(ctx *svc.ServiceContext) http.HandlerFunc {
|
||||
totalQty = qty
|
||||
}
|
||||
|
||||
// 电气件(SN 管理)
|
||||
if m.ManageMode == 2 {
|
||||
// 序列号件(sn_mode=1,逐件录 SN)
|
||||
if m.SnMode == snModeSN {
|
||||
if len(req.SnList) == 0 {
|
||||
fail(w, http.StatusBadRequest, "该物料为电气件(按 SN 管理),请至少录入 1 条序列号(SN)")
|
||||
fail(w, http.StatusBadRequest, "该物料为序列号件(逐件SN管理),请至少录入 1 条序列号(SN)")
|
||||
return
|
||||
}
|
||||
for _, sn := range req.SnList {
|
||||
@@ -371,7 +399,8 @@ func createInboundHandler(ctx *svc.ServiceContext) http.HandlerFunc {
|
||||
return
|
||||
}
|
||||
if _, err = tx.Inventory.Create().
|
||||
SetManageMode(2).
|
||||
SetManageMode(m.ManageMode).
|
||||
SetSnMode(m.SnMode).
|
||||
SetMaterialCode(req.MaterialCode).
|
||||
SetNillableMaterialName(strPtr(m.Name)).
|
||||
SetSnCode(sn).
|
||||
@@ -633,7 +662,7 @@ func genBatchNo(ctx *svc.ServiceContext, materialCode string) string {
|
||||
// 查当日该物料已有批次中最大流水号
|
||||
maxSeq := 0
|
||||
rows, err := ctx.EntClient.Inventory.Query().
|
||||
Where(inventory.ManageModeEQ(1), inventory.BatchNoHasPrefix(prefix)).
|
||||
Where(inventory.SnModeEQ(snModeBatch), inventory.BatchNoHasPrefix(prefix)).
|
||||
All(ctx0())
|
||||
if err == nil {
|
||||
for _, r := range rows {
|
||||
|
||||
Reference in New Issue
Block a user