Skip to content

现场操作验收清单 ​

本页用于首次交付、版本升级和现场复测,按本次实际交付的功能确认启动、设备、流程、结果与外部系统是否符合预期。验收结论限定于记录中的版本、配置、设备和场景;一次流程成功不能证明所有场景或长期运行稳定。

先按跨模块运行问题定位确定责任模块,再使用下表及对应功能文档。设备控制、通电、运动、数据库修改和远端写入须在现场授权范围内进行;只读审查只列计划与缺口,不执行这些操作。文档校验、模拟测试和既有日志不能替代本次真机验收。

使用方式 ​

  1. 记录主程序、项目包、插件包版本及配置位置,选择实际交付的设备、流程和输出;未交付功能标为“不适用”并说明原因。
  2. 为每个选中项写明输入、预期结果和判断依据,再执行获准的最小动作。使用同一 SN、批次、请求 ID 或时间范围串起界面、日志、记录与文件。
  3. 将实际结果与预期逐项比较,保存足以复核的脱敏证据。错误已经记录或能够定位失败节点,不表示该业务通过。
  4. 记录未完成项、负责人及下一步;版本或配置改变后,重验受影响项。回退材料准备与实际回退演练分开记录。
状态使用条件
通过在记录的条件下执行,实际结果符合预期且有证据
失败已执行,但结果或必要证据不符合预期
未测尚未执行,或条件不足以作出结论;写明缺口
不适用不属于本次交付范围;写明理由

空白项不能默认算通过。故障后的重试结果应关联原失败及处理措施,避免只保留最后一次成功。

验收总表 ​

验收项最小动作通过标准失败先看
主程序启动启动 ColorVision,打开主窗口主窗口、菜单、状态栏、日志入口可见主窗口导览、日志查看器
UI 组件入口打开本次交付实际需要的设置、日志、数据库、Socket、调度或插件市场窗口目标入口可见且无启动级错误;窗口出现不证明相关服务或业务完成UI 组件与源码目录
配置保存在获准的隔离配置上修改、保存并重启重启后值仍在,相关服务状态正确;先确认编辑会话模式,关闭窗口不一定撤销改值PropertyGrid 编辑与持久化
设备服务检查本次实际装配的设备与授权功能;不以有工厂推断默认显示或支持某项操作资源、运行实例、显示页、在线状态和获准动作分别有证据设备装配契约、具体设备页
相机取图连接相机,拍一张图或打开实时预览图像生成并能在图像编辑器打开相机服务、ImageEditor
流程设计打开现场流程模板,确认起始节点和关键节点参数流程能保存、重新打开,设备/模板绑定正确Flow 编辑工作区
流程执行在已确认安全的环境中运行目标最小流程或项目流程同一轮最终状态与预期一致,结果可追踪;能定位失败节点仅证明诊断有效,不算业务通过Flow 执行会话与最终化
图像与 overlay打开一张结果图并查看 ROI/POI/overlay图像、图层和坐标对齐ImageEditor、Engine 结果展示链路
数据落库按本模块的 SN、时间或批次查本次结果对应存储中有同一轮记录,必需字段、单位和判定符合业务要求数据库连接与 DAO 契约
文件导出导出 CSV/Excel/图片或项目结果文件存在、字段顺序和客户格式正确数据导出与导入、项目页
Socket/MES/Modbus发送本项目约定的最小命令或联机样例请求与最终业务结果可关联,外部系统收到预期状态码/数据;只收到受理 ACK 不算完成SocketProtocol、项目包总览
插件能力打开现场插件并执行最小功能插件菜单、窗口、设备连接、结果或导出正常现有插件能力说明
项目包流程打开客户项目,输入 SN,运行最小流程客户结果、文件、Socket/MES 返回符合项目页项目说明
回退材料核对上一版包、匹配配置和所需数据库备份材料可读取、版本与范围明确,恢复步骤及负责人可定位;是否已演练另行记录插件或项目包总览、现场记录

设备验收 ​

设备验收不要只看“列表里有”。要证明设备能被使用,并能被流程或项目包引用。

检查项通过标准
设备资源关键设备已经创建,名称和 Code 能区分现场真实设备
通信参数IP、端口、串口、波特率、设备号、文件路径与现场一致
最小动作只执行本次获准且符合现场安全条件的动作,记录请求与实际响应;电机回零、SMU 通电、文件上传不是默认无风险检查
流程引用流程节点或项目窗口能选到正确设备
日志证据连接、超时、驱动、权限错误已经处理或记录

如果手动设备页能操作,但流程里失败,优先查流程节点绑定和模板参数;如果设备页也失败,优先查硬件、驱动、端口/IP 和服务配置。

流程验收 ​

先确认本次运行使用的工作区、模板、起始节点及设备/图片/SN 绑定,说明执行的是当前画布还是已保存版本。等待该入口规定的最终状态,再核对需要的结果、图像、持久记录及导出。

共享 Flow 会话按最终化契约区分引擎结束和后处理返回;项目自有入口按项目文档判断。失败节点和日志用于定位问题,不能代替成功结果;稳定性验收还须预先定义重复次数、持续时间和可接受失败条件。

数据和导出验收 ​

交付物验收方式重点
SQLite/MySQL按 SN、时间、批次查询批次、模板、结果字段是否匹配
CSV/Excel打开文件核对字段和单位字段顺序、PASS/FAIL、客户旧格式兼容
图片/overlay打开结果图并查看标注点位、框线、图层和原图坐标
Socket/MES 返回保存请求和响应样例状态码、错误信息、Data 字段
Summary/文本核对产量、良率、失败项目录、文件名、模型分组、统计口径

如果导出为空,不要只重试导出按钮。先确认源数据是否存在于该模块使用的数据库、内存结果或图像中,当前查看的批次和导出对象是否一致,再查项目 exporter 或字段映射。

外部系统验收 ​

外部系统联调至少保留一组原始请求和响应。不同项目的协议不同,不能用一个项目的命令去验另一个项目。

类型最小证据
JSON Socket请求与响应 JSON、EventName、MsgID 或项目约定的关联字段、进程/模块状态
文本 Socket本项目约定的原始命令、终止符、返回码和数据
MES/串口原始报文及协议约定的帧边界(如 STX/ETX)、设备号、返回码、超时
ModbusIP、端口、寄存器地址、触发值、完成写回值
文件服务器请求路径、返回文件列表、下载/上传目标路径

外部系统能连上但业务没跑时,先查当前进程和 handler、协议模式、输入与设备/流程前提。仅在该项目明确依赖窗口时检查窗口是否打开;支持无窗口调用的模块不应套用这一前提。区分接收、受理、完成和外部确认,按具体协议保存对应证据。

交付记录模板 ​

text
现场/客户:
主程序/项目包/插件包版本:
配置位置与本次适用范围:
设备、连接方式和必要环境:
负责人/日期:

验收项:
输入与关联标识(SN/批次/请求 ID/时间范围):
预期结果与依据:
实际结果:
状态(通过/失败/未测/不适用):
证据位置(脱敏日志/截图/记录/文件/请求与响应):
失败或未测原因、处理措施与复测结果:

回退包/配置/数据库备份位置及对应版本:
恢复步骤/负责人:
回退演练状态与证据(未演练须明确):
剩余问题/后续负责人:
操作员培训情况(如适用):

基于 MIT License 发布。