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 构建指纹更新
This commit is contained in:
SunYF
2026-11-19 23:08:46 +08:00
parent 4c4cda1d41
commit 9aaa768e6c
40 changed files with 3037 additions and 364 deletions
+26 -6
View File
@@ -3,6 +3,7 @@ package plc
import (
"context"
"errors"
"net"
"strconv"
"strings"
"sync"
@@ -46,6 +47,10 @@ type Client interface {
WriteMW(ctx context.Context, addr, value int) error
}
// plcSnapshotTTL 48 位快照缓存有效期(2026-11-19 智能跟车):
// 2 秒内对 PLC 的多次全量读合并为一次;写 MW 后立即失效重建,兼顾负载与实时性。
const plcSnapshotTTL = 2 * time.Second
// Manager 管理 PLC 客户端实例
type Manager struct {
client Client
@@ -54,15 +59,18 @@ type Manager struct {
onFail func(ctx context.Context, err error) // 2026-11-16:连续失败首次沿触发(通信异常预警),恢复后重置
mu sync.Mutex
consecFails int
mockOffline bool // mock 模式:模拟 PLC 离线(拍板2 联调/自测用,真实 PLC 忽略)
mockOffline bool // mock 模式:模拟 PLC 离线(拍板2 联调/自测用,真实 PLC 忽略)
snap *snapshotCache // 48 位快照缓存(读合并 + 写失效)
}
func NewManager(c config.PlcConf, mock bool) (*Manager, error) {
m := &Manager{mock: mock}
m := &Manager{mock: mock, snap: newSnapshotCache(plcSnapshotTTL)}
// 日志前缀按实际连接目标做路由探测,精确显示连 PLC 走的是哪块网卡的 IP。
target := net.JoinHostPort(c.Host, strconv.Itoa(c.Port))
if mock {
m.client = newLogClient(newMockClient())
m.client = newLogClient(newMockClient(), target)
} else {
m.client = newLogClient(newTcpClient(c))
m.client = newLogClient(newTcpClient(c), target)
}
return m, nil
}
@@ -103,13 +111,20 @@ func (m *Manager) QueryStationPallet(ctx context.Context, stationNo int) (bool,
return v, err
}
// ReadBits 读 48 位点位信号(带恢复检测)。
// ReadBits 读 48 位点位信号(带恢复检测,穿透缓存,实时)。
func (m *Manager) ReadBits(ctx context.Context) ([]bool, error) {
v, err := m.client.ReadBits(ctx)
m.track(err)
return v, err
}
// ReadBitsCached 读 48 位快照(2 秒 TTL + singleflight 合并 + 写失效)。
// 看板/监控/流转引擎的"看一眼全量点位"走这里,避免高频轮询打死 PLC;
// 进站、到位等精细业务确认必须走 ReadBits/ReadMW 穿透,拿实时值。
func (m *Manager) ReadBitsCached(ctx context.Context) ([]bool, error) {
return m.snap.get(ctx, m.ReadBits)
}
// ReadMW 读 16 位寄存器(带恢复检测)。
func (m *Manager) ReadMW(ctx context.Context, addr int) (int, error) {
v, err := m.client.ReadMW(ctx, addr)
@@ -125,8 +140,13 @@ func (m *Manager) ReadMWBlock(ctx context.Context, start, count int) ([]int, err
}
// WriteMW 写 16 位寄存器(带恢复检测)。
// 2026-11-19:写入成功后立即失效 48 位快照——下一条指令/判定读到的是下发后的真实物理状态,
// 杜绝"下发了却仍吃 2 秒前旧缓存"造成误判(用户拍板的写即失效兜底)。写失败不失效(状态未变)。
func (m *Manager) WriteMW(ctx context.Context, addr, value int) error {
err := m.client.WriteMW(ctx, addr, value)
if err == nil {
m.snap.invalidate()
}
m.track(err)
return err
}
@@ -203,4 +223,4 @@ func parseCombination(s string) []int {
// Sleep 简化轮询间隔(供 logic 使用)
func Sleep(d time.Duration) {
time.Sleep(d)
}
}