工作流
基于 Flowable 8(BPMN 2.0)。业务人员在「流程中心 → 流程模型」中用仿钉钉的设计器设计表单和流程,发布后由后端转换为标准 BPMN 部署到引擎;用户和组织架构直接使用系统自己的表(不启用 Flowable IDM)。
架构
framework/workflow
业务模块接入工作流的契约(不依赖流程引擎)
├── FlowApi
发起 / 撤销流程、查询状态
├── FlowBusiness
声明业务流程及其变量
├── ApprovalFlow / ApprovalSupport
单据接入审批的公共组件
├── FlowFinishedEvent
流程结束事件(通过、拒绝、撤回、终止)
└── identity
FlowIdentityProvider:用户、角色查询,由 system 模块实现
modules/workflow
Flowable 集成
├── model
设计器 JSON 模型:FlowNode 节点树、FormField 表单字段、条件运算符
├── engine
BpmnModelConverter(节点树 → BPMN)、审批人策略 flowAssignee、条件计算 flowCondition、监听器
└── service / controller
模型发布、发起、待办 / 已办、审批、抄送、实例详情
- BPMN 只描述流转结构:审批人、分支条件等写在设计 JSON(
flow-design.json)中,随 BPMN 放在同一个部署里,由表达式 Bean 按节点 ID 读取;每个流程定义版本都自带对应的设计。 - 条件在 Java 中计算(
ConditionOperator),不拼接表达式,避免表达式注入。 - 审批接口用
@Retryable处理引擎乐观锁冲突(在事务之外重试)。 - 流程定义按租户部署,同一流程标识在各租户独立编号版本。
已接入审批的业务
流程未发布或停用时业务单据直接生效;发布后对应操作改为提交审批,通过后生效,拒绝或撤回后恢复原状态。
| 流程标识 | 业务 | 流程变量 | 审批通过后 |
|---|---|---|---|
ecom_inbound | 头程货件提交发运 | amount 费用合计、totalQty、storeName | 发运,生成在途调拨单 |
ecom_dev_project | 开发项目审批 | estMargin 试算利润率、estProfit、targetPrice、estPurchasePrice、estMonthlySales、sampleFee、platform、projectName | 通过并自动生成物料 |
scm_purchase_order | 采购订单审核 | amount、wholeDiscount、orderNo | 已审核 |
scm_order_change | 采购订单变更 | kind、amountDelta 等 | 变更生效 |
wms_stock_doc / wms_check | 出入库、调拨确认 / 有差异的盘点 | kind、bizType、totalQty / gainQty、lossQty | 更新库存 |
fin_voucher / fin_payment | 凭证 / 付款单 | amount 等 | 已审核 / 核销应付 |
fin_expense / fin_loan | 费用报销 / 员工借款 | - | 待付款 |
init.sql 内置了大部分流程模型(未发布);ecom_inbound 没有预置模型,需要审批时在「流程模型」中新建该标识的流程。接入方法见 单据公共组件 中的「接入审批」。
