Files
bj_power/bj_power_mes/internal/logic/materialsync.go
T
SunYF c33acab9c8 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. 修正前端提示文本,统一使用序列号件/批次件表述,与后端逻辑对齐
2026-09-30 17:33:11 +08:00

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()
}