交付时至少应拿到四类资料:源码与数据库、部署与账号信息、内容与素材源文件、说明与验收记录。缺少任何一类,后续维护、迁移或多人协作都可能返工。下面用一个假设的协作场景说明该拿什么、怎么核对。
假设某企业委托开发一个展示型网站,开发方两人,企业方一名对接人,上线后由企业方另一名运营接手更新内容。若交付只给了一个压缩包和一句“后台能登录”,运营想换横幅图时找不到原始设计文件,想换服务器时不知道数据库配置,想改页脚电话时不敢动代码。返工就从这里开始。
避免这种情况的做法是:交付前先列清单,交付时逐项核对,交付后双方签字确认。清单不求多,但每一项都要能实际打开、实际运行。
源码不是“能看的文件夹”,而是能在新环境里重新部署并正常访问的完整代码。核对时不要只看文件数量,要实际走一遍部署流程。
node_modules、缓存、日志等可再生成目录,但要说明如何安装依赖。.sql格式,包含表结构和必要的基础数据;确认导入后页面能正常读取内容。常见错误是把线上服务器当成唯一运行环境,交付时只给一个压缩包,没有数据库文件,也没有依赖说明。判断结果很简单:让接手的人在另一台机器上按文档部署一次,能跑通即合格,跑不通就说明资料不全。
账号交接最容易出问题,因为“能登录”和“能管理”是两回事。核对时逐项确认权限级别,而不是只看能否打开页面。
适用条件是:企业方希望长期自主运营。如果只是短期活动页,账号可以简化,但源码和数据库仍应完整交付。
很多返工不是因为代码,而是因为找不到原始素材。运营想换一张首页大图,只有压缩后的成品图,放大就模糊;想改宣传册文字,只有图片没有文字稿。
判断标准是:接手的人在不联系原开发方的情况下,能否独立完成一次首页横幅更换。能完成,素材交付就算到位。
文档不必写成长篇手册,但要覆盖接手人会遇到的操作。建议包含:后台各功能入口说明、内容发布流程、常见问题处理方式、目录结构说明、部署步骤。
验收记录则用于确认双方对“已完成”的理解一致。可以按功能模块逐项列出:首页、栏目页、详情页、表单、移动端显示等,每项标注通过或不通过,不通过的写明具体现象和期望结果。假设验收时发现表单提交后没有提示,就记录为待修复项,修复后复测再确认,而不是口头说“差不多行了”。
多人协作时,还应约定后续修改的对接方式:谁负责改代码、谁负责改内容、改动前是否需要备份。这些约定写进交付文档,比事后争论更省事。
拿到资料后,不要只清点文件数量。挑一台干净的电脑,按部署文档走一遍,登录后台改一条内容,换一张图,导出一次数据库。任何一步卡住,就当场记录并请对方补齐。全部通过后再确认交付完成。