Files
bj_power/bj_power_mes/internal/logic/settings.go
T
SunYF 42bcf395d2 feat: AGV三段链安全机制、补料/损耗/下班闭环、接驳台左右互换
AGV 调度:
- 任务重构为 GO_LOAD/TRANSPORT/EMPTY_RETURN/FREE 三段链,到位即停(ARRIVED)需人工确认装卸
- 自由调度单点步进,每段强制弹"请确保路径畅通无杂物";托盘回收独立工作台
- 接驳台 PLC 传感器检测到托盘即自动卸货放行,传感器故障由人工按钮兜底(无轮询)
- 车辆状态只读展示(海康3.1.7 queryAgvStatus),调度仍由 RCS 负责

物料闭环:
- 补料管理(SHORTAGE):工位申请 + 主管审批调增叫料池额度,与借料/差异补发三轨并行
- 损耗台账(loss_ledger):退料实际 < 理论必填原因、后审核,工单不记损耗
- 退料强制指定左/右接驳台,WMS 库管可代工位退料

下班闭环:
- 工位终端自检接驳台剩余物料后下班;库管收货 + 托盘拉走后事件驱动自动结班
- 退出登录未下班仅作安全提示(不强制拦截、不新增责任审批)

接驳台左右按操作员朝向建模(dock.side 字段),废除"奇左偶右"隐式约定;
看板标签 / seed / 迁移补丁 / 布局文档统一为中文左/右。

产线布局说明:C1 前线头 AGV 点、C15 后线尾 AGV 点、外部 O1/O2/O3 散点,
清理修订痕迹为最终态描述。
2026-11-03 18:29:31 +08:00

348 lines
16 KiB
Go
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
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
}