92 lines
6.0 KiB
Markdown
92 lines
6.0 KiB
Markdown
# 生产状态与订单绑定修复
|
|
|
|
## 目标
|
|
|
|
修复生产线程仍持有旧订单、订单管理却删除该订单并切换到新订单,最终导致
|
|
`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 联调。
|
|
|