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-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)。<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.AutoConfiguration | flow-engine-starter | 注册 FlowService / WorkflowService / FlowRecordService / RepositoryHolderContext / 网关上下文 / 脚本上下文 / 延迟任务 Runner |
com.codingapi.flow.infra.AutoConfiguration | flow-engine-starter-infra | 注册 10 个 JPA 仓储实现,并通过 FlowJpaPackageRegistrar 注册 JPA 扫描包 com.codingapi.flow.infra |
com.codingapi.flow.infra.AutoConfiguration | flow-engine-starter-infra | 注册 11 个 JPA 仓储实现,并通过 FlowJpaPackageRegistrar 注册 JPA 扫描包 com.codingapi.flow.infra |
com.codingapi.flow.api.AutoConfiguration | flow-engine-starter-api | 扫描 com.codingapi.flow.api,注册命令类 Controller(/api/cmd/**) |
com.codingapi.flow.query.AutoConfiguration | flow-engine-starter-query | 扫描 com.codingapi.flow.query,注册查询类 Controller(/api/query/**) |
| 扩展点 | 说明 |
|---|---|
| 事件订阅 | 实现 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 脚本 |