6.0 KiB
生产状态与订单绑定修复
目标
修复生产线程仍持有旧订单、订单管理却删除该订单并切换到新订单,最终导致
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。若旧数据存在重复活动运行,
迁移失败并回滚,需先人工核对记录。应用不会自动修改业务数据库。
验证
NOT_START、CANCELED或异常遗留的FINISHED订单关联RUNNING、PAUSED、RECOVERY或STOPPING运行时, 删除必须失败并返回指定终止提示;订单、工件和运行记录均保持不变。- 没有活动运行的
NOT_START、CANCELED订单仍然可以删除。 - 人工终止后的
FINISHED + STOPPED订单:无测量记录时可删除;有测量记录时拒绝并保留追溯数据。 - 正常完成的
FINISHED + COMPLETED订单始终拒绝删除。ERROR不视为人工终止。 - 数据库查询失败时删除回滚,并返回原始数据库错误。
- PostgreSQL 并发验证:删除事务锁定订单后,并发创建运行必须等待;删除提交后, 创建运行因外键不存在而失败,不能在保护检查与删除之间成为活动运行。
- PostgreSQL 并发验证:已有非活动运行在删除检查后尝试切换到活动状态时必须等待, 不能在保护检查与删除之间改变删除结论。
- 端到端验证“启动或恢复订单 -> 控制面板终止 -> 运行变为
STOPPED-> 删除订单”成功。 - 构建项目,确认新增仓储接口及调用无编译错误。
自动化回归
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 联调。