feat(production): 修改订单加工位置不一致问题
-创建订单时解除所有占用 -修改数据库位置唯一约束 -严格按照订单起始位置分配 -订单启动时重新初始化位置
This commit is contained in:
@@ -0,0 +1,252 @@
|
||||
# 清除报警按钮:可选复位修改方案
|
||||
|
||||
日期: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、配置开关或迁移,也未改动现场动作地址配置。
|
||||
Reference in New Issue
Block a user