ARTICLE · 1375227
把审批引擎从插件里「拆」出来: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.leaveAOP 切面支持 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,还是自研引擎?欢迎留言聊聊。














































































