主题
工作流(预留模块)
BPM-00 | Maven
pmforge-module-bpm| 状态 ⏸ 预留(已纳入构建,未接入运行时)
基于 Flowable 6.8 的流程引擎封装:流程定义与部署、发起、待办已办、会签或签抄送委派。代码在库,已在根 pom 启用并通过编译验证(未接入运行时)。
1. 模块概览
| 项 | 值 |
|---|---|
| Maven 模块 | pmforge-module-bpm |
| 控制器 | 12 |
| 接口 | 77 |
| 唯一权限点 | 37 |
| 数据对象(DO) | 8 |
| 已拆功能点 | 20 项 |
| 需求原件 | 03-01-流程设计 |
2. 能力清单
| 能力 | 优先级 | 状态 |
|---|---|---|
| BPMN 设计器 | P0 | ⏸ 预留 |
| 仿钉钉设计器 | P0 | ⏸ 预留 |
| 仿飞书设计器 | P1 | ⏸ 预留 |
| 流程定义管理 | P0 | ⏸ 预留 |
| 流程部署 | P0 | ⏸ 预留 |
| 流程分类 | P1 | ⏸ 预留 |
| 发起流程 | P0 | ⏸ 预留 |
| 我的流程列表 | P0 | ⏸ 预留 |
| 流程实例详情 | P0 | ⏸ 预留 |
| 取消流程 | P1 | ⏸ 预留 |
| 待办列表 | P0 | ⏸ 预留 |
| 已办列表 | P0 | ⏸ 预留 |
| 审批通过 / 驳回 | P0 | ⏸ 预留 |
| 会签 | P1 | ⏸ 预留 |
| 或签 | P1 | ⏸ 预留 |
| 抄送 | P1 | ⏸ 预留 |
| 委派与转办 | P2 | ⏸ 预留 |
| 加签与减签 | P2 | ⏸ 预留 |
| 超时提醒 | P2 | ⏸ 预留 |
| 触发与延迟节点 | P2 | ⏸ 预留 |
共 20 项,与能力地图的统计口径一致;状态为「预留」:代码在库、已通过编译验证,尚未接入 server 运行时。
3. 控制器与接口
| Controller | 路径前缀 | 接口 | 权限点 | 代码位置 |
|---|---|---|---|---|
| BpmTaskController | /bpm/task | 15 | 3 | modules/bpm/src/main/java/com/pmforge/module/bpm/controller/admin/task/BpmTaskController.java#L66 |
| BpmModelController | /bpm/model | 12 | 6 | modules/bpm/src/main/java/com/pmforge/module/bpm/controller/admin/definition/BpmModelController.java#L61 |
| BpmProcessInstanceController | /bpm/process-instance | 10 | 4 | modules/bpm/src/main/java/com/pmforge/module/bpm/controller/admin/task/BpmProcessInstanceController.java#L65 |
| BpmCategoryController | /bpm/category | 7 | 4 | modules/bpm/src/main/java/com/pmforge/module/bpm/controller/admin/definition/BpmCategoryController.java#L36 |
| BpmFormController | /bpm/form | 7 | 4 | modules/bpm/src/main/java/com/pmforge/module/bpm/controller/admin/definition/BpmFormController.java#L34 |
| BpmUserGroupController | /bpm/user-group | 6 | 4 | modules/bpm/src/main/java/com/pmforge/module/bpm/controller/admin/definition/BpmUserGroupController.java#L35 |
| BpmProcessExpressionController | /bpm/process-expression | 5 | 4 | modules/bpm/src/main/java/com/pmforge/module/bpm/controller/admin/definition/BpmProcessExpressionController.java#L32 |
| BpmProcessListenerController | /bpm/process-listener | 5 | 4 | modules/bpm/src/main/java/com/pmforge/module/bpm/controller/admin/definition/BpmProcessListenerController.java#L32 |
| BpmProcessDefinitionController | /bpm/process-definition | 4 | 1 | modules/bpm/src/main/java/com/pmforge/module/bpm/controller/admin/definition/BpmProcessDefinitionController.java#L52 |
| BpmOALeaveController | /bpm/oa/leave | 3 | 2 | modules/bpm/src/main/java/com/pmforge/module/bpm/controller/admin/oa/BpmOALeaveController.java#L39 |
| BpmCommentController | /bpm/comment | 2 | 2 | modules/bpm/src/main/java/com/pmforge/module/bpm/controller/admin/comment/BpmCommentController.java#L48 |
| BpmProcessInstanceCopyController | /bpm/process-instance/copy | 1 | 1 | modules/bpm/src/main/java/com/pmforge/module/bpm/controller/admin/task/BpmProcessInstanceCopyController.java#L54 |
4. 数据对象
| 表 | DO | 字段数 |
|---|---|---|
bpm_category | BpmCategoryDO | 0 |
bpm_form | BpmFormDO | 0 |
bpm_oa_leave | BpmOALeaveDO | 0 |
bpm_process_definition_info | BpmProcessDefinitionInfoDO | 0 |
bpm_process_expression | BpmProcessExpressionDO | 0 |
bpm_process_instance_copy | BpmProcessInstanceCopyDO | 0 |
bpm_process_listener | BpmProcessListenerDO | 0 |
bpm_user_group | BpmUserGroupDO | 0 |
主库脚本
sql/mysql/pmforge.sql只覆盖 system 与 infra,本模块的表结构以 DO 为准;启用前需自备 DDL(部分模块有测试脚本src/test/resources/sql/create_tables.sql)。
5. 启用前提
依赖:无强依赖,可单独启用;crm 的 pom 显式依赖它,启用 crm 前必须先启用 bpm。
- 根 pom 取消
pmforge-module-bpm注释 apps/pmforge-server/pom.xml加pmforge-module-bpm依赖- 用
modules/bpm/src/test/resources/sql/create_tables.sql起测试库 - Flowable 自身的表由
flowable.database-schema-update=true自动建 - 按 PRD 补
system_menu菜单与权限点(bpm:*)
6. 风险与注意
- Flowable 6.8.0 是钉死版本(BOM 注释禁止升 6.8.1,上游有回归)
- 流程模型编辑器在前端仓库,本仓库只有后端与 BPMN XML 生成逻辑
@TenantIgnore的批量收集在启动期扫描 HandlerMapping,新模块加控制器后要确认租户忽略表仍生效
7. 关联
- 相关页面:MOD-RSV-00
- 相关页面:PAT-05
- 模块手册:/modules/reserved/
- 接口索引:/code/api/bpm