feat(production): 修改订单流程卡死流程问题

This commit is contained in:
lidg
2026-11-06 15:49:33 +08:00
parent 753f9c3ed2
commit 81313e61b0
24 changed files with 949 additions and 261 deletions
@@ -0,0 +1,91 @@
# 生产状态与订单绑定修复
## 目标
修复生产线程仍持有旧订单、订单管理却删除该订单并切换到新订单,最终导致
`ProductionService::m_orderId` 与控制面板 `currentOrderId` 不一致的问题。
## 行为规则
- `NOT_START` 或 `CANCELED` 订单没有活动生产运行时,保持现有行为,允许删除。
- 订单存在 `RUNNING`、`PAUSED`、`RECOVERY` 或 `STOPPING` 的 `production_runs` 记录时,拒绝删除。
- 拒绝信息明确提示:请先在控制面板终止订单,终止完成后再删除。
- 人工终止后,订单状态为 `FINISHED` 且最新生产运行状态为 `STOPPED`;没有测量记录时允许删除。
- 正常生产完成、最新运行状态为 `COMPLETED` 的 `FINISHED` 订单继续禁止删除。
- 保留 `ProductionService::stopOrder()` 的订单 ID 一致性校验,防止误终止其他订单。
## 实现
`OrderService::deleteOrder()` 在现有事务中通过 `findOrderForUpdate()` 读取并锁定
目标订单,锁持续到提交或回滚。该锁与 `production_runs.order_id` 外键检查配合,避免
“检查后、删除前”并发创建活动运行的竞态。
在 `ProductionRepository` 增加按订单 ID 查询并锁定全部生产运行状态的接口。
查询使用 `FOR UPDATE`,既锁定已有运行记录,也返回最新运行状态和是否存在活动运行;
接口通过返回值与输出参数区分查询失败和查询成功。订单行锁阻止并发插入新运行,
运行记录锁阻止并发把历史运行切换为活动状态。
`OrderService::deleteOrder()` 在删除工件和运行记录前根据锁定结果处理:
- 存在活动运行:回滚,返回“订单存在活动生产任务,请先在控制面板终止订单,终止完成后再删除”。
- 查询失败:回滚并原样返回数据库错误,不显示终止提示。
- `NOT_START`、`CANCELED` 且不存在活动运行:继续现有删除流程。
- `FINISHED`、最新运行为 `STOPPED` 且不存在测量记录:继续现有删除流程。
- 其他 `FINISHED` 订单:回滚,返回现有“已完成订单不能删除”提示。
## 生产状态同步
`ProductionService::Snapshot` 一次发布初始化结果、运行 ID、订单 ID、状态、错误和
是否必须继续终止。控制面板在初始化完成前禁用生产操作,失败后提供重新检查入口。
恢复查询先在局部变量中验证订单、工件及托盘,再绑定运行上下文。无活动运行时进入 Idle;
有活动运行时进入 Paused 或 ManualConfirm;多个活动运行拒绝自动选择。
界面把候选订单 `selectedOrderId` 与服务绑定的订单分开。活动运行期间,定时刷新始终
读取绑定订单,即使数据库出现其他未完成订单也不切换。终止请求携带用户确认的
runId 和 orderId,服务校验两者后才处理。
启动事务锁定订单,创建运行记录、将订单设为 RUNNING,并写入状态历史和操作日志。
提交后才发布 Preparing、发起 PLC 检查。检查失败时保留当前运行,按恢复流程处理。
终止先持久化 STOPPING,再在数据库事务之外清理设备握手。清理成功后,订单结束、
运行 STOPPED、状态历史与操作日志在同一事务内提交;失败则保持绑定并允许重试终止,
禁止恢复生产。成功后先清空运行、订单、工件、位置等上下文,再发布 Idle。
正常完成也采用同一事务收尾,但运行状态为 COMPLETED。
数据库提交应答丢失时,不假定提交成功或失败;禁用操作并提供重新检查入口,重新读取
数据库决定状态。UPDATE 影响行数不是 1 时返回失败,不再将不存在的运行视为更新成功。
## 数据库部署
新建数据库使用 `db/schema.sql`。已有数据库在生产停止期间执行
`db/migrations/2026-11-05-production-stopping.sql`。该事务添加 STOPPING 约束支持,
重建包含 STOPPING 的活动订单唯一索引,并更新版本至 9。若旧数据存在重复活动运行,
迁移失败并回滚,需先人工核对记录。应用不会自动修改业务数据库。
## 验证
1. `NOT_START`、`CANCELED` 或异常遗留的 `FINISHED` 订单关联 `RUNNING`、`PAUSED`、`RECOVERY` 或 `STOPPING` 运行时,
删除必须失败并返回指定终止提示;订单、工件和运行记录均保持不变。
2. 没有活动运行的 `NOT_START`、`CANCELED` 订单仍然可以删除。
3. 人工终止后的 `FINISHED + STOPPED` 订单:无测量记录时可删除;有测量记录时拒绝并保留追溯数据。
4. 正常完成的 `FINISHED + COMPLETED` 订单始终拒绝删除。`ERROR` 不视为人工终止。
5. 数据库查询失败时删除回滚,并返回原始数据库错误。
6. PostgreSQL 并发验证:删除事务锁定订单后,并发创建运行必须等待;删除提交后,
创建运行因外键不存在而失败,不能在保护检查与删除之间成为活动运行。
7. PostgreSQL 并发验证:已有非活动运行在删除检查后尝试切换到活动状态时必须等待,
不能在保护检查与删除之间改变删除结论。
8. 端到端验证“启动或恢复订单 -> 控制面板终止 -> 运行变为 `STOPPED` -> 删除订单”成功。
9. 构建项目,确认新增仓储接口及调用无编译错误。
## 自动化回归
- `tests/recovery_flow`:初始化失败及重试、STOPPING 恢复、旧身份拒绝、事务回滚、
提交应答丢失、Idle 快照清理、终止后删除并启动新订单、订单删除矩阵。
- `tests/recovery_ui`:初始化操作门禁、重试释放按钮、定时刷新保持绑定订单、确认上下文。
Windows Qt 5.14 的 QMessageBox 不支持 offscreen 后端;测试使用原生 windows 后端,
通过 WA_DontShowOnScreen 隐藏测试窗口。
- `tests/vision_production`:既有视觉、检查点及恢复回归。
- `tests/recovery_postgres`:独立 PostgreSQL 9.5 实例上的约束、STOPPING 唯一性、影响行数。
自动化测试使用隔离数据库或模拟设备,不替代现场 PLC 联调。
@@ -0,0 +1,15 @@
# PLC 连接即就绪
用户要求屏蔽 PLC、机器人就绪门槛。采用固定规则,不增加配置开关:完整状态读取成功且 PLC
连接有效时,plcReady 为 true;不再读取 M100。M101 保留采集用于显示,但不再限制启动、
恢复和后续动作。通信失败、无有效状态时仍不可推进生产。用户临时注释的门禁、急停等检查
保持现状,本次只修改就绪规则。
实施及验证:先用真实 PostgreSQL 与本机 FakePlc 复现 M100/M101 均为 0 时等待超时;
修改状态归一化与等待分支,移除无用 requireReady 参数;验证两个信号均为 0 时完整生产、
暂停继续及超时恢复正常,状态读取失败不能发送动作,最后编译应用。不操作现场 PLC。
验证结果:原实现已复现两个就绪位为 0 时进入 TimeoutPaused;修改后所选端到端回归
13 项通过(含初始化及清理),随后补充断连场景与不再读取 M100 的断言,专项 5 项通过。
生产恢复回归 45 项通过,完整应用编译通过。用户临时屏蔽的门禁检查对应 3 项测试未纳入本轮运行。
验证程序位于 `tmp/build-state-app/ssp.exe`;现场正在运行的 Qt Creator 构建目录需重新编译并重启生效。
@@ -0,0 +1,14 @@
# 关闭动作超时
用户已确认取消动作超时。删除 tick 中等待就绪与机械动作的超时暂停分支,以及无调用的
timeoutForState 方法。反馈轮询与动作检查点保留,未收到反馈时保持当前动作,不重复下发。
人工暂停仍等待当前动作完成,终止订单仍可中断等待。PLC 通信超时和视觉识别超时保持原逻辑。
原分阶段超时配置保留兼容读取,但不再限制机械动作;stateTimeoutMs 仍用于视觉 PLC 阶段。
验证:先复现超过原时长进入 TimeoutPaused,再验证延迟反馈仍可完成生产、暂停继续、
人工恢复和终止删除后启动下一单。保留用户临时注释的门禁等检查,不执行相关门禁测试。
仅使用独立测试数据库和本机 FakePlc,不操作现场 PLC,不提交 Git。
验证结果:修改前拍照延迟反馈测试复现 TimeoutPaused;修改后 10 类动作在原时限 200 ms
之外继续等待至少 700 ms,保持轮询且未重复发命令,反馈到达后完成订单。端到端回归
22 项、生产恢复回归 45 项通过(均含初始化与清理),完整应用编译通过。
@@ -0,0 +1,19 @@
# 孤立视觉锁的残留拍照反馈清理
用户确认现场拍照命令 M846、到位反馈 M844,M844 是完成后置位且允许上位机清零的
握手反馈。现场 M846=0、M844=1、取料命令/反馈均为 0,无活动运行记录。
用户已批准修改:孤立锁恢复允许这种反馈残留进入人工确认,确认后清反馈并读回,再解锁。
只对 Idle 下的孤立锁放宽“拍照反馈必须为 0”的诊断条件;拍照命令为 1、取料任一信号
为 1、通讯失败仍拒绝。活动订单恢复规则不变。诊断和提交均读取当前信号,提交后、
写入前及读回后核对恢复代次/停止状态与数据库是否出现活动任务。未经人工提交不写 PLC。
只清配置中的拍照反馈位,不发动作命令;清理未确认或读回非零则保留 pending=true。
成功后清恢复文件和内存锁,发布状态快照,不启动任何订单。提示按实际配置显示地址及数值。
测试用真实 PG9.5 与本机 FakePlc 覆盖 M846/M844 成功、取消、命令/取料非零、
写入超时、读回反馈重新置位、确认期间状态改变及正常全零解锁。现场不自动清信号或启动订单。
验证结果:原实现无法对 M844=1 弹出确认,测试已复现。修复后端到端 21 项、生产恢复
45 项通过(含初始化与清理),包含解锁读回期间退出、空闲时无效终止请求两个异步场景。
空闲退出使恢复回调失效,保留未完成的锁;无效终止不再破坏正在进行的恢复。
实际 Qt Creator 构建目录已编译成功,现场遗留锁仍由操作者在新程序内确认后清理。
@@ -0,0 +1,46 @@
# 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。其他部署环境仍需执行上述迁移。
@@ -0,0 +1,22 @@
# 视觉锁与订单生命周期修复
用户通过界面终止/删除后重建订单仍无法启动。现场数据库已无 production_runs,新订单
为 NOT_START,但 exe 旁视觉恢复文件 pending=true、run_id/workpiece_id=0。视觉锁独立于
订单保存,旧终止流程未清除此锁,退出又会把它写回;界面未明确展示遗留锁原因。
修改范围:
- 终止时清理当前动作、拍照和取料握手,清零并读回确认 M852;失败保持可重试终止状态。
- PLC 清理成功后保存 pending=false,再结束运行并复位视觉内存状态;活动任务正常退出同样清理。
- 状态快照携带视觉恢复标志,空闲时有遗留锁显示明确原因和“解除视觉遗留锁”入口。
- 历史 pending=true 不因订单删除被直接忽略,仍经现有 PLC 握手检查与人工确认解除。
空闲状态继承的孤立锁在退出时保留,不隐式复位设备或解锁。
- 视觉处理内部如果处于暂停/待核对却外部仍在运行状态,应明确进入人工确认,不能静默等待。
验证:真实 PG9.5 + 本机 FakePlc,拍照/视觉阶段终止或退出,删除重建、重启后启动新单;
终止信号清理失败不得解锁;孤立文件恢复仅解锁而不启动订单;界面禁用原因与恢复按钮同步。
保留用户就绪屏蔽、动作无限等待、公共安全检查临时注释,不自动提交,不操作现场 PLC。
结果:修改前视觉终止/退出留下恢复锁的测试失败,修复后端到端 13 项、界面 20 项、
生产恢复 45 项、视觉生产 34 项、设备握手 7 项通过,合计 119 项 QtTest 结果(含初始化/清理)。
实际 Qt Creator 构建目录已编译成功。现场旧恢复文件保持不变,可通过“解除视觉遗留锁”
读取握手并人工确认后解除;业务库和现场 PLC 未被测试改写。
@@ -0,0 +1,17 @@
# 视觉准备阻塞修复
现场 enabled=false,但运行停在 VISION/NOT_SENT,安全门汇总为 false。公共安全检查
被用户临时注释,而 visionCurrent 仍单独检查安全门和急停,导致普通取料模式写入前直接
返回,反复准备而不推进。
用户随后明确要求相机不判断公共安全条件。最终修改:visionCurrent 不再独立判断安全门
和急停,由生产流程 checkRecoverySafety 统一负责;保留 PLC 状态有效、连接、动作上下文、
停止标志及异步回调代次校验。prepareVision 对无效上下文明确报错,防止再次静默循环。
用户临时注释的公共安全检查保持原样,本次没有恢复这些检查。
验证:公共检查当前被注释时,安全门/急停反馈不会单独阻断视觉关闭后的普通取料;
视觉关闭、视觉开启但无进程连接均能完成生产。保留暂停、恢复、终止及失效上下文回归。
只使用本机 FakePlc 与独立测试数据库,不操作现场 PLC,不提交 Git。
验证结果:最终策略在旧实现上复现被 ManualConfirm 阻断,修改后端到端 12 项、视觉生产
回归 34 项通过(含初始化与清理),完整应用编译成功。未执行要求公共门禁生效的旧用例。