fix md

Author: xlorne

CLAUDE.md

@@ -64,14 +64,16 @@ Note: `app-mobile`, `flow-pc`, and `flow-mobile` are planned but not yet impleme
 The workflow engine is organized into 8 layers:
 
 1. **Workflow Layer** (`com.codingapi.flow.workflow`)
-   - `Workflow` - Top-level container with nodes, edges, form definition
+   - `Workflow` - Top-level container with nodes, form definition
    - `WorkflowBuilder` - Builder pattern for workflow construction
 
 2. **Node Layer** (`com.codingapi.flow.node`)
-   - `IFlowNode` - Interface defining node lifecycle methods
-   - `BaseFlowNode` - Abstract base for all nodes, manages actions and strategies
+   - `IFlowNode` - Interface defining node lifecycle methods, includes `blocks()` method for child nodes
+   - `BaseFlowNode` - Abstract base for all nodes, manages actions, strategies, and blocks
    - `BaseAuditNode` - Abstract base for audit nodes (ApprovalNode, HandleNode)
-   - 12 node types: StartNode, EndNode, ApprovalNode, HandleNode, NotifyNode, ConditionBranchNode, ParallelBranchNode, RouterNode, InclusiveBranchNode, SubProcessNode, DelayNode, TriggerNode
+   - 15 node types: StartNode, EndNode, ApprovalNode, HandleNode, NotifyNode, ConditionBranchNode, ParallelBranchNode, RouterNode, InclusiveBranchNode, SubProcessNode, DelayNode, TriggerNode, ConditionNode, ParallelNode, InclusiveNode
+   - **Block nodes** (containers with child blocks): ConditionNode, ParallelNode, InclusiveNode
+   - **Branch nodes** (child nodes in blocks): ConditionBranchNode, ParallelBranchNode, InclusiveBranchNode
 
 3. **Action Layer** (`com.codingapi.flow.action`, `com.codingapi.flow.action.actions`)
    - `IFlowAction` - Interface for node actions with `copy()` method
@@ -109,7 +111,7 @@ The workflow engine is organized into 8 layers:
 - **Repository Pattern** (`com.codingapi.flow.repository`) - Abstraction for data persistence, isolates framework from implementation. Implementations are in `flow-engine-starter-infra`. Access via `RepositoryHolderContext` singleton.
 - **Gateway Pattern** (`com.codingapi.flow.gateway`) - Anti-corruption layer for external system integration (operators, users). Access via `GatewayContext` singleton.
 - **Domain Objects** (`com.codingapi.flow.domain`) - DelayTask, DelayTaskManager, UrgeInterval
-- **Edge System** (`com.codingapi.flow.edge`) - FlowEdge for node connections
+- **Node State System** (`com.codingapi.flow.manager`) - FlowNodeState for node classification (block nodes vs branch nodes), FlowNodeEdgeManager for traversing node relationships via blocks
 - **Event System** (`com.codingapi.flow.event`) - 5 event types: FlowRecordStartEvent, FlowRecordTodoEvent, FlowRecordDoneEvent, FlowRecordFinishEvent, FlowRecordUrgeEvent
 - **Backup System** (`com.codingapi.flow.backup`) - WorkflowBackup for workflow versioning
 

Design.md

@@ -13,20 +13,22 @@
     - `title`: 流程名称
     - `form`: 流程表单定义 (`FormMeta`)
     - `nodes`: 节点列表 (`List<IFlowNode>`)
-    - `edges`: 节点连接关系 (`List<FlowEdge>`)
     - `operatorCreateScript`: 创建者匹配脚本
-    - `isInterfere`: 是否开启干预
-    - `isRevoke`: 是否开启撤销
+    - `strategies`: 流程策略列表 (`List<IWorkflowStrategy>`)
     - `createdOperator`: 创建者ID
     - `createdTime`: 创建时间
+    - `updatedTime`: 更新时间
     - `schema`: 流程版本标识
 - **核心方法**:
     - `verify()`: 验证流程定义的合法性
-    - `nextNodes(IFlowNode)`: 获取指定节点的后续节点
+    - `nextNodes(IFlowNode)`: 获取指定节点的后续节点（通过FlowNodeEdgeManager遍历blocks）
     - `getStartNode()`: 获取开始节点
     - `getEndNode()`: 获取结束节点
     - `toJson()`: 序列化为JSON
     - `formJson(String)`: 从JSON反序列化（静态方法）
+- **数据结构说明**:
+    - 节点关系通过`blocks`属性实现层次化结构，不再使用单独的`edges`边关系
+    - 流程策略（InterfereStrategy、UrgeStrategy）在流程级别配置
 
 #### WorkflowBuilder
 - **位置**: `com.codingapi.flow.workflow.WorkflowBuilder`
@@ -47,19 +49,23 @@
     3. `generateCurrentRecords(FlowSession)`: 生成当前节点的流程记录
     4. `isDone(FlowSession)`: 判断节点是否完成
     5. `fillNewRecord(FlowSession, FlowRecord)`: 填充新记录数据
-    6. `filterBranches()`: 过滤条件分支
-    7. `actionManager()`: 获取动作管理器
-    8. `nodeStrategyManager()`: 获取策略管理器
+    6. `blocks()`: 获取当前节点的子节点列表（块节点有子节点，其他节点返回null或空）
+    7. `filterBranches()`: 过滤条件分支（块节点用于筛选执行的分支）
+    8. `actionManager()`: 获取动作管理器
+    9. `nodeStrategyManager()`: 获取策略管理器
 
 #### BaseFlowNode
 - **位置**: `com.codingapi.flow.node.BaseFlowNode`
 - **职责**: 所有节点的抽象基类，实现IFlowNode的默认行为
-- **核心属性**: `id`, `name`, `order`, `actions`, `strategies`
+- **核心属性**: `id`, `name`, `order`, `actions`, `strategies`, `blocks`（子节点列表）
 - **核心方法**:
     - `isWaitParallelRecord()`: 判断是否等待并行节点汇聚
     - `verifySession()`: 委托给ActionManager和StrategyManager验证
     - `setActions()`: 支持动作的复制更新（CustomAction除外）
     - `setStrategies()`: 支持策略的复制更新
+    - `blocks()`: 返回子节点列表
+    - `toMap()`: 序列化为Map（包含blocks字段）
+    - `fromMap()`: 从Map反序列化（从blocks字段加载子节点）
 
 #### BaseAuditNode
 - **位置**: `com.codingapi.flow.node.BaseAuditNode`
@@ -73,22 +79,89 @@
     - `isDone()`: 通过StrategyManager判断多人审批完成状态
     - `generateCurrentRecords()`: 通过StrategyManager加载操作者并生成记录
 
-#### 节点类型一览 (12种)
+#### 块节点系统 (Block Nodes System)
+
+**数据结构变更说明**:
+- 旧设计: 使用独立的`FlowEdge`对象和`edges`列表表示节点连接关系
+- 新设计: 使用层次化的`blocks`属性，节点包含子节点形成树形结构
+
+**FlowNodeState** - 节点状态分类
+- **位置**: `com.codingapi.flow.manager.FlowNodeState`
+- **职责**: 对节点进行分类，判断节点类型
+- **节点分类**:
+  - **块节点 (Block Nodes)**: `CONDITION`, `INCLUSIVE`, `PARALLEL` - 包含子节点的容器节点
+  - **分支节点 (Branch Nodes)**: `CONDITION_BRANCH`, `INCLUSIVE_BRANCH`, `PARALLEL_BRANCH` - 作为块节点的子节点
+- **核心方法**:
+  - `isBlockNode()`: 判断是否为块节点（有blocks属性）
+  - `isBranchNode()`: 判断是否为分支节点
+  - `getBlocks()`: 获取节点的子节点列表
+  - `getFirstBlocks()`: 获取第一个子节点（用于分支节点）
+
+**FlowNodeEdgeManager** - 节点关系管理器
+- **位置**: `com.codingapi.flow.manager.FlowNodeEdgeManager`
+- **职责**: 管理节点之间的连接关系，通过遍历blocks实现
+- **核心方法**:
+  - `getNextNodes(IFlowNode)`: 获取指定节点的后续节点
+  - `loadNextNodes()`: 递归加载下一节点（遍历blocks）
+- **遍历逻辑**:
+  1. 如果当前节点是块节点，返回其blocks
+  2. 如果当前节点是分支节点，返回其第一个block
+  3. 否则返回节点列表中的下一个节点
+  4. 递归处理嵌套的blocks
+
+**NodeMapBuilder** - 节点映射构建器
+- **位置**: `com.codingapi.flow.builder.NodeMapBuilder`
+- **职责**: 从Map数据构建节点对象
+- **核心方法**:
+  - `loadNodes(Map)`: 从Map的"blocks"键加载子节点列表
+  - `loadActions(Map)`: 加载节点动作
+  - `loadNodeStrategies(Map)`: 加载节点策略
+
+**节点关系示例**:
+```
+Workflow
+├── StartNode
+├── ApprovalNode
+├── ConditionNode (块节点)
+│   ├── blocks:
+│   │   ├── ConditionBranchNode (order=1)
+│   │   │   └── blocks: [NotifyNode, EndNode]
+│   │   └── ConditionBranchNode (order=2)
+│   │       └── blocks: [HandleNode, EndNode]
+└── EndNode
+```
+
+#### 节点类型一览 (15种)
+
+**基础节点 (9种)**:
+
+| 节点类型 | 类名 | NODE_TYPE | 说明 |
+|---------|------|-----------|------|
+| 开始节点 | StartNode | `START` | 流程起点 |
+| 结束节点 | EndNode | `END` | 流程终点 |
+| 审批节点 | ApprovalNode | `APPROVAL` | 需要审批的任务节点 |
+| 办理节点 | HandleNode | `HANDLE` | 需要办理的任务节点 |
+| 路由分支 | RouterNode | `ROUTER` | 普通路由节点 |
+| 通知节点 | NotifyNode | `NOTIFY` | 发送通知 |
+| 延迟节点 | DelayNode | `DELAY` | 延迟执行 |
+| 触发节点 | TriggerNode | `TRIGGER` | 事件触发 |
+| 子流程节点 | SubProcessNode | `SUB_PROCESS` | 嵌套子流程 |
+
+**块节点/容器节点 (3种)** - 包含子节点(blocks):
+
+| 节点类型 | 类名 | NODE_TYPE | 说明 |
+|---------|------|-----------|------|
+| 条件控制 | ConditionNode | `CONDITION` | 条件分支容器，包含多个ConditionBranchNode |
+| 并行控制 | ParallelNode | `PARALLEL` | 并行分支容器，包含多个ParallelBranchNode |
+| 包容控制 | InclusiveNode | `INCLUSIVE` | 包容分支容器，包含多个InclusiveBranchNode |
+
+**分支节点 (3种)** - 作为块节点的子节点:
 
 | 节点类型 | 类名 | NODE_TYPE | 说明 |
 |---------|------|-----------|------|
-| 开始节点 | StartNode | `start` | 流程起点 |
-| 结束节点 | EndNode | `end` | 流程终点 |
-| 审批节点 | ApprovalNode | `approval` | 需要审批的任务节点 |
-| 办理节点 | HandleNode | `handle` | 需要办理的任务节点 |
-| 条件分支 | ConditionBranchNode | `condition_branch` | 按条件路由 |
-| 并行分支 | ParallelBranchNode | `parallel_branch` | 并行执行多个分支 |
-| 路由分支 | RouterNode | `router` | 普通路由节点 |
-| 包容分支 | InclusiveBranchNode | `inclusive_branch` | 包容性分支 |
-| 通知节点 | NotifyNode | `notify` | 发送通知 |
-| 延迟节点 | DelayNode | `delay` | 延迟执行 |
-| 触发节点 | TriggerNode | `trigger` | 事件触发 |
-| 子流程节点 | SubProcessNode | `sub_process` | 嵌套子流程 |
+| 条件分支 | ConditionBranchNode | `CONDITION_BRANCH` | 条件控制下的分支，包含条件脚本 |
+| 并行分支 | ParallelBranchNode | `PARALLEL_BRANCH` | 并行控制下的分支 |
+| 包容分支 | InclusiveBranchNode | `INCLUSIVE_BRANCH` | 包容控制下的分支 |
 
 ---
 

PRD.md

@@ -51,7 +51,9 @@ Flow Engine 是一个企业级流程引擎，支持可视化流程设计、动
 
 基于画布的可视化流程设计，默认初始化开始节点、审批节点、结束节点。
 
-**支持 12 种节点类型**:
+**支持 15 种节点类型**:
+
+**基础节点 (9种)**:
 
 | 节点类型 | 说明 | 配置项 |
 |---------|------|--------|
@@ -60,14 +62,27 @@ Flow Engine 是一个企业级流程引擎，支持可视化流程设计、动
 | 审批节点 | 需要审批的任务节点 | 审批人配置、多人审批策略、超时处理、审批意见、签名设置 |
 | 办理节点 | 需要办理的任务节点 | 同审批节点 |
 | 通知节点 | 发送通知，无需审批 | 通知人配置、通知内容 |
-| 条件分支 | 按条件路由到不同分支 | 条件表达式脚本、分支节点配置 |
-| 并行分支 | 并行执行多个分支，需汇聚 | 分支节点配置、汇聚节点 |
 | 路由分支 | 普通路由节点 | 分支节点配置 |
-| 包容分支 | 包容性分支 | 分支节点配置 |
 | 子流程节点 | 嵌套子流程 | 子流程配置、子流程发起人 |
 | 延迟节点 | 延迟执行 | 延迟时间、延迟单位 |
 | 触发节点 | 事件触发 | 触发条件脚本、触发事件 |
 
+**块节点/容器节点 (3种)** - 包含子节点(blocks):
+
+| 节点类型 | 说明 | 配置项 |
+|---------|------|--------|
+| 条件控制 | 条件分支容器，包含多个条件分支 | 分支节点配置 |
+| 并行控制 | 并行分支容器，包含多个并行分支 | 分支节点配置、汇聚节点 |
+| 包容控制 | 包容分支容器，包含多个包容分支 | 分支节点配置 |
+
+**分支节点 (3种)** - 作为块节点的子节点:
+
+| 节点类型 | 说明 | 配置项 |
+|---------|------|--------|
+| 条件分支 | 条件控制下的分支 | 条件表达式脚本 |
+| 并行分支 | 并行控制下的分支 | - |
+| 包容分支 | 包容控制下的分支 | 条件表达式脚本 |
+
 **节点配置项**:
 1. **基础信息**: 节点名称、节点类型
 2. **审批人配置**:

README.md

@@ -8,11 +8,12 @@ Flow Engine 是一个基于 Java 17 和 Spring Boot 3.5.9 构建的企业级工
 
 ### 核心特性
 
-- **12 种节点类型** - 开始、结束、审批、办理、通知、条件分支、并行分支、路由、包容分支、子流程、延迟、触发节点
+- **15 种节点类型** - 开始、结束、审批、办理、通知、条件控制、条件分支、并行控制、并行分支、路由、包容控制、包容分支、子流程、延迟、触发节点
 - **8 种动作类型** - 通过、拒绝、保存、加签、委派、退回、转办、自定义
 - **策略驱动配置** - 所有关键配置通过策略实现，支持动态扩展
 - **Groovy 脚本扩展** - 支持发起人动态匹配、审批人加载、条件判断、自定义操作等
 - **多人审批模式** - 顺序审批、会签审批（可配置比例）、或签审批、随机审批
+- **层次化节点结构** - 通过blocks属性实现节点间的层次关系，不再使用独立的边关系
 - **线程安全** - 脚本运行时使用细粒度同步锁，支持不同脚本并发执行
 - **自动资源清理** - 双重清理机制（阈值触发 + 定时清理）避免内存泄漏
 - **完善的异常体系** - 基于 RuntimeException 的框架异常层次结构
@@ -57,8 +58,6 @@ flow-engine
 │       │   ├── DelayTask         # 延迟任务
 │       │   ├── DelayTaskManager  # 延迟任务管理器
 │       │   └── UrgeInterval      # 催办间隔
-│       ├── edge                  # 节点连接
-│       │   └── FlowEdge          # 流程边
 │       ├── error                 # 错误处理
 │       │   └── ErrorThrow        # 错误抛出器
 │       ├── event                 # 事件系统（5种）
@@ -92,15 +91,18 @@ flow-engine
 │       │   ├── OperatorManager   # 操作者管理器
 │       │   └── WorkflowStrategyManager # 工作流策略管理器
 │       ├── node                  # 节点层
-│       │   ├── nodes             # 节点实现（12种）
+│       │   ├── nodes             # 节点实现（15种）
 │       │   │   ├── StartNode     # 开始节点
 │       │   │   ├── EndNode       # 结束节点
 │       │   │   ├── ApprovalNode  # 审批节点
 │       │   │   ├── HandleNode    # 办理节点
 │       │   │   ├── NotifyNode    # 通知节点
+│       │   │   ├── ConditionNode # 条件控制节点（块节点）
 │       │   │   ├── ConditionBranchNode # 条件分支节点
+│       │   │   ├── ParallelNode  # 并行控制节点（块节点）
 │       │   │   ├── ParallelBranchNode    # 并行分支节点
 │       │   │   ├── RouterNode    # 路由节点
+│       │   │   ├── InclusiveNode # 包容控制节点（块节点）
 │       │   │   ├── InclusiveBranchNode  # 包容分支节点
 │       │   │   ├── SubProcessNode # 子流程节点
 │       │   │   ├── DelayNode     # 延迟节点
@@ -276,21 +278,36 @@ pnpm run dev:app-pc
 
 ## 节点类型
 
+### 基础节点 (9种)
+
 | 节点类型 | 描述 | NODE_TYPE |
 |---------|------|-----------|
 | StartNode | 开始节点 | `START` |
 | EndNode | 结束节点 | `END` |
 | ApprovalNode | 审批节点 | `APPROVAL` |
 | HandleNode | 办理节点 | `HANDLE` |
 | NotifyNode | 通知节点 | `NOTIFY` |
-| ConditionBranchNode | 条件分支 | `CONDITION_BRANCH` |
-| ParallelBranchNode | 并行分支 | `PARALLEL_BRANCH` |
 | RouterNode | 路由分支 | `ROUTER` |
-| InclusiveBranchNode | 包容分支 | `INCLUSIVE_BRANCH` |
 | SubProcessNode | 子流程节点 | `SUB_PROCESS` |
 | DelayNode | 延迟节点 | `DELAY` |
 | TriggerNode | 触发节点 | `TRIGGER` |
 
+### 块节点/容器节点 (3种) - 包含子节点(blocks)
+
+| 节点类型 | 描述 | NODE_TYPE |
+|---------|------|-----------|
+| ConditionNode | 条件控制节点 | `CONDITION` |
+| ParallelNode | 并行控制节点 | `PARALLEL` |
+| InclusiveNode | 包容控制节点 | `INCLUSIVE` |
+
+### 分支节点 (3种) - 作为块节点的子节点
+
+| 节点类型 | 描述 | NODE_TYPE |
+|---------|------|-----------|
+| ConditionBranchNode | 条件分支节点 | `CONDITION_BRANCH` |
+| ParallelBranchNode | 并行分支节点 | `PARALLEL_BRANCH` |
+| InclusiveBranchNode | 包容分支节点 | `INCLUSIVE_BRANCH` |
+
 ## 动作类型
 
 | 动作类型 | 描述 | ActionType |

TODO.md

@@ -6,7 +6,8 @@
 
 | 功能 | 状态 | 说明 |
 |-----|------|------|
-| 12 种节点类型 | ✅ | StartNode, EndNode, ApprovalNode, HandleNode, NotifyNode, ConditionBranchNode, ParallelBranchNode, RouterNode, InclusiveBranchNode, SubProcessNode, DelayNode, TriggerNode |
+| 15 种节点类型 | ✅ | StartNode, EndNode, ApprovalNode, HandleNode, NotifyNode, RouterNode, SubProcessNode, DelayNode, TriggerNode (基础9种); ConditionNode, ParallelNode, InclusiveNode (块节点3种); ConditionBranchNode, ParallelBranchNode, InclusiveBranchNode (分支节点3种) |
+| 节点层次化结构 | ✅ | 通过blocks属性实现节点间的层次关系，不再使用独立的边关系 |
 | 节点生命周期管理 | ✅ | verifySession → continueTrigger → generateCurrentRecords → fillNewRecord → isDone |
 | 节点配置面板 | ✅ | 基础信息、审批人配置、策略配置 |
 
@@ -293,7 +294,10 @@
 
 ### v0.2.0 (当前开发版本)
 
-- ✅ 12 种节点类型实现
+- ✅ 15 种节点类型实现（新增ConditionNode、ParallelNode、InclusiveNode块节点）
+- ✅ 节点层次化结构（blocks属性替代独立的边关系）
+- ✅ FlowNodeState节点分类（块节点vs分支节点）
+- ✅ FlowNodeEdgeManager关系管理器（遍历blocks实现）
 - ✅ 延迟节点完整实现
 - ✅ 触发节点完整实现
 - ✅ 路由节点完整实现
@@ -302,10 +306,7 @@
 - ✅ 流程催办功能（UrgeStrategy + UrgeInterval + FlowRecordUrgeEvent）
 - ✅ 流程干预功能（InterfereStrategy）
 - ✅ 节点撤回功能（RevokeStrategy）
-- 🚧 条件分支节点增强
-- 🚧 子流程节点完善
-- 🚧 包容分支节点完善
-- 🚧 前端流程设计器基础功能
+- 🚧 前端流程设计器基础功能（@flowgram.ai集成）
 
 ### v0.3.0 (计划中)