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 diff --git a/flow-frontend b/flow-frontend index c226882b..4b204551 160000 --- a/flow-frontend +++ b/flow-frontend @@ -1 +1 @@ -Subproject commit c226882bee9886cd27df98afa2fa4bae3551b12f +Subproject commit 4b204551b494be4817351bd8f9d9f6fb080c428d