整站源码交付前的验收工作流

功能定位
整站源码作为数字商品，买家真正需要的是“拿到就能跑起来”。交付前的工作流目标不是增加功能，而是消除歧义：目录为什么这样分、配置在哪里改、哪些是示例数据、哪些必须替换。适用场景包括模板源码打包、项目源码转让、内部复用的基线版本整理。判断标准很简单：让一个没参与开发的人按说明独立跑通，过程中不需要提问，就算过关。

验收五段式
第一段目录体检：删除临时文件与本地配置，保留清晰的层级，每个顶层目录配一句用途说明。第二段依赖核对：列出运行所需的环境条件与安装步骤，标注版本敏感项，避免“装完报错”成为第一封沟通。第三段配置收敛：把所有需要修改的项集中到一处，给出示例值与说明，示例值不能是可用的真实凭据。第四段数据说明：区分示例数据与结构定义，写清初始化方式与清空方式。第五段运行说明：按从零到可访问的顺序写步骤，每步给出预期结果，方便对照排错。

适用场景与执行节奏
小体量源码可以五段一次走完，大体量源码建议分两次：先做目录体检与依赖核对，稳定后再做配置收敛、数据说明与运行说明。交付前留一次“陌生环境演练”，在干净环境里按说明操作一遍，把卡住的地方补进文档。这一步最费时间，但最能减少后续往返。

注意事项
不要在源码里保留个人路径、密钥或调试开关，这类残留既影响体验也有风险。说明文档要写在仓库内而不是聊天记录里，聊天记录会丢，文档会跟着源码走。示例数据要能一键清空，否则买家不敢改。版本号与变更记录要同步，升级时买家才知道差异在哪。最后附一份常见问题清单，把演练中遇到的卡点提前写出来，比事后逐条解释更省力。