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 散点, 清理修订痕迹为最终态描述。
348 lines
16 KiB
Go
348 lines
16 KiB
Go
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
|
||
}
|