← 返回 系统集成与项目落地

交付文档 / 操作培训 / 质保

最后更新 2026-06-22
s6 · 系统集成与项目落地 🟢 通用/低风险
你将学到
  • 知道交付给甲方的文档包含哪些、每份文档要写到什么深度
  • 能按甲方不同角色(讲解员/管理员)区分培训内容,设计培训流程
  • 了解质保期的常见约定方式和运维条款的关键条目
  • 掌握验收后交接的正式流程,避免后期责任扯皮
  • 有一张可直接使用的交付文档清单模板

联调通过了,验收单签了,设备都跑起来了——这时候很多集成工程师觉得项目完成了,可以收尾了。但甲方的项目经理问你要"交付资料",你把联调记录和 BOM 表打包发过去,三天后收到一条消息:"这个灯光怎么切换我找不到,操作手册在哪?"

展厅项目的"交付"不是设备跑通那一刻,而是甲方能独立运营这套系统。这需要三样东西:完整的文档包、可以实操的培训、明确的质保和运维约定。少一样,后期都会变成麻烦。


交付文档:要给甲方哪些

一个完整的展厅集成交付文档包,通常包含下面这些内容。哪些是必须有的,哪些视项目复杂程度决定,下面逐一说明:

必交文档(每个项目都要有)

① 系统架构图(竣工版)

这是联调完成后最终实施状态下的系统集成图,不是方案阶段的初稿。竣工版要反映实际安装的设备型号、实际使用的 IP 地址、实际的线缆连接关系。如果施工中有变更(设备换型号了、某段走线改路径了),竣工版必须更新。

文件格式:PDF(主交付)+ 原始工程文件(Visio/draw.io,附在文档包里备查)。

② 点位图(竣工版)

同上,反映实际安装位置的竣工点位图。甲方日后如果需要维修、改扩建,这张图是最基础的参考。

③ 设备清单(含序列号和 IP)

比 BOM 表更完整的设备档案:

设备名称 型号 序列号 MAC 地址 固定 IP 安装位置 备注
序厅投影仪 (填型号) (填序列号) (如有) 192.168.1.31 序厅吊顶中央 PJLink控制
核心区LED屏 (填型号) (控制卡序列号) - 192.168.1.32 核心区北墙 含接收卡
串口服务器 USR-TCP232-XXX (填序列号) (填MAC) 192.168.1.30 机柜1U-3 有人官网手册
网络继电器 科星XXXX型 (填序列号) (填MAC) 192.168.1.40 机柜1U-4 8路,Modbus TCP
…(按实际填)

序列号有两个用途:质保期内维修时证明设备来源;甲方日后扩容采购时确认型号的历史记录。

④ IP 规划表

单独一张表,按子网分区列出所有设备的 IP、子网掩码、网关,以及 VLAN 划分(如有)。内容和设备清单里的 IP 列保持一致,但 IP 规划表通常按网段组织,是网络运维的第一参考。

⑤ 账号密码清单

所有设备、软件、平台的管理账号和密码,集中在一个文档里:

设备/系统 管理地址 账号 密码 用途
核心交换机 Web管理 192.168.1.1 admin (填密码) 网络配置
SoftControl 中控管理端 本地客户端 admin (填密码) 场景编辑/设备管理
串口服务器Web配置 192.168.1.30 admin (填密码) 串口参数配置
LED控制软件 本地客户端 admin (填密码) 内容更新/屏参调整
播控平台 SoftPlayer 本地/Web admin (填密码) 内容编排/发布
Windows 工控机 - administrator (填密码) 系统维护
路由器(如有) 192.168.0.1 admin (填密码) 外网访问(如有)

账号密码文档有安全性要求:不要发到群里,建议单独纸质打印一份给甲方负责人,数字版文件加密存储(用密码保护的 ZIP 或 Word 文档),告知甲方存档方式。

⑥ 操作手册(讲解员版)

给展厅讲解员用的简版操作手册,只讲日常操作,不讲配置和维护。格式以"场景"为单位,不以"设备"为单位——讲解员关心的是"我要开始讲解了,按什么步骤操作",而不是"这台设备的控制协议是什么"。

内容框架:

1. 开馆操作(一键开馆的步骤,含估计用时)
2. 讲解模式切换(序厅讲解→核心区讲解→产品区讲解,每个场景的触发方式)
3. 日常关机(一键闭馆的步骤和顺序)
4. 常见小问题处理(某台屏没亮、声音没出来,讲解员自己能解决的那层)
5. 联系方式(解决不了时联系谁,维护工程师电话)

图文并茂效果最好,手机拍的现场操作照片配上标注箭头,比纯文字好用 10 倍。如果中控有讲解员平板/手机 App,截图+标注每个按钮的功能。

⑦ 操作手册(管理员版)

给展厅管理员/IT负责人的完整版,比讲解员版多以下内容:

  • 开机启动顺序(设备有先后顺序,不能乱)
  • 内容更新操作(如何在播控平台上传新视频、修改播放计划)
  • 常见故障的现场应急处理(比联调故障表更精简、面向非技术人员)
  • 定期维护建议(每季度检查哪些项)
  • 联系工程师的条件(哪类问题自己处理,哪类问题应该打电话)

视项目规模可选的文档

⑧ 中控指令表

列出所有中控编程用到的控制指令:设备名、控制方式、指令内容(16进制或文本)、预期响应。这份文档主要给后期维护工程师用——系统改造或中控重新配置时,不用重新摸每台设备的指令。

⑨ 联调测试记录

联调阶段的逐设备测试记录和场景测试记录,证明每台设备、每个场景都经过测试验证。小项目有时候并入验收单,大项目建议单独作为一个文件。

⑩ 竣工说明(项目概述)

用于归档和后续维护参考,1-2页:项目背景、集成商信息、设备供应商联系方式、系统特殊注意事项(比如"某台设备重启后需要手动恢复某个配置"之类的非标情况)。


交付文档清单模板

把上面的内容整理成一张可以直接使用的清单:

项目名称:________________ 交付日期:________________ 交付版本:V_final

编号 文档名称 是否必交 格式 已准备 已移交甲方 备注
D01 系统架构图(竣工版) 必交 PDF + 原始文件 ✓/✗ ✓/✗ 反映实际施工状态
D02 点位图(竣工版) 必交 PDF + 原始文件 ✓/✗ ✓/✗
D03 设备清单(含序列号/IP) 必交 Excel/PDF ✓/✗ ✓/✗
D04 IP 规划表 必交 Excel/PDF ✓/✗ ✓/✗
D05 账号密码清单 必交 加密文件+纸质 ✓/✗ ✓/✗ 纸质交给甲方负责人
D06 操作手册(讲解员版) 必交 PDF ✓/✗ ✓/✗ 图文版,场景驱动
D07 操作手册(管理员版) 必交 PDF ✓/✗ ✓/✗
D08 中控指令表 建议 Excel/PDF ✓/✗ ✓/✗ 维护时重配指令用
D09 联调测试记录 建议 PDF ✓/✗ ✓/✗ 可并入验收单
D10 竣工说明(项目概述) 大项目必交 PDF ✓/✗ ✓/✗ 含供应商联系方式
D11 各设备原始说明书/手册 建议 PDF(电子版) ✓/✗ ✓/✗ 厂商官方版本
💡 提示

文档移交建议用正式的"文件移交确认单"——甲方在单子上签字确认收到,双方各留一份。这不是搞繁文缛节,而是防止三个月后甲方说"我们没收到操作手册"。


操作培训:不只是"演示一遍"

培训最常见的方式是:工程师操作一遍,甲方人员在旁边看,然后工程师走了,甲方人员回去自己试,发现什么都不会。

有效的培训不是演示,而是让甲方人员自己上手操作。工程师的角色不是表演,而是在旁边看着纠正。

讲解员培训

讲解员的培训目标是:能独立完成展厅日常开馆→讲解→闭馆的完整操作流程,不需要工程师在场。

培训流程建议:

  1. 讲解一遍(15-20分钟):工程师带着操作手册,操作一遍完整流程,边操作边解释每步的用途
  2. 讲解员自己操作一遍(20-30分钟):工程师在旁边不介入,遇到问题先让讲解员自己找,找不到再提示
  3. 异常情况模拟(15分钟):制造一个场景(比如"某台屏没亮,现在怎么办?"),让讲解员自己找到手册对应的处理步骤
  4. 拍视频存档:培训结束后,让讲解员再完整操作一遍,全程录屏或录像,存档在项目文件夹里

参加培训的讲解员,建议每人都操作一遍(不要只有主讲解员操作,其他人观摩),并在培训记录表上签字。

管理员培训

展厅管理员通常是甲方的IT负责人或设备管理员,培训内容比讲解员多:

  • 系统整体架构说明(各子系统是什么关系,不需要深到技术细节,但要让他知道"这台机柜里装的是什么,控制的是什么")
  • 内容更新操作(重点演示一遍,并让管理员自己操作一遍)
  • 设备重启恢复流程(断电后各设备的正确启动顺序,这是最常被忽略但最重要的一点)
  • 日常巡检建议(每天开馆前检查什么,每周/每月检查什么)
  • 故障应急联系流程(哪类问题先联系谁,联系不上备选是谁)
💡 提示

设备重启顺序专门讲一遍。很多展厅的故障来源于"停电恢复后乱序开机"——先开了中控,串口服务器还没上线,中控连接失败;或者先开播控主机,结果 HDMI 矩阵还没上线,信号路由没建立。正确的顺序通常是:网络设备(交换机)→ 中间件(串口服务器、网络继电器)→ 中控和播控主机 → 最后开显示设备。具体顺序以你的系统实际链路为准。

培训记录表

培训项目 培训时间 培训讲师 参训人员 参训人员签字 备注
讲解员:日常操作流程
讲解员:异常情况处理
管理员:系统概述
管理员:内容更新操作
管理员:重启恢复流程
管理员:故障联系流程

质保期与运维约定

质保和运维条款是合同里最容易含糊其辞的部分,模糊条款在日后维护时会产生大量扯皮。

质保期的常见约定方式

展厅集成项目的质保期通常从验收签字之日开始计算,一般分两类:

整体系统质保:集成商对系统整体的正常运行负责,时间一般 1-2 年(视合同约定)。质保期内出现非甲方操作失误导致的故障,集成商免费维修或更换。

设备质保:单独设备的质保按厂商条款执行(商用设备通常 1-3 年,工控设备按厂商为准),需要明确集成商在设备质保期内是"协调厂商送修"还是"直接提供备机替换"。

合同里要明确的关键条目:

1. 质保起始日期:以验收单签字日期为准
2. 质保范围:正常使用下的故障(不含人为损坏、不可抗力)
3. 响应时间约定:
   - 重大故障(展厅无法正常运行):X小时内响应,Y小时内到场(或远程介入)
   - 一般故障:X个工作日内处理
4. 质保期内的费用约定:人工费如何计算(免费/差旅实报实销/年费包干)
5. 硬件损坏的责任界定:原装设备损坏走厂商质保,还是集成商先垫换

运维约定

质保期结束后,通常转入付费运维阶段。运维约定建议在交付时就谈好,避免质保到期后双方重新谈判的摩擦:

常见运维模式

  • 按次计费:每次上门服务固定费用 + 差旅,适合甲方 IT 能力较强、自己能处理大部分小问题的情况
  • 年度运维包:按年收取固定费用,包含 X 次远程响应 + Y 次年度巡检 + Z 次上门维护,适合展厅使用频率高、甲方没有专职IT的情况
  • 纯远程支持:只提供远程协助,不含上门,适合远距离项目或甲方有自己施工人员的情况
💡 提示

运维合同里一定要约定"备件响应":如果核心设备(中控主机/播控主机/网络继电器)损坏,集成商提供备机的时间是多少。展厅无法运行的每一天都是业主的损失,这个条款是甲方最在意的,也是你区别于竞争对手的差异化服务点。

质保期内高发的运维请求

了解质保期内最常被叫回去处理的问题,可以提前在培训和文档里覆盖,减少不必要的到场:

问题类型 频率 能否通过培训/文档预防
内容更新不知道怎么操作 是——操作手册+培训覆盖
断电后设备不知道怎么重启 是——操作手册单独写一节"停电恢复流程"
某台屏没有画面(信号线接头松了) 部分——培训里教讲解员检查信号线接头
中控场景执行异常(参数被改动了) 部分——管理员操作手册强调不要随意改中控配置
设备网络IP冲突(有人接了新设备占用了IP) 是——IP规划表交出去,培训时说明展厅网络不要随意接设备
设备物理损坏(屏幕被打、传感器被拆) 否——属于人为损坏,走单独责任认定

验收后的交接流程

验收单签字不等于项目结束。一个完整的交接流程:

第一步:文档移交。把完整文档包(上面清单 D01-D11)整理好,统一存在一个文件夹里,移交给甲方负责人并签收。电子版同步发到甲方指定的邮箱(不要只发微信,邮件有时间戳记录)。

第二步:账号密码交接。账号密码文件单独交接,最好当面交给甲方 IT 负责人,纸质版由甲方妥善保管,数字版存在甲方指定的保密位置。

第三步:培训完成确认。培训记录表归档,确认所有应参训人员已完成培训并签字。

第四步:质保起始确认。双方在质保/运维服务协议上签字,明确质保起始日期(通常就是验收单日期)。

第五步:联系方式确认。集成方留下质保期内的技术支持联系人(姓名+电话+邮件),甲方留下日常联系人。双方确认紧急联系方式。

💡 提示

交接完成后,给甲方发一封正式的"项目交付确认邮件",内容包括:交付完成的日期、交付文档清单(列出每个文件名)、培训已完成、质保起始日期、技术支持联系方式。这封邮件一方面是礼节,另一方面是最清晰的书面记录,有任何纠纷时都是有效的参考依据。


学会之后你能做出什么——效果与应用场景

回到开头那条"操作手册在哪"的尴尬——学完这一节,你交出去的就不再是一堆联调记录和 BOM,而是一整套能让甲方自己转起来的东西。具体能做出什么,拆开看:

你能做出什么 靠的是本节哪块
交一套完整、甲方看得懂的文档包 D01-D11 交付清单,竣工版架构图/点位图/设备清单/IP 规划/账号密码全齐
把讲解员真正教会,工程师走了也能开馆 场景驱动的讲解员操作手册 + "演示→自己操作→异常模拟→录像存档"培训法
让管理员会更新内容、会正确重启 管理员版手册单独写的开机顺序 + 重启恢复流程(交换机→中间件→中控播控→显示设备)
把质保和运维条款写到不扯皮 质保起始日/响应时间/费用/硬件损坏责任五条 + 三种运维模式 + 备件响应约定
用一套正式流程完成交接、留住书面证据 文档移交→账号交接→培训确认→质保起始→联系方式五步 + 交付确认邮件

这套东西用在哪些展厅项目:

  • 政府 / 国企展厅:验收和归档最较真,D01-D11 一份不能少,文件移交确认单、交付确认邮件这些书面痕迹就是你日后不背锅的护身符。
  • 企业 / 品牌展厅:讲解员流动性大,今天教会的下个月可能离职——场景驱动的图文手册 + 培训录像,就是新人自己能上手的底气。
  • 博物馆 / 科技馆:常年高频运营,管理员的重启恢复流程和年度运维包最实用,一次停电乱序开机的返场就够回本这份文档。
  • 异地 / 连锁展厅:工程师去一趟成本高,把"能靠培训和文档预防的高发问题"提前覆盖掉,纯远程支持就能扛住大半。

同一套交付功夫,换个工程照样能用:楼宇智能化、会议室系统、监控安防这些集成项目,交付逻辑是一模一样的——文档包、上手培训、质保运维三件套。你在展厅练出来的"交付清单 + 培训法 + 质保条款"这套本事,迁移过去基本不用重学,无非是把设备清单里的项换一批。


本节学到的知识

  • 交付 ≠ 设备跑通,而是"甲方能独立运营这套系统",缺文档、培训、质保任何一样后期都变麻烦。
  • 交付文档清单编号 D01-D11:D01 架构图、D02 点位图、D03 设备清单、D04 IP 规划表、D05 账号密码、D06/D07 讲解员/管理员手册、D08 中控指令表、D09 联调记录、D10 竣工说明、D11 原始手册。
  • 竣工版文档要反映实际施工状态(实际型号/IP/走线),不是方案初稿;施工有变更必须更新。
  • 账号密码清单要单独交接:纸质给甲方负责人、数字版加密(密码 ZIP/Word),绝不发微信群。
  • 设备清单里的序列号有两个用途:质保维修时证明设备来源、日后扩容采购确认历史型号。
  • 讲解员手册按**"场景"为单位**(开馆/讲解切换/关机/小问题/联系方式),不按"设备"为单位;图文并茂比纯文字好用。
  • 有效培训不是演示,是让甲方自己上手:讲解一遍→讲解员自己操作→异常情况模拟→录像存档,参训人每人操作并签字。
  • 管理员培训必讲设备重启恢复顺序:交换机 → 串口服务器/网络继电器 → 中控播控主机 → 最后显示设备(以实际链路为准)。
  • 质保期从验收签字日起算;合同关键五条:起始日期、质保范围、响应时间、费用约定、硬件损坏责任界定。
  • 运维三种模式:按次计费 / 年度运维包 / 纯远程支持;运维合同一定要约定核心设备的备件响应时间。
  • 质保期高发运维请求(内容更新不会、停电不会重启、IP 冲突)大多能靠培训 + 文档提前预防,减少返场。
  • 交接五步:文档移交 → 账号密码交接 → 培训完成确认 → 质保起始确认 → 联系方式确认,最后补一封"项目交付确认邮件"作书面记录。

小结 · 你现在掌握了什么

  • 你有了一张完整的交付文档清单(D01-D11),知道哪些必交、哪些视规模决定、每份文档要写到什么程度。
  • 你知道了账号密码文档的安全交接方式:纸质给负责人,数字版加密存储,不发到微信群里。
  • 你有了一套有效的培训框架:讲解员培训=演示+自己操作+异常模拟+录像存档;管理员培训多一个重启恢复流程。
  • 你知道了质保合同里最容易模糊的条目(响应时间、费用、硬件损坏责任界定),以及质保期常见运维请求的预防方案。
  • 你有了完整的交接五步流程:文档移交→账号密码交接→培训确认→质保起始确认→联系方式确认。

到这里,展厅集成项目从需求到交付的完整链路已经走完。系统联调与验收 保证系统跑得通,这一节保证甲方用得起来——两件事缺一不可。

相关节系统联调与验收 · 方案设计与设备选型清单

内容有错、看不懂、或想看下一期?告诉我们 →

本文为公开资料的学习整理,非亲测。涉接线/花钱/合规的步骤请结合实物与官方最新资料验证,风险自负。见免责声明

需要展厅软硬件方案或定制开发?