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
@@ -0,0 +1,89 @@
package plc
import (
"context"
"sync"
"time"
)
// bitsSnapshot 一次 48 位点位快照(MB895~MB902)。
// 全程只存副本,调用方改动不影响缓存。
type bitsSnapshot struct {
bits []bool
at time.Time
}
// snapshotCache 全局单例的 PLC 48 位快照缓存(2026-11-19 智能跟车)。
//
// 目的:看板 SSE / PLC 监控 WS / 流转引擎 每轮都要读一次全量点位。多网卡、高频轮询
// 叠加时若不合并,会在 2 秒内对同一条 S7 连接打多次读事务。这里做两件事:
// 1. TTL:snapshotTTL 内的重复读直接返回同一份快照,不碰 PLC;
// 2. singleflight:TTL 过期瞬间并发的 N 个读,只放 1 个真读打 PLC,其余等结果;
// 3. 写失效:任何 WriteMW 后调用 Invalidate(),立即丢弃旧快照,下次读强制重建——
// 保证"下发指令 → 再读点位"不会因为吃了 2 秒旧缓存而误判(用户拍板的兜底)。
//
// 业务精细确认(进站判定读单个 MW / 到位确认)不走本缓存,直接穿透PLC,实时取值。
type snapshotCache struct {
mu sync.Mutex
ttl time.Duration
snap *bitsSnapshot
loading bool
waiters []chan struct{}
}
func newSnapshotCache(ttl time.Duration) *snapshotCache {
return &snapshotCache{ttl: ttl}
}
// get 取快照:命中 TTL 直接返回;并发只放一个真读(load),其余等待共享结果。
func (c *snapshotCache) get(ctx context.Context, load func(context.Context) ([]bool, error)) ([]bool, error) {
c.mu.Lock()
if c.snap != nil && time.Since(c.snap.at) < c.ttl {
bits := append([]bool(nil), c.snap.bits...)
c.mu.Unlock()
return bits, nil
}
if c.loading {
ch := make(chan struct{})
c.waiters = append(c.waiters, ch)
c.mu.Unlock()
select {
case <-ch:
case <-ctx.Done():
return nil, ctx.Err()
}
c.mu.Lock()
if c.snap != nil {
bits := append([]bool(nil), c.snap.bits...)
c.mu.Unlock()
return bits, nil
}
c.mu.Unlock()
// 真读失败导致无快照,等待者各自穿透重试(不把错误缓存)。
return load(ctx)
}
c.loading = true
c.mu.Unlock()
bits, err := load(ctx)
c.mu.Lock()
if err == nil {
c.snap = &bitsSnapshot{bits: append([]bool(nil), bits...), at: time.Now()}
}
c.loading = false
waiters := c.waiters
c.waiters = nil
c.mu.Unlock()
for _, ch := range waiters {
close(ch)
}
return bits, err
}
// invalidate 让缓存立即过期(写 MW 后调用):丢弃快照,下次 get 强制真读重建。
func (c *snapshotCache) invalidate() {
c.mu.Lock()
c.snap = nil
c.mu.Unlock()
}