流程设计器知识地图

流程设计器由独立 npm 插件 @yangxj96/logicflow-plugin-flowable 和 spectra-ui 宿主页面组成。插件负责画布建模与 BPMN XML 转换，宿主负责业务选择器、流程定义接口和部署操作，后端负责持久化、部署和流程运行。

三层边界

logicflow-plugin-flowable
  ├─ LogicFlow 插件注册
  ├─ BPMN 节点、边和连接规则
  ├─ DND 面板、属性面板、右键菜单
  ├─ 流程上下文
  └─ BPMN XML import / export

spectra-ui
  ├─ WorkflowDesigner 页面和三栏布局
  ├─ form / user / group / javaClass / process Picker
  ├─ 加载已有流程资源
  └─ 调用 WorkflowApi 部署流程

spectra-admin + Flowable
  ├─ 流程定义和版本
  ├─ BPMN XML 部署
  ├─ 流程实例和任务运行
  └─ 后端权限、事务和业务数据

文档导航

文档	内容
01-流程建模插件	安装、最小初始化、配置和公共 API
02-插件架构与初始化	FlowablePlugin 的初始化编排和模块调用关系
03-BPMN元素与节点模型	当前注册的元素、视觉模型、DND 分组和导入兼容映射
04-属性Schema与编辑面板	流程、节点、连线属性和 Picker 事件
05-连接规则与交互行为	连线创建约束、右键菜单、子流程容器和校验边界
06-BPMN导入导出	XML 映射、Flowable 扩展、ID 规范化、DI 和布局
07-Spectra宿主集成	Web 编辑页、业务 Picker、加载 XML 和部署
08-构建发布与扩展开发	tsup 产物、示例、增加节点和扩展属性

当前能力边界

当前插件实际提供：

• 5 类事件、4 类任务、3 类网关、2 类子流程/调用活动和 1 类序列流。
• LogicFlow 插件注册、节点渲染、拖拽面板、属性面板和节点/边右键菜单。
• 流程级、节点级和连线级属性 Schema。
• Flowable 扩展属性、表达式、脚本 CDATA 和文档说明。
• BPMN XML 导入、导出、重复属性清理、ID 规范化、BPMN DI 坐标及路径点恢复。
• property:picker 事件，把业务选择交给宿主实现。

当前插件不负责：

• 流程定义的保存、版本管理、发布审批和后端权限。
• 用户、部门、表单、Java 类和流程定义选择器的弹窗或 API。
• 保存/部署前的完整流程图校验。当前源码主要执行连线创建阶段的拓扑规则。
• BPMN 全量元素建模，例如 Pool、Lane、Message Flow、事件网关和复杂网关。

源码入口

领域	入口
插件公共入口	logicflow-plugin-flowable/src/index.ts
初始化编排	src/core/index.ts
节点类型和图标	src/core/constants.ts
元素注册	src/elements/index.ts
属性注册表	src/features/schema/index.ts
连线规则	src/features/behaviors/
流程上下文	src/features/context/
DND 面板	src/panel/dnd/
属性面板	src/panel/property/
XML 导入	src/features/import/
XML 导出	src/features/export/
Spectra 宿主	spectra-ui/src/views/System/Workflow/components/WorkflowDesigner/

版本事实

插件 package.json 版本是 0.1.2，包输出 ESM、CJS、TypeScript 声明和合并 CSS。