diff --git a/db/migrations/2026-11-09-reuse-tray-positions.sql b/db/migrations/2026-11-09-reuse-tray-positions.sql new file mode 100644 index 0000000..66a6f8d --- /dev/null +++ b/db/migrations/2026-11-09-reuse-tray-positions.sql @@ -0,0 +1,14 @@ +begin; + +-- Current physical occupancy is represented by tray_slots. Historical +-- workpieces may keep the same tray position across different orders. +drop index if exists public.ux_workpieces_tray_position; + +insert into public.schema_version (id, version, description) +values (1, 11, 'Allow historical workpieces to reuse tray positions') +on conflict (id) do update +set version = excluded.version, + description = excluded.description, + updated_at = now(); + +commit; diff --git a/db/schema.sql b/db/schema.sql index 0972751..699b9c7 100644 --- a/db/schema.sql +++ b/db/schema.sql @@ -56,10 +56,6 @@ create table if not exists workpieces ( updated_at timestamp not null default now() ); -create unique index if not exists ux_workpieces_tray_position -on workpieces(tray_id, tray_pos) -where tray_id is not null and tray_pos > 0; - create table if not exists tray_slots ( id bigserial primary key, tray_id bigint not null references trays(id) on delete cascade, @@ -119,7 +115,7 @@ create table if not exists schema_version ( ); insert into schema_version (id, version, description) -values (1, 10, 'Support reverse flip production checkpoints') +values (1, 11, 'Allow historical workpieces to reuse tray positions') on conflict (id) do update set version = excluded.version, description = excluded.description, diff --git a/docs/plans/2026-11-09-clear-alarm-reset-plan.md b/docs/plans/2026-11-09-clear-alarm-reset-plan.md new file mode 100644 index 0000000..e440c19 --- /dev/null +++ b/docs/plans/2026-11-09-clear-alarm-reset-plan.md @@ -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、配置开关或迁移,也未改动现场动作地址配置。 diff --git a/pages/orderpage.cpp b/pages/orderpage.cpp index c9d8834..024b812 100644 --- a/pages/orderpage.cpp +++ b/pages/orderpage.cpp @@ -254,6 +254,7 @@ void OrderPage::createOrder() } loadOrders(); + emit productionDataChanged(); emit logRequested("操作日志", "订单管理", "新建订单", "创建订单:" + order.no, "成功"); } @@ -282,6 +283,7 @@ void OrderPage::generateSelectedWorkpieces() } loadOrders(); + emit productionDataChanged(); emit logRequested("操作日志", "订单管理", "生成工件", "生成并分配订单 " + orderNo + " 的工件", "成功"); } diff --git a/pages/orderpage.h b/pages/orderpage.h index 656329a..7062789 100644 --- a/pages/orderpage.h +++ b/pages/orderpage.h @@ -20,6 +20,7 @@ public slots: void refresh(); signals: + void productionDataChanged(); void logRequested(const QString &type, const QString &module, const QString &action, const QString &content, const QString &status); diff --git a/repositories/trayrepository.cpp b/repositories/trayrepository.cpp index e2c82e2..6f868af 100644 --- a/repositories/trayrepository.cpp +++ b/repositories/trayrepository.cpp @@ -175,6 +175,24 @@ bool TrayRepository::assignSlot(int trayId, int rowNo, int columnNo, int workpie return true; } +bool TrayRepository::clearAllSlots(int *releasedCount, QString *error) +{ + if (!ensureOpen(error)) { + return false; + } + + QSqlQuery query(DatabaseManager::instance().database()); + if (!query.exec("update tray_slots set workpiece_id = null, state = 'EMPTY' " + "where workpiece_id is not null or state <> 'EMPTY'")) { + setError(query, error); + return false; + } + if (releasedCount) { + *releasedCount = query.numRowsAffected(); + } + return true; +} + bool TrayRepository::refreshStats(int trayId, QString *error) { if (!ensureOpen(error)) { @@ -239,18 +257,21 @@ bool TrayRepository::updateSlotState(int trayId, int rowNo, int columnNo, const } QSqlQuery query(DatabaseManager::instance().database()); - query.prepare("insert into tray_slots (tray_id, row_no, column_no, workpiece_id, state) " - "values (:tray_id, :row_no, :column_no, :workpiece_id, :state) " - "on conflict (tray_id, row_no, column_no) do update set " - "workpiece_id = excluded.workpiece_id, state = excluded.state"); + query.prepare("update tray_slots set state = :state " + "where tray_id = :tray_id and row_no = :row_no " + "and column_no = :column_no and workpiece_id = :workpiece_id"); query.bindValue(":tray_id", trayId); query.bindValue(":row_no", rowNo); query.bindValue(":column_no", columnNo); - query.bindValue(":workpiece_id", workpieceId > 0 ? QVariant(workpieceId) : QVariant(QVariant::Int)); + query.bindValue(":workpiece_id", workpieceId); query.bindValue(":state", state); if (!query.exec()) { setError(query, error); return false; } + if (query.numRowsAffected() != 1) { + if (error) *error = "Tray slot is no longer assigned to this workpiece"; + return false; + } return true; } diff --git a/repositories/trayrepository.h b/repositories/trayrepository.h index 7468733..b6ebd11 100644 --- a/repositories/trayrepository.h +++ b/repositories/trayrepository.h @@ -15,6 +15,8 @@ public: QString *error = nullptr); bool assignSlot(int trayId, int rowNo, int columnNo, int workpieceId, const QString &state, QString *error = nullptr); + bool clearAllSlots(int *releasedCount = nullptr, + QString *error = nullptr); bool refreshStats(int trayId, QString *error = nullptr); bool upsertTray(const Tray &tray, QString *error = nullptr); bool updateSlotState(int trayId, int rowNo, int columnNo, const QString &state, diff --git a/repositories/workpiecerepository.cpp b/repositories/workpiecerepository.cpp index e89faa9..959377a 100644 --- a/repositories/workpiecerepository.cpp +++ b/repositories/workpiecerepository.cpp @@ -105,10 +105,15 @@ bool WorkpieceRepository::claimNextPending(int orderId, Workpiece *workpiece, *workpiece = Workpiece(); QSqlQuery query(DatabaseManager::instance().database()); query.prepare("with candidate as (" - "select id from workpieces " - "where order_id = :order_id and state = 'PENDING' " - "order by tray_id nulls last, tray_pos, id " - "for update skip locked limit 1" + "select w.id from workpieces w " + "join trays t on t.id = w.tray_id " + "join tray_slots ts on ts.tray_id = w.tray_id " + "and ts.row_no = w.row_no and ts.column_no = w.column_no " + "and ts.workpiece_id = w.id and ts.state = 'PENDING' " + "where w.order_id = :order_id and w.state = 'PENDING' " + "order by t.rack_row nulls last, t.rack_column nulls last, " + "w.tray_pos, w.id " + "for update of w skip locked limit 1" ") " "update workpieces w set state = 'PROCESSING', " "process_step = 'WAITING_DEVICE_READY', updated_at = now() " @@ -120,6 +125,18 @@ bool WorkpieceRepository::claimNextPending(int orderId, Workpiece *workpiece, return false; } if (!query.next()) { + QSqlQuery pending(DatabaseManager::instance().database()); + pending.prepare("select exists (select 1 from workpieces " + "where order_id = :order_id and state = 'PENDING')"); + pending.bindValue(":order_id", orderId); + if (!pending.exec() || !pending.next()) { + setError(pending, error); + return false; + } + if (pending.value(0).toBool()) { + if (error) *error = "待加工工件与当前料位绑定不一致,不能继续生产"; + return false; + } return true; } diff --git a/services/orderservice.cpp b/services/orderservice.cpp index 90d1ec2..c842813 100644 --- a/services/orderservice.cpp +++ b/services/orderservice.cpp @@ -9,8 +9,12 @@ #include #include +#include +#include #include +#include + namespace { bool recordLog(const QString &action, const QString &content, const QString &status, @@ -35,6 +39,46 @@ QString workpieceBarcode(const QString &orderNo, int sequence) return QString("%1-%2").arg(orderNo).arg(sequence, 6, 10, QChar('0')); } +bool validateAllocationRange(const Order &order, const QList &trays, + QString *error) +{ + const int startTrayIndex = order.startTrayNo - 1; + const qint64 lastOffset = qint64(order.startSlotNo) - 1 + order.planNum - 1; + const qint64 endTrayIndex = startTrayIndex + lastOffset / 49; + if (startTrayIndex < 0 || lastOffset < 0 || startTrayIndex >= trays.size() + || endTrayIndex >= trays.size()) { + if (error) *error = "订单起始位置后的托盘容量不足"; + return false; + } + for (int trayIndex = startTrayIndex; trayIndex <= endTrayIndex; ++trayIndex) { + if (!trays.at(trayIndex).present) { + if (error) *error = QString("托盘 %1 未在位").arg(trayIndex + 1); + return false; + } + } + return true; +} + +bool ensureTrayPositionMigration(QString *error) +{ + const QSqlDatabase database = DatabaseManager::instance().database(); + if (database.driverName() == "QSQLITE") return true; + + QSqlQuery query(database); + if (!query.exec("select to_regclass('public.ux_workpieces_tray_position')") + || !query.next()) { + if (error) *error = query.lastError().text(); + return false; + } + if (!query.value(0).isNull()) { + if (error) { + *error = "请先执行 db/migrations/2026-11-09-reuse-tray-positions.sql"; + } + return false; + } + return true; +} + } OrderService &OrderService::instance() @@ -125,20 +169,47 @@ bool OrderService::createOrder(Order *order, QString *error) return false; } - WorkpieceRepository workpieceRepository; TrayRepository trayRepository; - QList affectedTrayIds; - int removedCount = 0; - if (!workpieceRepository.removeUninspected( - 0, &affectedTrayIds, &removedCount, &transactionError)) { + ProductionRunSnapshot activeRun; + if (!ProductionRepository().findActiveRun(&activeRun, &transactionError)) { database.rollback(); if (error) { - *error = "新建订单前清理未测量工件失败:" + transactionError; + *error = transactionError; } return false; } - for (const int trayId : affectedTrayIds) { - if (!trayRepository.refreshStats(trayId, &transactionError)) { + if (activeRun.id > 0) { + database.rollback(); + if (error) { + *error = "存在活动生产任务,请先终止或复位后再创建订单"; + } + return false; + } + if (!ensureTrayPositionMigration(&transactionError)) { + database.rollback(); + if (error) *error = transactionError; + return false; + } + + const QList trays = trayRepository.listTrays(&transactionError); + if (!transactionError.isEmpty()) { + database.rollback(); + if (error) *error = transactionError; + return false; + } + if (!validateAllocationRange(*order, trays, &transactionError)) { + database.rollback(); + if (error) *error = transactionError; + return false; + } + int releasedCount = 0; + if (!trayRepository.clearAllSlots(&releasedCount, &transactionError)) { + database.rollback(); + if (error) *error = "新建订单前解除料位占用失败:" + transactionError; + return false; + } + for (const Tray &tray : trays) { + if (!trayRepository.refreshStats(tray.id, &transactionError)) { database.rollback(); if (error) { *error = "重新统计料盘占用失败:" + transactionError; @@ -154,10 +225,10 @@ bool OrderService::createOrder(Order *order, QString *error) } return false; } - if (removedCount > 0 - && !recordLog("清理未测量工件", - QString("新建订单前清理 %1 个未测量工件") - .arg(removedCount), + if (releasedCount > 0 + && !recordLog("解除料位占用", + QString("新建订单前解除 %1 个料位占用,保留历史工件及检测数据") + .arg(releasedCount), "成功", &transactionError)) { database.rollback(); if (error) { @@ -217,6 +288,11 @@ bool OrderService::generateWorkpiecesAndAssign(int orderId, QString *error) } return false; } + if (!ensureTrayPositionMigration(&transactionError)) { + database.rollback(); + if (error) *error = transactionError; + return false; + } WorkpieceRepository workpieceRepository; TrayRepository trayRepository; @@ -245,6 +321,11 @@ bool OrderService::generateWorkpiecesAndAssign(int orderId, QString *error) } return false; } + if (!validateAllocationRange(order, trays, &transactionError)) { + database.rollback(); + if (error) *error = transactionError; + return false; + } for (const Tray &tray : trays) { if (!trayRepository.initializeSlots(tray.id, 7, 7, &transactionError)) { database.rollback(); @@ -256,12 +337,8 @@ bool OrderService::generateWorkpiecesAndAssign(int orderId, QString *error) } QSet existingBarcodes; - int assignedCount = 0; for (const Workpiece &workpiece : workpieces) { existingBarcodes.insert(workpiece.barcode); - if (workpiece.trayId > 0) { - ++assignedCount; - } } const int missingCount = order.planNum - workpieces.size(); @@ -287,91 +364,66 @@ bool OrderService::generateWorkpiecesAndAssign(int orderId, QString *error) ++nextSequence; } - const int requiredSlotCount = order.planNum - assignedCount; - QList emptySlots; - if (requiredSlotCount > 0) { - const int startTrayIndex = order.startTrayNo - 1; - if (startTrayIndex < 0 || startTrayIndex >= trays.size()) { + std::sort(workpieces.begin(), workpieces.end(), + [](const Workpiece &left, const Workpiece &right) { + return left.id < right.id; + }); + const int startTrayIndex = order.startTrayNo - 1; + + QList touchedTrayIds; + bool allocationChanged = missingCount > 0; + for (int index = 0; index < workpieces.size(); ++index) { + const int offset = order.startSlotNo - 1 + index; + const int trayIndex = startTrayIndex + offset / 49; + const int position = offset % 49 + 1; + const Tray &tray = trays.at(trayIndex); + const int rowNo = (position - 1) / 7 + 1; + const int columnNo = (position - 1) % 7 + 1; + const QList traySlots = trayRepository.listSlots(tray.id, &transactionError); + if (!transactionError.isEmpty() || traySlots.size() != 49) { database.rollback(); - if (error) { - *error = QString("Start tray %1 is outside the configured tray range") - .arg(order.startTrayNo); - } + if (error) *error = transactionError.isEmpty() ? "托盘格位数据不完整" : transactionError; return false; } - - for (int trayIndex = startTrayIndex; - trayIndex < trays.size() && emptySlots.size() < requiredSlotCount; - ++trayIndex) { - const Tray &tray = trays.at(trayIndex); - if (!tray.present) { - continue; + const TraySlot &slot = traySlots.at(position - 1); + const Workpiece &workpiece = workpieces.at(index); + if (workpiece.trayId > 0) { + if (workpiece.trayId != tray.id || workpiece.trayPos != position + || workpiece.rowNo != rowNo || workpiece.columnNo != columnNo + || workpiece.state != "PENDING" + || slot.workpieceId != workpiece.id || slot.state != "PENDING") { + database.rollback(); + if (error) *error = "已有工件分配与订单起始位置不一致"; + return false; } - - const QList traySlots = - trayRepository.listSlots(tray.id, &transactionError); - if (!transactionError.isEmpty()) { + } else { + if (slot.workpieceId != 0 || slot.state != "EMPTY" + || !workpieceRepository.assignToSlot(workpiece.id, tray.id, position, + rowNo, columnNo, &transactionError) + || !trayRepository.assignSlot(tray.id, rowNo, columnNo, + workpiece.id, "PENDING", &transactionError)) { database.rollback(); if (error) { - *error = transactionError; + *error = transactionError.isEmpty() + ? QString("托盘 %1 位置 %2 已被占用").arg(trayIndex + 1).arg(position) + : transactionError; } return false; } - - for (const TraySlot &slot : traySlots) { - const int position = (slot.rowNo - 1) * 7 + slot.columnNo; - if (trayIndex == startTrayIndex && position < order.startSlotNo) { - continue; - } - if (slot.workpieceId == 0 && slot.state == "EMPTY") { - emptySlots.append(slot); - if (emptySlots.size() >= requiredSlotCount) { - break; - } - } + allocationChanged = true; + if (!touchedTrayIds.contains(tray.id)) { + touchedTrayIds.append(tray.id); } } } - if (!transactionError.isEmpty()) { - database.rollback(); - if (error) { - *error = transactionError; - } - return false; - } - if (emptySlots.size() < requiredSlotCount) { - database.rollback(); - if (error) { - *error = QString("Not enough empty slots: required %1, available %2") - .arg(requiredSlotCount).arg(emptySlots.size()); - } - return false; - } - QList touchedTrayIds; - int slotIndex = 0; - for (const Workpiece &workpiece : workpieces) { - if (workpiece.trayId > 0) { - continue; - } - - const TraySlot &slot = emptySlots.at(slotIndex++); - if (!workpieceRepository.assignToSlot(workpiece.id, slot.trayId, - (slot.rowNo - 1) * 7 + slot.columnNo, - slot.rowNo, slot.columnNo, - &transactionError) - || !trayRepository.assignSlot(slot.trayId, slot.rowNo, slot.columnNo, - workpiece.id, "PENDING", - &transactionError)) { + if (!allocationChanged) { + if (!database.commit(&transactionError)) { database.rollback(); - if (error) { - *error = transactionError; - } + if (error) *error = transactionError; return false; } - if (!touchedTrayIds.contains(slot.trayId)) { - touchedTrayIds.append(slot.trayId); - } + return true; } for (const int trayId : touchedTrayIds) { @@ -398,6 +450,50 @@ bool OrderService::generateWorkpiecesAndAssign(int orderId, QString *error) return true; } +bool OrderService::validateWorkpieceAllocation(int orderId, QString *error) +{ + Order order; + if (!OrderRepository().findOrder(orderId, &order, error)) return false; + QString validationError; + const QList trays = TrayRepository().listTrays(&validationError); + QList workpieces = WorkpieceRepository().listByOrder(orderId, &validationError); + if (!validationError.isEmpty()) { if (error) *error = validationError; return false; } + if (!validateAllocationRange(order, trays, error)) return false; + if (workpieces.size() != order.planNum) { + if (error) *error = "订单工件数量与计划数量不一致"; + return false; + } + const int startTrayIndex = order.startTrayNo - 1; + for (int index = 0; index < order.planNum; ++index) { + const int offset = order.startSlotNo - 1 + index; + const int trayIndex = startTrayIndex + offset / 49; + const int position = offset % 49 + 1; + const Tray &tray = trays.at(trayIndex); + const QList traySlots = TrayRepository().listSlots(tray.id, &validationError); + if (!validationError.isEmpty() || traySlots.size() != 49) { + if (error) *error = validationError.isEmpty() ? "托盘格位数据不完整" : validationError; + return false; + } + const TraySlot &slot = traySlots.at(position - 1); + bool matched = false; + for (const Workpiece &workpiece : workpieces) { + if (workpiece.trayId == tray.id && workpiece.trayPos == position + && workpiece.rowNo == slot.rowNo && workpiece.columnNo == slot.columnNo + && slot.workpieceId == workpiece.id && slot.state == "PENDING" + && workpiece.state == "PENDING") { + matched = true; + break; + } + } + if (!matched) { + if (error) *error = QString("托盘 %1 位置 %2 的工件分配不一致") + .arg(trayIndex + 1).arg(position); + return false; + } + } + return true; +} + bool OrderService::startOrder(int id, QString *error) { return transition(id, QStringList() << "NOT_START", "RUNNING", "开始订单", error); diff --git a/services/orderservice.h b/services/orderservice.h index d89ef9d..89e19a6 100644 --- a/services/orderservice.h +++ b/services/orderservice.h @@ -15,6 +15,7 @@ public: bool findUnfinishedOrder(Order *order, QString *error = nullptr); bool createOrder(Order *order, QString *error = nullptr); bool generateWorkpiecesAndAssign(int orderId, QString *error = nullptr); + bool validateWorkpieceAllocation(int orderId, QString *error = nullptr); bool startOrder(int id, QString *error = nullptr); bool pauseOrder(int id, QString *error = nullptr); bool resumeOrder(int id, QString *error = nullptr); diff --git a/services/productionservice.cpp b/services/productionservice.cpp index 0890165..acc660e 100644 --- a/services/productionservice.cpp +++ b/services/productionservice.cpp @@ -592,6 +592,10 @@ bool ProductionService::start(int orderId, QString *error) if (error) *error = "订单状态已改变或存在待恢复的生产任务,请重新核对"; return false; } + if (!OrderService::instance().validateWorkpieceAllocation(orderId, error)) { + database.rollback(); + return false; + } const int newRunId = ProductionRepository().createRun( orderId, "PREPARING", "PREPARING", order.inspectionMode, @@ -621,8 +625,8 @@ bool ProductionService::start(int orderId, QString *error) } m_inspectionMode = order.inspectionMode; - m_currentTrayNo = 0; - m_currentSlotNo = 0; + m_currentTrayNo = order.startTrayNo; + m_currentSlotNo = order.startSlotNo; m_frontRawResult = 0; m_actionPending = false; m_actionStarting = false; @@ -657,6 +661,7 @@ bool ProductionService::start(int orderId, QString *error) m_state = Preparing; m_stateTimer.restart(); publishState(); + emit currentPositionChanged(m_currentTrayNo, m_currentSlotNo); publishVisionControl(); m_deviceService->startPolling(); diff --git a/ssp.pro.user b/ssp.pro.user index 9a81674..895b074 100644 --- a/ssp.pro.user +++ b/ssp.pro.user @@ -1,6 +1,6 @@ - + EnvironmentId diff --git a/widget.cpp b/widget.cpp index 98418df..a0ef900 100644 --- a/widget.cpp +++ b/widget.cpp @@ -137,6 +137,8 @@ void Widget::setupMainArea(QVBoxLayout *rootLayout) orderPage, &OrderPage::refresh); connect(dashboardPage, &DashboardPage::productionDataChanged, rackPage, &RackPage::refresh); + connect(orderPage, &OrderPage::productionDataChanged, + rackPage, &RackPage::refresh); DevicePage *devicePage = new DevicePage(this); logPage = new LogPage(this); qualityPage = new QualityPage(this);