· engineering· 约 28 分钟精读
Offline Ledger Row Deletion Missing Cell Irreversible — Technical Analysis | KeyRotate Technology
实物不在了,和记录不在了,是两件事。本文按 TagWorks 与 SlingGuard 的源码逐行核对删除链路:五行代码各自级联掉什么、证据照片为什么留在盘上、两次导出为什么算得出差集算不出原因;再对照 STFC SC26 与 LOLER 对“找不到”的计数与保留期,说明端侧缺的不是联网能力,而是哪几项记录。
一、把“东西不在了”拆成三件事
现场台账被问得最多的问题其实很朴素:这一件设备还在不在。而一款端侧应用能回答的只有另一件事——它在这本册子里有没有一行。
这两件事在正常作业时重合,在交接班、盘点和事故调查时被拆开。拆开之后至少有三种情形:
- 实物已经不能用了,但记录必须继续留在册(报废、隔离、送修在外);
- 实物丢了或者被转走了,册子上应当留下一条“它不在了、什么时候确认的、谁确认的”;
- 实物本来就还在,只是今天不在现场(借出、送检、换到另一处所)。
密旋科技这两款现场工具对这三种情形的实现是不对称的:SlingGuard 对第一种有明确建模,TagWorks 没有;两款对第二种都没有建模;第三种只能靠自由文本注释表达。这不是缺陷,是一条必须先说清的产品边界:端侧台账是“在册清单”,不是“在场清单”。边界被误读,就会出现本文要讨论的两种情形:账上有、现场没有;或者现场曾经有、账上连“少”都读不出来。
二、删除的全部代码是五行
先把两款源码里与“移除一行”有关的代码抄出来。TagWorks 侧只有两行有效语句:
// TagWorks/Sources/TagWorks/Services/RegisterStore.swift:232-235
func delete(_ asset: Asset) {
assets.removeAll { $0.id == asset.id }
records.removeAll { $0.assetID == asset.id }
}SlingGuard 侧是三行:
// SlingGuard/Sources/SlingGuard/Services/RiggingStore.swift:151-155
public func deleteAssets(ids: Set<UUID>) {
assets.removeAll { ids.contains($0.id) }
records.removeAll { ids.contains($0.assetId) }
releases.removeAll { ids.contains($0.assetId) }
}这五行是两款产品全部的数据销毁路径,没有第二处。它们的调用点各只有一个,都在登记册列表的侧滑动作上:
// TagWorks RegisterView.swift:49-52
.onDelete { idx in
let list = shown
for i in idx.sorted(by: >) { store.delete(list[i]) }
}
// SlingGuard RegisterView.swift:105-109
.onDelete { offsets in
if !isSelectMode {
store.deleteAssets(ids: Set(offsets.map { filteredAssets[$0].id }))
}
}从这段代码能读出四件事实。
第一,没有确认。confirmationDialog 在三款应用的源码里零命中;Button(role: .destructive) 一共四处——两款的签名页各一处(清除已保存的签名),QubitLab 设置页两处(重置全部进度)。没有一处挂在“把一件设备从台账里删掉”上:最需要留下动作痕迹的那一下,反而比清空一个孩子的全部学习进度少了半句确认。
第二,没有撤销。以词边界在两款 Sources 与 Tests 全量检索 undo、recycl、tombstone、deletedAt、softDelete、auditLog、eventLog、history of changes,全部零命中;唯一的 trash 命中是一个 SF Symbol 名字(“Remove Saved Signature” 用的 trash 图标)。删除不是“标记为已删除”,是从数组里拿走。
第三,removeAll 带走的不止那一行。检验记录以 assetID 挂在资产上、放行记录以 assetId 挂在资产上,两处级联把附属记录一起删净。报告、两份 CSV、仪表盘、检验历史页读的都是同一份内存数组,所以它们不会显示“一条被删设备的旧记录”——一致性保住了,代价是这段历史在设备内不留任何痕迹。
第四,两款侧滑删的都是可见集而不是底层数组:TagWorks 先把 shown 复制进局部变量再倒序删,SlingGuard 直接用 filteredAssets[$0],两者都对着屏幕那一列取行。写法是对的;有趣的是 SlingGuard 里还另有一个按下标取行的重载 deleteAsset(at offsets:),它索引的是未筛选的底层数组,全工程零调用点——哪天有人把它接到带筛选的列表上,删掉的就会是与屏幕无关的行。
测试覆盖同样只有一格。全工程唯一一处直接调用删除函数的测试,在 SlingGuard 的 DomainTests.swift:232-246:先放两件设备、只给第二件写一条记录;删掉第二件后断言记录集为空。TagWorks 侧没有删除路径的单元测试,两款也没有一条走查用例去点那个按钮。级联语义是对的,只是没被反复看守。
三、一次删除之后,各类产物的下落
把这条链上所有会被读到的东西列出来,就是一笔账。下表逐格核对删除之后各产物的下落。
| 产物 | 数据来源 | 删除之后 | 是否留下“曾经存在”的痕迹 |
|---|---|---|---|
| 登记册列表行 | store.assets | 立即消失 | 否 |
| 检验 / 检测记录 | store.records(按外键级联) | 立即消失 | 否 |
| 隔离放行记录(仅 SlingGuard) | store.releases | 立即消失 | 否 |
| 仪表盘的到期与状态计数 | 上三者的派生 | 一并变小 | 否 |
| 设备状态标签(打印物) | 由最近记录投影 | 应用内无入口 | 否(纸上的标签仍在设备上) |
| 离线 PDF 报告 | 由现存资产与记录渲染 | 不再出现 | 否 |
| 资产登记册 CSV / 事件历史 CSV | 现存数组 | 不再出现 | 否 |
| 自包含备份归档 | 现存快照与其引用闭包 | 不再包含 | 否 |
| 证据照片 JPEG 文件 | Documents/Photos | 留在磁盘上 | 是(但已无人引用) |
最后一行是这张表里唯一非零的一格,值得单独说。
两款应用都把证据照片以 UUID 文件名写进沙盒的 Documents/Photos,记录里只存文件名列表。TagWorks 的 PhotoStore.delete 全工程只有一个调用点:检测表单提交前的取消分支。资产删除路径完全不碰照片目录。于是出现一个方向性的不对称:备份是“缺一即拒”的——引用闭包里有名字而字节不在包内,BackupService 抛错,整包不生成;而删除留下的孤儿文件不在任何引用闭包内,既不打包,也不清理,只占容量。
它还有第二个后果:孤儿照片不进归档,恢复备份也就救不回它们所代表的那次检验——它们不属于任何记录,报告不渲染、CSV 不生成行,在设备上唯一的作用是一直等到整机抹掉时一起消失。
落盘时序也值得记一笔。TagWorks 的内存数组带 didSet,400 毫秒防抖落盘、退到后台时强制 flush,写失败会置 persistenceIssue 报警并整条闸住后续自动保存。SlingGuard 的防抖是 300 毫秒,save() 用 try? 吞掉两处错误、返回 Void,调用方无法感知失败,也没有 scenePhase 兜底。同一句“删除已保存”在两款里的可信度不是一个量级。
四、“应到未到”在数据模型里无处表达
现在回到第一节那个真正会被问到的问题:现场少了一件,台账能说什么?答案是——那一行还在,它什么都能说;那一行不在了,它什么都不能说。
先看“还在册”这一侧。两款都有“在册但没有检验记录”的状态——TagWorks 的 .untested 会出现在到期分面与报告封面,SlingGuard 的 .uninspected 同理。它区分“还没进过检测周期”与“检测合格”。但它是“在册未检”,不是“应到未到”:前者对一条存在的主记录求值,后者要拿期望集合与实测集合做差。两款都没有第二种能力——site / location 只是一段文本,没有“这个位置应有 N 件”的承载体。
TagWorks 的资产模型一共 9 个存储属性,逐个数下来没有一个能写“这台设备已经退役 / 已转走 / 找不到”:
// TagWorks/Sources/TagWorks/Models/Domain.swift:70-80(节选)
var id: UUID; var name: String; var identifier: String
var site: String; var applianceClass: ApplianceClass; var environment: TestEnvironment
var risk: RiskLevel; var lastTestDate: Date?; var photoFile: String?SlingGuard 侧多出的不是一个生命周期字段,而是一个布尔量 manualScrapped:写一条结论为 SCRAP 的记录时顺带置位,界面上没有任何开关能直接改它。这是端侧台账里唯一一处“实物不再使用但记录继续在册”的实现——那一行留着,报废记录留着,每次重算都把它归进单独一格。
只是这格的“退用”语义没有贯通到派生属性:报废件的到期日是一个非可选的计算属性(RiggingAsset.swift:176-179),报告的 Scheduled due 列与 CSV 的 Next Due Date 列都无条件渲染它。于是同一行里 Status 写着 Scrapped、右边照样印一个未来的待检日期——一台已宣告销毁的吊索具,在这两份对外载体上仍然保有一张待办日历。这是“留在册”与“还能用”共用了一条派生链,它说明另一端同样有盲区:留在册的不一定还能用,正如不在册的不一定已经不在了。
五、两份导出能算出差集,算不出原因
如果真要回答“上个月在册、这个月不在册的是哪一件”,在不引入云端服务的前提下,唯一的现实证据是同一本台账在两个时刻的两份导出。
把资产登记册 CSV 的每一行按设备编号取键,两次导出就是两个集合:
里的每个编号都意味着“这一行现在不在了”。三条性质值得写下来,因为它们决定了这套办法能用到什么程度。
其一,差集是空还是非空,取决于两次导出之间有没有发生过删除——但也只取决于这个。被侧滑删掉、被误删、被测试脚本清库、被恢复备份覆盖,四种成因在差集上完全同形,因为四个动作都不留下任何一行可导出的字节。
其二,差集里的元素不带原因。导出里没有“状态:已移除”这一列,因为那一行已经不属于任何被导出的数组;要让原因可导出,前提是删除不销毁行。
其三,差集只覆盖编号,不覆盖内容。一件吊索具的 WLL 被改过错、某条记录被重算过,在两次导出之间都不可见——除非逐字段比对,而那又会撞上另一个边界:两款资产册分别有 26 列与 19 列,能原样回读的只有少数几列,比出来的差异里相当一部分是格式差异而非语义差异。
下面的图把这条链路画成一次对撞:左右两份导出各列自己的编号,中间那个虚线空位就是差集里的元素——导出是集合上的投影,它天生带不走“移除”这类事件。
左右滑动查看完整图表
更省事的对照办法是读报告封面。SlingGuard 印 Assets in local register:,TagWorks 印 Assets in register:,把两期报告的这一行对起来就得到 。它比差集更弱——只知少了几件、不知少的是哪几件——但不需要用户额外导出文件,现实里因此更常被做到。审计若只问“两期数字对不对得上”,正好落在这套台账能力的中心;一旦追问“少的那一件为什么删”,就只能回到人记的笔记上。
六、法定侧怎么写“找不到”:三次计数与保留期限
放到法定与规程语境里,成熟做法在“移除一条记录”上其实非常保守。英国国家原子能机构下属的 STFC 安全规程第 26 号(Safe Use of Lifting Equipment and Lifting Accessories,Rev. 1.12,2023 年 6 月)第 4.5.4 条要求:
Ensure that where LELA cannot be located for inspection purposes the SHE Group is informed. If subsequently found, a thorough examination must take place prior to being returned to use. Items not located after 3 consecutive inspections will be considered missing and will be removed from the central register.
第 4.6.7 条从主管部门一侧又写了一遍:找不到的情形必须记入中央台账,连续三次检验找不到的件才移除。两条合起来给了三件可以直接抄走的东西:“找不到”是要记进台账的正向事实;移除要累计计数,一次不在不构成条件;被找回的件必须重新经过彻底检验才能回到使用。同文第 4.4.4 条补了反面——没有唯一登记号或没有安全作业载荷标记的属具应退回并立即停用;第 4.3.8 条要求退出使用的设备移到单独的受控位置,重新投用按新设备流程走一遍。在规程眼里,“不在了”不是一次数组删除,而是一段可回看的流程。
同一机构的电气侧规程 SC17(Rev. 4.0,2024 年 10 月)反而没有对应条款:它把检测记录保存期写成“现行 + 8 年”,通篇检索不到“无法定位”这类处理规则。两份规程同出一门、同期在用,一个写了找不到怎么办、一个没写——抄任何一份之前,得先判断自己这本册子对应哪一侧。
LOLER 1998 第十一(2)(a)(ii) 条给的是另一个维度:属具类吊装设备的彻底检验报告自出具起保存两年(其他设备为“直到停止使用为止”),第十一(2)(b) 条要求检验记录保留到下一次同类记录作出。HSE 的 Approved Code of Practice(ACOP L113,第二版,2014)第 373 段把电子台账的最低要求说得很白:存这些信息的系统应防未授权改动,且应能在需要时提供一份书面件。
澳大利亚与新西兰侧,AS/NZS 3760:2022 第 2.6.1 条的新西兰分支要求保存记录并附全部被检设备的台账(register),第 2.6.2 条的保留期是“宜 7 年”。示范《职业健康与安全条例》第 150(3) 条只强制四项:执行人姓名、测试日期、结果、下次测试日期。ISO/IEC 17025:2017 第 7.4.2 条要求项目在实物、记录或其他文件中获得唯一标识以免混淆。
近七日国内侧也有一条量级参照:国家密码管理局 2026 年 11 月 16 日的两则通知里,密评资质认定技术评审能力考核大纲对“台账”“资产”“归档”“保存期限”逐词零命中;写死留痕义务的是上位规章《商用密码检测机构管理办法》第十九条——原始记录与报告归档留存、可追溯、保存不少于 6 年。它约束的是检测机构而非端侧 App,但意思很清楚:一份要求可追溯 6 年的档案,意味着移除一条记录比新增一条更重。
并排看这些条款,它们对“少了一行”的态度恰好是两款实现程度的反面。
| 规程要求 | 条款出处 | 端侧两款工具的实现 |
|---|---|---|
| “找不到”要作为事实记入台账 | SC26 4.6.7 | 无对应字段,无对应入口 |
| 移除需累计计数(连续 3 次) | SC26 4.5.4 / 4.6.7 | 无计数,一次侧滑即生效 |
| 找回后须经彻底检验再投用 | SC26 4.5.4 | 无“待复检”这一中间态 |
| 记录防未授权改动、可出书面件 | ACOP L113 第 373 段 | 可出书面件;改动仅靠 iOS 沙盒 |
| 报告与记录按期保留 | LOLER 11(2)(a)(ii) / AS/NZS 2.6.2 | 由用户自行导出归档,应用不代管 |
七、把删除变成可解释的动作:四条不依赖云端的工程线
上表里几行“无对应”并不意味着产品做不了,只意味着现在没做。以下四条都能在纯端侧、纯本地的范围内落地,每条都写清改动落点与代价。
第一条:把“移除”从数组删除改成正向事实。 落点是两款的应用内模型(Asset、RiggingAsset):加一个可选的 removalReason 与一个计数字段。成本主要在解码边界——按已有的“新增键走 decodeIfPresent 回落”策略,旧台账不需迁移即可读回;要重新设计的是派生口径:状态枚举是否新增“挂失 / 待复检”一档、到期计算遇挂失态是否冻结、报告百分比的分母怎么算这一档。它只解决“能不能记下来”,不解决“会不会被篡改”。
第二条:给删除一条闸门。 三件事:一次二次确认(用 SwiftUI 的 confirmationDialog,与签名页同一交互语义);确认文案写清这次会级联掉几条检验与放行记录——这两个数在调用点已经可得;确认后不立即 removeAll,而是把一条移除事件追加进只写不改的历史数组,让它随备份归档一起打包。代价是台账变大、恢复路径要处理这份新历史、CSV 多一类文件;收益是“少了一行”从不可见变成可导出。
第三条:让孤儿文件有主人。 现状是记录删了、照片留在 Documents/Photos,而归档引用闭包由记录生成,于是这些文件既不可见也不可迁移。最小的改法是把“清理”做成一次显式可审的动作而不是删除的副作用:设置页给一个统计入口,报出未被任何记录引用的照片数与总字节数,由用户决定导出还是删除。不要顺手做成“删资产连带删照片”——那会把唯一还留在设备上的物证一并清掉。
第四条:把两期对账接住。 现在判断“这期比上期少了几件”靠读者自己比封面数字。可以让封面固定输出两行:本期在册数,以及上次导出时被识别为在册的基准数(存在沙盒里即可,不需要网络),再把差集列成一张附表。附表的数据源不是数组之差,而是第二条的移除事件历史;还没有历史时,它诚实地印一行“本版本前无移除记录留存”。
四条合起来,是把今天这条单向路——在册,然后不在册——改造成有计数、有理由、可导出的流程,全程数据不出设备。
八、能力边界
必须写清这套工具做不到什么,免得把上一节的方案读成现状。
- 应用内没有移除审计日志:两款源码里零个
auditLog、eventLog或任何变更历史,删除不产生可回读记录。 - 没有撤销、没有回收站、没有软删除标记;恢复的唯一来源是用户先前自己导出的归档,而归档按现存快照生成,删除之后再生成的那份不再包含这一件。
- 台账的防篡改靠 iOS 沙盒与系统备份策略,不靠应用内的摘要链:两款
Sources中CryptoKit、SHA256、SecKey全零命中,报告也没有可信时间戳或数字签名。ACOP 第 373 段“防未授权改动”这一条,端侧目前只能答出“改动不会静默同步到别处”。 - 无法回答“这台设备今天在现场吗”:应用不接定位与感知硬件、不做任何盘点,
site/location只是一段自由文本。 - 法定义务不由应用承担:LOLER、AS/NZS 3760 与 WHS 条例的保存义务主体是雇主或设备控制人。应用能在设备端生成书面件,但“按期保留”仍取决于人有没有把导出件存到别处——包括“删除之前先导出”。
- SlingGuard 报废件在报告里仍带未来到期日,TagWorks 连报废态都没有;两者都不构成“已退出使用”的可机读结论。
九、小结
端侧离线台账在“记录存在”这一侧做得相当扎实:一次检验要凑齐几项证据才允许进报告、一条失败记录要过几道判定才能放行、到期前多少天算临近,都有明确判据与可回归的测试。而在“记录消失”这一侧,两款只给了五行走完的 removeAll:无确认、无计数、无理由、无历史。
这个缺口不在“离线”这个约束里——上面四条没有一条需要网络。它缺的是把删除当成法定动作来设计的意愿:规程愿意花三次检验的耐心才肯把一件设备从中央台账上划掉,而手机上那一次侧滑,连“这会同时删掉三条记录”都还没说出口。
参考资料
- [1] STFC Safety Code 26 — Safe Use of Lifting Equipment and Lifting Accessories (Rev. 1.12, June 2023). SC26.pdf
- [2] STFC Safety Code 17 — Inspection and Testing of Electrical Equipment (Rev. 4.0, October 2024). SC17.pdf
- [3] HSE. Lifting Operations and Lifting Equipment Regulations 1998 (SI 1998/2306), regulation 11 — Keeping of information. regulation 11
- [4] HSE. Safe use of lifting equipment: L113 ACOP and guidance to LOLER 1998 (2nd ed, 2014), paras 331, 372-375. l113.pdf
- [5] HSE. Thorough examination of lifting equipment (INDG422). indg422.pdf
- [6] Standards Australia / Standards New Zealand. AS/NZS 3760:2022 In-service inspection and testing of electrical equipment, cl. 2.5.2 / 2.6. 目录页
- [7] Safe Work Australia. Model WHS Regulations 2011, reg 150(3) — records of testing; via Code of Practice: managing electrical risks. 模型条例与实务守则
- [8] ISO/IEC 17025:2017 General requirements for the competence of testing and calibration laboratories, cl. 6.4.13 / 7.4.2. 标准页
- [9] The Institution of Engineering and Technology. Code of Practice for In-service Inspection and Testing of Electrical Equipment (4th ed), §15.14 “Equipment that cannot be located”(本版正文为付费出版物,本文仅引用其章节编号与标题)。官方公开样章
- [10] OSHA. 29 CFR 1910.184 — Slings. 条文
- [11] 国家密码管理局《商用密码检测机构管理办法》(国密局令第 2 号)第十九条;2026-11-16 两则通知(密评资质评审能力考核大纲等)。商用密码管理