package logic import ( "context" "errors" "log" "time" "bj_power_mes/ent" "bj_power_mes/ent/material" "bj_power_mes/internal/wmsclient" ) // 物料两库对等双向同步(需求一 M1-M8,2026-09-29 定稿): // · MES 本地 materials 表 = 与 WMS materials 对等的副本,code(图号)为两库同步唯一业务键, // 两库均不物理删除(只停用,M5); // · MES 侧写入(M3):先落本地,再推 WMS /api/internal/materials/upsert,推失败置 sync_pending // 待重推(不回滚本地);列表请求顺带异步重推 pending 行; // · WMS 侧写入(M2/M4):经内部接口按 code 幂等 upsert 到本地(本包 UpsertLocalMaterial), // 只落本地、不回推 WMS(防同步环); // · 本地为空(冷启动)异步从 WMS 全量拉取补齐(M7);失败静默记日志,不阻塞用户; // · 型号/物料查询全部读本地(M6):WMS 宕机时 MES 建单/排产/下拉照常可用; // · 备料"物料在 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"` Spec string `json:"spec"` Unit string `json:"unit"` Description string `json:"description"` ItemType int `json:"itemType"` 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 == "" { return false, errors.New("code(图号)为必填项") } active := true if req.IsActive != nil { active = *req.IsActive } existing, err := s.ctx.EntClient.Material.Query().Where(material.CodeEQ(req.Code)).Only(ctx) if err == nil { // 物料类别防落 0:显式合法值(1原材料/3成品)才覆盖,否则保留本地值(与 snMode 禁止落 0 同款口径)。 // 「其他」类别已按 2026-10-19 裁决全项目移除(WMS 端不再产出 4,合法值收缩为 1/3)。 itemType := existing.ItemType if req.ItemType == 1 || req.ItemType == 3 { itemType = req.ItemType } // sn_mode 属行为字段:成品(item_type=3)序列号强制「是」(2026-10-19 拍板); // 其余显式 1/2 采纳,未传(0)保留本地值,禁止落 0。 snMode := existing.SnMode if itemType == 3 { snMode = 1 } else if req.SnMode == 1 || req.SnMode == 2 { snMode = req.SnMode } _, err = s.ctx.EntClient.Material.UpdateOneID(existing.ID). SetName(req.Name). SetSpec(req.Spec). SetUnit(req.Unit). SetDescription(req.Description). SetItemType(itemType). SetManageMode(req.ManageMode). SetSnMode(snMode). SetTemplateCode(req.TemplateCode). SetSafetyStock(req.SafetyStock). SetIsActive(active). SetSyncPending(false). Save(ctx) return false, err } if !ent.IsNotFound(err) { return false, err } // 新建:成品(item_type=3)序列号强制「是」(2026-10-19 拍板) newItemType := resolveItemType(req.ItemType) newSn := resolveSnMode(req.SnMode, req.ManageMode) if newItemType == 3 { newSn = 1 } _, err = s.ctx.EntClient.Material.Create(). SetCode(req.Code). SetName(req.Name). SetSpec(req.Spec). SetUnit(req.Unit). SetDescription(req.Description). SetItemType(newItemType). SetManageMode(req.ManageMode). SetSnMode(newSn). SetTemplateCode(req.TemplateCode). SetSafetyStock(req.SafetyStock). SetIsActive(active). SetSyncPending(false). Save(ctx) return err == nil, err } // resolveItemType 物料类别兜底:MES 物料档案=WMS 成品物料视图,来源未带合法类别(1原材料/3成品) // 时兜底 3 成品,避免落 0/1 导致列表误显示「原材料」(问题.md 待办3,2026-10-12)。 // 「其他」类别已按 2026-10-19 裁决全项目移除,合法值收缩为 1/3。 func resolveItemType(v int) int { if v == 1 || v == 3 { return v } return 3 } // materialUpsertOf 本地物料行 → 推 WMS 载荷。 func materialUpsertOf(m *ent.Material) wmsclient.MaterialUpsert { active := m.IsActive return wmsclient.MaterialUpsert{ Code: m.Code, Name: m.Name, Spec: m.Spec, Unit: m.Unit, Description: m.Description, ItemType: m.ItemType, ManageMode: m.ManageMode, SnMode: m.SnMode, TemplateCode: m.TemplateCode, SafetyStock: m.SafetyStock, IsActive: &active, } } // pushMaterialToWMS 推单行到 WMS(同步调用):成功清 sync_pending,失败置位并记入事件日志(不再自动重推,改为页面手动推送)。 func (s *Service) pushMaterialToWMS(ctx context.Context, m *ent.Material) error { if err := s.ctx.Wms.UpsertMaterialToWMS(ctx, materialUpsertOf(m)); err != nil { _ = s.ctx.EntClient.Material.UpdateOneID(m.ID).SetSyncPending(true).Exec(ctx) payload := map[string]any{"code": m.Code, "error": err.Error()} s.ctx.EventLog.Write(ctx, "material.sync.failed", "", "", "material", m.Code, "推送物料到 WMS 失败", payload) return err } _ = s.ctx.EntClient.Material.UpdateOneID(m.ID).SetSyncPending(false).Exec(ctx) return nil } // RetryPendingMaterialPushes 重推全部 sync_pending 行(M3),返回重推成功的行数。 func (s *Service) RetryPendingMaterialPushes(ctx context.Context) int { pending, err := s.ctx.EntClient.Material.Query().Where(material.SyncPendingEQ(true)).All(ctx) if err != nil { return 0 } okCnt := 0 for i := range pending { c, cancel := context.WithTimeout(ctx, 5*time.Second) if s.pushMaterialToWMS(c, pending[i]) == nil { okCnt++ } cancel() } return okCnt } // RetryPendingMaterialPushesAsync 异步重推(保留供管理员「重推全部」使用;列表请求不再自动触发)。 func (s *Service) RetryPendingMaterialPushesAsync() { go func() { ctx, cancel := context.WithTimeout(context.Background(), 30*time.Second) defer cancel() if n := s.RetryPendingMaterialPushes(ctx); n > 0 { log.Printf("[material-sync] 重推 WMS 成功 %d 行", n) } }() } // RetryProductTypeSync 手动重推单行物料到 WMS(页面「手动推送」按钮触发,替代原列表自动重推)。 func (s *Service) RetryProductTypeSync(ctx context.Context, id int) error { m, err := s.ctx.EntClient.Material.Get(ctx, id) if err != nil { return err } return s.pushMaterialToWMS(ctx, m) } // PullMaterialsFromWMSAsync 从 WMS 全量分页拉取物料 upsert 到本地(M7 冷启动补齐)。 // 仅在本地为空时调用——若本地已有 pending 行,说明本地存在未推 WMS 的改动,禁止被 WMS 旧值覆盖。 // 失败静默记日志,不阻塞用户。 func (s *Service) PullMaterialsFromWMSAsync() { go func() { ctx, cancel := context.WithTimeout(context.Background(), 60*time.Second) defer cancel() total := 0 for page := 1; page <= 100; page++ { _, rows, err := s.ctx.Wms.MaterialPage(ctx, "", "", "", 0, 0, page, 200) if err != nil { log.Printf("[material-sync] 拉取 WMS 物料失败(第 %d 页): %v", page, err) return } for _, r := range rows { 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, SnMode: r.SnMode, TemplateCode: r.TemplateCode, SafetyStock: r.SafetyStock, IsActive: &active, }); err != nil { log.Printf("[material-sync] 物料 %s 落库失败: %v", r.Code, err) continue } total++ } if len(rows) < 200 { break } } log.Printf("[material-sync] 自 WMS 全量同步物料 %d 行", total) }() } // EnsureMaterialCacheAsync 列表请求顺带的缓存维护(M7):本地为空才异步全量拉取补齐。 // 不再自动重推 sync_pending 行(改为页面「手动推送」按钮触发),避免静默重试掩盖同步故障。 func (s *Service) EnsureMaterialCacheAsync() { go func() { ctx, cancel := context.WithTimeout(context.Background(), 10*time.Second) n, err := s.ctx.EntClient.Material.Query().Count(ctx) cancel() if err == nil && n == 0 { s.PullMaterialsFromWMSAsync() } }() }