package logic import ( "context" "errors" "fmt" "net" "os" "runtime" "strconv" "strings" "time" "bj_power_mes/ent/sysconfig" "bj_power_mes/internal/wmsclient" ) // 系统基础设置配置键(sys_config 表,系统管理员「基础设置」页维护,保存即生效) const ( // CfgWmsBaseURL WMS 地址(IP:端口),保存即热切换 wmsclient;空=用 YAML 配置/默认地址 CfgWmsBaseURL = "wms.base_url" // CfgDemandDays 需求窗口天数:缺料补货/未来需求按日排产取未来 N 天(默认 5) CfgDemandDays = "demand.days" // CfgExtrapWindow 排产支撑外推均值窗口(近 N 天平均日需求,默认 3) CfgExtrapWindow = "producible.extrap.window" // CfgExtrapCap 排产支撑外推封顶天数(防死循环,默认 365) CfgExtrapCap = "producible.extrap.cap" // CfgLogRetention 事件日志保留天数,超过自动清理(0=不清理) CfgLogRetention = "eventlog.retention.days" // CfgPipelineCache 滚筒线缓存模式(1=启用缓存位并行流转,0=串行不缓存);预留配置,PLC 真机接入时生效 CfgPipelineCache = "pipeline_cache" // CfgAllowCrossDay 允许叫非今日排产的料(B5 跨日:1=允许(默认,工位端预警提示),0=禁止) CfgAllowCrossDay = "call.allow_cross_day" // CfgAllowBorrow 允许跨工位借料(1=允许(默认);0=禁止,超额叫料直接拒绝) CfgAllowBorrow = "call.allow_borrow" // CfgTorqueNgAlert 拧紧不合格报警开关(B2.1):1=开启(默认,拧紧扭矩不合格立即落预警),0=关闭(只写 step_data + 置待处置标记,不落预警) CfgTorqueNgAlert = "torque.ng.alert.enabled" // CfgDashboardRefreshSeconds 看板大屏轮询兜底刷新间隔(秒,1~10):仅影响 SSE 实时通道不可用时的 HTTP 轮询周期(默认 5) CfgDashboardRefreshSeconds = "dashboard.refresh.seconds" // CfgDashboardTitle 门口看板(项目A)标题文字:空=默认「总装产线实时看板」(默认空);看板端每分钟拉取跟随 CfgDashboardTitle = "dashboard.board.title" // CfgDashboardVoice 门口看板语音播报开关:1=开启(默认,报警语音播报),0=关闭 CfgDashboardVoice = "dashboard.board.voice" // CfgArchiveRemindDays 数据归档提醒周期(天):距上次成功备份超过该天数时提醒清理(默认 7,0=关闭) CfgArchiveRemindDays = "archive.remind.days" // CfgArchiveProtectDays 数据保护期(天):仅允许删除该天数之前的数据(默认 180) CfgArchiveProtectDays = "archive.protect.days" // CfgAgvUnloadTimeoutMinutes AGV 卸货超时报警(分钟):任务已派发但未「卸货完成(状态9)」超过该时长 → 落预警;默认 5 CfgAgvUnloadTimeoutMinutes = "agv.unload.timeout.minutes" // CfgMultiOrderCachePolicy 多工单缓存策略:physical=物理优先(目标点位实际空闲即可放);strict=严格隔离(多工单物料禁共位);默认 physical CfgMultiOrderCachePolicy = "cache.multi.order.policy" // CfgTorqueManualInput 拧紧枪数据输入:forbid=禁止手填(必须真实采集,默认);allow=允许手填(离线/无枪时手工录扭矩) CfgTorqueManualInput = "torque.manual.input" ) // startedAt 服务启动时刻(本机信息展示用) var startedAt = time.Now() // SettingsVO 基础设置视图:可配置项 + 本机基础信息(只读展示) type SettingsVO struct { // 可配置项 WmsBaseURL string `json:"wmsBaseURL"` // WMS 地址(空=未自定义,走 YAML/默认) DemandDays int `json:"demandDays"` // 需求窗口天数 ExtrapWindow int `json:"extrapWindow"` // 外推均值窗口天数 ExtrapCap int `json:"extrapCap"` // 外推封顶天数 LogRetentionDays int `json:"logRetentionDays"` // 事件日志保留天数(0=不清理) PipelineCache int `json:"pipelineCache"` // 滚筒线缓存模式(1=缓存并行,0=串行;预留,PLC 真机接入时生效) AllowCrossDay int `json:"allowCrossDay"` // 允许叫非今日排产的料(1=允许(默认),0=禁止) AllowBorrow int `json:"allowBorrow"` // 允许跨工位借料(1=允许(默认),0=禁止;关闭后超额叫料直接拒绝) TorqueNgAlert bool `json:"torqueNgAlert"` // 拧紧不合格报警开关(1=开启,0=关闭) DashboardRefreshSeconds int `json:"dashboardRefreshSeconds"` // 看板轮询兜底刷新间隔(秒,1~10) ArchiveRemindDays int `json:"archiveRemindDays"` // 数据归档提醒周期(天,0=关闭) DashboardTitle string `json:"dashboardTitle"` // 门口看板标题文字(空=不显示) DashboardVoice bool `json:"dashboardVoice"` // 门口看板语音播报开关 AgvUnloadTimeoutMinutes int `json:"agvUnloadTimeoutMinutes"` // AGV 卸货超时报警(分钟,默认 5) MultiOrderCachePolicy string `json:"multiOrderCachePolicy"` // 多工单缓存策略:physical/strict TorqueManualInput string `json:"torqueManualInput"` // 拧紧枪数据输入:forbid/allow // 本机基础信息(只读) LocalIPs []string `json:"localIPs"` // 本机内网 IPv4 列表 ListenAddr string `json:"listenAddr"` // 服务监听地址 DBInfo string `json:"dbInfo"` // 数据库 host:port/db(不含密码) EffectiveWms string `json:"effectiveWms"` // 当前生效的 WMS 地址 GoVersion string `json:"goVersion"` // Go 运行时版本 StartedAt string `json:"startedAt"` // 服务启动时间 } // SettingsReq 基础设置保存请求(nil 字段不改,便于部分保存) type SettingsReq struct { WmsBaseURL *string `json:"wmsBaseURL"` DemandDays *int `json:"demandDays"` ExtrapWindow *int `json:"extrapWindow"` ExtrapCap *int `json:"extrapCap"` LogRetentionDays *int `json:"logRetentionDays"` PipelineCache *int `json:"pipelineCache"` AllowCrossDay *int `json:"allowCrossDay"` AllowBorrow *int `json:"allowBorrow"` TorqueNgAlert *bool `json:"torqueNgAlert"` // B2.1 拧紧不合格报警开关(nil=不改) DashboardRefreshSeconds *int `json:"dashboardRefreshSeconds"` // 看板轮询兜底刷新间隔(秒,nil=不改) ArchiveRemindDays *int `json:"archiveRemindDays"` // 数据归档提醒周期(天,nil=不改) DashboardTitle *string `json:"dashboardTitle"` // 门口看板标题文字(nil=不改) DashboardVoice *bool `json:"dashboardVoice"` // 门口看板语音播报开关(nil=不改) AgvUnloadTimeoutMinutes *int `json:"agvUnloadTimeoutMinutes"` // AGV 卸货超时报警(分钟,nil=不改) MultiOrderCachePolicy *string `json:"multiOrderCachePolicy"` // 多工单缓存策略(nil=不改) TorqueManualInput *string `json:"torqueManualInput"` // 拧紧枪数据输入(nil=不改) } // defaults 建议默认值(未配置时生效) var settingsDefaults = map[string]int{ CfgDemandDays: 5, CfgExtrapWindow: 3, CfgExtrapCap: 365, CfgLogRetention: 0, CfgPipelineCache: 0, CfgAllowCrossDay: 1, CfgAllowBorrow: 1, CfgTorqueNgAlert: 1, // B2.1 默认开启拧紧不合格报警 CfgDashboardRefreshSeconds: 5, // 看板轮询兜底刷新间隔(秒) CfgArchiveRemindDays: 7, // 数据归档提醒周期(天) CfgArchiveProtectDays: 180, // 数据保护期(天) CfgAgvUnloadTimeoutMinutes: 5, // AGV 卸货超时报警(分钟) } // GetSettings 读取基础设置 + 本机信息。DB 读失败时按默认值返回(设置页必须能打开)。 func (s *Service) GetSettings(ctx context.Context) (*SettingsVO, error) { kv := map[string]string{} if rows, err := s.ctx.EntClient.SysConfig.Query().All(ctx); err == nil { for _, r := range rows { kv[r.Key] = r.Value } } vo := &SettingsVO{ WmsBaseURL: kv[CfgWmsBaseURL], DemandDays: cfgIntFrom(kv, CfgDemandDays), ExtrapWindow: cfgIntFrom(kv, CfgExtrapWindow), ExtrapCap: cfgIntFrom(kv, CfgExtrapCap), LogRetentionDays: cfgIntFrom(kv, CfgLogRetention), PipelineCache: cfgIntFrom(kv, CfgPipelineCache), AllowCrossDay: cfgIntFrom(kv, CfgAllowCrossDay), AllowBorrow: cfgIntFrom(kv, CfgAllowBorrow), TorqueNgAlert: s.CfgInt(ctx, CfgTorqueNgAlert, 1) == 1, // B2.1 默认开启 DashboardRefreshSeconds: cfgIntFrom(kv, CfgDashboardRefreshSeconds), ArchiveRemindDays: cfgIntFrom(kv, CfgArchiveRemindDays), DashboardTitle: kv[CfgDashboardTitle], DashboardVoice: s.CfgInt(ctx, CfgDashboardVoice, 1) == 1, AgvUnloadTimeoutMinutes: cfgIntFrom(kv, CfgAgvUnloadTimeoutMinutes), MultiOrderCachePolicy: cfgStrFrom(kv, CfgMultiOrderCachePolicy, "physical"), TorqueManualInput: cfgStrFrom(kv, CfgTorqueManualInput, "forbid"), LocalIPs: localIPv4s(), ListenAddr: fmt.Sprintf("%s:%d", s.ctx.Config.Host, s.ctx.Config.Port), DBInfo: fmt.Sprintf("%s:%d/%s", s.ctx.Config.Database.Host, s.ctx.Config.Database.Port, s.ctx.Config.Database.Dbname), EffectiveWms: strings.TrimSuffix(s.ctx.Wms.BaseURL(), "/"), GoVersion: runtime.Version(), StartedAt: startedAt.Format("2006-01-02 15:04:05"), } return vo, nil } // SaveSettings 保存基础设置(幂等 upsert,nil 字段不改);WMS 地址变化即热切换。 func (s *Service) SaveSettings(ctx context.Context, req SettingsReq, operator string) error { // 校验 if req.WmsBaseURL != nil { u := strings.TrimSpace(*req.WmsBaseURL) if u != "" && !strings.HasPrefix(u, "http://") && !strings.HasPrefix(u, "https://") { return errors.New("WMS 地址需以 http:// 或 https:// 开头,如 http://192.168.1.100:9091") } } type item struct { key string val *int lo int hi int remark string } items := []item{ {CfgDemandDays, req.DemandDays, 1, 60, "需求窗口天数(缺料补货/未来需求)"}, {CfgExtrapWindow, req.ExtrapWindow, 1, 30, "排产支撑外推均值窗口天数"}, {CfgExtrapCap, req.ExtrapCap, 30, 3650, "排产支撑外推封顶天数"}, {CfgLogRetention, req.LogRetentionDays, 0, 3650, "事件日志保留天数(0=不清理)"}, {CfgPipelineCache, req.PipelineCache, 0, 1, "滚筒线缓存模式(1=启用缓存位并行流转,0=串行不缓存);预留配置,PLC 真机接入时生效"}, {CfgAllowCrossDay, req.AllowCrossDay, 0, 1, "允许叫非今日排产的料(1=允许,工位端预警提示;0=禁止)"}, {CfgAllowBorrow, req.AllowBorrow, 0, 1, "允许跨工位借料(1=允许(默认),工位端手动分配借料来源;0=禁止,超额叫料直接拒绝)"}, {CfgDashboardRefreshSeconds, req.DashboardRefreshSeconds, 1, 10, "看板轮询兜底刷新间隔(秒,1~10,仅 SSE 不可用时的 HTTP 轮询周期)"}, {CfgArchiveRemindDays, req.ArchiveRemindDays, 0, 365, "数据归档提醒周期(天,0=关闭;距上次成功备份超过该天数时提醒)"}, {CfgAgvUnloadTimeoutMinutes, req.AgvUnloadTimeoutMinutes, 1, 1440, "AGV 卸货超时报警(分钟,1~1440;任务派发后超过该时长未卸货完成则落预警)"}, } for _, it := range items { if it.val == nil { continue } if *it.val < it.lo || *it.val > it.hi { return fmt.Errorf("%s 取值范围 %d~%d", it.remark, it.lo, it.hi) } if err := s.upsertConfig(ctx, it.key, strconv.Itoa(*it.val), it.remark); err != nil { return err } } if req.TorqueNgAlert != nil { v := 0 if *req.TorqueNgAlert { v = 1 } if err := s.upsertConfig(ctx, CfgTorqueNgAlert, strconv.Itoa(v), "拧紧不合格报警开关(1=开启,0=关闭)"); err != nil { return err } } if req.DashboardTitle != nil { t := strings.TrimSpace(*req.DashboardTitle) if len(t) > 30 { return errors.New("门口看板标题需 0~30 字(空=不显示标题)") } if err := s.upsertConfig(ctx, CfgDashboardTitle, t, "门口看板标题文字(空=不显示)"); err != nil { return err } } if req.DashboardVoice != nil { v := 0 if *req.DashboardVoice { v = 1 } if err := s.upsertConfig(ctx, CfgDashboardVoice, strconv.Itoa(v), "门口看板语音播报开关(1=开启,0=关闭)"); err != nil { return err } } if req.WmsBaseURL != nil { u := strings.TrimSpace(*req.WmsBaseURL) if err := s.upsertConfig(ctx, CfgWmsBaseURL, u, "WMS 服务地址(保存即生效)"); err != nil { return err } // 热切换:保存即生效,无需重启 s.ctx.Wms.SetBaseURL(u) } if req.MultiOrderCachePolicy != nil { p := strings.TrimSpace(*req.MultiOrderCachePolicy) if p != "physical" && p != "strict" { return errors.New("多工单缓存策略仅支持 physical(物理优先)或 strict(严格隔离)") } if err := s.upsertConfig(ctx, CfgMultiOrderCachePolicy, p, "多工单缓存策略(physical=物理优先:目标点位实际空闲即可放;strict=严格隔离:多工单物料禁共位)"); err != nil { return err } } if req.TorqueManualInput != nil { t := strings.TrimSpace(*req.TorqueManualInput) if t != "allow" && t != "forbid" { return errors.New("拧紧枪数据输入仅支持 forbid(禁止手填)或 allow(允许手填)") } if err := s.upsertConfig(ctx, CfgTorqueManualInput, t, "拧紧枪数据输入(forbid=禁止手填,必须真实采集;allow=允许手填,离线/无枪时手工录扭矩)"); err != nil { return err } } payload := map[string]any{"req": req} s.ctx.EventLog.Write(ctx, "sys.settings.save", "", operator, "sys_config", "", "保存基础设置", payload) return nil } // TestWms 测试 WMS 连通性:调免登录看板总览接口,返回耗时/错误。 // candidate 非空时测试该地址(保存前试测用),为空测当前生效地址。 func (s *Service) TestWms(ctx context.Context, candidate string) (string, error) { client := s.ctx.Wms if u := strings.TrimSpace(candidate); u != "" { if !strings.HasPrefix(u, "http://") && !strings.HasPrefix(u, "https://") { return "", errors.New("WMS 地址需以 http:// 或 https:// 开头") } client = wmsclient.New(u, s.ctx.Config.Wms.Token) } c2, cancel := context.WithTimeout(ctx, 5*time.Second) defer cancel() start := time.Now() if _, err := client.DisplayOverview(c2); err != nil { return "", fmt.Errorf("连接失败: %v", err) } return fmt.Sprintf("连接成功(%d ms)", time.Since(start).Milliseconds()), nil } // CfgInt 读取整型配置(未配置/非法值回退 def)。供业务模块读取可配置参数。 func (s *Service) CfgInt(ctx context.Context, key string, def int) int { v, err := s.ctx.EntClient.SysConfig.Query().Where(sysconfig.Key(key)).Only(ctx) if err != nil || v == nil { return def } n, err := strconv.Atoi(strings.TrimSpace(v.Value)) if err != nil { return def } return n } // CfgStr 读取字符串配置(未配置回退 def)。供业务模块读取枚举型配置(如缓存策略/拧紧开关)。 func (s *Service) CfgStr(ctx context.Context, key, def string) string { v, err := s.ctx.EntClient.SysConfig.Query().Where(sysconfig.Key(key)).Only(ctx) if err != nil || v == nil { return def } return strings.TrimSpace(v.Value) } // upsertConfig 幂等写入配置 func (s *Service) upsertConfig(ctx context.Context, key, value, remark string) error { exist, err := s.ctx.EntClient.SysConfig.Query().Where(sysconfig.Key(key)).Only(ctx) if err == nil && exist != nil { return exist.Update().SetValue(value).SetRemark(remark).Exec(ctx) } return s.ctx.EntClient.SysConfig.Create().SetKey(key).SetValue(value).SetRemark(remark).Exec(ctx) } // cfgIntFrom 从已加载的 kv map 解析整型(非法/未配置回退默认值) func cfgIntFrom(kv map[string]string, key string) int { v, ok := kv[key] if !ok || strings.TrimSpace(v) == "" { return settingsDefaults[key] } n, err := strconv.Atoi(strings.TrimSpace(v)) if err != nil { return settingsDefaults[key] } return n } // cfgStrFrom 从已加载的 kv map 解析字符串配置(空回退 def) func cfgStrFrom(kv map[string]string, key, def string) string { v, ok := kv[key] if !ok || strings.TrimSpace(v) == "" { return def } return strings.TrimSpace(v) } // localIPv4s 枚举本机非环回 IPv4(内网 IP 展示) func localIPv4s() []string { hostname, _ := os.Hostname() out := []string{} if hostname != "" { out = append(out, hostname) } addrs, err := net.InterfaceAddrs() if err != nil { return out } for _, a := range addrs { ipnet, ok := a.(*net.IPNet) if !ok || ipnet.IP.IsLoopback() || ipnet.IP.To4() == nil { continue } out = append(out, ipnet.IP.String()) } return out }