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
+43 -14
View File
@@ -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 {