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
+49
View File
@@ -42,6 +42,14 @@ type Client interface {
QueryTask(ctx context.Context, taskCode string) (status string, agvCode string, err error)
// CancelTask 取消任务(按 taskCode)。
CancelTask(ctx context.Context, taskCode, reason string) error
// ContinueTask 继续执行任务(接口文档 2.1.2):模板触发方式=任务编号的动作组停在等待点,
// 上层按业务时机发本接口(传 taskCode,与 RCS 模板配置「触发方式=任务编号」一致,文档推荐),
// RCS 取下一个动作继续执行。B01 举升模板:举升完成(b01endJuSheng)→第 1 次;到位确认(b01endZhuanYi)
// 后人工放行→第 2 次(触发组3 放下)。
ContinueTask(ctx context.Context, taskCode string) error
// FreeRobot 释放 AGV(接口文档 3.1.2):把指定车辆置空闲,RCS 可重新调度。
// 放下完成(b01endFangXia/b02end3/c01end2)或人工点「下一站/结束」时调用,robots 为车号列表。
FreeRobot(ctx context.Context, robots []string) error
// QueryAgvStatus 获取车辆状态(3.1.7 queryAgvStatus):车辆闲忙/充电/电量/位置。
// 用于并发闸门取 AGV 总数 + 人工派车状态点展示。
// 纯只读展示,不参与调度(调度完全交给 RCS 自身)。
@@ -341,6 +349,35 @@ func (c *realClient) CancelTask(ctx context.Context, taskCode, reason string) er
return c.call(ctx, "/cancelTask", payload, nil)
}
// ContinueTask 实现 Client:继续执行任务(2.1.2)。触发方式=任务编号 → 只传 taskCode(文档推荐),
// wbCode/podCode/agvCode 三种触发方式均不传——模板配置以任务编号为准,传了反而不匹配。
func (c *realClient) ContinueTask(ctx context.Context, taskCode string) error {
if taskCode == "" {
return fmt.Errorf("缺少任务单号")
}
payload := map[string]any{"taskCode": taskCode}
return c.call(ctx, "/continueTask", payload, nil)
}
// FreeRobot 实现 Client:释放 AGV(3.1.2)。指定车号列表时 robotCount 传列表长度(-1=全部,需 mapShortName,
// MES 永不释放全部车辆——释放哪些车必须显式点名,防止误放正在作业的车)。
func (c *realClient) FreeRobot(ctx context.Context, robots []string) error {
clean := make([]string, 0, len(robots))
for _, r := range robots {
if r = strings.TrimSpace(r); r != "" {
clean = append(clean, r)
}
}
if len(clean) == 0 {
return fmt.Errorf("缺少要释放的车辆编号")
}
payload := map[string]any{
"robotCount": fmt.Sprintf("%d", len(clean)),
"robots": clean,
}
return c.call(ctx, "/freeRobot", payload, nil)
}
// queryAgvStatusData 3.1.7 单条车辆状态 data 项(字段兼容字符串/数字)
type queryAgvStatusData struct {
RobotCode flexString `json:"robotCode"`
@@ -418,6 +455,18 @@ func (m *mockClient) CancelTask(ctx context.Context, taskCode, reason string) er
return nil
}
// ContinueTask Mock:模拟任务继续成功。
func (m *mockClient) ContinueTask(ctx context.Context, taskCode string) error {
logx.WithContext(ctx).Infof("[AGV]"+commTag+"[MOCK] ContinueTask taskCode=%s(模拟继续任务成功)", taskCode)
return nil
}
// FreeRobot Mock:模拟释放车辆成功。
func (m *mockClient) FreeRobot(ctx context.Context, robots []string) error {
logx.WithContext(ctx).Infof("[AGV]"+commTag+"[MOCK] FreeRobot robots=%v(模拟释放车辆成功)", robots)
return nil
}
// QueryAgvStatus Mock:返回两台示例车(一台空闲、一台执行中),便于联调展示。
func (m *mockClient) QueryAgvStatus(ctx context.Context, mapShortName string) ([]AgvVehicle, error) {
logx.WithContext(ctx).Infof("[AGV]" + commTag + "[MOCK] QueryAgvStatus(模拟返回样例车 9001/9002)")