Files
bj_power/bj_power_mes/internal/plc/snapshot_cache.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

90 lines
2.5 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 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()
}