本次重构将原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. 修正前端提示文本,统一使用序列号件/批次件表述,与后端逻辑对齐
209 lines
7.5 KiB
Go
209 lines
7.5 KiB
Go
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 {
|
|
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).
|
|
SetUnit(req.Unit).
|
|
SetDescription(req.Description).
|
|
SetItemType(req.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
|
|
}
|
|
_, err = s.ctx.EntClient.Material.Create().
|
|
SetCode(req.Code).
|
|
SetName(req.Name).
|
|
SetSpec(req.Spec).
|
|
SetUnit(req.Unit).
|
|
SetDescription(req.Description).
|
|
SetItemType(req.ItemType).
|
|
SetManageMode(req.ManageMode).
|
|
SetSnMode(resolveSnMode(req.SnMode, req.ManageMode)).
|
|
SetTemplateCode(req.TemplateCode).
|
|
SetSafetyStock(req.SafetyStock).
|
|
SetIsActive(active).
|
|
SetSyncPending(false).
|
|
Save(ctx)
|
|
return err == nil, err
|
|
}
|
|
|
|
// 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,失败置位等待重推(不 panic)。
|
|
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)
|
|
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)
|
|
}
|
|
}()
|
|
}
|
|
|
|
// 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 列表请求顺带的缓存维护(M3/M7):本地为空才异步全量拉取;重推 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()
|
|
}
|
|
}()
|
|
s.RetryPendingMaterialPushesAsync()
|
|
}
|