没有一个通用粒度,判断标准是“将来谁在什么场景下需要据此做决定”。如果项目结束后你不打算再改动站点,也不承担审计或交接义务,保留到可追溯的验收结论、变更记录和当前线上配置即可;如果站点仍在迭代、有合规审计要求或可能更换服务商,就需要保留到能独立重建关键决策的粒度,包括原始需求确认、字段与权限设计依据、第三方依赖清单和发布回滚记录。粒度不足的代价是下一次变更要重新调研,粒度过度则带来存储与检索负担,且旧文档可能误导后来者。
静置型项目的特征是上线后只做内容更新,功能不再扩展。这类项目的历史文档可以压缩到三类:验收时双方确认的范围与结论、上线时刻的配置快照、未关闭问题的处理结果。需求讨论过程、中间稿、废弃方案可以只保留摘要和最终结论,不必保留每一轮沟通原文。
持续演进型项目则相反,功能会分批上线,涉及多角色协作或外部系统对接。此时文档粒度要能回答“这个字段为什么这样设计”“这个权限为什么只给某个角色”“这个第三方接口为什么选了这个版本”。缺少这些依据,后续接手的人只能靠猜,容易推翻原本有意为之的约束。
判断属于哪一类,不看项目预算大小,而看三个可核对的事实:上线后是否还有排期中的功能变更;是否存在需要向外部说明系统行为的场景,例如审计、对账、责任界定;是否可能在合同期内更换服务商或内部负责人。三项中命中两项以上,按持续演进型处理。
粒度不够的典型证据是,一次小改动需要重新确认原本已有的信息。例如要调整某个表单字段,却找不到当初该字段是否与后台报表、导出文件或第三方系统关联的记录,只能重新测试整条链路。另一个证据是交接时新负责人反复追问同一类问题,说明文档只记录了“做了什么”,没记录“为什么这样做”。
粒度过度也有可观察的信号:文档数量增长快于功能变化,检索一个结论需要在多份相似文件间比对;同一决策存在多个版本的描述,且没有标明哪份有效;旧文档中的方案已被推翻但未标注失效。这些情况下,问题不是保留得太少,而是缺少版本与有效性标记。
需要注意,文档被频繁查阅或很少被查阅,都不能单独证明粒度合适。很少被查阅可能是因为项目确实稳定,也可能是因为没人知道文档放在哪里。判断依据应是“能否支撑下一次决策”,而不是访问次数。
把历史文档分成三层,按条件决定保留到哪一层。
实施动作上,建议在项目结束的交接环节做一次“重建测试”:假设由一位没参与项目的人接手,只依据保留的文档,能否说明当前线上关键配置的由来,并完成一次小范围变更。如果测试中出现的疑问集中在决策层,就补决策层;如果集中在结论层,说明连基础验收记录都不完整。这个测试的结果直接决定下一步是补文档还是清理冗余,而不是笼统地“多存一点”。
涉及个人信息、支付、对外数据交换或行业监管要求的项目,保留粒度往往由合规义务决定,而不是由团队偏好决定。这类项目应保留数据处理目的的说明、字段来源与去向、权限变更记录,且保存期限要按适用要求设定,到期后按规则删除而不是无限期堆积。
另一种例外是服务商更替。如果合同约定项目结束后资料移交,移交清单应明确到决策层,避免只交付成品文件而缺少配置依据。此时可核对的事实是:移交后接手方能独立完成一次发布和回滚,而不需要联系原服务商。做不到这一点,说明粒度不足。
反过来,如果项目已明确不再维护、没有合规义务、也不会更换负责人,把过程层长期保留通常没有收益,反而增加检索成本和误用旧信息的风险。此时更合理的动作是保留结论层,对过程层设定清理期限,并在结论层中注明哪些材料已被清理,避免后来者误以为资料完整。