优秀建站服务商，项目结束后历史文档需要保留到什么粒度
📱 Mozilla/5.0 AppleWebKit/537.36 (KHTML, like Gecko; compatible; ClaudeBot/1.0; +claudebot@anthropic.com)
🔗 /9c142be7beeb.html
📄
优秀建站服务商，项目结束后历史文档需要保留到什么粒度
保留粒度不应按“整套交付物”一刀切，而应按文档是否还承担可验证、可迁移、可追责三种用途来分层。项目结束后，凡是仍能解释线上系统当前状态、支撑后续改动或界定旧合作关系边界的文档，值得保留到字段与配置级；只服务于当时汇报、已经无法对应现行系统的过程稿，可以降到摘要级甚至退出。判断标准不是页数，而是删掉之后下一次故障或改版会不会失去依据。
先按用途分三层，而不是按文件夹保留
历史文档通常混杂四类内容：需求与变更记录、设计与数据结构、部署与配置、验收与沟通记录。项目结束后，它们的价值衰减速度不同。需求原文可能已经过时，但需求变更的日期、原因和批准人往往仍能解释某个功能为什么长成现在这样；设计稿可能被新版覆盖，但字段含义、枚举值、第三方接口约定如果没写进代码注释，就仍然是唯一说明。
可以按三层处理：
- 可验证层：数据库结构说明、字段字典、接口约定、环境变量清单、域名与证书的归属记录、第三方服务账号的所属主体。这一层建议保留到字段级和配置项级，因为它们是排查与迁移时直接对照的依据。
- 可迁移层：信息架构、页面清单、内容模型、重定向规则、素材授权来源。这一层保留到条目级即可，不必保留每一版视觉稿。
- 可追责层：合同附件、验收单、变更确认、付款与交付节点记录。这一层按合作关系的实际存续需要保留，粒度到签署版本，而不是到每一次邮件往返。
过程性草稿、内部评审截图、重复导出的中间文件，通常可以只留一份带日期的摘要，说明结论和影响范围即可。
三种处理方式的适用前提
保留适用于系统仍在运行、后续仍会改版，或原服务商不再参与维护的情况。此时文档的作用是替代口头记忆。一个实际动作是：把字段字典和接口约定单独抽成一份“现行状态说明”，标注最后核对日期。做完这一步，下一次改动就能先对照说明判断影响面，而不是先翻整套交付包，后续排查范围会明显收窄。
改写适用于原始文档仍然准确、但组织方式已经无法使用的情况。例如旧需求文档按当时的页面顺序编写，而现在的系统已经按模块拆分。此时不必保留全部原文，而是把仍然成立的部分重写成“当前系统说明”，把失效部分标注为历史背景。改写的前提是有人能确认哪些内容仍然成立；如果无人确认，改写容易把过时信息包装成现状，反而更危险。
退出适用于文档对应的对象已经不存在，且没有任何迁移、审计或争议处理需求。判断依据不是“看起来没用”，而是确认三件事：对应功能已下线、相关账号与数据已妥善处理、合作关系已无未结事项。三者缺一，就应先降级保留而不是直接删除。
用一组可区分的证据决定粒度
面对一份文档，可以问四个问题，答案不同则处理方式不同：
- 删掉它之后，能否仅凭代码和线上系统还原同样的信息？能，则可退出；不能，则至少保留到条目级。
- 它描述的是现行状态，还是某个历史时点的状态？前者保留并标注核对日期，后者降为背景。
- 它是否涉及账号、域名、证书、数据归属或授权？涉及则保留到主体与配置级，因为这类信息出错代价高。
- 它是否可能用于界定旧合作关系的责任？可能则保留签署版本，不必保留全部沟通细节。
这组问题的价值在于把“重要不重要”的主观判断，换成“删掉后是否失去唯一依据”的可核对判断。若某份文档同时满足“无唯一性、无归属信息、无争议可能”，退出的理由就比较充分。
一个假设例子：删掉字段字典之后
假设某站点在项目结束后只保留了页面截图和需求文档，字段字典被当作过程稿删除。半年后需要新增一个筛选条件，开发人员只能从数据库里反推字段含义，其中两个枚举值的业务含义无法确认，只能按字面猜测。上线后发现其中一个值实际对应已停用的旧分类，筛选结果与预期不符，需要回滚并重新确认。
这个例子的比较方法很直接：如果字段字典保留到字段级，确认成本是一次查阅；如果只保留到摘要级，确认成本是一次线上验证甚至一次回滚。数字不必精确，关键是两种粒度对应的下一步动作不同。需要说明的是，这只是用于说明取舍的假设，不是真实项目记录。
退出旧系统或旧合作关系时的最小动作
当旧内容、旧系统或旧合作关系需要退出时，建议先做一次“保留清单”而不是“删除清单”。清单上写明：保留什么、保留到什么粒度、由谁确认、下次复核时间。然后执行两个动作：把仍对应线上系统的文档标注为现行状态并注明核对日期；把仅作历史背景的文档集中存放并标注失效范围。
这两个动作的结果会直接影响下一步：有了现行状态标注，后续改动可以先查文档再动代码；有了失效范围标注，就不会在排查时误用旧配置。若某份文档既无法确认是否现行，又涉及账号或数据归属，正确的下一步不是删除，而是先确认归属主体，再决定保留粒度。项目结束不等于信息责任结束，粒度选择本质上是在为下一次改动保留可核对的依据。
