跳到正文
EquatorOps
EquatorOps 博客 平台架构

每个引擎背后的五条工程原则

每个 EquatorOps 引擎的内部,都由五条原则撑起架构的通用性:不可变性、“守卫、执行、证明”生命周期、状态机、图遍历和证据链。

阅读约 5 分钟 EquatorOps 团队
通用引擎 工程原则

在为什么每个行业都需要同样的八大引擎一文中,我们介绍了 EquatorOps 背后的四层架构:八大通用引擎、九大功能领域、30 多个租户 API 和十一个行业解决方案。那篇文章讲的是引擎是什么,以及它们如何组合成一个完整的平台。

本文再往下深入一层。打开这八个引擎中的任何一个,都能在里面看到同样的五条工程原则。它们相当于每家汽车制造商都依赖的物理定律:燃烧、摩擦、热力学、导电性、结构完整性。这些定律不必重新发明,只需在其基础上构建。


1)不可变性:每条记录都是永久的

系统中每一条重要记录都是一次写入的。文件的第 3 版不能编辑,只能创建第 4 版;已完成的检验不能修改,只能新建一次检验。报价版本不可变,审计条目不可变,交易台账条目也不可变。

哪些记录不可变: 审计事件、台账条目、文件版本、检验结果、审批记录、验证产物和状态转换日志。

如何更正: 不可变记录永远不做编辑,而是用一条引用原记录的新记录取而代之。系统借助物化快照维护“当前视图”,同时保留完整历史。

这在架构上相当于汽车的事件数据记录器(俗称“黑匣子”):没有人能回过头去悄悄改动记录。正是这一特性,让整个平台的可审计性来自设计本身,而不是靠人力硬撑。


2)守卫、执行、证明:通用的生命周期

系统中的每个工作流程都遵循同一个三段式节奏。

守卫: 操作执行之前,系统先检查它该不该执行。安全护栏核实这不是一次重复操作,质量关卡核实物料已通过检验,审批流程核实变更已由有权批准的人授权。

执行: 操作发生。库存移动,工单推进,报价被接受,付款完成结算。

证明: 系统记录所发生的一切,并保留完整的溯源信息。取证分析记录审计追踪,验证包固化证据,文件包准确记录用到了哪些版本。

守卫失败与执行失败: 守卫失败表示操作在任何状态变更之前就被拒绝(检测到重复、未通过关卡、未经授权);执行失败表示操作已经开始,但无法完成(外部系统宕机、违反约束)。守卫检查依靠幂等键和状态机转换守卫,在竞态条件下依然保持稳定。

“证明”产出什么: 每个完成的操作都会产出一份证明产物:一条带有稳定 ID 的不可变记录,关联执行时已有的证据(文件版本、检验结果、审批链)。这些产物可查询、可导出。

这就是“安全带联锁 → 驾驶 → 事件数据记录器”的模式。每个引擎、每项功能、每个行业,概莫能外。


3)状态机:没有什么会“说变就变”

系统中每个重要实体都在受管控的状态机中流转。序列化资产开箱即带 24 种生命周期状态,租户还可以扩展。容器有生命周期状态,工单有状态,报价有状态,采购阶段也有状态。

有了状态机,就不能跳过必经的中间状态,直接从“草稿”跳到“已发运”,就像时速 60 英里时,不能从驻车挡直接换到倒挡。系统强制执行合法的状态转换,并记录每一次转换。

由配置驱动,而非由代码驱动: 状态机定义是配置,而不是写死的逻辑。租户可以为自己的工作流程扩展允许的状态转换。流程进行中策略发生变化时,在途实体继续沿用原有规则(带版本的状态机快照),新实体则采用更新后的定义。

正是这一点,让平台在压力之下依然可预期。系统一忙,人就会抄近路;状态机不会。


4)图遍历:顺着关联走下去

平台中最强大的计算,源自最简单的想法:从一个对象出发,顺着关联走下去,看看它会波及什么。

Impact Intelligence(影响智能分析)用它来计算变更影响:“如果修改这份材料规格,哪些工单、检验、供应商和文件会受到影响?”它会遍历整张运营图谱。

同样的模式随处可见。容器嵌套用递归遍历来解析嵌套托盘里装了什么;保管链遍历序列化资产的事件历史;工单依赖遍历依赖图,找出哪些工作受阻。

边如何产生: 大多数边由业务事件显式创建(工单引用了某个 SKU,文件附加到了变更申请上)。也有一些边从配置推导而来(某供应商获准供应某类物料)。系统会在遍历结果中区分显式边和推导边。

防止图谱漂移: 创建边时,系统会对照两端节点的当前状态校验这条边。过时的边(引用已删除或已被取代的节点)会被标记为失效而不是删除,从而保留审计历史。遍历查询可以选择包含或排除失效边。

未知依赖: 图谱表示的是已知关系。如果遍历止步于某些节点,而这类节点通常应当有某类出边却没有,Impact Intelligence 就会标记“覆盖缺口”,把潜在盲区提出来供人审查。

从根本上说,平台就是一张互联的运营数据地图,业务规则落在每一条边上。正因如此,无需定制集成工作,也能实现跨领域的洞察。


5)证据链:主张、证明、签核

系统中所有受监管、高信任要求的工作流程,都遵循同一个抽象模式:

  • 有人主张某件事应当发生(变更申请、采购订单、处置决定)。
  • 系统采集证明(检验结果、文件版本、影响分析、成本估算)。
  • 获得授权的一方签核(审批流程、外部签收、质量关卡处置)。

作为数据对象: 主张、证明和签核都是一等实体,带有稳定 ID、时间戳和操作人归属,彼此关联,构成一条可验证的链。

验证级别: 证据链会写入审计日志,并具备篡改可察觉的特性(仅追加存储、用于完整性校验的哈希链)。外部签收和高信任工作流程可以使用密码学签名。证据包可以导出为自包含的数据包,附带保留期元数据,用于合规归档。

这一模式支撑着:

  • 质量门控采购: 检验 → 处置 → 付款放行
  • 文件控制: 版本 → 文件包 → 签收
  • 验证包: 影响分析 → 确认计划 → 验证产物
  • 变更控制: 变更申请 → 影响评估 → 批准

抽象模式相同,名词不同。正因如此,一个平台无需十一套代码库,就能服务十一个行业。


下一步

如果还没读过架构概览,请从为什么每个行业都需要同样的八大引擎读起。

想详细了解各个引擎,请浏览引擎目录。

打算动手构建,就到 /developers 申请 API 访问权限。

分享本文

觉得有用?不妨分享给团队。

结合工作流程来看

看看理念背后的实际记录。

带着一个工作流程或运营问题来,我们会演示相关应用记录与职责之间如何关联。