2. 核心概念：任务、工作流、节点、边、状态、上下文的定义与关系

在 IAM 异步任务编排引擎中，核心概念是构建一切复杂流程的基石。理解 任务（Task）、工作流（Workflow）、节点（Node）、边（Edge）、状态（State） 和 上下文（Context） 的定义及其相互关系，是掌握引擎架构的第一步。这些概念共同构成了一个可描述、可执行、可观测的编排模型。

2.1 核心概念定义

2.2 概念关系与编排模型

这六个概念并非孤立存在，它们通过以下关系构成一个完整的编排体系：

• 工作流包含节点和边： 一个 Workflow 由一组 Node 和连接它们的 Edge 组成，形成 DAG 结构。
• 节点引用任务： 每个执行类型的 Node 内部引用一个具体的 Task 定义。一个 Task 可以被多个 Node 引用。
• 边决定流转： Edge 不仅定义了顺序，还可以携带条件表达式（Condition），实现分支、并行、聚合等复杂编排模式。
• 状态附着于实例： State 属于运行时的 Workflow 实例或 Task 实例，而非定义本身。
• 上下文贯穿全局： Context 是工作流实例的“背包”，所有节点均可读写，是数据传递的唯一通道。

2.3 状态机与生命周期

每个工作流实例和任务实例都遵循一个有限状态机模型。状态转换由引擎核心驱动，确保流程的可观测性和可靠性。

工作流实例状态

• INIT：实例已创建，等待调度。
• RUNNING：至少一个节点正在执行。
• SUSPENDED：流程因等待外部输入或条件不满足而暂停。
• SUCCEEDED：所有节点执行成功，流程正常结束。
• FAILED：节点执行失败且无补偿策略，流程终止。
• TERMINATED：被手动终止或超时强制结束。

任务实例状态

• PENDING：等待被调度器分配。
• RUNNING：任务正在执行中。
• SUCCEEDED：任务执行成功，输出已写入上下文。
• FAILED：任务抛出异常或返回错误码。
• RETRYING：引擎根据重试策略自动重新调度。
• TIMEOUT：执行时间超过配置阈值。

2.4 上下文传递机制

上下文（Context）是工作流实例的“共享内存”。它采用 键值对（Key-Value） 结构，并支持以下特性：

• 作用域隔离： 每个工作流实例拥有独立的上下文，互不干扰。
• 节点级读写： 上游节点写入的数据，下游节点可以读取。引擎保证写后读的可见性。
• 快照与回滚： 在关键节点执行前，引擎会对上下文进行快照。如果后续节点失败并触发回滚，可以恢复到快照点。
• 序列化传输： 上下文数据会被序列化为 JSON 或 Protobuf，在分布式节点间传递。

2.5 概念关系总结

在 IAM 异步任务编排引擎中，这六个核心概念形成了一个从 定义 到 编排 再到 运行时 的完整闭环：

1. 设计时： 开发者定义 Task 和 Context 结构，使用 Node 和 Edge 组装成 Workflow。
2. 运行时： 引擎实例化 Workflow，为每个实例分配独立的 Context，并根据 Edge 的指向调度 Node 执行对应的 Task。
3. 观测时： 每个 Node 和 Workflow 实例的 State 变化被持久化，用于监控、告警和事后审计。