现场操作验收清单
本页用于首次交付、版本升级和现场复测,按本次实际交付的功能确认启动、设备、流程、结果与外部系统是否符合预期。验收结论限定于记录中的版本、配置、设备和场景;一次流程成功不能证明所有场景或长期运行稳定。
先按跨模块运行问题定位确定责任模块,再使用下表及对应功能文档。设备控制、通电、运动、数据库修改和远端写入须在现场授权范围内进行;只读审查只列计划与缺口,不执行这些操作。文档校验、模拟测试和既有日志不能替代本次真机验收。
使用方式
- 记录主程序、项目包、插件包版本及配置位置,选择实际交付的设备、流程和输出;未交付功能标为“不适用”并说明原因。
- 为每个选中项写明输入、预期结果和判断依据,再执行获准的最小动作。使用同一 SN、批次、请求 ID 或时间范围串起界面、日志、记录与文件。
- 将实际结果与预期逐项比较,保存足以复核的脱敏证据。错误已经记录或能够定位失败节点,不表示该业务通过。
- 记录未完成项、负责人及下一步;版本或配置改变后,重验受影响项。回退材料准备与实际回退演练分开记录。
| 状态 | 使用条件 |
|---|---|
| 通过 | 在记录的条件下执行,实际结果符合预期且有证据 |
| 失败 | 已执行,但结果或必要证据不符合预期 |
| 未测 | 尚未执行,或条件不足以作出结论;写明缺口 |
| 不适用 | 不属于本次交付范围;写明理由 |
空白项不能默认算通过。故障后的重试结果应关联原失败及处理措施,避免只保留最后一次成功。
验收总表
| 验收项 | 最小动作 | 通过标准 | 失败先看 |
|---|---|---|---|
| 主程序启动 | 启动 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)、设备号、返回码、超时 |
| Modbus | IP、端口、寄存器地址、触发值、完成写回值 |
| 文件服务器 | 请求路径、返回文件列表、下载/上传目标路径 |
外部系统能连上但业务没跑时,先查当前进程和 handler、协议模式、输入与设备/流程前提。仅在该项目明确依赖窗口时检查窗口是否打开;支持无窗口调用的模块不应套用这一前提。区分接收、受理、完成和外部确认,按具体协议保存对应证据。
交付记录模板
现场/客户:
主程序/项目包/插件包版本:
配置位置与本次适用范围:
设备、连接方式和必要环境:
负责人/日期:
验收项:
输入与关联标识(SN/批次/请求 ID/时间范围):
预期结果与依据:
实际结果:
状态(通过/失败/未测/不适用):
证据位置(脱敏日志/截图/记录/文件/请求与响应):
失败或未测原因、处理措施与复测结果:
回退包/配置/数据库备份位置及对应版本:
恢复步骤/负责人:
回退演练状态与证据(未演练须明确):
剩余问题/后续负责人:
操作员培训情况(如适用):