Merge pull request #135 from codingapi/dev

Dev

Author: xlorne

docs/bugs/107562-processNodes-节点路径错误.md

@@ -0,0 +1,34 @@
+# processNodes 接口返回数据异常
+
+> 编码: 107562 | 日期: 2026-05-14 | 严重度: S2 | 状态: 待确认
+
+## 现象描述
+
+processNodes 接口返回的数据并没有按照一个确定的流程路径来返回，而是返回了所有的流程节点。当遇到条件分支时，应该默认走其他情况，但目前由于可能包含多条条件分支，所以都默认走其他情况导致返回数据不符合预期。
+
+## 关键信息
+
+- **可能关联的模块**：
+  - flow-engine-starter-api（REST API 层）- 提供 `/api/cmd/record/processNodes` 接口
+  - flow-engine-framework（节点引擎）- 包含节点执行、分支过滤逻辑
+  - FlowProcessNodeService（处理流程节点信息的服务）
+  
+- **受影响的功能**：
+  - 流程节点信息获取
+  - 条件分支节点的路径过滤
+  - processNodes 接口的数据返回结果
+
+- **初步判断**：
+  问题可能出现在节点的 `filterBranches()` 方法或 FlowProcessNodeService 的分支过滤逻辑中。当遇到条件分支时，应该根据条件脚本执行结果选择匹配的分支，但当前实现可能没有正确处理多条件分支的过滤，导致返回了所有节点而不是遵循特定的流程路径。
+
+## 期望行为
+
+processNodes 接口应该返回从当前节点开始、按照确定的流程路径（基于条件分支的默认分支或其他逻辑）逐步推进的节点列表，而不是返回所有可能的节点。当遇到条件分支时，应该：
+
+1. 根据条件分支的条件脚本执行结果选择匹配的分支
+2. 如果条件不匹配，则默认走其他（else）分支
+3. 最终返回按照这一确定路径所包含的所有节点
+
+## 备注
+
+{待人工补充}

docs/bugs/116393-并行人工包容分支节点排序错误.md

@@ -0,0 +1,33 @@
+# processNodes 接口分支节点排序异常
+
+> 编码: 116393 | 日期: 2026-05-14 | 严重度: S2 | 状态: 待确认
+
+## 现象描述
+
+`processNodes` 接口返回的节点列表中，并行分支节点（`ParallelBranchNode`）、人工分支节点（`ManualBranchNode`）、包容分支节点（`InclusiveBranchNode` / `InclusiveElseBranchNode`）等分支类节点出现在了结束节点（`EndNode`）之后，未按流程图中的节点定义顺序排序，导致前端展示的流程路径不直观。
+
+## 关键信息
+
+- **可能关联的模块**：
+  - flow-engine-starter-api（REST API 层）- 提供 `/api/cmd/record/processNodes` 接口
+  - flow-engine-framework（节点引擎）- `FlowProcessNodeService` 和 `NextNodeLoader`
+
+- **可能关联的节点类型**：
+  - `ParallelNode` / `ParallelBranchNode`（并行分支）
+  - `ManualNode` / `ManualBranchNode`（人工分支）
+  - `InclusiveNode` / `InclusiveBranchNode` / `InclusiveElseBranchNode`（包容分支）
+
+- **受影响的功能**：
+  - `processNodes` 接口的节点返回顺序
+  - 流程预览中分支节点位置展示
+
+- **初步判断**：
+  问题可能在 `FlowProcessNodeService.NextNodeLoader.fetchNextNode()`（`flow-engine-framework/src/main/java/com/codingapi/flow/service/impl/FlowProcessNodeService.java:170-192`）的递归遍历逻辑中。当前实现是深度优先递归，将每个节点 add 到一个共享 `nodeList`，分支控制节点的子分支可能在递归回溯阶段才被加入，导致顺序晚于 End 节点。需要确认递归顺序与节点 `order` 字段的关系，或在遍历完成后按节点定义顺序重新排序输出。
+
+## 期望行为
+
+`processNodes` 接口返回的节点列表应按照流程图中的节点定义顺序排序（即按 Start → 各业务节点 → 各分支控制节点 → End 的顺序），分支节点应出现在它实际所在的流程位置，而不是 End 节点之后。
+
+## 备注
+
+{待人工补充}

docs/components/flow-engine-framework_FlowScriptContext.md

@@ -22,7 +22,7 @@ description: Groovy 脚本运行时的 $bind 上下文对象，为脚本提供
 <dependency>
     <groupId>com.codingapi.flow</groupId>
     <artifactId>flow-engine-framework</artifactId>
-    <version>0.0.30</version>
+    <version>0.0.31</version>
 </dependency>
 ```
 

docs/components/flow-engine-framework_GatewayContext.md

@@ -22,7 +22,7 @@ GatewayContext 是框架内部获取流程操作人（IFlowOperator）数据的
 <dependency>
     <groupId>com.codingapi.flow</groupId>
     <artifactId>flow-engine-framework</artifactId>
-    <version>0.0.30</version>
+    <version>0.0.31</version>
 </dependency>
 ```
 

docs/components/flow-engine-framework_GroovyScriptBind.md

@@ -22,7 +22,7 @@ GroovyScriptBind 是脚本编写者在流程 Groovy 脚本中通过 `$bind` 变
 <dependency>
     <groupId>com.codingapi.flow</groupId>
     <artifactId>flow-engine-framework</artifactId>
-    <version>0.0.30</version>
+    <version>0.0.31</version>
 </dependency>
 ```
 

docs/components/flow-engine-framework_GroovyScriptRequest.md

@@ -22,7 +22,7 @@ GroovyScriptRequest 是流程 Groovy 脚本中 `request` 参数的实际类型
 <dependency>
     <groupId>com.codingapi.flow</groupId>
     <artifactId>flow-engine-framework</artifactId>
-    <version>0.0.30</version>
+    <version>0.0.31</version>
 </dependency>
 ```
 

docs/components/flow-engine-framework_GroovyWorkflowRequest.md

@@ -22,7 +22,7 @@ GroovyWorkflowRequest 用于工作流级别（非会话级别）的脚本场景
 <dependency>
     <groupId>com.codingapi.flow</groupId>
     <artifactId>flow-engine-framework</artifactId>
-    <version>0.0.30</version>
+    <version>0.0.31</version>
 </dependency>
 ```
 

docs/components/flow-engine-framework_IFlowOperator.md

@@ -22,7 +22,7 @@ IFlowOperator 是流程引擎中对参与流程的用户（审批人、创建者
 <dependency>
     <groupId>com.codingapi.flow</groupId>
     <artifactId>flow-engine-framework</artifactId>
-    <version>0.0.30</version>
+    <version>0.0.31</version>
 </dependency>
 ```
 

docs/components/flow-engine-framework_RepositoryHolderContext.md

@@ -22,7 +22,7 @@ RepositoryHolderContext 是流程引擎运行时的基础设施注册中心。
 <dependency>
     <groupId>com.codingapi.flow</groupId>
     <artifactId>flow-engine-framework</artifactId>
-    <version>0.0.30</version>
+    <version>0.0.31</version>
 </dependency>
 ```
 

docs/components/flow-engine-framework_ScriptRegistryContext.md

@@ -22,7 +22,7 @@ ScriptRegistryContext 是流程引擎中所有默认 Groovy 脚本的注册中
 <dependency>
     <groupId>com.codingapi.flow</groupId>
     <artifactId>flow-engine-framework</artifactId>
-    <version>0.0.30</version>
+    <version>0.0.31</version>
 </dependency>
 ```