Forge Admin

🚀 基于 Vue3 + Spring Boot 3 的企业级中后台管理框架
✨ 集成 AI 数据可视化大屏，自然语言一键生成数据报表

在线演示 · 快速开始 · AI 大屏 · 功能模块 · 更新日志

---

✨ 项目简介

Forge Admin 是一个现代化的企业级中后台管理框架，采用 微内核 + 插件化 架构设计，核心功能以插件形式存在，便于按需引入和扩展。

系统架构

🌟 核心亮点

能力	说明
🏗️ 微内核架构	核心框架轻量级，功能通过插件扩展，按需引入
🤖 AI 大屏生成	自然语言描述需求，AI 自动生成完整数据大屏
🎨 低代码大屏设计	拖拽式可视化编辑器，丰富的图表组件和主题
🔐 多租户 & RBAC	完善的多租户数据隔离 + 细粒度权限控制
⚡ AI驱动代码生成器	AI驱动0代码生成，简单CRUD实现0代码驱动
🔄 流程管理	轻量集成 Flowable 工作流引擎
🔌 多 AI 供应商	支持阿里百炼、OpenAI、DeepSeek、Ollama 等
📊 真实数据对接	大屏报表直接对接后端 API，告别静态 Mock

📺 演示地址

后台管理：http://81.70.22.48:8084/forge/login

账号：admin / 123456

项目文档：http://81.70.22.48:8084/forge-docs/

项目源码：gitee: https://gitee.com/ForgeLab/forge-admin 项目源码：github: https://github.com/yaomindong1996/forge-admin

---

🖼️ 系统截图

后台管理系统

登录页面

系统提供安全的登录认证，支持验证码校验，保障系统安全。

首页仪表盘

直观的数据展示面板，实时掌握系统运行状态和关键业务指标。

菜单管理

灵活的菜单配置，支持动态路由、权限绑定，轻松构建系统导航结构。

配置管理

可视化配置管理，支持系统参数、字典数据的动态维护。

消息管理

统一消息中心，管理系统通知、站内消息，支持消息模板配置。

流程管理

轻量集成 Flowable 工作流引擎，业务一键触发，统一管控。

我的待办

文件管理

统一文件管理，支持 RustFS、本地存储等多种存储方式。

数据权限配置

灵活的数据权限配置，精确到字段级别的数据隔离。

Excel 导出配置

导入导出可配置，省去多余的注解配置，动态调整模版。

服务监控

实时监控服务器状态，包括 CPU、内存、磁盘等关键指标。

---

🤖 AI 数据可视化大屏

Forge AI — AI 驱动的数据可视化低代码开发平台。一句话描述即可自动生成数据大屏，支持拖拽编排、数据接入与一键发布。

核心特性

🤖 AI 智能生成	🧩 组件素材库	🎨 主题定制
接入 AI 大模型，一句话描述即可自动生成数据大屏页面。支持多供应商灵活配置，AI 对话式交互完成组件编排与数据配置。	内置 50+ 图表组件，涵盖柱状图、折线图、饼图、雷达图、热力图、地图等。所有组件支持拖拽编排、自由缩放与图层管理。	内置多套深/亮色主题，支持自定义主题色、全局滤镜、背景图片/颜色、画布尺寸与适配方式。
📊 数据接入	⚡ 事件交互	🚀 一键发布
支持静态数据、动态 HTTP 请求、数据池三种数据模式。内置数据映射、过滤器、在线编辑器，轻松对接后端 API。	支持组件交互事件（单击/双击/鼠标进入/移出）、高级生命周期事件（渲染前/后）、自定义 JavaScript 代码编辑器。	编辑完成即可发布上线，自动生成预览链接，支持截图分享。发布前自动保存，杜绝数据丢失。

界面预览

页面	截图
登录页
项目列表
画布编辑器
AI 供应商配置

内置组件

分类	组件
图表	柱状图、横向柱状图、折线图、面积图、饼图、环形图、雷达图、散点图、热力图、漏斗图、水球图、中国地图
信息	文字、渐变文字、词云、图片、视频、嵌套网页
表格	滚动排名列表、滚动表格
装饰	边框 0113、装饰 0105、数字翻牌、时钟、倒计时、数字计数

AI 供应商

支持阿里百炼（通义千问）、OpenAI（GPT）、智谱 AI（GLM）、Moonshot（Kimi）、DeepSeek、Ollama 等主流 AI 服务，内置预设模板一键配置，兼容 OpenAI API 格式的任意自定义服务。

---

---

AI驱动的代码生成

🧠 基于AI驱动的代码生成，区别与其它传统的代码生成器，简单的CRUD页面，可以通过组件市场进行个性化配置，配置之后既可完整0代码生成，也可以选择将代码包下载到工程，进行后续的改造

AI表单生成

AI表单生成列表

模版配置

表单编辑

---

💻 技术栈

后端技术

技术	说明
Spring Boot 3	应用开发框架
Spring Cloud	微服务框架（可选）
MyBatis-Plus	ORM 框架
Sa-Token	认证授权框架
Redisson	分布式缓存
Quartz	任务调度
Flowable	工作流引擎
Spring Cloud Gateway	网关（可选）

前端技术

技术	说明
Vue 3	渐进式前端框架
Naive UI	Vue 3 组件库
Pinia	状态管理
Vue Router	路由管理
Vite	构建工具
UnoCSS	原子化 CSS
ECharts 5	数据可视化图表库
VChart	字节跳动图表框架

---

📁 模块说明

后端模块

forge/
├── forge-admin/                 # 主应用模块
├── forge-flow/                  # 流程管理模块
├── forge-framework/            # 框架核心
│   ├── forge-plugin-parent/    # 插件父模块
│   │   ├── forge-plugin-system/     # 系统管理插件
│   │   ├── forge-plugin-generator/  # 代码生成插件
│   │   ├── forge-plugin-job/        # 任务调度插件
│   │   └── forge-plugin-message/    # 消息插件
│   └── forge-starter-parent/   # 启动器父模块
│       ├── forge-starter-auth/      # 认证授权
│       ├── forge-starter-cache/     # 缓存管理
│       ├── forge-starter-config/    # 配置中心
│       └── forge-starter-api-config/# API配置

前端项目

forge-admin-ui/                  # 后台管理系统前端
├── src/
│   ├── api/            # API 接口
│   ├── components/     # 公共组件（含 AI 表单组件）
│   ├── composables/    # 组合式 API
│   ├── layouts/       # 布局组件
│   ├── router/        # 路由配置
│   ├── store/         # 状态管理
│   └── views/         # 页面视图

forge-report-ui/                # AI 数据可视化大屏前端（基于 GoView）
├── src/
│   ├── components/
│   │   └── GoAI/       # AI 功能核心模块
│   ├── api/ai/         # AI 接口层
│   ├── packages/       # 图表组件包（ECharts/VChart/装饰/3D）
│   └── views/          # 大屏编辑器/预览/项目管理

---

🚀 快速开始

环境要求

• JDK 17+
• Node.js 18+
• pnpm 8+
• MySQL 8.0+
• Redis 6.0+

后端部署

1. 克隆项目

git clone https://gitee.com/ForgeLab/forge-admin.git
cd forge-admin

2. 导入数据库

执行 forge/forge-admin/sql/初始化脚本.sql 创建基础数据库表 如果需要部署大屏项目 执行 forge/forge-report/sql/report-init.sql 大屏相关数据表

3. 本地环境配置

复制配置模板

首次克隆项目后，需要复制配置模板文件到本地配置：

# 复制admin模块配置
cp forge/forge-admin/src/main/resources/application-dev.example.yml forge/forge-admin/src/main/resources/application-dev.yml

# 复制flow模块配置
cp forge/forge-flow/src/main/resources/application-dev.example.yml forge/forge-flow/src/main/resources/application-dev.yml

修改配置信息

编辑 application-dev.yml 文件，修改以下配置：

数据库配置

spring:
  datasource:
    dynamic:
      datasource:
        master:
          url: jdbc:mysql://localhost:3306/your_database?useUnicode=true&characterEncoding=utf8&zeroDateTimeBehavior=convertToNull&useSSL=true&serverTimezone=GMT%2B8&autoReconnect=true&rewriteBatchedStatements=true&allowPublicKeyRetrieval=true&nullCatalogMeansCurrent=true
          username: your_username
          password: 'your_password'

Redis配置

spring.data:
  redis:
    host: localhost
    port: 6379
    database: 0
    password: 'your_redis_password'
    redisson:
      config: |
        singleServerConfig:
          address: "redis://localhost:6379"
          database: 0
          password: 'your_redis_password'

配置说明

• application-dev.yml 属于本地配置文件，已经加入 .gitignore，不会提交到Git仓库
• application-dev.example.yml 是配置模板，提交到Git仓库，供其他开发者参考
• 其他配置项根据需要自行修改，不需要提交到仓库

注意事项

⚠️ 禁止将包含敏感信息的配置文件提交到Git仓库

• 数据库密码、Redis密码、密钥等敏感信息不得提交
• 新增配置项需要添加到 application-dev.example.yml 模板中，并替换敏感信息
• 生产环境配置使用单独的 application-prod.yml，同样不提交到仓库

其他配置

• 前端配置请参考 forge-admin-ui/.env.example 文件，复制为 .env.local 进行修改

4. 启动服务

cd forge/forge-admin
mvn spring-boot:run

服务默认启动在 http://localhost:8080

前端部署

后台管理系统

cd forge-admin-ui
pnpm install
pnpm dev

AI 大屏平台

后台项目启动 forge-report服务

cd forge-report-ui
npm install
npm run dev

系统用户名: admin / 123456

构建生产版本

# 后台管理
cd forge-admin-ui && pnpm build

# AI 大屏
cd forge-report-ui && npm run build

测试/生产环境部署

详细的 Nginx 配置请参考 NGINX_CONFIG.md

---

📋 功能模块

系统管理

模块	说明
用户管理	用户的增删改查、角色绑定、组织关联
角色管理	角色权限配置、资源绑定
菜单管理	动态菜单配置、页面路由管理
部门管理	组织架构管理、树形结构
岗位管理	岗位配置、用户岗位关联
租户管理	多租户配置、租户隔离

系统监控

模块	说明
在线用户	查看当前在线用户、强制下线
定时任务	任务配置、动态调度
系统日志	操作日志、登录日志查询
系统监控	CPU、内存、磁盘监控

运维工具

模块	说明
缓存管理	Redis 缓存可视化操作
文件管理	文件上传、存储配置
字典管理	静态字典维护
通知公告	通知发布、阅读状态跟踪

开发者工具

模块	说明
代码生成	可视化配置、代码生成
API 配置	接口行为动态配置
数据源管理	多数据源配置
Excel 配置	导入导出模版动态配置

AI 大屏报表

模块	说明
大屏编辑器	拖拽式可视化设计，支持 30+ 图表组件
AI 生成	自然语言描述，一键生成数据大屏
AI 供应商	多供应商管理，支持 7+ 主流 AI 服务
数据源配置	对接真实后端 API，支持动态数据刷新
项目管理	大屏项目持久化存储、发布管理
模板市场	预置行业模板，快速复用

---

🔌 插件说明

系统管理插件 (forge-plugin-system)

提供完整的系统管理功能，包括用户、角色、菜单、部门、岗位、租户等管理。

代码生成插件 (forge-plugin-generator)

可视化代码生成工具，支持：

• 数据库表导入
• 字段配置
• 模板管理
• 代码预览与下载

任务调度插件 (forge-plugin-job)

基于 Quartz 的分布式任务调度，支持：

• Cron 表达式配置
• 手动触发执行
• 任务执行日志

消息插件 (forge-plugin-message)

统一消息中心，支持：

• 系统通知
• 站内消息
• 消息模板

---

❓ 常见问题

Q: 为什么我拉取代码后启动报错？

A: 首次拉取代码需要复制配置模板并修改为本地环境的数据库和Redis配置。

Q: 新增配置项需要注意什么？

A: 如果新增的配置项是通用的，请同步更新到 application-dev.example.yml 模板中，敏感信息用占位符代替。

Q: 不小心提交了敏感配置怎么办？

A:

1. 立即修改密码
2. 执行 git rm --cached <file> 从仓库中移除文件
3. 将文件加入 .gitignore
4. 提交并推送到仓库

---

📝 更新日志

查看 CHANGELOG.md 了解项目的版本更新历史。

🤝 贡献指南

欢迎提交 Issue 和 Pull Request。

📮 联系作者 项目合作，沟通交流，欢迎各位老板打扰👏🏻

💖 开源赞助支持

感谢各位大佬赞助支持项目持续迭代、维护与开源分享，所有赞助不分金额，都是莫大鼓励！

赞助规则

• 微信转账/赞赏均可
• 赞助后可提供：微信昵称、自定义备注、个人诉求、GitHub/Gitee 主页
• 永久公示在本项目 README 赞助名单中

🏆 赞助名单

序号	微信昵称	赞助金额	赞助时间	个人诉求 / 备注
1	Jacstybao	¥30.00	2025-05-12	希望升级springBoot4
2	白哥	¥200.00	2025-05-12	开源赞助
2	*超	¥30.00	2025-05-12	开源赞助

---

赞助方式

扫码微信即可赞助，备注「开源赞助」，我会及时录入名单更新 README。

📄 许可证

本项目基于 MIT 许可证开源。