ARTICLE · 1395400
换个人能不能接住你的系统?验收先看文档和付款节点
换个人能不能接住你的系统?验收先看文档和付款节点系统能不能续命,不是看界面能不能点,而是看关键人走后,那些没写下来的上下文还在不在。如果你是出钱的老板,验收时只问一句:换一个人照着现有文档,能不能把系统重新部署一遍? 接不住,就不算交付完成;尾款就不能轻易放。下面把这条标准拆成三个可核查的节点:文档、付款、关键路径。 咱们干这行的都清楚,系统交接最怕的不是代码没写好,而是话没说完。 以下来自我早年经手的一个制造企业项目,隐去名称。 我见过一套设备台账系统,第一版由内部团队开发,核心开发中途调走,交接文档几乎为零。人还在的时候,界面什么都能点;人一调走,就剩下一份几乎空白的文档。 接手的服务方盯着旧代码看了一轮,直接说看不懂,只能推倒重来。这件事说明一个道理:系统能不能续命,不看代码跑没跑通,看那份没写下来的上下文有没有被落到文档上。 交付文档至少应包含部署手册、数据字典、配置清单和恢复流程。行业常见尾款比例是百分之十到百分之二十;文档缺失时,尾款可以挂起。 我参与过一个平台项目,几十号抽调的人把它做到几百人天天用。验收那会儿界面确实能点,数据也能看。可一到推广,一句“数据模型与技术架构不符”就把它判了重来。 这句判断到底依据哪份文档,没有人当场答得上来。我后来才明白,这类隐性口径比代码更致命,因为它只装在离开或拍板的人脑子里。 行业常见验收周期为三十到六十天,其中文档复核应占三到五个工作日。验收单上要写清三个节点:文档是否可读、部署是否可复现、关键路径是否可查。 我看过一份数据底座的调研过程,几家服务方轮番讲,每一家都说自己最好。真正能说清数据从哪来、断了怎么恢复、配置改在哪里的,没几个人。 后来系统越铺越复杂,出一次小问题,还是要找原来那个讲得最好的人。人一走,系统就成了没人敢碰的黑箱。越是号称智能的系统,这一层越难核对。 付款节点可以拆成三笔:启动付三成,验收通过付五成,知识交接完成后付两成。最后那两成,就是逼着交付方把“人脑里的上下文”落到纸面上。 你现在就可以打开手头合同,找验收条款里有没有“知识交接”这四个字。没有,就发一句话给乙方:把部署手册、数据字典、配置清单补进来。 补完再验收;验完再放尾款。系统能不能用,不是看当天跑通,而是看换个人也敢接。 问:系统已经上线很久,现在补文档来得及吗? 答:来得及。先从最近一次故障复盘开始,把恢复步骤、配置位置、数据来源写成文档,三个月内可补齐关键路径。 问:尾款只留一成,算不算合理? 答:服务类项目里,尾款比例常见百分之十到百分之二十。知识交接复杂的,可以分两笔,最后两成留在交接完成后。 问:验收时技术负责人不配合看文档怎么办? 答:把验收标准提前写进合同,要求乙方当面演示一次重新部署。只验界面,不验文档,尾款不签字。 问:智能系统怎么验证它不是黑箱? 答:要求服务方提供数据来源、断点恢复流程、配置变更记录。讲不清的,先不写验收通过。 需要《合同避坑自查清单》的,公众号后台回复『清单』。















































































