工程 · TourCheck

一本自己签名的日志

2026年11月5日 · Software by Design

巡更记录只有在起争议时才有价值:保险理赔、事件复盘、“证明夜间巡查真的发生过”。如果数据库是唯一的证据,那谁能改数据库,谁就决定了发生了什么。TourCheck 的回答是一本日志:它不让篡改变得不可能,而是让篡改可见。

只写一次,环环相链

每个事件(一次检查点扫码、一次巡查开始、一起事故)只写一次,永不更新。更正是新行,不是编辑。在这些行之上是一条哈希链日志:每条记录带着一个哈希,把自己绑定到上一条记录以及它所引用行的载荷上,区块链就是这么做的,只是去掉了一切让区块链令人难受的部分。改写历史意味着把它之后的每条记录全部重算:而链头存放在验证者会注意到的地方。

重点不是篡改不可能;在一台自托管的机器上,没有什么是不可能的。重点是篡改会留下指纹。验证会重算每个被引用行的载荷哈希:被有意抹掉的行验证为 TOMBSTONED:故意的、可见的:而其他任何不一致验证为 TAMPERED。“数据库这么说”变成“数据库能证明”。

让它站得住的规则

一轮红队演练把模糊的承诺变成了被强制执行的不变量:而最有意思的,是那些最无聊的:

  • 巡查状态只有一个写入者。只有一条代码路径可以变更巡查的状态,在一个事务里,而且每次变更都产生一条注明谁关闭它的日志记录。控制器里散落的一条 UPDATE 没法悄悄改写结果。
  • 来源由服务器裁决。事件的方式和站点范围在服务器端从绑定和成员关系解出。客户端的声明是校验的输入,从不原样落库,所以构造出来的请求没法把自己的扫码记到它不属于的站点名下。
  • 重放比对的是声明,不只是 id。重复的客户端事件 id 会和已存的载荷哈希、绑定备注、照片和时间戳逐项比对:一条与原件不符的重放是不匹配,不是去重。
  • 探测是有代价的。未知成员的尝试消耗的是站点的锁定计数器,所以探测不能被用来枚举哪些成员存在:除非连被探测的东西一起锁掉。
  • 永远一个锁顺序。先取巡查行,再取链头:绝不反过来。它存在是为了让事件摄入和巡查关闭不会互相死锁;并发下的正确性也是一种完整性属性。

证据住在访问即策略的地方

照片和生成的报告不进用户可见的 Files 文件夹,它们住在 appdata 下,用应用管理的 id,授权按站点角色判定。这直接消灭了整整一类 bug:文件权限免费附赠的“别的查看者拿到 404,或者更糟,200”问题。按日锚定连无聊的情况也处理了:空链也产生一个有效锚点,所以“上周二什么都没发生”本身就是一句可证明的陈述。

这一切都不需要您信任我们。链验证是您可以运行的代码,威胁模型写在决策记录里,而 AGPL 意味着职工代表委员会、审计师或一位多疑的管理员都能核实这本日志是否做了这篇文章所说的事。无法被检视的签名功能不算签名:只是装饰。