结论先说:历史文档不必全部长期保留,但“可重建当前线上状态”的那一层必须留。判断粒度时,先问两个问题——这份文档是否影响后续改版、迁移或纠纷举证;丢掉它之后,是否还能从线上环境和版本记录还原当时的决定。两个都答“否”,就可以只留索引或直接归档到冷存储;只要有一个答“是”,就要保留到可读、可追溯的粒度。
网站项目产生的文档大致分两类。决定记录包括:栏目结构定稿、URL规则、表单字段与接收方式、第三方接口的对接约定、备案与域名相关材料的存放位置、验收时确认的功能范围。这类文档回答的是“为什么现在是这样”,一旦丢失,后续接手的人只能靠猜。
过程噪音包括:中间版本的排版稿、被否掉的首页方案、临时的会议截图、重复的测试截图。它们对复盘有价值,但对运维和二次开发几乎没有约束力。粒度控制的关键,就是把这两类分开处理,而不是按“统统保留三年”一刀切。
这种情况下,保留粒度可以粗一些。建议只长期保留四类:上线版本的页面与模板清单、数据库结构说明、第三方账号与接口的归属说明、验收确认记录。中间设计稿和调试日志在项目结束后保留一个版本周期即可,之后压缩归档。
动作上,可以要求交付方提供一份“环境与依赖说明”,写明程序版本、插件或模块清单、服务器基本配置项。拿到这份说明后,下一步的维护排期才有依据——否则每次小改动都要先花时间摸清环境。
这时粒度必须提高到“可独立重建”。除了上面四类,还要保留:数据库导出结构(不含真实用户敏感数据的样例即可)、伪静态与重定向规则、图片与附件的目录约定、以及所有自定义功能的字段说明。设计源文件是否保留,取决于是否还需要继续调整视觉;如果视觉已冻结,保留导出的切图与样式文件通常够用。
假设一个例子:某站点上线两年后要迁到新服务器,如果只留了页面截图和一份功能列表,接手方需要重新推断表单提交逻辑和栏目层级;如果留了字段说明与重定向规则,迁移主要是配置工作。这个对比说明,粒度不是越细越好,而是要和“下一步谁来做、做什么”对齐。
判断一份文档是否值得长期保留,可以看三条证据:
这里有一个与直觉相反的现象:文档数量多,不等于交接顺利。实际交接中最常卡住的,往往是缺少一份“当前状态说明”,而不是缺少过程稿。所以保留策略的重点应放在状态类文档,而不是把所有历史文件都堆在一起。
对多数企业站点,决定记录建议随站点生命周期保留,过程噪音保留到下一次大改版即可。合同、验收单、发票类材料按财务与合规要求单独管理,不混在技术文档里。
例外有三种:涉及在线交易或用户注册的站点,字段与数据处理说明要长期保留;有知识产权争议或未结清尾款的项目,全部过程文档暂缓清理;使用过定制开发且原开发方已无法联系的项目,重建说明要留得更完整,因为无法再向对方求证。
最后一步动作:在项目结束会上指定一个人,把文档按“决定记录/过程噪音/合规材料”三堆分开,并写一页索引说明每份文件放在哪、对应哪个版本。做完这一步,后续无论是改版还是换人,都能先看索引再决定要不要翻原始文件,而不是从一堆压缩包里找线索。