跳到正文
观点文章/文章详情

系统交付时,除了账号还应该拿到什么?

核心结论

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

业务系统交付箱包含代码、数据库、配置、字段权限、导出与恢复资料,账号只是入口

先看一个假设的例子:系统上线半年,一直运行平稳。负责的开发离职后,公司想换一台服务器重新部署,打开交付时留下的压缩包,发现没有构建说明,没有环境变量清单,数据库结构只在一个人的电脑里。再想导出客户数据,发现后台只能导出列表页看到的字段,关联的附件和状态历史带不走。

交付时对方给了管理员账号,大家觉得系统已经交到手里。账号只是入口。真正决定企业能不能自主运行、维护和恢复的,是另外六类资料。

账号不是交付物

管理员账号说明你能登录,不说明你能重建系统、迁移数据、排查故障或换人维护。一个可交付的系统,应该让没有参与开发的另一名技术人员,按照资料完成部署、导出和恢复。

这不是不信任供应商,而是任何长期系统都需要交接。人员会变动,供应商会更换,服务器会迁移。资料不全,企业就被锁在一个不能离开的位置。

代码与构建

需要拿到:源代码仓库的完整访问权限、分支与发布记录、依赖清单、构建命令、产物说明。

仅有代码还不够。要确认在一台干净机器上,按照说明能否构建出可运行版本。第三方依赖的版本要锁定,许可证清单要保留,便于后续合规核对。密钥、数据库密码和第三方账号不能写在代码里;交付时应提供配置模板,而不是把正式凭证打进压缩包。

如果使用低代码或平台配置,对应的是应用导出包、配置说明和平台依赖,而不是源代码。退出时能否导出,要在合同里约定。

数据库与迁移

需要拿到:数据库结构说明、建库脚本、迁移脚本、参考数据(角色、状态、字典)、以及一份脱敏的样例数据。

迁移脚本要能按顺序执行,从空库建出当前结构。只给一份数据库备份,不等于给了可维护的结构;下次升级仍然不知道怎么改。

参考数据要单独列出:哪些状态、角色、权限、字典是系统运行必需的,哪些是业务自己维护的。恢复时先恢复参考数据,再恢复业务数据,顺序错了会缺关联。

环境配置

需要拿到:服务器与运行环境要求、环境变量清单、域名与证书、存储位置、邮件与短信配置、第三方接口账号、定时任务、日志位置。

配置要说明哪些是敏感信息、由谁保管、如何轮换。不要把所有正式密码写在一份文档里发给所有人;提供清单和保管方式,比提供明文更有用。

还要说明备份与监控:数据库多久备份一次、备份放在哪里、日志保留多久、出错时看哪个文件或面板。

字段、权限与接口清单

字段字典说明每个字段的业务含义、类型、必填、来源和负责人。没有它,后续改字段只能靠猜。

角色权限清单说明每个角色能看什么、能改什么、记录范围是什么。接口清单说明系统对外提供和被调用的接口、鉴权方式、频率限制和错误码。

这三份资料也是后续换人、接新系统和做审计的基础。

数据导出与恢复

数据导出要覆盖业务记录、附件、状态历史和关联关系,而不只是当前列表页的字段。导出格式要通用,字段名要能对应字段字典。

恢复资料要包括:备份文件、恢复步骤、恢复所需的环境和凭证、恢复后的核对方法。最重要的是实际演练一次:在隔离环境里,用交付资料恢复一份数据,确认业务能查、能导出、能继续。

只在文档里写“已备份”,不算恢复能力。备份介质损坏、密钥丢失、恢复步骤缺一步,都会在真正需要时才发现。

文档、缺陷、待办与联系人

交付文档不需要写成手册,但至少要包括:系统用途、主要流程、部署步骤、常见故障、已知缺陷、未完成事项、供应商与内部联系人。

已知缺陷要如实列出,包括触发条件和临时绕过方法。未完成事项要写清是否影响使用、计划何时处理。把这些留在聊天记录里,交接后就会消失。

源代码、数据、文档的归属与使用范围,应在合同中明确约定。本文只列交付资料和验证方法,不判断具体合同条款的法律效力。

交付清单

类别

交付物

验收方式

缺失风险

代码与构建

仓库权限、依赖、构建说明

干净机器构建一次

无法重新部署

数据库

结构、迁移、参考数据

从空库建出当前版本

升级无依据

环境配置

变量清单、域名证书、第三方账号

按清单搭一套测试环境

换机即停摆

字段与权限

字段字典、角色矩阵、接口清单

抽查字段与权限是否一致

后续改动靠猜

数据导出

记录、附件、历史、关联

导出并在另一环境导入

数据被锁死

恢复与文档

备份、恢复步骤、缺陷、联系人

实际恢复演练一次

出事无法恢复

验收时不要只看清单有没有勾。让接手的技术人员独立完成一次构建、一次导出和一次恢复,遇到问题当场记录,由交付方补齐。能独立完成,才算交付。

交付之后,运行数据仍需持续备份;代码仓库不能代替数据库和上传文件的恢复。网站项目的代码、内容与媒体恢复有相似原则,但业务系统还多出角色、状态和第三方接口。需要把交付范围写进项目,可以在业务系统开发里约定;项目开始前整理数据与字段,可参考业务系统准备清单。定制与 SaaS 的长期成本比较,见定制开发还是买 SaaS。

聊聊你的项目

网站 / 业务系统 / AI 应用

企业微信咨询