Archived
ChaiHaoandClaude Fable 5
ac85ecf2ea
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01KeDBx2PHLavbURXB8LJJ7m
315 lines
13 KiB
TypeScript
315 lines
13 KiB
TypeScript
/**
|
|
* 流程包 DSL 与触发器配置(编码规范 §8.1;语义出处 OS 03)。
|
|
*
|
|
* 流程包 = 调用接口 + 两种活动(声明)+ 审批点 + 两种网关;工作流 = 其运行时实例。
|
|
* 触发器与流程包**平级**:不入流程包结构、不随流程包版本,配置独立存放。
|
|
*
|
|
* 编排铁律:**连线即映射,画图即校验,不闭合不得发布** —— 存在未完成边、未满足必填
|
|
* 或类型冲突的流程包可存草稿、不得发布。校验算法在 `process` 的 domain,本文件只定形状。
|
|
*/
|
|
import { z } from 'zod';
|
|
import {
|
|
activityIdSchema,
|
|
nodeIdSchema,
|
|
processPackageIdSchema,
|
|
staffIdSchema,
|
|
triggerIdSchema,
|
|
} from './id.ts';
|
|
import { jsonSchemaSchema } from './contract7.ts';
|
|
|
|
/* ── 负责人四策略(OS 03) ──────────────────────────────────────────── */
|
|
|
|
export const OWNER_STRATEGIES = ['assigned', 'sole', 'rotation', 'follow-source'] as const;
|
|
export const ownerStrategySchema = z.enum(OWNER_STRATEGIES);
|
|
export type OwnerStrategy = z.infer<typeof ownerStrategySchema>;
|
|
|
|
export const OWNER_STRATEGY_LABEL: Readonly<Record<OwnerStrategy, string>> = {
|
|
assigned: '指定人',
|
|
sole: '岗位唯一人',
|
|
rotation: '轮值',
|
|
'follow-source': '来源跟随',
|
|
};
|
|
|
|
export const ownerSpecSchema = z.object({
|
|
/** 编排声明岗位,起单时确定性解析 */
|
|
position: z.string().min(1),
|
|
strategy: ownerStrategySchema.default('sole'),
|
|
/** strategy = assigned 时直接绑定员工(慎用) */
|
|
staffId: staffIdSchema.optional(),
|
|
});
|
|
export type OwnerSpec = z.infer<typeof ownerSpecSchema>;
|
|
|
|
/* ── 边与载荷映射 ────────────────────────────────────────────────────── */
|
|
|
|
/**
|
|
* 映射来源四类:上游输出口载荷字段 / 流程变量 / 起单载荷 / 常量;
|
|
* 允许 S-FEEL 表达式做转换(与触发器字段映射同一形式)。
|
|
*/
|
|
export const mappingSourceSchema = z.discriminatedUnion('from', [
|
|
z.object({ from: z.literal('output-port'), port: z.string().min(1), path: z.string().min(1) }),
|
|
z.object({ from: z.literal('workflow-var'), name: z.string().min(1) }),
|
|
z.object({ from: z.literal('initiation'), path: z.string().min(1) }),
|
|
z.object({ from: z.literal('constant'), value: z.unknown() }),
|
|
z.object({ from: z.literal('expression'), sfeel: z.string().min(1) }),
|
|
]);
|
|
export type MappingSource = z.infer<typeof mappingSourceSchema>;
|
|
|
|
export const fieldMappingSchema = z.object({
|
|
/** 下游活动契约 data 的字段路径 */
|
|
target: z.string().min(1),
|
|
source: mappingSourceSchema,
|
|
});
|
|
export type FieldMapping = z.infer<typeof fieldMappingSchema>;
|
|
|
|
export const edgeSchema = z.object({
|
|
id: z.string().min(1),
|
|
from: nodeIdSchema,
|
|
to: nodeIdSchema,
|
|
/** XOR 网关出边的条件(S-FEEL);AND 出边留空 */
|
|
condition: z.string().optional(),
|
|
/** 连一条边即须完成该边映射 —— 必填未映射 = 边未完成 */
|
|
mapping: z.array(fieldMappingSchema).default([]),
|
|
/** 边标签:画布上的出口名(如「TYPE-A」「通过」) */
|
|
label: z.string().optional(),
|
|
/** 边标签色调(呈现):ok = 绿(通过类) / bad = 红(驳回类) */
|
|
tone: z.enum(['ok', 'bad']).optional(),
|
|
/** 回边标记:人裁决后重开新任务实例(同节点、新任务 ID、留痕关联) */
|
|
reopen: z.boolean().default(false),
|
|
});
|
|
export type Edge = z.infer<typeof edgeSchema>;
|
|
|
|
/* ── 失败走向四选一(OS 03) ────────────────────────────────────────── */
|
|
|
|
export const failureDispositionSchema = z.discriminatedUnion('kind', [
|
|
z.object({ kind: z.literal('terminate') }),
|
|
z.object({ kind: z.literal('reroute'), edgeId: z.string().min(1) }),
|
|
z.object({ kind: z.literal('escalate'), approvalNodeId: nodeIdSchema }),
|
|
/** 仅限 AND 分支;静态校验其下游映射不得依赖该分支的必填字段 */
|
|
z.object({ kind: z.literal('tolerate') }),
|
|
]);
|
|
export type FailureDisposition = z.infer<typeof failureDispositionSchema>;
|
|
|
|
export const FAILURE_DISPOSITION_LABEL: Readonly<Record<FailureDisposition['kind'], string>> = {
|
|
terminate: '终止流',
|
|
reroute: '改道',
|
|
escalate: '升审批',
|
|
tolerate: '容忍',
|
|
};
|
|
|
|
/* ── 催办阶梯(时限机制复用) ────────────────────────────────────────── */
|
|
|
|
export const nudgeLadderSchema = z.object({
|
|
/** ISO-8601 duration */
|
|
deadline: z.string().min(2),
|
|
steps: z.array(z.object({ after: z.string().min(2), action: z.enum(['nudge', 'escalate']) })).default([]),
|
|
});
|
|
export type NudgeLadder = z.infer<typeof nudgeLadderSchema>;
|
|
|
|
/* ── 节点 ─────────────────────────────────────────────────────────────── */
|
|
|
|
export const GATEWAY_KINDS = ['parallel', 'exclusive'] as const;
|
|
export const gatewayKindSchema = z.enum(GATEWAY_KINDS);
|
|
export type GatewayKind = z.infer<typeof gatewayKindSchema>;
|
|
|
|
export const GATEWAY_KIND_LABEL: Readonly<Record<GatewayKind, string>> = {
|
|
parallel: '并行网关',
|
|
exclusive: '异或网关',
|
|
};
|
|
|
|
const nodeBase = {
|
|
id: nodeIdSchema,
|
|
label: z.string().min(1),
|
|
/** 画布上的第二行小字(如「照谱执行 / 临场演绎」)—— 呈现注记,不影响语义 */
|
|
sub: z.string().optional(),
|
|
/**
|
|
* 画布坐标 —— 布局引擎的输入;不影响语义。
|
|
* row/col = 编译布局的行列;x/y = **手绘几何**(编辑器保存后,手绘成为呈现真相)。
|
|
*/
|
|
layout: z
|
|
.object({
|
|
row: z.number().int(),
|
|
col: z.number().int(),
|
|
x: z.number().optional(),
|
|
y: z.number().optional(),
|
|
})
|
|
.optional(),
|
|
};
|
|
|
|
export const processNodeSchema = z.discriminatedUnion('kind', [
|
|
z.object({ ...nodeBase, kind: z.literal('start') }),
|
|
z.object({
|
|
...nodeBase,
|
|
kind: z.literal('end'),
|
|
/** 流程包显式终点的输出声明 */
|
|
output: jsonSchemaSchema.optional(),
|
|
}),
|
|
z.object({
|
|
...nodeBase,
|
|
kind: z.literal('activity'),
|
|
/** 以声明入流:引用活动库中已安装的活动 */
|
|
activityId: activityIdSchema,
|
|
/**
|
|
* 契约注记(编排定契约,AM 03):这个节点**声明**吃什么、吐什么。
|
|
* 是「导出依赖文件」的骨架 —— 开发者对着声明在系统外开发活动;
|
|
* 闭合校验的机检仍以边映射与活动契约面为准,注记是给人读的那一层。
|
|
*/
|
|
in: z.array(z.string()).optional(),
|
|
out: z.array(z.string()).optional(),
|
|
/** 版本约束:留空 = 装配时取最新生效版 */
|
|
activityVersion: z.string().optional(),
|
|
owner: ownerSpecSchema,
|
|
failure: failureDispositionSchema.default({ kind: 'terminate' }),
|
|
/** 委托消息模板,可插值载荷字段;缺省为空 */
|
|
message: z.string().optional(),
|
|
}),
|
|
z.object({
|
|
...nodeBase,
|
|
kind: z.literal('approval'),
|
|
/** 审批点功能属性四件:审批岗位 / 输入装配映射 / 驳回走向 / 催办阶梯 */
|
|
approver: ownerSpecSchema,
|
|
/** 驳回走向:声明式,不由临场决定 */
|
|
reject: z.discriminatedUnion('kind', [
|
|
z.object({ kind: z.literal('reopen'), nodeId: nodeIdSchema, mapping: z.array(fieldMappingSchema).default([]) }),
|
|
z.object({ kind: z.literal('terminate') }),
|
|
]),
|
|
nudge: nudgeLadderSchema.optional(),
|
|
message: z.string().optional(),
|
|
}),
|
|
z.object({
|
|
...nodeBase,
|
|
kind: z.literal('gateway'),
|
|
gateway: gatewayKindSchema,
|
|
/** 分叉 / 汇合 */
|
|
mode: z.enum(['fork', 'join']),
|
|
/** 判据说明(人读):条件本体仍在出边的 S-FEEL 上,这里是「为什么这么分」 */
|
|
basis: z.string().optional(),
|
|
}),
|
|
]);
|
|
export type ProcessNode = z.infer<typeof processNodeSchema>;
|
|
|
|
/* ── 调用接口:流程包的唯一出入口 ───────────────────────────────────── */
|
|
|
|
export const callInterfaceSchema = z.object({
|
|
input: jsonSchemaSchema,
|
|
/** 显式终点的输出声明 —— 末端输出载荷按此交付、按来源回执 */
|
|
output: jsonSchemaSchema,
|
|
});
|
|
export type CallInterface = z.infer<typeof callInterfaceSchema>;
|
|
|
|
/* ── 流程包 ───────────────────────────────────────────────────────────── */
|
|
|
|
export const PROCESS_PACKAGE_STATES = ['draft', 'published', 'retired'] as const;
|
|
export const processPackageStateSchema = z.enum(PROCESS_PACKAGE_STATES);
|
|
export type ProcessPackageState = z.infer<typeof processPackageStateSchema>;
|
|
|
|
export const processPackageSchema = z.object({
|
|
id: processPackageIdSchema,
|
|
name: z.string().min(1),
|
|
version: z.number().int().min(1),
|
|
state: processPackageStateSchema,
|
|
callInterface: callInterfaceSchema,
|
|
nodes: z.array(processNodeSchema).min(2),
|
|
edges: z.array(edgeSchema),
|
|
/** 流程变量声明:边映射的 workflow-var 来源 */
|
|
variables: z.array(z.object({ name: z.string().min(1), schema: jsonSchemaSchema })).default([]),
|
|
description: z.string().optional(),
|
|
/**
|
|
* 手绘图存证(可空):编辑器保存的 FlowGraph 原样落此 —— **手绘几何即呈现真相**。
|
|
* 语义(节点/边/映射)永远以上面的 nodes/edges 为准,流转判断不读它;
|
|
* 它只承载语义装不下的画布事实:卡点、行分组、锚定、折线点。
|
|
*/
|
|
diagram: z.record(z.string(), z.unknown()).optional(),
|
|
});
|
|
export type ProcessPackage = z.infer<typeof processPackageSchema>;
|
|
|
|
/* ── 编排校验的报告形状(前端画布即时预览与后端裁决同源) ───────────── */
|
|
|
|
export const CLOSURE_VIOLATION_KINDS = [
|
|
'edge-unmapped',
|
|
'required-unmapped',
|
|
'type-conflict',
|
|
'dangling-node',
|
|
'gateway-unbalanced',
|
|
'join-ambiguous-source',
|
|
'tolerate-required-dependency',
|
|
'unknown-activity',
|
|
'missing-owner-position',
|
|
] as const;
|
|
export const closureViolationKindSchema = z.enum(CLOSURE_VIOLATION_KINDS);
|
|
export type ClosureViolationKind = z.infer<typeof closureViolationKindSchema>;
|
|
|
|
export const closureViolationSchema = z.object({
|
|
kind: closureViolationKindSchema,
|
|
nodeId: nodeIdSchema.optional(),
|
|
edgeId: z.string().optional(),
|
|
field: z.string().optional(),
|
|
message: z.string(),
|
|
});
|
|
export type ClosureViolation = z.infer<typeof closureViolationSchema>;
|
|
|
|
export const closureReportSchema = z.object({
|
|
publishable: z.boolean(),
|
|
violations: z.array(closureViolationSchema),
|
|
});
|
|
export type ClosureReport = z.infer<typeof closureReportSchema>;
|
|
|
|
/* ── 触发器三类(OS 3.1) ──────────────────────────────────────────── */
|
|
|
|
export const TRIGGER_KINDS = ['periodic', 'event', 'registration'] as const;
|
|
export const triggerKindSchema = z.enum(TRIGGER_KINDS);
|
|
export type TriggerKind = z.infer<typeof triggerKindSchema>;
|
|
|
|
export const TRIGGER_KIND_LABEL: Readonly<Record<TriggerKind, string>> = {
|
|
periodic: '周期触发',
|
|
event: '事件触发',
|
|
registration: '登记触发',
|
|
};
|
|
|
|
export const triggerConfigSchema = z.object({
|
|
id: triggerIdSchema,
|
|
name: z.string().min(1),
|
|
enabled: z.boolean().default(true),
|
|
/** 触发器只知道调用接口,不知流程内部 */
|
|
processPackageId: processPackageIdSchema,
|
|
/** 起单载荷装配:事件信封与载荷字段 → 调用接口的 data 字段;缺必填即起单失败入死信 */
|
|
mapping: z.array(fieldMappingSchema).default([]),
|
|
/**
|
|
* 判别式取**四个互斥值**:周期触发的两型(日历 / 数据日历)在此展开 ——
|
|
* `TRIGGER_KINDS` 仍是三类分类学(周期 / 事件 / 登记),两者以 `triggerKindOf()` 对应。
|
|
*/
|
|
spec: z.discriminatedUnion('kind', [
|
|
z.object({
|
|
kind: z.literal('periodic-calendar'),
|
|
/** cron 风格的日历表达式 */
|
|
calendar: z.string().min(1),
|
|
}),
|
|
z.object({
|
|
kind: z.literal('periodic-data'),
|
|
/** 数据日历型:按台账日期字段 + 偏移 + 过滤条件逐行起单 */
|
|
domain: z.string().min(1),
|
|
object: z.string().min(1),
|
|
dateField: z.string().min(1),
|
|
/** 偏移:如 -P3D 表示日期字段前 3 天 */
|
|
offset: z.string().min(2),
|
|
filter: z.string().optional(),
|
|
}),
|
|
z.object({
|
|
kind: z.literal('event'),
|
|
/** 命中规则:S-FEEL,对事件信封与载荷字段求值 */
|
|
rule: z.string().min(1),
|
|
eventType: z.enum(['data', 'time', 'human', 'control']).default('data'),
|
|
}),
|
|
z.object({
|
|
kind: z.literal('registration'),
|
|
/** 登记表单由调用接口 schema 自动渲染 */
|
|
formHint: z.string().optional(),
|
|
}),
|
|
]),
|
|
});
|
|
export type TriggerConfig = z.infer<typeof triggerConfigSchema>;
|
|
|
|
/** 四个判别值 → 三类分类学(OS 3.1) */
|
|
export function triggerKindOf(spec: TriggerConfig['spec']): TriggerKind {
|
|
return spec.kind === 'event' ? 'event' : spec.kind === 'registration' ? 'registration' : 'periodic';
|
|
}
|