Files
bj_power/bj_power_mes/internal/logic/settings.go
T

348 lines
16 KiB
Go
Raw Normal View History

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"
2026-10-26 16:32:35 +08:00
// 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=禁止;关闭后超额叫料直接拒绝)
2026-10-26 16:32:35 +08:00
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"`
2026-10-26 16:32:35 +08:00
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,
2026-10-26 16:32:35 +08:00
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),
2026-10-26 16:32:35 +08:00
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=禁止,超额叫料直接拒绝)"},
2026-10-26 16:32:35 +08:00
{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
}
}
2026-10-26 16:32:35 +08:00
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
}