私活交付要交哪些东西,列个清单

我交付烧烤店那单的时候,手写代码不到 20 行,但交付清单我写了整整一页。私活交付要给客户的,从来不是一堆代码文件,而是六样东西——源码、跑起来的方法、账号清单、文档、数据、以及一份验收确认。 少任何一样,后面都会有人来问你。

一、源码与版本说明

给一个完整的、能编译能跑的项目,不是几个散落文件。

清单里要写清楚:用什么语言和框架、依赖怎么装、有没有环境变量要配。别让客户拿到代码之后第一句话是「这个怎么跑」。

具体动作:交付前自己在干净环境里完整跑一遍,把每一步命令记下来。

二、部署与运行说明

这是最容易被跳过、又最容易被追问的一样。

包括三部分:本机怎么跑、服务器怎么部署、常见报错怎么处理。

我习惯写一页纯文本,不用花哨格式,按顺序列命令就行。客户的技术水平参差不齐,说明写细一点,能省掉后面很多次远程协助。

具体动作:把「从零到跑起来」的全过程写成编号步骤,找人照着走一遍看会不会卡住。

三、账号与权限清单。

把所有用到的第三方账号、密钥、后台地址列成一张表。

包括:数据库账号、对象存储、短信服务、支付配置、域名和证书、服务器登录方式。每一项写清楚用途和归属。

这里有个容易出问题的点:交付的是账号信息,不是账号所有权。哪些要过户、哪些是租用的、到期后怎么办,提前说清楚。涉及账号归属和过户的处理,以平台规则和当地法律法规为准。

具体动作:用表格列,一行一个账号,写用途、账号、密码存放方式。

四、使用文档。

面向使用者的说明,不是面向开发者的。

写清楚:每个功能在哪、怎么操作、有没有权限区分、注意事项是什么。截图比文字更省事。

这份文档的价值在于减少你被问的次数。 客户找不到某个按钮就来问你一次,一天能问八回。

具体动作:按功能模块写,一块配一张截图。

五、数据与素材。

项目里用到的初始数据、图片素材、字体、图标,一并整理好交出去。

尤其是素材,要说明来源和授权情况。用了有版权限制的字体或图片,风险是客户的,但麻烦会先找到你。

具体动作:建一个素材文件夹,按类型分好,附一份来源说明。

六、验收确认与交付记录。

这一条最容易被忽略,但它决定了前面五样交出去之后算不算完。

做法很简单:把交付清单发过去,请客户逐项确认,回复一句「已收到并确认」即可。这条记录就是你的交付凭证。

具体怎么写验收、怎么应对拖着不反馈,可以看客户测试阶段拖着不反馈,怎么推。

具体动作:清单发出去的同时,明确说明「如有异议请在某个期限内提出」。

哪些不该交

清单之外,有几样东西要留意。

不该交的:你自己其他项目的代码、内部工具、与你签过保密义务的第三方资料、和你私人账号绑定的凭据。

该交但要说清边界的:比如服务器是你在管还是客户在管、后续维护包不包含、超出范围的改动怎么算。

把边界写在交付清单里,比事后争论便宜得多。

按顺序整理,别一次发完。

交付的时候别一口气把所有文件甩进群里。按顺序发,每发一样说一句这是什么。

1. 先发验收确认的要求——告诉客户接下来要确认什么

2. 再发使用文档和账号清单——他马上要用到的

3. 然后发源码和部署说明——技术内容

4. 最后发素材和归档文件——补全

这个顺序的好处是客户始终知道你在干什么。 一次性甩文件,对方只会觉得信息过载。

一份最小清单。

项目再小,建议至少交这五样:

  • 源码(能跑)
  • 部署说明(照着能起来)
  • 账号清单(用途写清楚)
  • 使用文档(能自己操作)
  • 验收确认(有记录)

交付材料的完整度,直接决定你售后要花多少时间。 这也是我把交付拆成四个节点的原因,具体见私活交付分几个节点,我排了四个。

至于版权素材授权、账号过户、合同责任划分这些事,以平台规则、合同约定和当地法律法规为准,我不给判断。

常见问题

Q:私活交付要交哪些东西?

A:至少六样——源码与版本说明、部署运行说明、账号与权限清单、使用文档、数据与素材、验收确认记录。项目再小也建议交最小五样。

Q:客户只要源码,其他都不要,怎么办?

A:按他要求给,但仍然建议把部署说明和账号清单一并发出。这两样不发,后面一定会被反复追问,成本更高。

Q:交付清单要不要写进合同?

A:写进合同或需求确认里更稳妥,避免后面在「这个算不算交付内容」上扯皮。具体条款以合同约定和当地法律法规为准。

相关阅读


本文作者西米,37 岁程序员,一个人加五个 AI 员工在跑一家公司。踩过的坑和真实账本都写在公众号「西米分享」。

完整代码、踩坑清单与最新进展,都在公众号。

📱 关注公众号「西米分享」