docs(tests): explain ledger scheduling replay and local elision
This commit is contained in:
@@ -1,11 +1,19 @@
|
||||
/**
|
||||
* 操作账本与调度基础结构的单元测试。账本保存依赖、冻结请求和执行证据;队列及堆只决定处理顺序。
|
||||
* 这里直接操作内存账本,验证状态机与压缩规则,不代表网络或持久存储已经完成。
|
||||
*/
|
||||
import { test } from 'node:test';
|
||||
import assert from 'node:assert/strict';
|
||||
import { createDeque, createMinHeap } from '../../src/lib/canvas-runtime/structures.ts';
|
||||
import { createLedger, compressChanges } from '../../src/lib/canvas-runtime/ledger.ts';
|
||||
// 固定的文本元素快照;完整几何和 incarnation 让字段压缩与身份检查有明确基线。
|
||||
const node = { id: 'a', incarnation: 1, ownerCanvasId: 'root', componentId: 'text', dataVersion: 1, data: { title: 'a', text: '' }, structure: 'node', geometry: { x: 0, y: 0, width: 20, height: 20, rotation: 0 } };
|
||||
// 构造最小文档操作;依赖由各用例显式传入,避免默认依赖掩盖错误。
|
||||
const intent = (id, changes = [], dependencies = []) => ({ id, operationType: 'document.change', operationSchemaVersion: 1, sequence: 1, origin: 'user', changes, dependencies });
|
||||
// 把 create 操作冻结成固定请求;后续状态转换必须保留同一请求 ID 和请求体。
|
||||
const frozen = ledger => ledger.freeze({ id: 'request', operationIds: ['create'], canvasIds: ['root'], expectedVersions: { root: 1 }, payload: { changes: [] } });
|
||||
|
||||
// 先验证大量 FIFO 出入队后的顺序,再验证最小堆以截止时间为主、序号为次序,空容器均返回 undefined。
|
||||
test('FIFO retains order across compaction; retry heap orders deadline then sequence', () => {
|
||||
const queue = createDeque(); for (let i = 0; i < 4000; i++) queue.push(i);
|
||||
for (let i = 0; i < 4000; i++) assert.equal(queue.pop(), i);
|
||||
@@ -16,6 +24,7 @@ test('FIFO retains order across compaction; retry heap orders deadline then sequ
|
||||
assert.equal(heap.pop(), undefined);
|
||||
});
|
||||
|
||||
// 仅针对完全未发送的修改:改名和移动折叠进创建对象,随后删除可抵消整个创建过程,移动不能覆盖标题。
|
||||
test('wholly unsent create-data-delete disappears but a position update preserves the title', () => {
|
||||
const create = { kind: 'element', id: 'a', before: null, after: node };
|
||||
const rename = { kind: 'field', target: { id: 'a', incarnation: 1 }, field: 'data.title', before: 'a', after: 'renamed', beforePresent: true, afterPresent: true };
|
||||
@@ -25,6 +34,7 @@ test('wholly unsent create-data-delete disappears but a position update preserve
|
||||
assert.deepEqual(compressChanges([...compressed, { kind: 'element', id: 'a', before: compressed[0].after, after: null }]), []);
|
||||
});
|
||||
|
||||
// 未知和已受理都保留“可能执行”证据并阻塞依赖删除;只有 applied 才放行,重派发仍使用原请求体。
|
||||
test('frozen identity remains exact after unknown/accepted outcomes and deletion is a separate pending operation', () => {
|
||||
const ledger = createLedger(); ledger.add(intent('create'), { a: 'absent' });
|
||||
const request = frozen(ledger), body = request.body;
|
||||
@@ -38,6 +48,7 @@ test('frozen identity remains exact after unknown/accepted outcomes and deletion
|
||||
ledger.result('request', 'applied'); assert.equal(ledger.eligible('delete'), true);
|
||||
});
|
||||
|
||||
// 拒绝缺失依赖及同 ID 不同意图;旧代次落盘完成不能把后来新增的操作一并标记为持久化。
|
||||
test('dependencies are explicit, duplicate identities conflict and late durable completion does not mark newer work durable', () => {
|
||||
const ledger = createLedger();
|
||||
assert.throws(() => ledger.add(intent('child', [], ['missing']), {}), /dependency_missing/);
|
||||
@@ -48,6 +59,7 @@ test('dependencies are explicit, duplicate identities conflict and late durable
|
||||
assert.equal(ledger.eligible('second'), false);
|
||||
});
|
||||
|
||||
// 恢复后先保留可能执行的风险;明确零写入结果将原操作阻塞,并拒绝再把同一终态改写为成功。
|
||||
test('recovery retains possible application; explicit terminal zero-write does not pretend dependent writes succeeded', () => {
|
||||
const original = createLedger(); original.add(intent('create'), {}); frozen(original); original.markDispatch('request');
|
||||
const restored = createLedger(original.getSnapshot());
|
||||
|
||||
Reference in New Issue
Block a user