文章目录
- 一、Activiti Modeling App 7.9.0 核心特性与架构
- 1.1. 核心功能
- 1.2. 技术架构
- 1.3. 兼容环境
- 二、快速部署清单（分 2 种部署模式）
- 2.1.前置条件
- 2.2.模式 1：Docker Compose 快速部署
- 2.3.模式 2：源码编译部署（适合二次开发）
- 2.4.生产环境部署补充清单
- 三、常见问题与解决
- 四、核心目录结构（源码部署参考）
Activiti Modeling Application (AMA) 7.9.0 是 Alfresco 推出的低代码流程建模工具，基于 Activiti 7 核心引擎，专注于可视化设计 BPMN 2.0 流程、DMN 决策表、表单等，支持与 Activiti Runtime 集成实现流程执行，适用于企业级流程自动化场景。以下是详细介绍和可落地的快速部署清单。
一、Activiti Modeling App 7.9.0 核心特性与架构
1.1. 核心功能
| 模块 | 核心能力 |
|---|---|
| BPMN 2.0 建模 | 可视化拖拽设计流程（网关、任务、事件、边界事件等），支持流程校验、导出 BPMN XML |
| DMN 决策表设计 | 可视化编辑决策表、决策逻辑，支持 FEEL 表达式，导出 DMN 1.3 标准文件 |
| 表单设计器 | 拖拽式设计表单（文本、下拉、日期、附件等控件），支持表单与流程任务绑定 |
| 版本管理 | 模型版本化管理，支持版本对比、回滚、发布 |
| 团队协作 | 模型权限控制（查看 / 编辑）、评论功能，支持多人协同建模 |
| 集成能力 | 与 Activiti Runtime 7.x 无缝集成，一键发布模型到运行时引擎；支持 REST API 扩展 |
| 自定义扩展 | 支持自定义建模规则、表单控件、BPMN 元素属性，适配企业个性化需求 |
1.2. 技术架构
- 前端：基于 Angular 12 + TypeScript，使用 bpmn-js/dmn-js 作为核心建模引擎，UI 框架采用 Clarity Design。
- 后端：基于 Spring Boot 2.6.x，核心依赖 Activiti Core 7.9.0、Activiti Cloud Services，支持微服务 / 单体部署。
- 存储：默认嵌入式 H2（开发环境），生产支持 PostgreSQL/MySQL；可选集成 Alfresco Content Services 存储模型文件。
- 认证授权：默认 Keycloak（OpenID Connect），支持 LDAP/Active Directory 集成。
1.3. 兼容环境
- JDK：11（必须，7.9.0 不再支持 JDK 8）
- 浏览器：Chrome 88+、Firefox 85+、Edge 88+
- 后端依赖：Activiti Core 7.9.0、Activiti Cloud 7.9.0（微服务部署时）
- 数据库：PostgreSQL 12+、MySQL 8.0+（生产）、H2 1.4.200（开发）
- Keycloak：15.0.2+（认证服务）
二、快速部署清单（分 2 种部署模式）
2.1.前置条件
- 服务器 / 本地环境：至少 2 核 4G 内存，10G 磁盘空间
- 安装：Docker + Docker Compose（推荐容器部署），或 JDK 11 + Maven 3.8.x（源码部署）
- 网络：允许访问 Maven 中央仓库、Docker Hub
2.2.模式 1：Docker Compose 快速部署
- 步骤 1：下载官方部署配置
# 创建部署目录mkdiractiviti-modeling-7.9.0&&cdactiviti-modeling-7.9.0# 下载官方docker-compose.yml（7.9.0 版本）curl-Ohttps://raw.githubusercontent.com/Activiti/activiti-modeling-app/7.9.0/docker/docker-compose.yml# （可选）下载自定义配置文件（如数据库、Keycloak配置）curl-Ohttps://raw.githubusercontent.com/Activiti/activiti-modeling-app/7.9.0/docker/.env- 步骤 2：修改配置（关键）
编辑 .env 文件，调整核心参数：
# 基础配置ACTIVITI_VERSION=7.9.0SPRING_PROFILES_ACTIVE=dev,auth# 数据库配置（默认H2，生产改MySQL/PostgreSQL）DB_TYPE=h2DB_URL=jdbc:h2:mem:activiti;DB_CLOSE_DELAY=-1DB_USER=saDB_PASSWORD=# Keycloak 配置（默认内置，生产建议独立部署）KEYCLOAK_URL=http://localhost:8180/authKEYCLOAK_REALM=activitiKEYCLOAK_CLIENT_ID=activiti-modelingKEYCLOAK_USER=adminKEYCLOAK_PASSWORD=admin# 端口配置MODELING_APP_PORT=8080KEYCLOAK_PORT=8180- 步骤 3：启动服务
# 启动所有服务（Modeling App + Keycloak + 内置数据库）docker-composeup-d# 查看启动日志docker-composelogs-factiviti-modeling-app- 步骤 4：访问验证
访问地址：http://<服务器 IP>:8080
默认账号：admin/admin
验证：登录后可创建 BPMN 流程、DMN 决策表，确认建模功能正常。
2.3.模式 2：源码编译部署（适合二次开发）
- 步骤 1：拉取源码
# 克隆7.9.0版本源码gitclone-b7.9.0 https://github.com/Activiti/activiti-modeling-app.gitcdactiviti-modeling-app- 步骤 2：编译前端（Node.js 14+ 环境）
# 安装前端依赖cdappnpminstall# 编译前端资源（输出到dist目录）npmrun build--prod- 步骤 3：编译后端（Maven 3.8+ + JDK 11）
# 返回根目录cd..# 编译后端工程（跳过测试）mvn clean package-DskipTests- 步骤 4：启动后端服务
# 运行打包后的JAR包java-jarbackend/target/activiti-modeling-app-7.9.0.jar\--spring.profiles.active=dev\--server.port=8080\--spring.datasource.url=jdbc:h2:mem:activiti\--keycloak.auth-server-url=http://localhost:8180/auth- 步骤 5：访问验证
前端访问：http://localhost:8080（后端内置前端静态资源）
账号：admin/admin（需先启动 Keycloak，参考 Docker 部署的 Keycloak 配置）
2.4.生产环境部署补充清单
| 检查项 | 配置要求 |
|---|---|
| 数据库 | 替换 H2 为 PostgreSQL/MySQL，配置连接池（如 HikariCP），开启数据库备份 |
| 认证授权 | 独立部署 Keycloak，配置 HTTPS，创建专属 Realm 和用户组，限制权限 |
| 网络安全 | 开启 HTTPS（配置 SSL 证书），限制 Modeling App 端口访问（仅内网 / 指定 IP） |
| 存储 | 模型文件存储到 Alfresco Content Services，开启版本备份 |
| 性能优化 | JVM 参数：-Xms2G -Xmx4G，调整 Tomcat 线程池，数据库索引优化 |
| 监控 | 集成 Prometheus + Grafana，监控 JVM、数据库、接口响应时间 |
| 日志 | 配置 logback 输出 JSON 格式日志，对接 ELK 栈，开启审计日志（模型创建 / 修改 / 删除） |
三、常见问题与解决
- Keycloak 登录失败：检查 Keycloak 是否启动，Realm/Client ID 是否匹配，默认密码是否修改。
- 前端编译报错：确保 Node.js 版本为 14.x（7.9.0 不支持 Node.js 16+），删除 node_modules 后重新安装。
- 后端启动报 JDK 版本错误：确认环境变量 JAVA_HOME 指向 JDK 11，执行java -version验证。
- BPMN 模型发布失败：检查 Activiti Runtime 是否部署，Modeling App 与 Runtime 的版本是否均为 7.9.0。
四、核心目录结构（源码部署参考）
activiti-modeling-app/ ├── app/# 前端源码（Angular）│ ├── src/app/# 核心组件（BPMN/DMN/表单设计器）│ └── dist/# 编译后前端资源├── backend/# 后端源码（Spring Boot）│ ├── src/main/java/# 核心API、权限、集成逻辑│ └── target/# 编译后JAR包└── docker/# Docker部署配置├── docker-compose.yml# 一键部署配置└── .env# 环境变量配置Activiti Modeling App 7.9.0 是轻量级但功能完整的流程建模工具，Docker Compose 部署最快（5 分钟完成），适合快速验证；源码部署适合二次开发。生产环境需重点关注数据库、认证、网络安全的配置，确保稳定性和安全性。
“人的一生会经历很多痛苦，但回头想想，都是传奇”。
