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

418 lines
21 KiB
Go
Raw Normal View History

package logic
import (
"context"
"encoding/json"
"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 门口看板(MES /board 页)标题文字:空=默认「总装产线实时看板」(默认空);看板端每分钟拉取跟随
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"
// CfgDashboardKpiVisible 门口看板 KPI 显示项(JSON 数组字符串,15 个白名单 key,见 SaveSettings;默认 [])
CfgDashboardKpiVisible = "dashboard.kpi.visible"
// CfgDashboardAnimationLevel 门口看板动画级别(full 完整/simple 简洁/off 关闭;默认 full)
CfgDashboardAnimationLevel = "dashboard.animation.level"
// CfgDashboardBoardTitleScroll 门口看板标题滚动开关(0 不滚动/1 滚动;默认 0)
CfgDashboardBoardTitleScroll = "dashboard.board.title.scroll"
CfgAgvTaskTypLift = "agv.task.typ.lift"
CfgAgvTaskTypPlain = "agv.task.typ.plain"
// CfgAgvTaskTypEmpty 人工派车首段「空车去接货点」模板(2026-11-17 用户拍板 C01):
// 只传到达点(单点 path)、不指定 agv、不举升;到位后停住等人工选下一站,下一站按目标点走 B01/B02。
CfgAgvTaskTypEmpty = "agv.task.typ.empty"
// 2026-11-09:全局 torque.manual.input 开关已废弃;「允许手填」改由拧紧枪配置页按工位维护,见 torque_gun_config.go。
)
// 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
DashboardKpiVisible string `json:"dashboardKpiVisible"` // 门口看板 KPI 显示项(JSON 数组字符串,默认 [])
DashboardAnimationLevel string `json:"dashboardAnimationLevel"` // 门口看板动画级别 full/simple/off(默认 full)
AgvTaskTypLift string `json:"agvTaskTypLift"`
AgvTaskTypPlain string `json:"agvTaskTypPlain"`
AgvTaskTypEmpty string `json:"agvTaskTypEmpty"`
DashboardBoardTitleScroll int `json:"dashboardBoardTitleScroll"` // 门口看板标题滚动 0/1(默认 0)
// 本机基础信息(只读)
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=不改)
DashboardKpiVisible *string `json:"dashboardKpiVisible"` // 门口看板 KPI 显示项(JSON 数组字符串,nil=不改)
DashboardAnimationLevel *string `json:"dashboardAnimationLevel"` // 门口看板动画级别 full/simple/off(nil=不改)
AgvTaskTypLift *string `json:"agvTaskTypLift"`
AgvTaskTypPlain *string `json:"agvTaskTypPlain"`
AgvTaskTypEmpty *string `json:"agvTaskTypEmpty"`
DashboardBoardTitleScroll *int `json:"dashboardBoardTitleScroll"` // 门口看板标题滚动 0/1(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 卸货超时报警(分钟)
CfgDashboardBoardTitleScroll: 0, // 门口看板标题滚动(默认 0=不滚动)
}
// 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"),
AgvTaskTypLift: cfgStrFrom(kv, CfgAgvTaskTypLift, "B01"),
AgvTaskTypPlain: cfgStrFrom(kv, CfgAgvTaskTypPlain, "B02"),
AgvTaskTypEmpty: cfgStrFrom(kv, CfgAgvTaskTypEmpty, "C01"),
DashboardKpiVisible: cfgStrFrom(kv, CfgDashboardKpiVisible, "[]"),
DashboardAnimationLevel: cfgStrFrom(kv, CfgDashboardAnimationLevel, "full"),
DashboardBoardTitleScroll: cfgIntFrom(kv, CfgDashboardBoardTitleScroll),
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;任务派发后超过该时长未卸货完成则落预警)"},
}
// AGV 三个任务模板(举升 B01 / 移动 B02 / 空车接货 C01)2026-11-17 用户裁决改为只读:
// 基础设置页仅展示不可修改,保存请求即使带上这两个字段也一律忽略,模板编号由出厂常量+seed 锁定。
// 地图简称同样只读且已迁至 yaml Agv.MapShortName(本接口不再接收 agvMapShortName 字段)。
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)
// 按字符数(中文 1 字=1 rune),放宽到 100 字
if len([]rune(t)) > 100 {
return errors.New("门口看板标题需 0~100 字(空=不显示标题)")
}
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
}
}
// 门口看板 KPI 显示项:合法 JSON 数组 + 元素在 15 个白名单 key(禁正则,用 encoding/json)
if req.DashboardKpiVisible != nil {
v := strings.TrimSpace(*req.DashboardKpiVisible)
var arr []string
if err := json.Unmarshal([]byte(v), &arr); err != nil {
return errors.New("看板 KPI 显示项需为合法的 JSON 数组")
}
allowed := map[string]bool{
"output": true, "rate": true, "wip": true, "cycle": true,
"pass": true, "online": true, "location": true,
"yield": true, "onlineRate": true, "doneRate": true,
"wipOrders": true, "materialReady": true, "torque": true,
"inbound": true, "outbound": true,
}
for _, k := range arr {
if !allowed[k] {
return fmt.Errorf("看板 KPI 显示项「%s」不在允许范围(output/rate/wip/cycle/pass/online/location/yield/onlineRate/doneRate/wipOrders/materialReady/torque/inbound/outbound)", k)
}
}
if err := s.upsertConfig(ctx, CfgDashboardKpiVisible, v, "门口看板 KPI 显示项(JSON 数组字符串)"); err != nil {
return err
}
}
// 门口看板动画级别:full/simple/off
if req.DashboardAnimationLevel != nil {
v := strings.TrimSpace(*req.DashboardAnimationLevel)
if v != "full" && v != "simple" && v != "off" {
return errors.New("看板动画级别仅支持 full(完整)/simple(简洁)/off(关闭)")
}
if err := s.upsertConfig(ctx, CfgDashboardAnimationLevel, v, "门口看板动画级别(full/simple/off)"); err != nil {
return err
}
}
// 门口看板标题滚动:0/1
if req.DashboardBoardTitleScroll != nil {
v := *req.DashboardBoardTitleScroll
if v != 0 && v != 1 {
return errors.New("看板标题滚动开关仅支持 0(不滚动)/1(滚动)")
}
if err := s.upsertConfig(ctx, CfgDashboardBoardTitleScroll, strconv.Itoa(v), "门口看板标题滚动(0/1)"); err != nil {
return err
}
}
// 2026-11-09:「允许手填」改由「拧紧枪配置」页按工位维护(关闭时校验本工位控制器地址),
// 基础设置页不再保存该全局开关。
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 幂等写入配置(原子 upsert)。
// 2026-11-10 根治 SQLSTATE 23505:原实现「先查后插」在并发/重复提交下两个请求会同时走到
// Create(),撞 sys_config_pkey 或 sys_config_key_key。改为单条 INSERT ... ON CONFLICT (key)
// DO UPDATE,由数据库保证串行收敛;id 交给序列,不再手工赋主键。
func (s *Service) upsertConfig(ctx context.Context, key, value, remark string) error {
_, err := s.ctx.SQLDB.ExecContext(ctx,
`INSERT INTO sys_config (key, value, remark) VALUES ($1, $2, $3)
ON CONFLICT (key) DO UPDATE SET value = EXCLUDED.value, remark = EXCLUDED.remark`,
key, value, remark)
return err
}
// 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
}