结论先说:保留粒度不取决于文件多少,而取决于这份文档未来是否还要被“执行一次”。如果后续只做展示或归档,保留最终版和变更记录即可;如果后续还要迁移、二次开发、续费或排查故障,就必须保留到可复现的配置与账号层级。判断标准是:拿到这份文档的人,能否在不联系原团队的前提下把站点重新跑起来或定位问题。
很多马鞍山建站公司交付后,客户把整包文件丢进网盘就算“留档”,结果半年后要换服务器或改功能时,发现缺了数据库结构和环境配置。这里的关键不是留得多,而是留得对。
两种条件的分界线是“是否还要动手改”。只要答案是会改,归档粒度就必须升级到可复现层级。
如果项目还要继续用,建议按下面几类保留,而不是只留一个压缩包:
这里要提醒一句:账号类文档保存的是“归属和交接结果”,不是密码明文堆在一起。权限清单应记录谁负责、在哪里管理,而不是把敏感信息抄进普通文档。
有时会出现与直觉相反的结果——资料留得越多,接手的人越找不到重点。原因通常不是文档不够,而是没有分层。把所有截图、聊天记录、临时文件混在一个目录里,等于没有归档。
可核对的证据是:让一个没参与项目的人,仅凭文档完成一次本地启动或一次配置修改。如果他反复问你“这个文件放哪”“这步在哪做”,说明粒度不对,而不是资料太少。此时应做的动作是拆分目录:把“必须读”的启动说明放在最外层,把“参考用”的过程记录放进子目录,并注明哪些已过期。
这个动作的结果会直接影响下一步:接手人能独立跑通,才说明归档合格;跑不通,就回到缺失的那一层补齐,而不是继续堆文件。
假设某站点要换服务器。若只保留了页面文件,没有数据库结构和环境变量说明,迁移时就会出现页面能打开、但后台数据读不出来的情况。反过来,如果保留了结构说明和配置清单,即使原开发不在,也能按步骤恢复。
这个例子的数字只用于比较方法:把“能独立完成迁移”设为通过标准,分别用“仅页面文件”和“源码加配置清单”去测试,看哪一种能通过。结论通常指向后者。例外是:如果站点本来就是纯静态、无后台、无数据库,那么粒度可以降到页面文件加部署说明,不必强求数据库部分。
建议在项目结束前做一次交接核对:由接手方按文档独立操作一遍,记录卡住的步骤,再决定补哪些内容。这个动作能直接暴露粒度是否足够,也避免文档停留在“看起来完整”。
例外情况也要说清:如果合同约定后续维护仍由原团队负责,且交接范围仅限展示,那么归档粒度可以适当降低,但仍应保留最终版本和变更记录,以免日后责任不清。无论哪种情况,保留粒度的判断都回到同一个问题——未来是否需要有人独立执行。