From 73c9f1b4ddcc0767b14678fbabd55e2e4659d459 Mon Sep 17 00:00:00 2001 From: lorne <1991wangliang@gmail.com> Date: Mon, 17 Aug 2026 10:56:42 +0800 Subject: [PATCH 1/3] Update flow-frontend to latest main --- flow-frontend | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/flow-frontend b/flow-frontend index c226882b..fa3b1057 160000 --- a/flow-frontend +++ b/flow-frontend @@ -1 +1 @@ -Subproject commit c226882bee9886cd27df98afa2fa4bae3551b12f +Subproject commit fa3b10576d9bd406dbdb7ed0729820739ef408a4 From 1eac4ddfc066e8e55e30f92cefb70a609ebb056b Mon Sep 17 00:00:00 2001 From: lorne <1991wangliang@gmail.com> Date: Mon, 17 Aug 2026 11:21:46 +0800 Subject: [PATCH 2/3] =?UTF-8?q?docs:=20=E9=9B=86=E6=88=90=E6=89=8B?= =?UTF-8?q?=E5=86=8C/=E6=96=87=E6=A1=A3=E5=AF=B9=E9=BD=90=E6=9C=80?= =?UTF-8?q?=E6=96=B0=E4=BB=A3=E7=A0=81=EF=BC=88=E7=89=88=E6=9C=AC=E5=8F=B7?= =?UTF-8?q?=E3=80=81=E4=BB=93=E5=82=A8=E8=AE=A1=E6=95=B0=E3=80=81=E6=89=A9?= =?UTF-8?q?=E5=B1=95=E5=8F=A3=E5=BE=84=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - integration-manual.html：后端版本 0.0.52 → 0.1.0-SNAPSHOT、前端 → 0.1.9； infra 注册仓储 10→11；节点策略/自定义动作由「可扩展/扩展 BaseAction」改为 工厂固定注册口径（业务方经 CUSTOM + Groovy 脚本表达差异）；SVG 版本对齐 0.1.x - Integration/README.md：仓储接口计数统一（12 = 11 infra + NodeViewJavaScriptRepository） - capabilities/flow-engine-framework/sub-process.md：子流程默认开关去除演进式歧义 Co-Authored-By: Claude --- docs/Integration/README.md | 2 +- .../flow-engine-framework/sub-process.md | 2 +- docs/manual/integration-manual.html | 12 ++++++------ 3 files changed, 8 insertions(+), 8 deletions(-) diff --git a/docs/Integration/README.md b/docs/Integration/README.md index f16e3db7..b49c9ef1 100644 --- a/docs/Integration/README.md +++ b/docs/Integration/README.md @@ -33,7 +33,7 @@ | [流程用户体系](./user-integration.md) | `FlowOperatorGateway` / `IFlowOperator` / `GatewayContext` / 线程缓存 / 当前登录人 | | [流程默认脚本](./script-integration.md) | 12 种脚本类型、`GroovyScriptRequest` 完整 API、`$bind`、默认脚本替换、脚本生命周期 | | [流程事件机制](./event-integration.md) | 7 种事件、`EventPusher`、`IHandler` 订阅、异步分发管道、事务变体、推送时机 | -| [仓储抽象与持久化](./repository-integration.md) | `IRepositoryHolder`、12 个仓储接口、JPA 实现、脚本仓储、锁机制 | +| [仓储抽象与持久化](./repository-integration.md) | `IRepositoryHolder`、12 个仓储接口（含 11 个 JPA 实现 + 需自行实现的 `NodeViewJavaScriptRepository`）、脚本仓储、锁机制 | | [Spring Boot 自动配置](./auto-configuration.md) | `AutoConfiguration` 8 个 Bean、4 个 Register、必选/可选 Bean 清单 | | [REST API](./rest-api.md) | 4 个 Controller、`mockKey`/`operatorId` 分流机制、请求/响应结构 | | [Mock 模式](./mock-mode.md) | 全内存沙箱 `MockInstance`、15 分钟过期、接入方式 | diff --git a/docs/capabilities/flow-engine-framework/sub-process.md b/docs/capabilities/flow-engine-framework/sub-process.md index 30540922..9024a07f 100644 --- a/docs/capabilities/flow-engine-framework/sub-process.md +++ b/docs/capabilities/flow-engine-framework/sub-process.md @@ -67,7 +67,7 @@ def run(request){ ## 子流程查看主流程历史 -`SubProcessStrategy.showParentProcessRecords` 控制子流程参与人能否在节点记录中查看主流程历史，默认关闭，历史流程定义保持关闭： +`SubProcessStrategy.showParentProcessRecords` 控制子流程参与人能否在节点记录中查看主流程历史，默认关闭（存量历史流程定义同样保持关闭，不自动开启）： - 开启后，查询子流程节点记录会递归拼接可见的祖先流程历史、对应子流程聚合节点以及当前子流程实际记录。 - 主流程历史严格沿持久化 `fromId` 链回溯，仅展示到触发当前子流程为止的实际路径，不执行主流程未来节点推演，也不展开无关分支。 diff --git a/docs/manual/integration-manual.html b/docs/manual/integration-manual.html index 43fa1f85..a31e72d6 100644 --- a/docs/manual/integration-manual.html +++ b/docs/manual/integration-manual.html @@ -90,7 +90,7 @@

Flow Engine 集成手册

本手册面向后端与前端开发者，完整介绍如何将 Flow Engine（后端）与 flow-frontend（前端框架）集成到一个企业项目中。涵盖后端 Spring Boot 集成、前端 packages 集成能力、插件扩展机制，以及基于官方示例（后端 flow-engine-example、前端 app-pc / app-mobile）的集成分析。

-
适用版本：后端 0.0.52（Java 17 / Spring Boot 3.5.9）；前端 0.0.52（React 18 / TypeScript 5 / pnpm 10 monorepo）。
+
适用版本：后端 0.1.0-SNAPSHOT（Java 17 / Spring Boot 3.5.9）；前端 0.1.9（React 18 / TypeScript 5 / pnpm 10 monorepo）。

目录

@@ -222,14 +222,14 @@

2.1 一站式引入（推荐）

<dependency>
     <groupId>com.codingapi.flow</groupId>
     <artifactId>flow-engine-starter</artifactId>
-    <version>0.0.52</version>
+    <version>0.1.0-SNAPSHOT</version>
 </dependency>

starter 通过 Spring Boot 自动装配机制注册以下 AutoConfiguration：

- +
自动配置类来源模块职责
com.codingapi.flow.AutoConfigurationflow-engine-starter注册 FlowService / WorkflowService / FlowRecordService / RepositoryHolderContext / 网关上下文 / 脚本上下文 / 延迟任务 Runner
com.codingapi.flow.infra.AutoConfigurationflow-engine-starter-infra注册 10 个 JPA 仓储实现，并通过 FlowJpaPackageRegistrar 注册 JPA 扫描包 com.codingapi.flow.infra
com.codingapi.flow.infra.AutoConfigurationflow-engine-starter-infra注册 11 个 JPA 仓储实现，并通过 FlowJpaPackageRegistrar 注册 JPA 扫描包 com.codingapi.flow.infra
com.codingapi.flow.api.AutoConfigurationflow-engine-starter-api扫描 com.codingapi.flow.api，注册命令类 Controller（/api/cmd/**）
com.codingapi.flow.query.AutoConfigurationflow-engine-starter-query扫描 com.codingapi.flow.query，注册查询类 Controller（/api/query/**）
@@ -285,8 +285,8 @@

5. 后端：扩展点

- - + +
扩展点说明
事件订阅实现 IHandler<E> 订阅 7 种事件：Start / Todo / Done / Finish / Urge / Revoke / Delete，自动被 Spring 扫描
节点策略15+ 策略（OperatorLoad / RecordMerge / Revoke / Router / FormFieldPermission 等）由 NodeStrategyManager 持有，可扩展
自定义动作8 种内置动作（PASS/REJECT/RETURN/TRANSFER/DELEGATE/ADD_AUDIT/SAVE/CUSTOM），扩展 BaseAction 实现新动作
节点策略15 种策略（OperatorLoad / RecordMerge / Revoke / Router / FormFieldPermission 等）由 NodeStrategyManager 持有（工厂固定注册，不支持新增策略类型；业务方通过策略配置 + Groovy 脚本表达差异）
自定义动作8 种内置动作（PASS/REJECT/RETURN/TRANSFER/DELEGATE/ADD_AUDIT/SAVE/CUSTOM）由 FlowActionFactory 固定注册（不支持新增动作类型）；业务方通过 CUSTOM 动作 + Groovy 脚本表达自定义行为
自定义脚本注册ScriptRegistryContext.getInstance().setRegistry(new CustomScriptRegistry()) 替换默认 Groovy 脚本
@@ -611,7 +611,7 @@

15. 全栈集成最佳实践

通用约束 - • 前后端版本对齐（0.0.52） + • 前后端版本对齐（0.1.x） • 前端跨包用完整包名 import • TS strict，禁用 any • 样式用 .module.scss From 7f1d48b79986d727078262e9953a8fe1b3484b36 Mon Sep 17 00:00:00 2001 From: lorne <1991wangliang@gmail.com> Date: Mon, 17 Aug 2026 11:23:59 +0800 Subject: [PATCH 3/3] Update flow-frontend to latest main --- flow-frontend | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/flow-frontend b/flow-frontend index fa3b1057..4b204551 160000 --- a/flow-frontend +++ b/flow-frontend @@ -1 +1 @@ -Subproject commit fa3b10576d9bd406dbdb7ed0729820739ef408a4 +Subproject commit 4b204551b494be4817351bd8f9d9f6fb080c428d