交付文档 / 操作培训 / 质保
- 知道交付给甲方的文档包含哪些、每份文档要写到什么深度
- 能按甲方不同角色(讲解员/管理员)区分培训内容,设计培训流程
- 了解质保期的常见约定方式和运维条款的关键条目
- 掌握验收后交接的正式流程,避免后期责任扯皮
- 有一张可直接使用的交付文档清单模板
联调通过了,验收单签了,设备都跑起来了——这时候很多集成工程师觉得项目完成了,可以收尾了。但甲方的项目经理问你要"交付资料",你把联调记录和 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 | 操作手册(讲解员版) | 必交 | ✓/✗ | ✓/✗ | 图文版,场景驱动 | |
| D07 | 操作手册(管理员版) | 必交 | ✓/✗ | ✓/✗ | ||
| D08 | 中控指令表 | 建议 | Excel/PDF | ✓/✗ | ✓/✗ | 维护时重配指令用 |
| D09 | 联调测试记录 | 建议 | ✓/✗ | ✓/✗ | 可并入验收单 | |
| D10 | 竣工说明(项目概述) | 大项目必交 | ✓/✗ | ✓/✗ | 含供应商联系方式 | |
| D11 | 各设备原始说明书/手册 | 建议 | PDF(电子版) | ✓/✗ | ✓/✗ | 厂商官方版本 |
文档移交建议用正式的"文件移交确认单"——甲方在单子上签字确认收到,双方各留一份。这不是搞繁文缛节,而是防止三个月后甲方说"我们没收到操作手册"。
操作培训:不只是"演示一遍"
培训最常见的方式是:工程师操作一遍,甲方人员在旁边看,然后工程师走了,甲方人员回去自己试,发现什么都不会。
有效的培训不是演示,而是让甲方人员自己上手操作。工程师的角色不是表演,而是在旁边看着纠正。
讲解员培训
讲解员的培训目标是:能独立完成展厅日常开馆→讲解→闭馆的完整操作流程,不需要工程师在场。
培训流程建议:
- 讲解一遍(15-20分钟):工程师带着操作手册,操作一遍完整流程,边操作边解释每步的用途
- 讲解员自己操作一遍(20-30分钟):工程师在旁边不介入,遇到问题先让讲解员自己找,找不到再提示
- 异常情况模拟(15分钟):制造一个场景(比如"某台屏没亮,现在怎么办?"),让讲解员自己找到手册对应的处理步骤
- 拍视频存档:培训结束后,让讲解员再完整操作一遍,全程录屏或录像,存档在项目文件夹里
参加培训的讲解员,建议每人都操作一遍(不要只有主讲解员操作,其他人观摩),并在培训记录表上签字。
管理员培训
展厅管理员通常是甲方的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),知道哪些必交、哪些视规模决定、每份文档要写到什么程度。
- 你知道了账号密码文档的安全交接方式:纸质给负责人,数字版加密存储,不发到微信群里。
- 你有了一套有效的培训框架:讲解员培训=演示+自己操作+异常模拟+录像存档;管理员培训多一个重启恢复流程。
- 你知道了质保合同里最容易模糊的条目(响应时间、费用、硬件损坏责任界定),以及质保期常见运维请求的预防方案。
- 你有了完整的交接五步流程:文档移交→账号密码交接→培训确认→质保起始确认→联系方式确认。
到这里,展厅集成项目从需求到交付的完整链路已经走完。系统联调与验收 保证系统跑得通,这一节保证甲方用得起来——两件事缺一不可。
相关节:系统联调与验收 · 方案设计与设备选型清单