- MES 新增实体:混产模板、产品BOM、产品工艺物料、试制记录(schema + ent 生成码 + logic/handler/前端页) - WMS 实体增强:检验记录、库存、半成品重构;新增序列号库存与短缺代报 - AGV 与产能:AGV 手动点位与链路、物料守卫、短缺预测、原因字典 - 前端通用能力:新增下一步引导组件 NextStepBar,统一帮助文档/布局/请求拦截与操作列 - 工位终端:界面与各 handler 调整(api/store/绑定/PLC/拧紧/上报等) - 配置与文档:更新 mes-api.yaml、WMS README 及案例/产线API/问题记录/项目说明/流程说明
419 lines
20 KiB
Go
419 lines
20 KiB
Go
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"
|
||
// 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"
|
||
// 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"`
|
||
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"`
|
||
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"),
|
||
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=禁止,超额叫料直接拒绝)"},
|
||
{CfgDashboardRefreshSeconds, req.DashboardRefreshSeconds, 1, 10, "看板轮询兜底刷新间隔(秒,1~10,仅 SSE 不可用时的 HTTP 轮询周期)"},
|
||
{CfgArchiveRemindDays, req.ArchiveRemindDays, 0, 365, "数据归档提醒周期(天,0=关闭;距上次成功备份超过该天数时提醒)"},
|
||
{CfgAgvUnloadTimeoutMinutes, req.AgvUnloadTimeoutMinutes, 1, 1440, "AGV 卸货超时报警(分钟,1~1440;任务派发后超过该时长未卸货完成则落预警)"},
|
||
}
|
||
if req.AgvTaskTypLift != nil {
|
||
if v := strings.TrimSpace(*req.AgvTaskTypLift); v != "" {
|
||
if err := s.upsertConfig(ctx, CfgAgvTaskTypLift, v, "AGV 举升任务模板编号(B01)"); err != nil { return err }
|
||
}
|
||
}
|
||
if req.AgvTaskTypPlain != nil {
|
||
if v := strings.TrimSpace(*req.AgvTaskTypPlain); v != "" {
|
||
if err := s.upsertConfig(ctx, CfgAgvTaskTypPlain, v, "AGV 移动任务模板编号(B02)"); err != nil { return err }
|
||
}
|
||
}
|
||
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)
|
||
// 按字符数(中文 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
|
||
}
|