M5(2/3): process 用例与流转 —— 流程引擎的确定性调度
- routing domain:选边(XOR 恰取一条 + 默认分支兜底;AND 全走)、边映射装配(四类来源 + S-FEEL 转换)、AND 汇合回齐(容忍分支不阻汇合)、审批点驳回走向声明式 - process-service:起单 → 调度节点 → 负责人四策略解析(结果与依据留痕)→ 活动起单 / 审批点卡工位 / 终点收束按来源回执;任务终态到达继续流转或走失败走向四选一; 审批驳回按声明回指定节点重开新实例;状态每次变动后重算聚合投影 - adapter:流程包(id × version)、工作流实例、节点实例三表持久 —— 崩溃后可续跑 ADR 待补项登记为 debt M5-1:§6.1 的 Mastra workflow 编译器作为可替换 adapter 后补, 当前由自持确定性状态机承担,语义等价、usecase 不动 325 个测试通过,门禁五道全绿 Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01KeDBx2PHLavbURXB8LJJ7m
This commit is contained in:
co-authored by
Claude Opus 5
parent
291fc39179
commit
a8f6eef610
@@ -0,0 +1,174 @@
|
||||
/**
|
||||
* process 存储 adapter —— Drizzle 只准出现在 adapter(编码规范 §5.3)。
|
||||
*/
|
||||
import { and, asc, desc, eq } from 'drizzle-orm';
|
||||
import type { ProcessPackage, TerminalState, WorkflowState } from '@contracts';
|
||||
import { processPackageSchema } from '@contracts';
|
||||
import type { Db } from '@shared/db.ts';
|
||||
import type { ProcessStore, WorkflowRecord } from '../../port.ts';
|
||||
import type { NodeInstance } from '../domain/owner-resolution.ts';
|
||||
import { nodeInstanceTable, processPackageTable, workflowTable } from './process-schema.ts';
|
||||
|
||||
type WorkflowRow = typeof workflowTable.$inferSelect;
|
||||
|
||||
function toWorkflow(row: WorkflowRow): WorkflowRecord {
|
||||
return {
|
||||
id: row.id,
|
||||
packageId: row.packageId,
|
||||
packageVersion: row.packageVersion,
|
||||
subject: row.subject,
|
||||
state: row.state as WorkflowState,
|
||||
source: row.source as WorkflowRecord['source'],
|
||||
initiation: row.initiation as Record<string, unknown>,
|
||||
ports: row.ports as Record<string, Record<string, unknown>>,
|
||||
vars: row.vars as Record<string, unknown>,
|
||||
startedAt: row.startedAt.toISOString(),
|
||||
...(row.finishedAt === null ? {} : { finishedAt: row.finishedAt.toISOString() }),
|
||||
};
|
||||
}
|
||||
|
||||
export function createProcessStore(db: Db): ProcessStore {
|
||||
return {
|
||||
async savePackage(pkg: ProcessPackage) {
|
||||
await db
|
||||
.insert(processPackageTable)
|
||||
.values({ id: pkg.id, version: pkg.version, name: pkg.name, state: pkg.state, definition: pkg })
|
||||
.onConflictDoUpdate({
|
||||
target: [processPackageTable.id, processPackageTable.version],
|
||||
set: { name: pkg.name, state: pkg.state, definition: pkg },
|
||||
});
|
||||
},
|
||||
|
||||
async getPackage(id, version) {
|
||||
const conditions = [eq(processPackageTable.id, id)];
|
||||
if (version !== undefined) conditions.push(eq(processPackageTable.version, version));
|
||||
const rows = await db
|
||||
.select()
|
||||
.from(processPackageTable)
|
||||
.where(and(...conditions))
|
||||
.orderBy(desc(processPackageTable.version))
|
||||
.limit(1);
|
||||
return rows[0] === undefined ? undefined : processPackageSchema.parse(rows[0].definition);
|
||||
},
|
||||
|
||||
async listPackages() {
|
||||
const rows = await db.select().from(processPackageTable).orderBy(asc(processPackageTable.name));
|
||||
return rows.map((r) => processPackageSchema.parse(r.definition));
|
||||
},
|
||||
|
||||
async publishPackage(id, version) {
|
||||
const rows = await db
|
||||
.select()
|
||||
.from(processPackageTable)
|
||||
.where(and(eq(processPackageTable.id, id), eq(processPackageTable.version, version)))
|
||||
.limit(1);
|
||||
const row = rows[0];
|
||||
if (row === undefined) return;
|
||||
const definition = { ...(row.definition as Record<string, unknown>), state: 'published' };
|
||||
await db
|
||||
.update(processPackageTable)
|
||||
.set({ state: 'published', publishedAt: new Date(), definition })
|
||||
.where(and(eq(processPackageTable.id, id), eq(processPackageTable.version, version)));
|
||||
},
|
||||
|
||||
async insertWorkflow(record) {
|
||||
await db.insert(workflowTable).values({
|
||||
id: record.id,
|
||||
packageId: record.packageId,
|
||||
packageVersion: record.packageVersion,
|
||||
subject: record.subject,
|
||||
state: record.state,
|
||||
source: record.source,
|
||||
initiation: record.initiation,
|
||||
ports: record.ports,
|
||||
vars: record.vars,
|
||||
startedAt: new Date(record.startedAt),
|
||||
});
|
||||
},
|
||||
|
||||
async getWorkflow(id) {
|
||||
const rows = await db.select().from(workflowTable).where(eq(workflowTable.id, id)).limit(1);
|
||||
return rows[0] === undefined ? undefined : toWorkflow(rows[0]);
|
||||
},
|
||||
|
||||
async listWorkflows(limit) {
|
||||
const rows = await db.select().from(workflowTable).orderBy(desc(workflowTable.startedAt)).limit(limit);
|
||||
return rows.map(toWorkflow);
|
||||
},
|
||||
|
||||
async updateWorkflow(id, patch) {
|
||||
const values: Record<string, unknown> = {};
|
||||
if (patch.state !== undefined) values['state'] = patch.state;
|
||||
if (patch.ports !== undefined) values['ports'] = patch.ports;
|
||||
if (patch.vars !== undefined) values['vars'] = patch.vars;
|
||||
if (patch.finishedAt !== undefined) values['finishedAt'] = new Date(patch.finishedAt);
|
||||
const [row] = await db.update(workflowTable).set(values).where(eq(workflowTable.id, id)).returning();
|
||||
if (row === undefined) throw new Error(`工作流不存在:${id}`);
|
||||
return toWorkflow(row);
|
||||
},
|
||||
|
||||
async listInstances(workflowId) {
|
||||
const rows = await db
|
||||
.select()
|
||||
.from(nodeInstanceTable)
|
||||
.where(eq(nodeInstanceTable.workflowId, workflowId))
|
||||
.orderBy(asc(nodeInstanceTable.createdAt));
|
||||
return rows.map(
|
||||
(r): NodeInstance => ({
|
||||
nodeId: r.nodeId,
|
||||
instance: r.instance,
|
||||
running: r.running,
|
||||
waiting: r.waiting,
|
||||
activated: r.activated,
|
||||
...(r.terminal === null ? {} : { terminal: r.terminal as TerminalState }),
|
||||
...(r.failureDigested === null ? {} : { failureDigested: r.failureDigested }),
|
||||
}),
|
||||
);
|
||||
},
|
||||
|
||||
async insertInstance(workflowId, instance) {
|
||||
await db.insert(nodeInstanceTable).values({
|
||||
workflowId,
|
||||
nodeId: instance.nodeId,
|
||||
instance: instance.instance,
|
||||
running: instance.running,
|
||||
waiting: instance.waiting,
|
||||
activated: instance.activated,
|
||||
terminal: instance.terminal ?? null,
|
||||
failureDigested: instance.failureDigested ?? null,
|
||||
taskId: instance.taskId ?? null,
|
||||
approvalId: instance.approvalId ?? null,
|
||||
});
|
||||
},
|
||||
|
||||
async updateInstance(workflowId, nodeId, instance, patch) {
|
||||
const values: Record<string, unknown> = {};
|
||||
if (patch.running !== undefined) values['running'] = patch.running;
|
||||
if (patch.waiting !== undefined) values['waiting'] = patch.waiting;
|
||||
if (patch.terminal !== undefined) values['terminal'] = patch.terminal;
|
||||
if (patch.failureDigested !== undefined) values['failureDigested'] = patch.failureDigested;
|
||||
if (patch.taskId !== undefined) values['taskId'] = patch.taskId;
|
||||
if (Object.keys(values).length === 0) return;
|
||||
await db
|
||||
.update(nodeInstanceTable)
|
||||
.set(values)
|
||||
.where(
|
||||
and(
|
||||
eq(nodeInstanceTable.workflowId, workflowId),
|
||||
eq(nodeInstanceTable.nodeId, nodeId),
|
||||
eq(nodeInstanceTable.instance, instance),
|
||||
),
|
||||
);
|
||||
},
|
||||
|
||||
async findInstanceByTask(taskId) {
|
||||
const rows = await db
|
||||
.select()
|
||||
.from(nodeInstanceTable)
|
||||
.where(eq(nodeInstanceTable.taskId, taskId))
|
||||
.limit(1);
|
||||
const row = rows[0];
|
||||
return row === undefined ? undefined : { workflowId: row.workflowId, nodeId: row.nodeId, instance: row.instance };
|
||||
},
|
||||
};
|
||||
}
|
||||
Reference in New Issue
Block a user