引擎层：存储、索引与执行

引擎做四件事

上一课写下的是定义。让定义活起来的是引擎层。不管内部怎么实现，它做的事就四件，顺序也是一条数据的旅程：

数据源只读地进来，落成对象；人和智能体通过 Action 改它；读的人拿到的，永远是合并之后的当前值。数据源一变，对象就要跟着变，把数据源搬进对象、让它能被快速查询的这一步，通常叫索引。

当前值 = 数据源的值 + 改动

同一个属性有两个来源：数据源同步来的值，和人或智能体通过 Action 改的值。引擎把两层叠起来读，改动在上面。看一张工单的 status：

未配 writeback 时，改动只落在语义层。读对象时，overridden 提示被改动盖住的属性，sourceGone 表示源头已无此行，rev 每改一次加 1。写入带 ifRev 可防止并发覆盖。

ifRev 用在两处：旧写法的 aidc semantic act … --if-rev N，以及开发者直接写数据。对不上就返回 409 rev_mismatch，刷新之后再改。规则式的 Action（例如 hold-work-order）没有 ifRev：它在执行的那一刻判断提交条件，所以两个班组长同时暂停同一张工单，后一个会被条件拦下。

修改语义层不会自动修改 ERP。只有给 Action 配 writeback webhook，才会调用源系统。下一次同步不会冲掉语义层的改动。

读：对象集变成一条 SQL

引擎把对象集编译成一条 SQL，在当前值上执行。符合条件的 Object Type 才有同名 Postgres 视图。部门级类型、受 Markings 或安全策略保护的类型、名字超过 63 字节的类型、没有存储属性的类型不建视图。可用 SQL Console 或 psql 查询已有视图。

例如统计一条产线上各种状态的工单数，就是一条普通的 SELECT：

SELECT status, count(*) AS n
FROM "WorkOrder"
WHERE "lineCode" = 'L1'
GROUP BY status;

派生属性是读时算出来的，不进 SQL 视图，也不能用来过滤或排序。要按它筛选时，先想想它是不是该变成一个存下来的属性。

查询也有规则：搜索条件最多嵌套三层；按属性分组的聚合，缺省最多返回 10,000 组。临时对象集用来把一次查询的结果交给下一次调用，24 小时后过期。

数据接入也是引擎的一部分。连接 SDK 的发布端只读源系统。绑定写在 Object Type 的 datasources 中，也可用 aidc semantic datasource set 配置。平台保存定义后先全量同步，再只同步变化。

写：一个事务，几个上限

新建 Object Type 缺省只能经 Action 改。开发者可直接编辑明确设了 editsConfiguration.onlyAllowPrivilegedEdits: false 的类型。执行 Action 时，引擎先校验参数和提交条件，再在一个事务里写入改动和记录。设计时要记住几个上限：

批量执行先校验全部请求。一个不通过，就全部不写。带 writeback webhook 的 Action 不接受 applyBatch。

这些上限逼你把问题写小：先用条件缩小对象集再取回，分页取而不是一次全拿，大批量的修改拆成几次 Action。

引擎在里面跑，人和程序要从外面进来。下一节看进来的四个入口。