夜雨聆风学习资料网

ARTICLE · 1375227

把审批引擎从插件里「拆」出来:Ingenious v3 核心包开源

把审批引擎从插件里「拆」出来:Ingenious v3 核心包开源

Ingenious v3 引擎正式发布|设计器驱动、可插拔的下一代工作流内核

一个流程改一个节点,就要改一次代码、发一次版本;OA 的请假报销有一套审批口径,MES 的工单下达又写了另一套;想接审计、风控、消息提醒,只能往业务代码里一层层塞 if-else。

做过审批系统的开发,对这几件事大概都不陌生。

今天正式发布 Ingenious v3 引擎——工作流内核 Ingenious 的第三代版本。它不再藏在某个插件目录里,而是以独立 Composer 包 madong/workflow 交付:PHP 8.1+ 面向对象设计,轻量、可扩展、可剥离,已在 OA 智能行政办公、MES 制造执行系统等生态应用中作为统一审批底座稳定运行。

先说清楚这次发了什么

· 引擎核心包 madong/workflow 已上架 Packagist,composer require 即可安装,以 Apache-2.0 协议开放源码;

· 流程定义由 LogicFlow 设计器导出的 JSON 直接驱动,画图—发布—运行,不用手写建模代码;

· 八类节点、并行会签与运行时加签、子流程、事件总线、AOP 切面、模块化扩展全部内置;

· 15 个可替换服务接口,不依赖 webman、不依赖插件目录;

· 86 项测试、184 项断言,包内置 5 份真实流程 JSON 与快速开始文档;

· 另有非开源的商用 workflow 插件,安装即用。

一句话:引擎开源,设计器和商用插件独立交付。下面拆开讲。

为什么一定要把内核独立出来

Ingenious 最早以 madong/ingenious 之名服务早期业务流程场景,其后经历 v2 迭代,两条旧版本线留在早期仓库 ingenstream/ingenious,现已停止演进。

真正推动重构的不是版本号,而是生态应用变多了:审批能力从「某个插件的内部实现」,变成了「多个产品共享的基础设施」。OA 的请假报销、MES 的工单下达与工艺变更,需要的是同一套流程语义、同一份审计口径、同一种扩展方式。

这就给内核提出了三个硬要求:

1. 不能绑定任何具体框架或插件目录,必须能被任意 PHP 项目以依赖方式引入;

2. 流程建模不能依赖硬编码,必须能被可视化设计器驱动;

3. 持久化、调度、消息等基础设施不能写死,必须允许宿主按需替换。

工程上的铺垫在 2026 年 9 月就完成了:宿主工程 v5.1.2 将工作流引擎由源码集成切换为 Composer 依赖 madong/workflow。今天,v3 以独立包、独立命名空间、独立文档体系面向社区发布。

授权边界需要特别说明:开源的是引擎核心包 madong/workflow(Apache-2.0);宿主 workflow 插件与流程/表单设计器属于独立交付的商用模块,不在核心包开源授权范围内。

七个硬核能力,逐个看

01 设计器驱动,零手写建模

引擎直接解析 LogicFlow 流程设计器导出的 JSON 流程定义,节点、边、布局坐标与业务属性一次性载入即可执行。流程定义统一采用 snake_case 字段命名,类名引用以点号形式书写,由引擎自动还原为命名空间。开发动作被压缩成三步:画图 → 发布 → 运行。

02 八类节点,覆盖完整流程语义

ingenious:start / end / task / decision / fork / join / custom / wfSubProcess

从开始、审批、条件路由、并行汇聚到子流程嵌套,八种节点类型全覆盖。任务节点支持:

· 处理人变量解析:${var} / node.var

· 主办 / 协办 / 抄送:Major / Minor / Cc

· 普通 / 会签:ANY / ALL

03 分支、会签与运行时加签

决策节点配合出边表达式实现 #变量 / ${变量} 条件路由;fork / join 支持多线并行与全上游办结合并。会签节点同时支持并行与串行两种模式,完成条件可以写得很细:

· #nrOfCompletedInstances==3:指定票数

· 过半表达式

· ONE_VOTE_VETO:一票否决

· 留空则按默认规则判定

引擎自动维护总票数、未完成票数、已完成票数等计数变量。办理过程中还可发起前加签、后加签与运行时会签,无需重新发布流程定义——这一点对真实审批场景尤其关键。

04 子流程与变量隔离

子流程节点支持父子实例关联、变量继承与隔离,报名、采购、验收这类独立流程可以沉淀为可复用组件,在主流程中按需调用。

05 事件、AOP 与模块化扩展

7 类生命周期事件,通过 EventBus 发布订阅:

process.start / process.end / task.start / task.complete task.assign / node.enter / node.leave

AOP 切面支持 BEFORE / AROUND / AFTER / AFTER_RETURN / AFTER_THROW 五种织入类型与 10 个织入点,审计、风控、埋点这类横切逻辑可以挂到流程执行链上,不侵入业务代码。

模块化机制提供 register / boot / shutdown 生命周期与依赖拓扑排序,CoreModule、ParserModule、EventModule、InterceptorModule 开箱即用。

06 调度与幂等

引擎侧定义调度契约与事件挂载点,宿主侧提供常驻进程与六类执行器,覆盖任务提醒、超时处理、自动办理、回调、即时通知等 10 类调度场景。调度记录以 wf:{instanceId}:{taskId}:{scene} 为幂等键,同一任务同场景重复挂载自动覆盖或跳过;执行历史独立落表,失败可追溯补偿。

07 服务可替换,内核可剥离

引擎不依赖 webman,也不依赖插件目录,通过接口注入与配置装配运行:

· 6 个核心服务接口:定义、实例、任务、参与者与历史数据的读写

· 9 个预留接口:表单、设计、代理人、抄送等扩展域

· 宿主可实现全部 15 个接口,对接任意持久化方案

EngineConfig 统一管理 services、aspects、modules、extensions 与调试开关;自定义节点、节点拦截器、新节点类型、以及通过 DesignerParserInterface 替换第三方设计器解析器,都有明确扩展点。

质量不是口号:86 项测试、184 项断言

测试套件包含单元测试、集成测试与 5 份真实流程 JSON,覆盖模块集成与自定义处理器,当前通过 86 项测试、184 项断言。

文档方面是 14 篇编号中文文档 + 9 篇插件架构文档。宿主 workflow 插件已实现全部服务接口的 MySQL 持久化、调度与消息推送,可以直接当作生产级实现范例来读。

三条上手路径,按你的角色选

路径一:先看,不动环境

在线 Demo:v3.demo-flow.madong.tech,打开即可体验从流程设计、发布,到发起审批、办理流转的完整链路,适合选型评估阶段快速上手。

路径二:基于开源核心包自研

包内置完整示例资产,装上就有样可循:

· tests/process/:5 份真实流程 JSON——请假、报销、会签、并行汇聚、自定义节点

· tests/fixture/memory/:内存版服务实现

· docs/01-快速开始.md:从零启动请假流程的最小闭环

框架示例插件 demo 还额外提供 visual-flow 流程设计器示例页面,方便直接查看设计器与引擎的对接方式。

安装(已发布至 Packagist,无需再配置 VCS 仓库):

composer require madong/workflow:^3.0

或写入 composer.json 后执行 composer update madong/workflow:

{   "require": { "madong/workflow": "^3.0" } }

本地开发可把源码置于 packages/workflow,以 path 类型仓库替代(优先级高于 Packagist)。环境要求:PHP ^8.1、Composer 2.x,依赖 php-di/php-di ^7.0、madong/helper ^1.0、monolog/monolog ^2.x。

最小闭环四步:创建引擎并注入服务映射 → 发布设计器导出的流程定义 → startProcess 发起实例 → completeTask 办理任务。引擎同时提供 jumpTask、rejectToFirst、rejectToEnd 等流转方法,宿主工程可参考 plugin/workflow/config/engine.php 的接口映射与 WorkflowClient 门面实现。

配套设计器也在框架里:

· 工作流设计器template/admin/lib/visual-flow:基于 Vue 3 + LogicFlow 的私有库,以 lib 方式集成(不发布 npm),配套二开指南与多个业务场景示例,支持自定义节点、自定义边与自定义表单;导出的 JSON 正是引擎的输入。

· 表单设计器template/admin/lib/visual-form:VForm3 Pro 授权产物,通过框架插件接入(installVisualForm() / useVForm()),为审批单据提供可视化表单建模。

两套设计器与核心包是解耦的:核心包只负责解析设计器导出的 JSON,不捆绑前端实现。二开团队可以基于内置设计器快速搭建,也可以实现 DesignerParserInterface 换成自有设计器。

路径三:直接装商用插件,装好即用

社区另提供 workflow 商用模块:以插件形式随框架安装,安装过程自动完成数据库迁移、种子数据、菜单导入与模板复制,无需从零搭建持久化、审批页面与调度进程。

请注意该插件是独立交付的商用版本,源码不开源,不在核心包 Apache-2.0 授权范围内;插件 NOTICE 对商用集成另有书面授权要求,表单设计器亦须遵循 VForm3 Pro 的授权条款。

选型建议

需要自研内核、深度定制的团队 → 基于开源核心包 madong/workflow + 框架内置设计器二次开发

希望快速上线审批能力的业务方 → 直接安装 workflow 商用插件,开箱即用

相较此前版本,变了什么

v1 与 v2 已停止演进,官方未单独发布逐条版本变更清单;以下基于新版本的实际架构与工程形态整理:

1. 交付形态 源码内置、随插件演进 → 独立 Composer 包 madong/workflow,上架 Packagist

2. 命名空间madong\ingenious\* → madong\workflow\*,包名与命名空间独立

3. 语言基线 旧式 PHP 写法 → PHP 8.1+,采用 readonly 属性、枚举与命名参数

4. 建模方式 手写建模 / 硬编码流转为主 → 解析 LogicFlow 设计器 JSON,可视化编排即发布即运行

5. 框架耦合 与宿主框架、插件目录耦合 → 不依赖 webman 与插件目录,接口注入 + 配置装配

6. 扩展机制 有限钩子 → 事件总线 + AOP 切面(5 类型 / 10 织入点)+ 模块化拓扑排序 + 自定义节点 / 解析器

7. 基础设施 持久化与调度方式固定 → 15 个服务接口可替换,宿主自选存储与调度实现

8. 文档与验证 缺少完整公开文档 → 14 篇编号中文文档 + 9 篇插件架构文档,86 项测试守护

兼容性上有个好消息:v3 保留了 ingenious:* 一脉的流程节点类型字面量,设计器无需迁移节点类型;但服务层已全面迁移到新命名空间与接口体系。旧版本仍可通过 VCS 指向早期仓库继续安装,新旧版本可并行评估。

升级前,这几条请务必过一遍

· 引用替换:代码中的 madong\ingenious\* 统一替换为 madong\workflow\*;

· 定义核对:流程定义字段已全部改为 snake_case,点号形式的类名拼写要正确;

· 行为差异:部分接口在 v3 中仅保留定义、尚无内部调用点,原依赖其行为的逻辑需改用事件或 AOP 实现;

· 升级节奏:建议按「影子并行 — 结果比对 — 灰度切换 — 保留回滚开关」推进,避免一次性全量切换;

· 部署注意:使用调度能力时务必启用 workflow-scheduler 常驻进程;宿主集成消息通知时执行 php webman madong:migrate-message workflow 补齐消息数据;生产环境建议关闭 debug,并为流程定义发布、任务流转配置审计切面。

它能落在哪些业务里

· 企业行政审批中枢:请假、加班、出差、报销、会议室、用章、物品领用统一接入,业务类型 → 审批场景 → 流程定义 → 流程实例,终态事件自动回写单据状态,审批通过即生效、驳回即冻结。OA 智能行政办公已以此为全部单据的审批底座。

· 制造执行关键节点管控:MES 把工单下达(mes:wo_release)、工艺路线变更(mes:route_change)、良率解锁与拦截解锁挂到引擎,订阅 process.end 自动回写业务终态——审批通过即放行,拒绝即冻结。

· 合规审计与风控:AOP 统一织入审计、风控、埋点,事件总线留存完整生命周期轨迹;会签、一票否决与条件路由满足多部门制衡、分级授权。

· 定时催办与自动化流转:借助 10 类调度场景做到期提醒、重复催办、超时自动办理、到点回调,覆盖合同审批、付款审批、证照年审等强时效流程。

· 异构 PHP 项目嵌入:内核不依赖特定框架,任意 PHP 项目都可通过服务接口注入自有持久化实现,把工作流嵌进现有系统,而不必引入完整应用框架。

写在最后

从内置模块到独立内核,从手写建模到设计器驱动,从单一审批到事件、切面与模块共同构成的扩展体系——Ingenious v3 想做的,是把「流程」还原成一项可复用、可替换、可治理的基础能力。

它既是 OA、MES 等生态应用的共同底座,也向社区开发者开放了一个轻量而完整的工作流内核。

欢迎下载体验、提交问题、参与共建。让流程编排更简单,让业务创新更快一步。

延伸阅读

· 在线 Demo:https://v3.demo-flow.madong.tech

· 引擎仓库:https://github.com/madong-code/workflow-engine

· 完整文档:包内 docs/ 架构文档

你在项目里怎么处理审批逻辑?手写状态机、接第三方 BPM,还是自研引擎?欢迎留言聊聊。

回首页,搜索你想要的文档

在首页搜索框输入关键词,快速定位资料

文库首页搜索指引 立即搜索

相关学习资料