工业软件厂商移交时应交付哪些文档？买方检查清单

系统能跑、文档却没到，后来会发生什么？

移交会上，文档经常被当成剩下的纸面工作。系统已经投用，操作工被带着过了一遍画面，其余文件约定「下周再交」。一周拖成一个季度。等项目组散了，能讲清某个标签、某张表、某一处画面对应关系的人，已经不再负责这个现场。

缺文档的后果不会出现在验收当天，而会出现在工厂之后几乎都会碰到的那些事上。一套工业软件——无论是 SCADA、MES、能源管理还是产线集成——能维护到什么程度，取决于文档找不找得到、读不读得懂。

• PLC 换过了，某个标签要重新映射，却没有人能找到它原先占用的 I/O 点或寄存器
• 生产报表要改，却没有人写下它读的是哪几张数据库表、用的是哪套汇总规则
• 原厂工程师已经离场，工厂拿手头现有资料培训不了新操作工
• 下一家承包商被请来做扩展，只好先反推地址、画面和接口，才能开始新工作
• 维保内容出现争议，却没有滚动的维保清单或年度维保报告，说不清当年实际做了什么

这五件事是系统上线之后的日常，不是偶发事故。14 类文档存在的理由，是让产线改造、人员交接、后续集成和维保复核变成常规工作，而不是变成考古。

移交资料里应有哪 14 类文档？

一套完整的工业项目资料是 14 类：项目方案书、技术协议、规格书（式样书）、I/O 分配表、地址分配表、网络拓扑图、画面设计说明书、操作使用说明书、数据库表说明书、数据接口说明书、测试报告、验收资料、维保清单、年度维保报告。平铺成一堆文件名，买方很难对着箱子检查。按每组文档要回答的问题来分组，检查才做得到。

下面这张表是为移交会写的。第三列不是阶段退出条件，而是验收单签字前要看的内容。

在开工前就把这份清单写进技术协议。签约时没点名的文档，往往会拖到项目组离开后再谈，那时补做慢、争议也难收场。

买方在移交单上签字前应检查什么？

验收单签字，对供应商意味着项目关闭；对工厂意味着从此要靠文档自己撑下去。下面这些问题可以在移交会上逐条问；如果回答是「回头再发」，这一项就还没有交付。

• 14 类是否逐项写进了技术协议，还是合同只写了「资料」二字、没有清单？
• 每一份点名的文档，是不是与现场 I/O、地址、画面和接口一致的竣工版？
• 一个没参加过项目的人，能否按操作使用说明书走完一个班、而不必打电话给供应商？
• 测试报告是否写了判定条件、方法、结果和日期，让第三者能判断通过还是不通过？
• 数据库表说明书和数据接口说明书是否写清了表、字段、数据方向以及主数据的责任方？
• 维保清单和年度维保报告是否已有可使用的模板，让下一年的工作有对照基准？
• 移交后可编辑的源文件归谁——工厂持有，还是只有供应商留底的 PDF？

最后一问最常被跳过。签过字的 PDF 是记录；可编辑的 I/O 分配表、地址分配表和网络拓扑图，才是产线改了之后工厂用得上的工具。记录和工具都要，不能互相替代。

文档应以哪种语言、哪种格式交付？

操作人员读不懂的文档，上线后不会被使用。语言是移交条件，不是事后再做的翻译，应写在技术协议里每一份文档名称的旁边。

格式同样决定文档还能不能继续用。一份画满批注的扫描件是记录；一份可编辑的 I/O 分配表、地址分配表和网络拓扑图才是现场工具。两者都要。

• 会议与常驻接口的工作语言——国内项目用中文窗口；涉外项目在技术协议里写明英语窗口是否贯穿全程，而不是临时配一次翻译
• 规格书（式样书）与操作使用说明书的语言——给谁用就用谁的语言；只有封面译过、正文仍是另一种语言的文件，不算已交付
• 文件格式——可编辑源文件（表格、图纸、文档）加上已签字的 PDF 归档件；写明哪些文档必须两种都交
• 版本管理——每份文档带版本号、日期，以及设计稿与竣工稿的区分标记

把语言和格式写进与文档名称同一张表。能在签约前填完这张表的供应商，已经把文档当成交付物，而不是收尾时再凑的文件。