Files
ssp/docs/superpowers/specs/2026-11-05-active-run-order-deletion-design.md
T

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。若旧数据存在重复活动运行, 迁移失败并回滚,需先人工核对记录。应用不会自动修改业务数据库。

验证

  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 联调。