一、AGV 挂起动作引擎(弃显式任务队列、弃并发硬拒) - 新增 internal/logic/agv_pending.go:待发动作直接挂任务(pending_action + pending_since), CONTINUE_LIFT(举升完成→continueTask#1)/ WAIT_DROP_CONFIRM(人工确认放下→continueTask#2) / FREE_ROBOT(末组完成→freeRobot);系统动作超 60s 未触发转预警人工重试,绝不自动重发 - Client 新增 ContinueTask(RCS 2.1.2) / FreeRobot(3.1.2),仅点名释放指定车,禁止释放全部 - agv_task 增 pending_action/pending_since 字段,ent 重生成 + db.go 幂等迁移补丁 + migrateonce - 回调按 B01/B02/C01 模板编排:业务流转到位即自动放行放下、回调自动放车; 仅人工派车(MANUAL)挂 WAIT_DROP_CONFIRM;新增 /agv/confirm-drop、/agv/pending/retry - 前端 AgvManual/Agv 确认放下、挂起重试按钮与等待提示联动 二、智能跟车 + 动态目标截断流转引擎 - 新增 internal/logic/flow_engine.go:事件驱动(报工/扫码),读 48 位物理快照,从下游往上游算, 前方占用则动态截断到最近空闲缓存位;IN_TRANSIT 在途闭锁防重复下发,MW=0 才确认到位落台账; 主线占用=台账 OR 传感器,工位 G 位只认台账;在途超 5s 落预警 - workpiece 增 flow_transit_mw/target/at 字段,ent 重生成 + 迁移补丁 三、PLC 读取优化与诊断 - 新增 internal/plc/snapshot_cache.go:2s TTL + singleflight + 写失效,合并 SSE/PLC监控/流转引擎 的重复点位读取;tcp.go 读块重构、localip.go 多网卡、plcdiag 诊断工具、plc_monitor/logging 配套 四、文档与前端 - help.js 重写「工位下发」帮助:明确报工自动驱动流转 vs 下发路线码的定位、缺料/握手/撤回边界 - 案例.md 补充定稿说明;public/index.html 构建指纹更新
212 lines
12 KiB
Go
212 lines
12 KiB
Go
package logic
|
||
|
||
import (
|
||
"context"
|
||
"fmt"
|
||
"time"
|
||
|
||
"bj_power_mes/ent"
|
||
"bj_power_mes/ent/agvtask"
|
||
|
||
"github.com/zeromicro/go-zero/core/logx"
|
||
)
|
||
|
||
// ============ AGV 挂起动作引擎(2026-11-19 主控定稿) ============
|
||
// 弃「显式任务队列」、弃「并发硬拒扩展」——待发动作直接挂在任务上(pending_action + pending_since):
|
||
// - 每个任务最多一个待办动作;触发源(自定义回调 / 轮询到位探测 / 人工操作)命中即发,条件未满足就等着;
|
||
// - RCS 报错 → 清挂起 + event_log + 预警(WS 由 agv_hub 轮询变化检测 ≤3s 自动跟推,无需 logic 层直推);
|
||
// - 系统待发动作(CONTINUE_LIFT / FREE_ROBOT)超 60s 未触发 → 转预警人工重试,绝不自动重发
|
||
// (重发 continueTask 可能重复触发动作组;重发 freeRobot 可能误放正在作业的车);
|
||
// - WAIT_DROP_CONFIRM 是等人工的挂起,**仅人工派车(Kind=MANUAL)**使用(B01 到位举着货
|
||
// 等「确认放下」或「下一站」),无超时——人可以等很久;
|
||
// - 业务流转(叫料/退料/托盘回收,Kind≠MANUAL)B01 到位**严禁**挂 WAIT_DROP_CONFIRM:
|
||
// 到位即自动放行放下(continueTask 第2次)→ 放下完成回调自动 freeRobot 放车——
|
||
// 物理搬运与业务台账彻底解耦(主控 2026-11-19 整改定稿,用户原话「人工再确认不确认,
|
||
// 其实已经没有什么意义了,就直接放AGV离开吧」),单据留在 PENDING 等工人签收;
|
||
// - AGV 并发闸门 guardAgvConcurrency 保持不变(在途链数 ≤ 车数)。
|
||
//
|
||
// 海康 RCS-Lite 模板回调配置(2026-11-19 甲方 RCS 后台截图,主控提取,唯一权威):
|
||
// B01 举升模板 3 组:组1 移动→举升→移动(自动, b01endJuSheng=举升完成) / 组2 转移货架(任务编号触发,
|
||
// b01endZhuanYi=到位停稳) / 组3 移动→放下(自动, b01endFangXia=放下完成)
|
||
// B02 移动模板 3 组:组1(b02endOne)/组2(b02end2=停稳) 自动,组3(任务编号触发, b02end3=末组完成)
|
||
// C01 空车模板 2 组:组1(c01endOne=到位停稳) 自动,组2(任务编号触发, c01end2=末组完成)
|
||
// method 在 body 不在 URL,最大 16 字符(文档 §2.2.1)。
|
||
|
||
// 挂起动作取值(落 agv_tasks.pending_action,前端按此渲染等待提示与按钮互锁)
|
||
const (
|
||
// agvPendingContinueLift B01 下发成功即挂:等举升完成回调(b01endJuSheng) → 发第 1 次 continueTask(放行组2 转移)。
|
||
agvPendingContinueLift = "CONTINUE_LIFT"
|
||
// agvPendingDropConfirm B01 到位停稳(b01endZhuanYi)挂:等人工「确认放下」→ 发第 2 次 continueTask(放行组3 放下)。
|
||
// 放下必须人工确认(装卸强制确认铁律),本挂起不设超时。
|
||
agvPendingDropConfirm = "WAIT_DROP_CONFIRM"
|
||
// agvPendingFreeRobot continueTask 放行末组后挂:等末组完成回调(b01endFangXia/b02end3/c01end2) → 发 freeRobot 放车。
|
||
agvPendingFreeRobot = "FREE_ROBOT"
|
||
)
|
||
|
||
// agvPendingTimeout 系统待发动作超时(秒)。超时转预警人工重试(人工可点「AGV任务」列表重试按钮)。
|
||
const agvPendingTimeout = 60
|
||
|
||
// agvPendingTimeoutKey 预警去重键前缀(同任务 30 分钟去重,防轮询刷屏)。
|
||
const agvPendingTimeoutKey = "agv_pending_timeout"
|
||
|
||
// setAgvPending 挂起待办动作(覆盖写;一个任务同时只有一个待办)。
|
||
func (s *Service) setAgvPending(ctx context.Context, taskID int, action string) {
|
||
now := time.Now().Unix()
|
||
if err := s.ctx.EntClient.AgvTask.UpdateOneID(taskID).
|
||
SetPendingAction(action).SetPendingSince(now).Exec(ctx); err != nil {
|
||
logx.WithContext(ctx).Errorf("[AGV][pending] 挂起动作写入失败 taskID=%d action=%s: %v", taskID, action, err)
|
||
}
|
||
}
|
||
|
||
// clearAgvPending 清除挂起动作(触发完成 / RCS 报错)。
|
||
func (s *Service) clearAgvPending(ctx context.Context, taskID int) {
|
||
_ = s.ctx.EntClient.AgvTask.UpdateOneID(taskID).
|
||
SetPendingAction("").SetPendingSince(0).Exec(ctx)
|
||
}
|
||
|
||
// agvPendingFailText 挂起动作中文名(告警/日志用)。
|
||
func agvPendingFailText(action string) string {
|
||
switch action {
|
||
case agvPendingContinueLift:
|
||
return "等待举升完成以放行转移(continueTask)"
|
||
case agvPendingDropConfirm:
|
||
return "等待人工确认放下"
|
||
case agvPendingFreeRobot:
|
||
return "等待放下/末段完成以释放车辆(freeRobot)"
|
||
}
|
||
return action
|
||
}
|
||
|
||
// failAgvPending RCS 报错/异常 → 清挂起 + 留痕 + 预警(主控定稿:立即清,绝不带病挂着)。
|
||
func (s *Service) failAgvPending(ctx context.Context, t *ent.AgvTask, action, scene string) {
|
||
s.clearAgvPending(ctx, t.ID)
|
||
s.ctx.EventLog.Write(ctx, "agv.pending_fail", "system", "", "agv_task", t.TaskNo,
|
||
"挂起动作["+agvPendingFailText(action)+"]触发失败("+scene+"),已清除挂起,等待人工处置", nil)
|
||
s.CreateAlertDedup(ctx, "agv_pending_fail", "警告", t.TaskNo,
|
||
"AGV 任务 "+t.TaskNo+" 的动作["+agvPendingFailText(action)+"]触发失败("+scene+"),请到「AGV管理→AGV任务」重试或人工处置", 30)
|
||
}
|
||
|
||
// runPendingContinueLift 举升完成回调(b01endJuSheng)命中 → 发第 1 次 continueTask 放行组2(转移货架)。
|
||
// 成功清挂起;失败清挂起+预警(绝不留挂起重试——重发会重复触发动作组)。
|
||
func (s *Service) runPendingContinueLift(ctx context.Context, t *ent.AgvTask) {
|
||
if err := s.ctx.Agv.ContinueTask(ctx, t.TaskNo); err != nil {
|
||
s.failAgvPending(ctx, t, agvPendingContinueLift, err.Error())
|
||
return
|
||
}
|
||
s.clearAgvPending(ctx, t.ID)
|
||
s.ctx.EventLog.Write(ctx, "agv.pending_continue_lift", "system", "", "agv_task", t.TaskNo,
|
||
"举升完成,已放行货架转移(continueTask 第1次)", nil)
|
||
}
|
||
|
||
// runPendingFreeRobot 末组完成回调命中 → 发 freeRobot 放车 + 段收尾。
|
||
// 放下即发不等签收(2026-11-19 用户裁决:freeRobot=放下即发,签收只闭环单据)。
|
||
func (s *Service) runPendingFreeRobot(ctx context.Context, t *ent.AgvTask, scene string) {
|
||
if err := s.ctx.Agv.FreeRobot(ctx, []string{t.AgvCode}); err != nil {
|
||
s.failAgvPending(ctx, t, agvPendingFreeRobot, err.Error())
|
||
return
|
||
}
|
||
s.clearAgvPending(ctx, t.ID)
|
||
s.finishAgvSegmentAfterFreeRobot(ctx, t, scene)
|
||
}
|
||
|
||
// finishAgvSegmentAfterFreeRobot freeRobot 成功后的段收尾:置终态 + 点位解锁 + 业务回写(送达)。
|
||
func (s *Service) finishAgvSegmentAfterFreeRobot(ctx context.Context, t *ent.AgvTask, scene string) {
|
||
if t.Status != "9" && t.Status != "5" {
|
||
_ = s.ctx.EntClient.AgvTask.UpdateOneID(t.ID).SetStatus("9").Exec(ctx)
|
||
s.unlockAgvPointByTask(ctx, t.TargetDock, t.TaskNo)
|
||
}
|
||
s.ctx.EventLog.Write(ctx, "agv.pending_free_robot", "system", "", "agv_task", t.TaskNo,
|
||
scene+",车辆 "+t.AgvCode+" 已释放(freeRobot,放下即发不等签收)", nil)
|
||
// CALL 链送达回写:货放下+车释放才真正送达(原 ConfirmUnloadRelease 逻辑移到回调侧)
|
||
if t.BizType == "CALL" {
|
||
s.notifyDeliveredOnArrival(ctx, t)
|
||
if s.ctx.Wms != nil && t.BizNo != "" {
|
||
if derr := s.ctx.Wms.DeliveryDelivered(ctx, t.BizNo); derr != nil {
|
||
s.recordSyncFailure("delivery.delivered", t.BizNo, "/api/internal/delivery/delivered",
|
||
map[string]any{"deliveryNo": t.BizNo}, derr)
|
||
}
|
||
}
|
||
}
|
||
s.maybeCloseShifts(ctx)
|
||
}
|
||
|
||
// checkAgvPendingTimeouts 每轮刷新调用:系统待发动作超时转预警(人工重试,绝不自动重发)。
|
||
func (s *Service) checkAgvPendingTimeouts(ctx context.Context) {
|
||
rows, err := s.ctx.EntClient.AgvTask.Query().
|
||
Where(agvtask.PendingActionIn(agvPendingContinueLift, agvPendingFreeRobot)).All(ctx)
|
||
if err != nil || len(rows) == 0 {
|
||
return
|
||
}
|
||
now := time.Now().Unix()
|
||
for _, t := range rows {
|
||
if t.PendingSince <= 0 || now-t.PendingSince < agvPendingTimeout {
|
||
continue
|
||
}
|
||
_, _ = s.CreateAlertDedup(ctx, agvPendingTimeoutKey, "警告", t.TaskNo,
|
||
"AGV 任务 "+t.TaskNo+" 挂起动作["+agvPendingFailText(t.PendingAction)+"]已超过 60 秒未触发(海康回调可能丢失),"+
|
||
"请现场核实后到「AGV管理→AGV任务」点「重试挂起动作」,系统不会自动重发", 30)
|
||
s.ctx.EventLog.Write(ctx, "agv.pending_timeout", "system", "", "agv_task", t.TaskNo,
|
||
"挂起动作["+agvPendingFailText(t.PendingAction)+"]超时 60 秒,已转预警等待人工重试", nil)
|
||
}
|
||
}
|
||
|
||
// RetryAgvPending 人工重试挂起动作(预警/任务列表入口):按任务当前挂起重放对应动作。
|
||
// 重试也只重放一次,失败照常清挂起+预警——是否再试由人决定。
|
||
func (s *Service) RetryAgvPending(ctx context.Context, taskNo, operator string) error {
|
||
t, err := s.ctx.EntClient.AgvTask.Query().Where(agvtask.TaskNo(taskNo)).First(ctx)
|
||
if err != nil || t == nil {
|
||
return fmt.Errorf("AGV 任务不存在:%s", taskNo)
|
||
}
|
||
switch t.PendingAction {
|
||
case agvPendingContinueLift:
|
||
s.ctx.EventLog.Write(ctx, "agv.pending_retry", operator, "", "agv_task", t.TaskNo, "人工重试:放行货架转移", nil)
|
||
s.runPendingContinueLift(ctx, t)
|
||
return nil
|
||
case agvPendingFreeRobot:
|
||
s.ctx.EventLog.Write(ctx, "agv.pending_retry", operator, "", "agv_task", t.TaskNo, "人工重试:释放车辆", nil)
|
||
s.runPendingFreeRobot(ctx, t, "人工重试触发")
|
||
return nil
|
||
case "":
|
||
return fmt.Errorf("任务 %s 当前没有挂起动作,无需重试", taskNo)
|
||
default:
|
||
return fmt.Errorf("任务 %s 挂起动作 %s 不支持重试", taskNo, t.PendingAction)
|
||
}
|
||
}
|
||
|
||
// ConfirmAgvDrop 人工「确认放下」(**仅人工派车** B01 到位举着货 → 放行组3 放下):
|
||
// 第 2 次 continueTask,成功后段保持 ARRIVED 等用户「下一站/结束用车」触发 freeRobot
|
||
// (人工派车放下完成后车辆原地待命,绝不自动放车——主控 2026-11-19 整改)。
|
||
// 业务流转段(Kind≠MANUAL)不走这里:到位自动放行放下,见 autoDropBusinessB01。
|
||
func (s *Service) ConfirmAgvDrop(ctx context.Context, taskNo, operator string) error {
|
||
t, err := s.ctx.EntClient.AgvTask.Query().Where(agvtask.TaskNo(taskNo)).First(ctx)
|
||
if err != nil || t == nil {
|
||
return fmt.Errorf("AGV 任务不存在:%s", taskNo)
|
||
}
|
||
if t.Kind == "MANUAL" {
|
||
if t.Status != "ARRIVED" {
|
||
return fmt.Errorf("任务不在「到位待令」状态,无法确认放下(当前 %s)", agvTaskStatusText(t.Status))
|
||
}
|
||
} else {
|
||
// 业务段兜底入口(自动放行失败后的补救路径):不卡状态细节,直接补发放行
|
||
if t.Status == "9" || t.Status == "5" {
|
||
return fmt.Errorf("任务已结束,无需确认放下")
|
||
}
|
||
}
|
||
return s.confirmDropAndPendingFreeRobot(ctx, t, operator)
|
||
}
|
||
|
||
// autoDropBusinessB01 业务流转段(叫料/退料/托盘回收,Kind≠MANUAL)B01 到位自动放行放下:
|
||
// 第 2 次 continueTask 放行组3(放下),成功挂 FREE_ROBOT 等放下完成回调自动 freeRobot 放车。
|
||
// 主控 2026-11-19 整改定稿:业务流转「物理放下与业务台账解耦」——车到目标接驳台就自动放下、
|
||
// 自动离开,绝不挂 WAIT_DROP_CONFIRM 等人工点按钮;单据留在 PENDING 等工人签收。
|
||
func (s *Service) autoDropBusinessB01(ctx context.Context, t *ent.AgvTask, source string) {
|
||
if err := s.ctx.Agv.ContinueTask(ctx, t.TaskNo); err != nil {
|
||
// 放行失败:清挂起 + 预警(人可经「AGV任务→确认卸货放行」补救),保持 ARRIVED
|
||
s.failAgvPending(ctx, t, agvPendingDropConfirm, "业务到位自动放行放下失败:"+err.Error())
|
||
return
|
||
}
|
||
s.setAgvPending(ctx, t.ID, agvPendingFreeRobot)
|
||
s.ctx.EventLog.Write(ctx, "agv.auto_drop", "system", "", "agv_task", t.TaskNo,
|
||
"业务流转到位("+source+"),已自动放行放下(continueTask 第2次);放下完成后自动释放车辆,单据待工人签收", nil)
|
||
}
|