核心结论
账号只是入口,交付要覆盖六类资料:代码与构建、数据库结构与迁移、环境配置、字段权限与接口清单、数据导出与恢复、文档与联系人。每类都要能在没有原开发者的情况下被另一个人使用。源代码和数据归属应在合同中约定,本文不作法律结论。

先看一个假设的例子:系统上线半年,一直运行平稳。负责的开发离职后,公司想换一台服务器重新部署,打开交付时留下的压缩包,发现没有构建说明,没有环境变量清单,数据库结构只在一个人的电脑里。再想导出客户数据,发现后台只能导出列表页看到的字段,关联的附件和状态历史带不走。
交付时对方给了管理员账号,大家觉得系统已经交到手里。账号只是入口。真正决定企业能不能自主运行、维护和恢复的,是另外六类资料。
账号不是交付物
管理员账号说明你能登录,不说明你能重建系统、迁移数据、排查故障或换人维护。一个可交付的系统,应该让没有参与开发的另一名技术人员,按照资料完成部署、导出和恢复。
这不是不信任供应商,而是任何长期系统都需要交接。人员会变动,供应商会更换,服务器会迁移。资料不全,企业就被锁在一个不能离开的位置。
代码与构建
需要拿到:源代码仓库的完整访问权限、分支与发布记录、依赖清单、构建命令、产物说明。
仅有代码还不够。要确认在一台干净机器上,按照说明能否构建出可运行版本。第三方依赖的版本要锁定,许可证清单要保留,便于后续合规核对。密钥、数据库密码和第三方账号不能写在代码里;交付时应提供配置模板,而不是把正式凭证打进压缩包。
如果使用低代码或平台配置,对应的是应用导出包、配置说明和平台依赖,而不是源代码。退出时能否导出,要在合同里约定。
数据库与迁移
需要拿到:数据库结构说明、建库脚本、迁移脚本、参考数据(角色、状态、字典)、以及一份脱敏的样例数据。
迁移脚本要能按顺序执行,从空库建出当前结构。只给一份数据库备份,不等于给了可维护的结构;下次升级仍然不知道怎么改。
参考数据要单独列出:哪些状态、角色、权限、字典是系统运行必需的,哪些是业务自己维护的。恢复时先恢复参考数据,再恢复业务数据,顺序错了会缺关联。
环境配置
需要拿到:服务器与运行环境要求、环境变量清单、域名与证书、存储位置、邮件与短信配置、第三方接口账号、定时任务、日志位置。
配置要说明哪些是敏感信息、由谁保管、如何轮换。不要把所有正式密码写在一份文档里发给所有人;提供清单和保管方式,比提供明文更有用。
还要说明备份与监控:数据库多久备份一次、备份放在哪里、日志保留多久、出错时看哪个文件或面板。
字段、权限与接口清单
字段字典说明每个字段的业务含义、类型、必填、来源和负责人。没有它,后续改字段只能靠猜。
角色权限清单说明每个角色能看什么、能改什么、记录范围是什么。接口清单说明系统对外提供和被调用的接口、鉴权方式、频率限制和错误码。
这三份资料也是后续换人、接新系统和做审计的基础。
数据导出与恢复
数据导出要覆盖业务记录、附件、状态历史和关联关系,而不只是当前列表页的字段。导出格式要通用,字段名要能对应字段字典。
恢复资料要包括:备份文件、恢复步骤、恢复所需的环境和凭证、恢复后的核对方法。最重要的是实际演练一次:在隔离环境里,用交付资料恢复一份数据,确认业务能查、能导出、能继续。
只在文档里写“已备份”,不算恢复能力。备份介质损坏、密钥丢失、恢复步骤缺一步,都会在真正需要时才发现。
文档、缺陷、待办与联系人
交付文档不需要写成手册,但至少要包括:系统用途、主要流程、部署步骤、常见故障、已知缺陷、未完成事项、供应商与内部联系人。
已知缺陷要如实列出,包括触发条件和临时绕过方法。未完成事项要写清是否影响使用、计划何时处理。把这些留在聊天记录里,交接后就会消失。
源代码、数据、文档的归属与使用范围,应在合同中明确约定。本文只列交付资料和验证方法,不判断具体合同条款的法律效力。
交付清单
类别 | 交付物 | 验收方式 | 缺失风险 |
|---|---|---|---|
代码与构建 | 仓库权限、依赖、构建说明 | 干净机器构建一次 | 无法重新部署 |
数据库 | 结构、迁移、参考数据 | 从空库建出当前版本 | 升级无依据 |
环境配置 | 变量清单、域名证书、第三方账号 | 按清单搭一套测试环境 | 换机即停摆 |
字段与权限 | 字段字典、角色矩阵、接口清单 | 抽查字段与权限是否一致 | 后续改动靠猜 |
数据导出 | 记录、附件、历史、关联 | 导出并在另一环境导入 | 数据被锁死 |
恢复与文档 | 备份、恢复步骤、缺陷、联系人 | 实际恢复演练一次 | 出事无法恢复 |
验收时不要只看清单有没有勾。让接手的技术人员独立完成一次构建、一次导出和一次恢复,遇到问题当场记录,由交付方补齐。能独立完成,才算交付。
交付之后,运行数据仍需持续备份;代码仓库不能代替数据库和上传文件的恢复。网站项目的代码、内容与媒体恢复有相似原则,但业务系统还多出角色、状态和第三方接口。需要把交付范围写进项目,可以在业务系统开发里约定;项目开始前整理数据与字段,可参考业务系统准备清单。定制与 SaaS 的长期成本比较,见定制开发还是买 SaaS。