Files
ssp/docs/plans/2026-11-09-clear-alarm-reset-plan.md
T
lidg 47627b07f0 feat(production): 修改订单加工位置不一致问题
-创建订单时解除所有占用
-修改数据库位置唯一约束
-严格按照订单起始位置分配
-订单启动时重新初始化位置
2026-11-09 15:04:11 +08:00

21 KiB
Raw Blame History

清除报警按钮:可选复位修改方案

日期:2026-11-09

状态:用户已确认实施,代码修改、Qt 5.14.1 MinGW 构建及隔离回归验收已完成;验证范围及限制见第 10 节。未提交 Git,未操作现场 PLC 或业务数据。第 2—9 节保留批准方案,源码行号为实施前定位。

1. 目标和确定的交互

按钮保留名称“清除报警”。点击后先选择,选择之前不写 PLC、不改变订单。

弹窗标题:清除报警

正文:

是否同时复位自动线?

复位将结束旧生产任务、清除遗留动作及视觉状态,回到待机,不继续旧订单,也不自动启动新订单。 无测量记录的旧任务将删除订单及关联数据;已有测量记录的旧任务保留历史数据。 新建的未开始订单和正常完成订单保留。

选项:

选项 行为
是,清警并复位 清警、结束旧任务、清理软件及配置握手状态,成功后进入 Idle
否,仅清除报警 沿用现有清警功能,不改变任务、工序、动作锁或暂停状态
取消/关闭/Esc 不执行任何操作

默认选择“否,仅清除报警”;关闭或 Esc 按取消处理。选择复位时要求确认机器人已停止、现场位置允许结束旧任务。软件复位不代替机器人急停或回原点。

复位成功提示:复位完成,当前待机,可启动订单。 仅清警成功提示:报警已清除,生产任务及运行状态未重置。

2. 当前源码证据与可复用实现

工作区:E:/QTCode/ssp/ssp;检查时 HEAD:6a70f19,按实际工作区源码核对,实施前需再次确认差异。以本次需求及当前代码为准;历史设计文件的视觉握手进入条件、终止删除规则已有后续调整,不能原样照搬。

文件及位置 已存在的实现 本方案使用方式
pages/dashboardpage.cpp:485 clearAlarm() 改为三选交互
pages/dashboardpage.cpp:562 confirmControlOperation(title,effect) 复用防重复弹窗、身份重校验思路;不改其他按钮的二选确认
pages/dashboardpage.cpp:852 updateRecoveryButtons() 修复未初始化或遗留恢复状态时无法进入复位的问题
services/productionworker.cpp:122 requestClearAlarm() 保留仅清警入口;新增复位请求及结果转发
services/productionservice.cpp:1032 clearAlarm(QString*) 保留只清警语义,补充异步完成结果
services/productionservice.cpp:883 stop(QString*,bool) 参考取消请求、设备清理、状态发布的顺序,不直接把 reset 转发为 stopOrder
services/productionservice.cpp:2598 finalizeRun(bool,bool,QString*) 复用订单/运行行锁、无测量删除、有测量保留的事务规则
services/deviceservice.cpp:439 terminate(OperationCallback) 参考通信取消和串行握手清理;当前只清当前动作、拍照、取料及 M852
services/deviceservice.cpp:869 clearSignals(command,feedback,callback) 复用写 command=false、feedback=false;该函数为私有方法
repositories/orderrepository.cpp:265 removeOrder(id,error) 清理订单级动作、运行、报警及订单记录
services/productionservice.cpp:201 saveVisionRecoveryState(pending,error) 持久化复位未完成/完成状态

已有测试模式:tests/termination、tests/orderdelete 使用 PG 临时表;tests/actiondispatch 使用本机模拟 PLC。tests 目录当前被 .gitignore 忽略,实施时保留本地测试并报告该事实,不擅自改忽略规则或提交。

3. 旧任务与新订单的边界

复位目标由后台读取实际活动 production_runs 确定,不能采用 Dashboard 当前选中的订单作为删除目标。

情况 处理
旧任务无任何测量记录 删除该旧订单、其工件、动作/运行/状态历史及关联报警,释放其料位,保留复位操作审计日志
旧任务已有测量记录 订单 FINISHED、运行 STOPPED;保留工件、测量及动作历史;本次不额外删除其中未检测工件
旧任务已在上次复位中删除或结束 视为业务数据收尾已完成,继续清理文件、内存和界面,不再次删除
无旧任务,只有软件/视觉遗留锁 不删除任何订单,清理遗留状态
新订单 NOT_START,无旧运行关联 不删除、不改成 FINISHED,不重新生成或清空其工件
正常完成的历史订单 保留,原删除限制继续有效
多个活动任务或目标身份矛盾 列明冲突,停止破坏性操作,不自动选择一个或批量删除

注意:createOrder() 当前另有全局清理无测量工件的行为。这不是复位步骤,本方案不扩大或改写它。已有测量工件及占用料位继续保留,复位不代表整架清空。

4. 入口与接口安排

采用一个专用复位入口,复用终止底层能力,不增加通用工作流框架、不新增数据库状态枚举。

以下接口已实现:

  • ProductionWorker::requestResetContext():只读获取后台旧任务摘要;返回成功或失败上下文,用于弹窗展示。
  • ProductionWorker::requestReset(const QJsonObject &context):携带用户确认的旧 run/order 身份、现场确认标志,不携带“选中订单即删除”的含义。
  • ProductionService::resetProduction(const QJsonObject &context, QString *error):受理复位并启动异步流程。
  • resetContextReady(context)、alarmOperationBusyChanged(busy)、alarmOperationFinished(resetRequested,success,message):传递弹窗数据、防重复状态及实际完成结果。
  • Snapshot 增加 resetInProgress 和 resetRequired,分别标识正在复位与上次复位尚未完成;后者阻止旧任务恢复,同时保留清警/复位入口。
  • Dashboard 完成后发 productionDataChanged();OrderPage/RackPage 各增加一个薄的 public refresh 槽,复用各自现有加载方法,由 Widget 连接。

上下文查询仅需要旧 run/order 身份和终态,不要求先成功恢复工件、料盘或动作检查点。查询失败仍可选择“仅清除报警”;不能把查询失败当作“没有旧任务”执行数据库删除。

弹窗显示将处理的旧任务和将保留的未开始订单。用户确认后后台重新检查目标:旧任务被另一个任务替换则拒绝过期操作;旧目标已结束/删除则按幂等收尾处理。后台再次查询是否有测量记录,弹窗期间新产生的测量记录必须得到保留。

当前 controlOperationContext() 会因旧 run 与 currentOrderId 不同、工件恢复资料缺失而返回空;复位不能依赖它作为唯一入口。

5. “仅清除报警”分支

  1. 发送现有配置 clearAlarmCommand。
  2. PLC 清警写入成功后,更新既有报警记录并记录结果。
  3. 通过完成信号通知 UI 成功或失败。
  4. 不取消动作、不改生产状态、不改订单、不清视觉文件、不重置重试次数。

clearAlarm() 现有返回 true 只表示异步请求已受理,不能用作“清警成功”。“清警命令已确认”与仍存在的真实设备故障需分别显示,不能保证写一次后所有外部故障都消失。

6. “清警并复位”后台顺序

A. 确认目标,进入互斥操作

  • 后台独立防重复,不仅依赖按钮禁用。
  • 真实关机/退出过程优先,不清掉 m_shutdownRequested 来抢占复位。
  • 取消旧人工恢复对话框的有效性,停止流程推进和状态采集,递增动作、恢复、视觉代次,阻止旧回调修改新状态。
  • 已发送请求视为可能到达 PLC;取消队列不等于设备动作已撤回。
  • 有旧运行时持久化 STOPPING;复位未完成标志落盘后才继续后续步骤。无旧运行不创建虚假 production_run。
  • 不在 PLC 异步通信期间持有数据库事务和行锁。

B. 清理通信与 PLC

  • 复用现有通信取消和串行请求清理逻辑,清理失效 pending/busy 状态。
  • 先完成软件请求收尾,再发送清警及握手复位,避免被旧 productionActionBusy 挡住。
  • 新增专用设备复位入口;复用 clearSignals 等底层代码,不改变正常终止的清理范围。
  • 按现有动作地址映射清理 PhotoMove、RackPick、FrontLoad、Inspect、FrontUnload、Flip、ReverseFlip、BackLoad、BackUnload、RackPlace 的 command/feedback,以及比较取料有效位。
  • 地址从配置获取、去重;拍照保持 M846/M844。只操作项目已定义的生产握手点,不清设备状态、急停输入、检测结果寄存器或整片 PLC 地址。
  • 旧反馈为 1 不作为拒绝进入复位的条件。正常动作发送前不读取 feedback 的现有规则不变。
  • 复位写入失败须报告具体动作/地址;必要的复位读回只验证写零结果,不恢复原动作的执行前反馈门槛。
  • 软件代码已有清反馈行为,但现场仍须按点表核实所有相关点的写入权限和 PLC 是否接受清零;不得推断物理归零已完成。

C. 结束旧任务的数据事务

  • 重新锁定目标订单及运行记录,核对不是其他新任务。
  • 再查询测量记录,包括通过工件关联找到的检测记录。
  • 无测量记录:按旧 orderId 清工件/动作/运行记录、释放料位、刷新料盘统计、删除旧订单。
  • 有测量记录:结束旧运行及旧订单,保留数据。
  • 操作日志与业务收尾放在同一事务。成功操作日志保留旧订单号、运行 ID、处理结果,不依赖已删除订单行。
  • 只在需要的地方提取现有终止收尾事务为局部共享方法,避免复位直接调用带初始化/动作恢复门槛的 stopOrder();不复制第二套 SQL,也不增加大范围抽象。
  • 当前 finalizeRun() 遇到 run 已 STOPPED/COMPLETED 或被删除会失败;复位调用前必须处理“此前已收尾”的分支,不能把幂等重试当错误。

D. 清理持久化和内存状态

  • 业务事务完成后保存视觉 pending=false,清理旧视觉结果、请求和目标身份。
  • 数据库与 JSON 文件不能跨介质原子提交:若事务已成功而文件失败,保留“复位未完成”状态;再次复位检测旧任务已结束,从剩余文件/内存步骤继续。
  • 复位成功时清空 runId/orderId/currentWorkpiece/checkpoint/位置,以及动作 starting/pending/poll/completed/error、检测读取 pending/ready/error、视觉锁和目标、旧人工恢复上下文、暂停请求、旧重试状态。
  • 停止标志仅在确认没有更新的终止/退出请求后清理;关机标志不作为普通锁清零。
  • m_initialized 与 m_persistenceUncertain 只能在数据库状态核对成功后更新,不能提前伪装成功。
  • 若中途退出或程序崩溃,STOPPING 或持久化 pending 标志应使重启后仍能继续复位,不能误恢复旧订单。

E. 验证并发布 Idle

  • 再确认没有剩余活动运行,旧回调已失效,设备清理结束,恢复文件已提交。
  • 发布 Idle、空工件、空位置和视觉可用状态,恢复设备采集,发出复位完成信号。
  • 启动按钮按原正常条件计算:存在 NOT_START 订单、工件已生成、初始化成功、无旧任务及遗留锁。
  • 不强行启用缺工件/配置不合法/PLC 断线情况下的启动;不自动启动新订单。

7. 失败、并发与按钮规则

情况 处理
PLC 不通或复位写入失败 旧任务尚未删除,显示失败步骤;允许重新清警/复位
数据库事务失败 回滚业务数据;PLC 已清理也不能宣告复位完成
COMMIT 应答不确定 重新查实际旧任务状态,再决定剩余步骤;不盲目重复删除
数据完成、文件失败 保留故障状态,再次复位只完成剩余步骤
已复位后再次点击“是” 幂等清警/复位,不删除新 NOT_START,不产生新运行
初始化失败但 run/order 可读取 允许专用复位,不要求先恢复旧工件动作
无旧任务但内存绑定旧 ID 清掉过期绑定,不据此操作新订单
复位期间迟到的设备/视觉回调 代次及任务身份校验后丢弃,不复活旧锁
用户取消选择 无副作用
程序退出与复位竞争 退出优先,保留未完成标记,不触发错误的成功通知

UI 在实际清警/复位进行中防重复,禁用启动、继续、恢复、标 NG 等冲突操作。复位失败后解除“本次操作忙”,保留具体错误并重新开放复位入口。

初始化失败或仅存在遗留恢复锁不能成为永久禁用按钮的理由;正在进行的真实终止/复位不重复启动。旧人工恢复会话可以由明确的复位操作取消。

8. 修改文件

文件 修改内容
pages/dashboardpage.h/.cpp 三选弹窗、后台目标摘要、结果提示、按钮规则、复位完成通知
services/productionworker.h/.cpp 上下文/复位请求及忙状态、完成信号转发
services/productionservice.h/.cpp 专用复位流程、持久化目标核对、旧任务收尾、全面内存清理及幂等处理
services/deviceservice.h/.cpp 专用全动作握手复位、通信收尾、失败地址反馈、恢复采集
modbus/modbustcpmanager.cpp 中止旧请求后释放旧连接,避免其异步断开误取消新的复位请求
repositories/orderrepository/productionrepository 仅在当前事务查询不足时补最小查询;沿用现有约束与删除规则
widget.cpp、pages/orderpage.h/.cpp、pages/rackpage.h/.cpp 复位后刷新订单列表和料位,调用现有加载方法
tests/ 增加隔离回归测试,保留原终止/删除/动作发送测试

不计划新增数据库表、削弱外键/NOT NULL、增加配置开关或改写正常生产状态机。保留既有就绪屏蔽、动作无限等待、正常动作发送前不检查 feedback 的行为;不顺手修改 ssp.pro.user。

9. 实施阶段和验收

阶段 1:先补回归场景

以现有临时表与 Fake PLC 模式复现旧问题:clearAlarm 后旧 run/视觉锁仍存在,新订单启动仍被拒绝。测试当前代码失败,作为修改前基线。

阶段 2:交互和目标身份

实现三选、只读目标摘要、身份重校验和异步完成信号。验证“取消零写入”“否只清警”“是只针对旧任务”“初始化失败仍能显示选择”。不改其他按钮确认行为。

阶段 3:复位收尾

实现通信/PLC 清理、旧任务事务、JSON 与内存收尾。验证所有清理对象来自目标旧任务;无测量自动删除、有测量保留;正常完成订单和新订单不受影响。

阶段 4:失败重试和界面刷新

注入通信、事务、COMMIT 应答、文件写入、迟到回调错误;验证可再次复位、无重复删除、不会误报 Idle。补齐控制面板、订单列表、料架显示刷新。

阶段 5:最终回归和构建

必测:

  1. 否/取消分支,不改变旧任务和动作锁。
  2. 运行、暂停、Error、ManualConfirm、等待反馈不超时均可发起复位。
  3. 无测量旧任务删除,料位释放,旧回调无效。
  4. 有测量旧任务保留,FINISHED/STOPPED,正常完成仍禁止删除。
  5. 无任务仅视觉锁,复位后重启不再锁住。
  6. 新 NOT_START 已存在,复位保留其订单和工件,随后能启动它。
  7. 无新订单时复位后可以创建、生成工件、启动新订单。
  8. 旧 run/order 与 UI 当前选中订单不同,不误删新单。
  9. 初始化失败、动作检查点缺失但旧任务可识别时可收尾。
  10. 多活动任务/身份变化被明确拒绝,不批量删除。
  11. 全部 10 类动作握手、M846/M844 和比较取料位的复位范围正确,不写其他地址。
  12. PLC 失败不删旧任务;事务失败数据回滚;文件失败和已提交删除均可幂等重试。
  13. 重复点击、复位后再次复位、旧视觉响应迟到、退出竞争。
  14. 复位结束状态采集和各页面刷新正常,不自动启动。
  15. 原 orderdelete、termination、actiondispatch 回归不退化,Qt 5.14.1 MinGW 构建及 git diff --check 通过。

测试仅使用本机模拟 PLC 和 PG9.5 会话临时表/独立测试环境,禁止通过验证操作真实订单或现场设备。用户已确认按本方案实施,不自动提交 Git。

10. 实施结果与独立验收记录

验收日期:2026-11-09。实际 PostgreSQL 版本为 9.5.3。数据库测试仅在当前连接创建临时表,设置 search_path=pg_temp,pg_catalog;复制表结构后将序列默认值替换为临时序列,再插入测试数据。PLC 测试只连接 127.0.0.1 的模拟服务器。UI 测试强制使用 SQLite 内存库、模拟设备及 FakeWorker。

已完成的行为

  • “清除报警”提供是/否/取消三选;默认否,复位需现场确认。仅清警保留旧任务及人工恢复会话,取消不提交操作。
  • 复位按数据库实际活动运行确定旧订单,重查确认身份及测量记录;旧任务无测量则删除,有测量则保留历史,新未开始订单与正常完成订单保留。
  • PLC 清警及全部配置动作握手清零、旧任务事务收尾、恢复文件写入均成功后,清空软件运行状态并发布 Idle;订单与料架页面收到刷新通知,不自动启动。
  • 文件写入失败、数据库回滚、通信失败及退出中断均保留未完成状态,可再次从清警入口复位。未完成复位不能走旧任务恢复入口。

实施中经回归发现并修复了三个边界问题:旧 Modbus 连接异步断开会干扰新的清警请求,因此中止时隔离旧 client 并在下一请求创建新连接;排队退出的原子标志不能被复位清零;仅清警等待期间迟到的人工恢复上下文应保留为暂时禁用的对话框,清警结束后重新开放。

验证证据

验证项 结果与实际覆盖
旧问题基线 tests/resetbaseline 修改前复现 ManualConfirm / activeRuns=1 / visionLock=1,断言进入 Idle 失败。该测试记录原问题;新方案的“仅清警”刻意保留这些状态,不将此基线列入应通过的最终测试集。
tests/resetdevice 通过。全部 10 类动作握手及比较取料位清零、M846/M844、地址去重、读回核验、不写额外线圈或寄存器;重复/冲突操作拒绝、写失败、读回仍为 1、重试、在途采集/动作取消、对象销毁及非法配置。日志:build/resetdevice/test-result.txt。
tests/resetproduction PostgreSQL 9.5.3 临时表测试通过。仅清警保留状态;未初始化/无检查点可复位;无测量删除与料位释放;已测量订单及其未测工件保留;确认期间新测量按工件关联识别;新单保留;过期身份/多个活动任务拒绝;已结束任务幂等;事务回滚;数据库提交成功后文件失败、重建服务后重试;断线、终止、在线/离线退出中断;外部退出标志不被吞;孤立锁清理及报警记录清除、恢复采集、迟到视觉结果无效。日志:build/resetproduction/test-result.txt。
新订单完整入口 在上述临时表测试内,复位后实际调用 OrderService::createOrder → generateWorkpiecesAndAssign → ProductionService::start,进入 WaitingDeviceReady,且仅有一条 RUNNING 运行。另验证复位不会自行启动已存在的新单。
tests/resetui 通过。默认否、现场勾选、Esc/关闭/取消零提交、查询失败仍能仅清警、旧任务身份不随当前选择改变、防重复、真实完成后才解除忙状态、仅成功复位刷新、未完成复位禁止恢复、No 保留原人工会话及迟到上下文、对话框析构与排队回复安全。
原回归 orderdelete 9 场景、termination 删除/保留/回滚、actiondispatch 10 动作直接发送及完成握手均通过。Modbus 修正后重新构建并通过后两项。日志:build/termination/test-result.txt、build/actiondispatch/test-result.txt。
构建与源码复核 Qt 5.14.1 MinGW 主程序构建成功,git diff --check 通过;独立核对实际运行目标、事务与文件顺序、退出优先、旧回调失效、Modbus 连接生命周期,以及 Widget 到订单/料架的刷新连接。

验证限制

  • 未注入 PostgreSQL “服务端已 COMMIT,但客户端未收到应答”的网络故障;已经测试事务回滚、已结束/已删除目标的幂等处理,以及提交成功后文件失败。不能将这些测试等同于 COMMIT 丢应答实测。
  • UI 自动化为 offscreen 交互逻辑测试。Qt 5.14 Windows 的 QMessageBox::showEvent 在该模式下存在原生窗口句柄问题,测试程序仅跳过该事件;没有验证现场 Windows 原生结果弹窗的实际显示。订单/料架整页刷新连接经源码核对,未连接现场业务数据做整窗联调。
  • 服务层在线/离线退出回调已测试;Worker 在复位退出失败后发出 shutdownReady 的分支经过源码复核,未实测真实窗口关闭与现场 PLC 断线的组合。
  • 未连接现场 PLC、机器人或相机运行整线。测试证明复位后可重新受理新订单,不能据此宣称机器人已回原点或整条自动化工序已完成现场验收。

新增测试保留在已有忽略规则下的 tests/,未修改该规则、未自动加入 Git。未新增数据库 schema、配置开关或迁移,也未改动现场动作地址配置。