一个注解起家，25 个模块收尾：Erupt 的生态版图长这样

一、先说个扎心的现状

如果你写 Java、做过公司内部系统，八成用过这类框架：RuoYi、YuDao、eladmin......它们的模式高度一致------给你一个脚手架，一键生成一堆前后端代码，然后这堆代码就归你养了。

刚开始很爽。生成一个用户管理、角色管理，五分钟跑起来。可等到第三个月，你会发现：生成的 20 个页面里有 18 个长得一模一样，改一个公共逻辑要在 18 个地方改；升级框架版本？生成的代码早被你改花了，根本 merge 不回去。

2026 年这件事更微妙了。有报告显示，今年 Q1 前端基础 UI 实现的需求同比降了 43% ，企业不再要人手搓页面，而是要"高级工程师去驾驭 AI 生成的代码"。换句话说：手搓 CRUD 这件事，正在被时代淘汰。

问题是------你淘汰了手搓，用什么接住？如果答案还是"让 AI/脚手架生成一堆代码你自己养"，那只是把手搓的活儿换了个人干，维护的债一分没少。

Erupt 给的是另一个答案。而且很多人没意识到，它已经不是"一个注解"那么小了。

二、先复习：Erupt 的核心赌注

一句话：一个类 = 一个后台页面。

java 复制代码

@Erupt(name = "Product")
@Table(name = "t_product")
@Entity
public class Product extends BaseModel {

    @EruptField(
        views = @View(title = "Name"),
        edit  = @Edit(title = "Name", notNull = true, search = @Search)
    )
    private String name;

    @EruptField(
        views = @View(title = "Price"),
        edit  = @Edit(title = "Price", type = EditType.NUMBER)
    )
    private BigDecimal price;
}

就这么点代码，你得到一个完整的后台页面：表格、搜索、新增/编辑表单、字段校验、分页、RBAC 权限、审计日志、Excel 导入导出、OpenAPI 接口------全都自动带上。零 Controller、零前端构建、2--5 秒启动。

关键不在"少写代码"，而在唯一真理来源是注解元数据：改一次注解，页面、接口、权限、导出全跟着变。没有 18 份重复代码要同步。

这是"点"。真正被低估的，是从这个点长出来的整个"面"。

三、生态盘点：一套元数据，长出六大能力域

Erupt 仓库有 ~25 个模块。别慌，按"你实际会用到的能力"归成六块看就清楚了。

域一 · 基础后台（erupt-core / upms / security / excel / data）

这是地基。erupt-upms 提供开箱即用的用户/角色/菜单/数据权限（RBAC），erupt-security 管登录与加密，erupt-excel 本周还新增了 EruptExcelService------导出、导入、模板生成一把梭：

java 复制代码

// Excel 导出 / 导入 / 模板，一个 service 全包
eruptExcelService.exportExcel(eruptModel, dataList);
eruptExcelService.importExcel(eruptModel, inputStream);
eruptExcelService.generateTemplate(eruptModel);

数据层 erupt-data 同时支持 JPA（MySQL / PostgreSQL / Oracle / SQL Server / 达梦）和 MongoDB。这一层就已经顶得上大多数"脚手架框架"的全部功能了------但它只是 Erupt 的起点。

域二 · 工作流（erupt-flow）

这两周文档刚扩成多页指南：快速开始、流程开发、自定义节点、流程打印、库表设计。erupt-flow 是一套嵌进 Erupt 的审批/工作流引擎 ------请假、报销、采购审批这类"带流转"的业务，不用你再外挂一个 Activiti 然后头疼集成。它和 @Erupt 实体同源，流程绑在你的领域模型上。

在线预览：erupt.xyz/#!/flow。

域三 · 多租户 SaaS（erupt-tenant）

如果你要把内部系统做成对外的 SaaS，erupt-tenant（Erupt SaaS）本周文档也扩成了多页：快速开始、多租户开发、独立域名与定制、库表设计。它解决 SaaS 最麻烦的三件事------租户数据隔离、按租户定制、独立域名------而你的业务代码几乎不用为"多租户"改造。

域四 · 语义层 & BI（erupt-cube / erupt-report）

这块是 Erupt 最近发力最猛的地方。

erupt-cube 是一个指标语义层平台 ，主打"用低成本查询十亿行级数据集"，带自己的 Cube ML 建模语法、可视化建模与分析。最硬核的是本周落地的 SQL Port ------它用 Apache Calcite 实现了一个 PostgreSQL 线协议端口：

sql 复制代码

# 你的 BI 语义层，现在能被任何 Postgres 客户端直连
psql -h your-erupt-cube -p 5432 -d cube
> SELECT region, SUM(gmv) FROM sales GROUP BY region LIMIT 10;

也就是说，DataGrip、Metabase、Superset 这些工具可以把 Erupt Cube 当成一个 Postgres 数据库直接连，底层由 Calcite 做 LIMIT / top-N 下推优化。语义层不再是封闭的孤岛。

erupt-report（前身 erupt-bi，本周正式改名）则是配置化的报表/图表模块：报表配置、数据源、图表、发布，一条龙。

域五 · AI（erupt-ai / ai-canvas / ai-claw）

Erupt 把自己定位成"AI Harness（AI 挽具）"------erupt-ai 内置 50+ LLM 供应商适配 、MCP 原生工具 、A2A（Agent 间协作）协议，全部能从后台 UI 配置。

erupt-ai-canvas 更进一步：对着后台说一句话，AI 流式生成一整页 HTML，而且这页面用当前登录用户的 token 走 Erupt SDK 查数据、字段来自真实模型 schema、每轮生成存版本可回滚。

域六 · 扩展 & 集群（erupt-extra / erupt-cloud / erupt-designer）

erupt-extra 是一堆即插即用的小能力：erupt-job（定时任务）、erupt-magic-api（动态 API）、erupt-monitor（监控）、erupt-websocket（实时交互）、erupt-notice（通知）、erupt-print（打印）、erupt-terminal（服务终端）、erupt-generator（代码生成）。

erupt-designer 是运行时表单设计器------底层用 ByteBuddy 在运行期动态生成字节码，不重启就能改模型（这就是官方第 07 期专题讲的"字节码设计器"）。

erupt-cloud 管分布式配置与集群，本周文档还补了集群架构图，Server / Node 分离部署。

四、和"脚手架框架"到底差在哪

同样是做后台，路线完全不同：

维度	脚手架框架（RuoYi/YuDao 等）	Erupt 生态
出发点	生成代码，代码归你养	注解即元数据，元数据是唯一真理来源
加一个页面	生成一套前后端代码	写一个类，页面自动出
改公共逻辑	多处重复代码同步改	改一处注解，全局生效
框架升级	生成代码被改花，难 merge	业务是注解，升级基本无痛
工作流	通常外挂 Activiti 自己集成	erupt-flow 同源内置
多租户	多为企业版/自己改造	erupt-tenant 开箱
BI / 语义层	基本没有	erupt-cube 语义层 + Postgres 端口
AI	外接	50+ LLM / MCP / A2A / 一句话生成页面

不是说脚手架框架不好------快速起一个标准管理系统它们很能打。但当你的系统要长期演进、要加工作流、要做多租户、要接 BI 和 AI ，脚手架给你的那堆生成代码会变成越来越重的包袱；而 Erupt 是往同一套元数据上叠模块，越长越轻。

五、5 分钟感受一下

最快的方式------克隆仓库跑自带 sample，H2 内存库，零配置：

bash 复制代码

git clone https://github.com/erupts/erupt
cd erupt/erupt-sample && mvn spring-boot:run
# 浏览器打开 http://localhost:8080/  默认账号 guest/guest

或者用 Maven 起步依赖，往你现有 Spring Boot 3 项目里加：

xml 复制代码

<dependency>
  <groupId>xyz.erupt</groupId>
  <artifactId>erupt-spring-boot-starter-all</artifactId>
</dependency>

然后按需往上叠模块：要工作流加 erupt-flow、要多租户加 erupt-tenant、要 BI 加 erupt-cube / erupt-report、要 AI 加 erupt-ai。核心不变，能力按需生长。

六、写在最后

低代码这条赛道，2026 年正在分化：一派让 AI/脚手架生成更多代码 ，另一派让元数据吃掉重复劳动。

前者解决的是"写得快"，后者解决的是"改得起、长得动"。

Erupt 押的是后者------从一个 @Erupt 注解出发，长成一个覆盖工作流、多租户、语义层 BI、AI 的生态，而它们全都站在同一套元数据地基上。

所以下次别再说"Erupt 就是个生成后台的小工具"了。它是你内部系统未来五年的地基。

🌟 觉得这套路线对，给个 Star：github.com/erupts/erupt
💬 想动手：按第五节 5 分钟跑通，卡住了去 GitHub Discussions 或扫码进群