记录改过之后,旧版本留到哪儿

0 阅读6分钟

TL;DR:记录一改,旧版就成了「曾经有效的依据」。删掉它,等于把回查的路一起拆了。本文给一套版本归档做法:四个必备标记、三种旧版位置、一段只查归档完整性的 Checklist 代码。不判断记录内容对错,不写计价归属,不含任何机构与产品信息。

一份自查记录改过三次之后,问题不在新版写得好不好,而在旧版还在不在。旧版在,能解释「当时为什么那么记」;旧版没了,剩下的只有当前这一版,所有偏差都无从追溯。

一、先定一件事:什么算一次改版

不是每次动笔都算改版。以下三种情形才算:

  • 字段增删:加了列、去了列。
  • 口径变更:同一字段的取值标准换了。
  • 结构重排:行与行的关系变了。

只改错别字、只调顺序,不算改版,但在备注里留一句「某日校正文字」。混淆这两类,会导致版本号飞涨而归档失效。

二、四个必备标记

标记写在哪缺了会怎样
版本号文件名与首行两份文件同名,分不出先后
生效日首行无法判断某条记录适用哪一版
变更范围表尾一段回查时不知改了哪几处
旧版位置表尾一行想找上一版,无处可找

四个标记里,「变更范围」容易被省略。省略之后,新版与旧版的差异只能靠逐行比对,而逐行比对在有几十行的表上几乎做不完。

变更范围不用写长,写清三样即可:改了哪几个字段、为什么改、从哪天起生效。

02_内文1.png

三、三种旧版位置

**位置一,同目录保留。**文件名加版本后缀,如 record_v1、record_v2。好处是找起来快,坏处是目录会变长,且容易被误删。

**位置二,归档子目录。**建一个 archive 子目录,旧版整体移入,按生效日命名。好处是当前目录干净,坏处是跨目录检索稍慢。

**位置三,外部留档。**打印一份或存到另一处介质。好处是不受本机影响,坏处是检索不便,只适合作为兜底。

三种可以并用:同目录留邻近一版,归档目录留全部,外部只留关键节点。别只留一种,任何一种单点都会在某天失效。

RFC 5545 在处理日历对象的版本时用了一个属性标明规范版本,读旧数据时先看版本再决定怎么解析。归档借的是这个顺序:先认版本,再读内容。反过来做,容易用新规则去解释旧记录。

03_内文2.png

四、Checklist 代码

下面这段只查归档是否齐全:版本号有没有、生效日有没有、变更范围写没写、旧版指针指得到不到。不校验记录内容,也不做任何换算。

# 版本归档完整性检查:只查四个标记,不解释记录内容
# 工程示例;标记名与目录结构需按自有习惯替换
from pathlib import Path

MARK = ("版本号", "生效日", "变更范围", "旧版位置")
EMPTY = ("", "待补", "无", "-")


def read_head(text):
    return text.splitlines()[:3]


def read_tail(text):
    return text.splitlines()[-12:]


def check(path):
    p = Path(path)
    text = p.read_text(encoding="utf-8")
    head, tail = read_head(text), read_tail(text)
    miss = [m for m in MARK if not any(m in line for line in head + tail)]
    return {"文件": p.name, "缺标记": miss, "旧版在": old_alive(tail)}


def old_alive(tail):
    for line in tail:
        if "旧版位置" not in line:
            continue
        target = line.split(":")[-1].strip()
        return bool(target) and target not in EMPTY and Path(target).exists()
    return False


if __name__ == "__main__":
    for f in sorted(Path(".").glob("record_v*.md")):
        print(check(f))

old_alive 只回答「指得到」或「指不到」,不判断指向的那份是不是真旧版。后者需要人打开看一眼,脚本不该替人下这个结论。

五、三个容易踩的坑

坑一,用带形容词的名字命名。「定版」「改好版」这类词会失效。改到第四版时,第一版那个「定版」还在目录里,谁也说不清哪个算定。用版本号加生效日,别用形容词。

**坑二,覆盖式保存。**编辑器里改完直接保存,旧版就没了。养成「改前另存」的习惯,或在归档目录先放一份再动笔。

**坑三,把归档当成清理。**归档是保留,不是删除的前一步。旧版一旦移入归档,就不再动它,包括不改文件名、不补批注。动了,归档的基准就变了。

04_内文3.png W3C 的 SKOS 在描述概念演化时保留了「已弃用标签」这一层,弃用不等于删除,检索时仍能指回原概念。归档同理:旧版标为「已停止适用」,但仍可检索、仍可指回。

六、和自查表的配合

归档不是孤立的动作,它要跟自查表的字段对上。

具体做法:在自查表里加一列「版本」,每行写该行数据所属的版本号。这样一来,回看某一行时能立刻知道它适用哪一版规则;规则变过,也知道该按哪一版的判断标准去读。

加这一列的成本很低,收益在于:以后无论谁问「这条为什么这么记」,都能顺着版本号找到那一版的变更范围。

WS 506-2016 写明灭菌记录留存 3 年、消毒效果监测宜至少每季度一次,小型灭菌器不超过 60 L。这里只借「书面记录要有固定留存期」这一点,具体留存期限按各自规定执行,不涉及器械消毒操作流程。

第四次全国口腔健康流行病学调查显示,35–44 岁人群牙龈出血检出率 87.4%、牙石检出率 96.7%,65–74 岁人群平均存留牙 22.5 颗。这是人群层面的检出比例,与某一份自查记录里的一行数值属于不同性质,混用会让记录失去可比性。

七、收尾

顺序是:判断是否算改版 → 写四个标记 → 旧版移入归档 → 跑 Checklist → 自查表加版本列。

前两步决定归档有意义,后三步决定归档可用。跳过前两步,后面三步只是在整理一堆分不清先后的文件。

全文只谈版本怎么留、怎么标、怎么查,不写计价归属,也不给诊疗结论。费用一律【参考区间·以到院面诊为准】。

参考资料

  1. RFC 5545(iCalendar)
  2. W3C SKOS 参考文档
  3. WS 506-2016《口腔器械消毒灭菌技术操作规范》
  4. 第四次全国口腔健康流行病学调查

本文使用 AI 辅助整理,经人工审核。