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
+24 -2
View File
@@ -23,6 +23,8 @@ import (
// · 备料"物料在 WMS 档案存在"校验仍直查 WMS(M8)——备料要出库,库存真源在 WMS。
// MaterialUpsertReq 两库物料 upsert 载荷(WMS→MES 推送 / MES 拉 WMS 补齐共用),code 为同步唯一业务键。
// snMode 为「是否逐件SN管理」(1序列号件/2批次件/0未选择):显式传 1/2 以传入值为准;
// 缺省 0 时新建按类型联动默认(电气件→1,其余→2),更新保留本地已选值(该字段不允许被同步冲成 0)。
type MaterialUpsertReq struct {
Code string `json:"code"`
Name string `json:"name"`
@@ -30,14 +32,27 @@ type MaterialUpsertReq struct {
Unit string `json:"unit"`
Description string `json:"description"`
ItemType int `json:"itemType"`
ManageMode int `json:"manageMode"`
ManageMode int `json:"manageMode"` // 类型 1结构件/2电气件/3其他
SnMode int `json:"snMode"`
TemplateCode string `json:"templateCode"`
SafetyStock int `json:"safetyStock"`
IsActive *bool `json:"isActive"`
}
// resolveSnMode 归一化 sn_mode:显式 1/2 直接生效;0(未选择)按类型联动默认(电气件→1,其余→2)。
func resolveSnMode(snMode, manageMode int) int {
if snMode == 1 || snMode == 2 {
return snMode
}
if manageMode == 2 {
return 1
}
return 2
}
// UpsertLocalMaterial 按 code 幂等 upsert MES 本地物料副本。
// WMS→MES 推送落点(M2):WMS 是该行内容的写入方,落库成功即视为两库一致,清 sync_pending。
// sn_mode 属行为字段:显式 1/2 采纳,否则新建按类型联动默认、更新保留本地值(禁止落 0)。
// 返回 true=新建 / false=更新;code 为必填业务键,不可通过本接口修改。
func (s *Service) UpsertLocalMaterial(ctx context.Context, req MaterialUpsertReq) (bool, error) {
if req.Code == "" {
@@ -49,6 +64,10 @@ func (s *Service) UpsertLocalMaterial(ctx context.Context, req MaterialUpsertReq
}
existing, err := s.ctx.EntClient.Material.Query().Where(material.CodeEQ(req.Code)).Only(ctx)
if err == nil {
snMode := existing.SnMode
if req.SnMode == 1 || req.SnMode == 2 {
snMode = req.SnMode
}
_, err = s.ctx.EntClient.Material.UpdateOneID(existing.ID).
SetName(req.Name).
SetSpec(req.Spec).
@@ -56,6 +75,7 @@ func (s *Service) UpsertLocalMaterial(ctx context.Context, req MaterialUpsertReq
SetDescription(req.Description).
SetItemType(req.ItemType).
SetManageMode(req.ManageMode).
SetSnMode(snMode).
SetTemplateCode(req.TemplateCode).
SetSafetyStock(req.SafetyStock).
SetIsActive(active).
@@ -74,6 +94,7 @@ func (s *Service) UpsertLocalMaterial(ctx context.Context, req MaterialUpsertReq
SetDescription(req.Description).
SetItemType(req.ItemType).
SetManageMode(req.ManageMode).
SetSnMode(resolveSnMode(req.SnMode, req.ManageMode)).
SetTemplateCode(req.TemplateCode).
SetSafetyStock(req.SafetyStock).
SetIsActive(active).
@@ -93,6 +114,7 @@ func materialUpsertOf(m *ent.Material) wmsclient.MaterialUpsert {
Description: m.Description,
ItemType: m.ItemType,
ManageMode: m.ManageMode,
SnMode: m.SnMode,
TemplateCode: m.TemplateCode,
SafetyStock: m.SafetyStock,
IsActive: &active,
@@ -155,7 +177,7 @@ func (s *Service) PullMaterialsFromWMSAsync() {
active := r.IsActive
if _, err := s.UpsertLocalMaterial(ctx, MaterialUpsertReq{
Code: r.Code, Name: r.Name, Spec: r.Spec, Unit: r.Unit, Description: r.Description,
ItemType: r.ItemType, ManageMode: r.ManageMode, TemplateCode: r.TemplateCode,
ItemType: r.ItemType, ManageMode: r.ManageMode, SnMode: r.SnMode, TemplateCode: r.TemplateCode,
SafetyStock: r.SafetyStock, IsActive: &active,
}); err != nil {
log.Printf("[material-sync] 物料 %s 落库失败: %v", r.Code, err)