交付时应拿到的不只是网页文件,而是一套能让别人接手后继续改、继续上线的资料。至少包括源码与版本信息、数据库结构与备份、域名和服务器权限、后台账号、设计源文件、部署说明、测试记录,以及一份双方确认的验收单。缺少任何一项,后续换人维护或二次开发都会返工。
多人协作最容易出问题的地方,是开发方认为“站能打开就算交付”,需求方却拿不到能改的东西。开始验收前,先把合同或需求文档里的功能点列成一张表,逐条对照。适用条件是项目已经进入验收阶段、功能基本冻结;如果还在加需求,应先冻结范围再谈交付,否则清单会一直变。
判断信号:每一条功能都能在正式环境里自己操作一遍,并且知道改哪里、由谁改。只能演示、不能自己动手的,不算交付完成。
按用途分四类收,比按文件类型收更不容易漏。
示例(假设项目):某企业站用常见内容管理系统搭建,交付时除源码外,还应拿到主题或模板的修改说明、已装组件的用途清单、以及哪些内容在后台改、哪些必须改代码。这样接手的人不会因为误删组件导致页面异常。
部署说明至少覆盖:用什么运行环境、装哪些依赖、配置文件里哪些值要改、数据怎么导入、静态资源怎么生成、上线后怎么确认成功。判断标准很简单——找一个没参与开发的人,只给文档和权限,看能否在测试环境把站跑起来。跑不起来,说明文档不够。
后台使用说明则面向日常运营:怎么发文章、怎么改导航、怎么换图片、误操作后怎么恢复。这部分不必写技术细节,但要写清操作边界,避免运营人员改到不该动的地方。
如果某项暂时拿不到,例如域名还在转移中,应写进遗留问题清单,注明责任方和完成时间,而不是口头带过。适用条件是双方约定分期交付;此时未交部分必须有书面记录,否则后期容易扯皮。
资料收齐后,指定一名内部负责人把账号、文档和备份统一归档,并修改所有初始密码。随后安排一次简短的交接演练:由接手人独立完成一次内容发布和一次测试环境部署。能独立完成,交付才算真正结束。