系统架构总览
Forge Admin 采用微内核 + 插件化架构。产品可拆成多个可独立部署的进程(不是 Spring Cloud 微服务网格):进程之间用配置好的 HTTP 地址通信,不依赖服务注册中心。
进程与前端
| 进程 / 前端 | 说明 | 部署要求 |
|---|---|---|
Admin 服务 (forge-admin-server) | 主应用入口,聚合所有插件,提供后台管理 API | 必须 |
Flow 服务 (forge-flow-server) | 独立流程引擎,Flowable 运行时 | 按需 |
Report 服务 (forge-report-server) | 数据大屏报表服务 | 按需 |
App 服务 (forge-app-server) | App 接口服务 | 按需 |
管理端前端 (forge-admin-ui) | 后台 SPA(浏览器侧,不是后端微服务) | 必须 |
架构层级
┌─────────────────────────────────────────────────────────┐
│ forge-admin-ui(前端) │
│ Vue 3 + Naive UI + Vite + Pinia + UnoCSS │
├─────────────────────────────────────────────────────────┤
│ Nginx / 网关(生产环境) │
├─────────────────┬──────────┬──────────┬─────────────────┤
│ Admin 服务 │Flow 服务 │Report 服务│ App 服务 │
│ :8580 │ :8081 │ :8581 │ :8583 │
│ ┌─────────────┐│ Flowable│ 大屏报表 │ 移动端 API │
│ │Plugin System││ 引擎 │ 服务 │ │
│ │Plugin Flow ││ │ │ │
│ │Plugin Gen ││ │ │ │
│ │Plugin AI ││ │ │ │
│ ├─────────────┤│ │ │ │
│ │ Starter 层 ││ │ │ │
│ │ auth/cache ││ │ │ │
│ │ orm/tenant ││ │ │ │
│ │ crypto/log ││ │ │ │
│ └─────────────┘│ │ │ │
├─────────────────┴──────────┴──────────┴─────────────────┤
│ MySQL 8.0 │ Redis 6.0+ │
└─────────────────────────────────────────────────────────┘服务职责
Admin 服务
核心服务,聚合了所有业务插件和技术 Starter:
- 平台管理能力(插件
forge-plugin-system):用户、角色、菜单、组织、岗位、字典。演示左侧一级菜单叫 平台管理,不是「系统管理」;组织表是sys_org,不是「部门」。 - 代码生成:AI 驱动代码生成器(
forge-plugin-generator) - 流程:流程模型与审批客户端(
forge-plugin-flow)。操作入口是 流程中心,待办在 工作台待办,不是「流程管理」。 - 定时任务:Quartz / SnailJob(
forge-plugin-job) - 消息中心:站内信、邮件、App 推送(
forge-plugin-message) - AI 能力:供应商与模型管理(
forge-plugin-ai)
Flow 服务
独立的 Flowable 流程引擎运行时(默认端口 8081)。Admin 通过 forge-flow-client 的 FlowClient(RestTemplate)按 forge.flow.client.url 调用 Flow,不是 Feign,也不走服务发现。
Report 服务
数据大屏报表服务,提供可视化图表和画布布局能力。管理端通常经 SSO / 反向代理嵌入打开设计器。
App 服务
移动端 API 接口服务,为 H5 / App 端提供数据接口。
三层框架设计
应用层 → forge-admin-server(Spring Boot 入口,聚合所有模块)
├── forge-business(业务模块)
│
插件层 → forge-plugin-parent(system/job/message/flow/collaboration/print/generator/ai/capability/mcp/external/data 等)
│
启动器层 → forge-starter-parent(技术能力:auth/cache/orm/tenant/crypto/plugin ... 24 个 Starter)Starter 提供技术能力(认证、缓存、ORM、加密),Plugin 提供业务功能(系统管理、代码生成、流程),两者通过 Spring Boot 自动装配组合。
