Files
bj_power/bj_power_mes/internal/logic/agv_pending.go
T
SunYF 9aaa768e6c feat(mes): AGV挂起动作引擎 + 智能跟车流转 + PLC快照缓存(2026-11-19 主控拍板)
一、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 构建指纹更新
2026-11-19 23:08:46 +08:00

212 lines
12 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"
"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)
}