Files
ssp/docs/superpowers/specs/2026-11-06-plc-flow-fixes.md
T

3.4 KiB

PLC 联机流程修复

后续变更:用户于 2026-11-06 要求取消 PLC/机器人就绪位门槛,当前规则见 2026-11-06-connected-plc-ready.md。下述就绪要求及验证结果为该变更之前的记录。

已确认范围

用户根据上一轮分析授权修改。采用局部修复,不改 PLC 地址或视觉识别关闭时的拍照位前置协议。 真实设备点表和动作耗时需现场确认,不能用本机模拟结果代替。

修改方案

  1. REVERSE_FLIP 同时加入 schema、实际数据库迁移和运行时约束校验;新增迁移可从版本 8/9 升至 10, 包含 STOPPING 检查约束与活动订单唯一索引。旧约束在启动时明确提示执行新迁移,避免运行到中途才失败。
  2. 通讯有效、急停未触发、安全门全部关闭、可选 PLC 错误码无故障,使用同一个检查函数。 启动前验证这些条件;进入等待就绪后再等待 PLC/机器人 ready。恢复及新动作发送前还要求 ready。 已在途动作的轮询、完成反馈持久化和清理不要求 ready 始终为 1,因为运行中 ready 可能为 0。
  3. 等待就绪、拍照移动、取放、正反翻转、检测分别可设置超时,未配置时使用原有 stateTimeoutMs。 等待就绪超时进入 TimeoutPaused,保留运行上下文、停止调度并显示未就绪原因;条件满足后可恢复。 动作超时仍保留 PLC 握手及检查点,不自动重发动作。实际超时值不凭空放大。
  4. 显示反向翻面中文状态和恢复动作名称。

验证

  • 使用真实 PostgreSQL 9.5 与本机 FakePlc 的 TCP 通讯,在 simulation=false 下执行: 镀前单件/连续两件、镀后单件、暂停继续、超时恢复、终止删除后启动新订单。
  • 门打开时启动及恢复均不得写入生产控制;在途机器人不就绪不能阻止已完成动作的握手清理。 已复现并修复恢复异步读取期间开门后仍写检测模式的问题,写模式前再次检查安全状态。
  • 等待就绪超时及恢复、分阶段超时覆盖/回退/无效值,以及慢反馈不被旧统一超时误判。
  • PostgreSQL 检查点写入接受 REVERSE_FLIP,旧约束被拒绝并明确提示迁移。
  • 隔离数据库验证升级、重复迁移及完整 schema;回归原有流程、界面、视觉及设备握手测试并编译应用。

验证结果:端到端 15 项、生产恢复 45 项、视觉生产 34 项、恢复界面 19 项、PostgreSQL 16 项、 设备握手 7 项,合计 136 项 QtTest 结果通过(含各套件初始化与清理);完整应用编译通过。

部署

已有数据库执行 db/migrations/2026-11-06-production-plc-flow.sql,不必再单独执行版本 9 迁移。 部署前确保生产已停止;迁移在同一事务内提交,锁等待上限 5 秒,失败全部回滚。 程序仍读取 exe 旁的 config.ini;现有地址保持不变。可选超时键示例在项目 config.ini 中注释列出, 现场确认后填写到实际运行的配置。数据库迁移不会主动发出任何 PLC 操作。

2026-11-06 已将本机 127.0.0.1:5432/ssp 从版本 8 升至 10。升级前确认应用未运行、 无活动任务,并保存结构备份 tmp/ssp-schema-before-plc-flow-v10.sql;事务内再次检查无活动生产。 升级后核实 REVERSE_FLIP 约束及包含 STOPPING 的唯一索引生效,订单、工件、运行及检测记录数量 均保持为 0。其他部署环境仍需执行上述迁移。