Files
bj_power/bj_power_mes/internal/logic/materialsync.go
T
SunYF af554cea75 feat: 同步失败台账双向可重试 + 拧紧枪按工位配置 + 虚拟工位体系 + 去Redis与文档口径对齐
- 同步失败台账:MES/WMS 双端新增台账与页面,跨系统通知失败落台账、人工重试或标记已处理,不自动重传;重试前先判对端终态;叫料、配送、出库回写失败提示指向台账;补幂等建表脚本与菜单权限。
- 拧紧枪:新增按工位配置页,展示控制器地址与三把枪通道号(仅供查看,不参与采集校验);「允许手填」由全局开关改为每工位开关,关闭时校验该工位已配控制器;终端启动/登录上报配置并按本工位拉取,扭矩手填框按本工位置灰;补全局值迁移到各工位的脚本。
- 工位体系:终端未配置工位号时登录页可选(含虚拟工位),固定工位模式保留;虚拟/线下位不叫料、不退料、不作转产目标,未采集绑定放行并说明原因;叫料期望接驳台改为选填。
- AGV与出库:补「出库单已送达」回写;空车回充、接驳台传感器失联、配送状态更新失败均落预警或留痕并提示人工核对;人工出库不引入送达状态;出库单支持目标工位/接驳台并扩展导出列。
- 基础设施:看板缓存由Redis改为MES进程内实现,文档与启动脚本同步去Redis;扫码监听支持多地址、端口被占自动降级;PLC对账与工位报警在MES不可达时降级放行并留日志。
- 文档与帮助:案例与部署手册按实测订正(工位绑定、菜单名称、补料由班组长代提、菜单覆盖对照、虚拟工位);迁移脚本改为本地即时执行并登记7个已执行脚本;三端页面帮助改为「业务/操作/影响范围/后果」四要素。
- 测试:新增独立Go模块,按三个业务场景做真实HTTP与真实写库的流水测试,含运行报告。
2026-11-09 18:58:47 +08:00

270 lines
11 KiB
Go

package logic
import (
"context"
"errors"
"fmt"
"log"
"strings"
"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
failed := 0
var failedCodes []string
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)
// 启动期同步不是单据级回调:落预警中心 + 操作日志,不进同步失败台账(无可重放端点)
if aerr := s.CreateAlert(ctx, "material_sync_pull_failed", "警告", "物料档案",
"冷启动从 WMS 全量拉取物料失败:"+err.Error()+"(请人工确认两库物料一致)"); aerr != nil {
log.Printf("[material-sync] 落预警中心失败: %v", aerr)
}
s.ctx.EventLog.Write(ctx, "material.sync.pull_failed", "", "system", "material", "",
"冷启动从 WMS 全量拉取物料失败:"+err.Error(), nil)
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)
failed++
if len(failedCodes) < 20 {
failedCodes = append(failedCodes, r.Code)
}
continue
}
total++
}
if len(rows) < 200 {
break
}
}
log.Printf("[material-sync] 自 WMS 全量同步物料 %d 行", total)
// 2026-11-09 缺陷修复:单行落库失败此前只打日志无 DB 留痕,冷启动后两库不一致无人察觉。
// 汇总一条操作日志 + 预警中心(启动期同步非单据级回调,无可重放端点,不进同步失败台账)。
if failed > 0 {
detail := fmt.Sprintf("冷启动从 WMS 拉取物料:共 %d 行落库失败(%s%s),请人工核对两库物料一致",
failed, strings.Join(failedCodes, ","), map[bool]string{true: " 等", false: ""}[len(failedCodes) == 20])
if aerr := s.CreateAlert(ctx, "material_sync_pull_failed", "警告", "物料档案", detail); aerr != nil {
log.Printf("[material-sync] 落预警中心失败: %v", aerr)
}
s.ctx.EventLog.Write(ctx, "material.sync.row_failed", "", "system", "material", "", detail, nil)
}
}()
}
// 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()
}
}()
}