专题 · Topics
每一期专题以一个核心话题为线索,把零散在源码、注解、模块里的 Erupt 能力,串成一条可读、可上手、可对位竞品的叙事。
节奏:约每月一期。

每期专题首发于此,另有版本动态、源码解读、社区精选案例。回复「加群」加入用户群,回复「入门」获取 5 分钟上手指南。
历史文章 · Archive
模块开关不是卸载
装上 46 个模块后,新人面对的是一排看不懂的菜单。erupt-upms 的模块中心不做插件市场:关掉模块只是 e_upms_module.enabled 的一列,真正干活的是 EruptMenuSeeder——按指纹跳过没变的模块,变了就对每个菜单字段做三方合并(库里值、上次写入值、本次声明值),管理员改过的保留;关闭走同一条对账路径,菜单置为禁用而非隐藏,因为隐藏的菜单仍会授权。代价写在明处:关的只是入口,Bean、接口与定时任务仍在运行。
公开链接不该是第二套认证
给陌生人一个能提交数据的链接,最容易的做法是开一条匿名接口。erupt-share 反过来:打开链接就是以签发人名义铸一枚普通会话,再由 SessionScopeGuard 按一张 22 条路由的白名单收窄到一张表单;链接权限不超过签发人,停用即注销已发会话,失败按 IP 限速,访问次数用一条 UPDATE 计数。代价写在明处:访客会话仍以签发人名义落库。
编码 Agent 的工牌
让 AI 写代码不难,难的是授权与交付。erupt-ai-dev 不给 Agent 造权限体系:每次运行由 DevMcpGrants 签发一枚只指向一张需求的 MCP 令牌,经 McpAuthenticator 接入 erupt-ai 的 /mcp,数据权限借需求创建者的 AI 角色;评审、验收、交付全是 @RowOperation,自审默认禁止;多仓库交付先 rebase 全部、任一冲突整批不推。代价写在明处:Agent 以服务器账号运行,读到的数据会发给模型提供方。
配置中心不必是另一个服务
后台里的「系统参数」常是一张 key/value 表加一个 getConfig 工具方法:读的人自己管缓存,和 application.yml 互不相识。erupt-config 不造新的读取 API,而是把配置项做成 Spring 环境最前面的一层 PropertySource:启动前由 EruptConfigEnvironmentPostProcessor 用 JDBC 读入,@Value 与 @ConfigurationProperties 原样读取,保存后替换整层、重设 @Value 字段并发 EruptConfigRefreshedEvent,多节点靠 Redis 广播或轮询聚合签名。代价写在明处:没有版本、灰度和审批,密文只遮罩不加密,SpEL 与构造器注入只在启动时解析。
SAML 的难点是拒绝
接入企业 SAML 单点登录,常见反应是找个成熟库——但库只解决 XML 签名的数学,一份响应能不能登录取决于验签前后查哪几样、按什么顺序。erupt-sso 的 SsoSamlService 只有 406 行、只用 JDK 的 javax.xml.crypto.dsig:状态一次性、InResponseTo、Destination、受众与有效期、只引用自身的签名,ID 只在被签元素上可解析以挡住签名包装,加密断言直接拒绝。代价写在明处:不解密断言、不签 AuthnRequest、没有单点登出,也不能充当 IdP。
事务没提交,别通知外部
数据变更要推给外部系统,最顺手的写法是在 DataProxy#afterAdd 里发 HTTP——它在事务提交之前执行,请求线程还得替接收方等着。erupt-webhook 押反向:订阅管线已发的 EruptAddEvent / EruptEditEvent / EruptDeleteEvent,AFTER_COMMIT 之后才匹配订阅,后台线程做 HMAC-SHA256 签名、3 次尝试、写投递日志,回滚的写入不通知。订阅表与日志表本身也是 @Erupt 模型,测试按钮、下钻、重发都是已有扩展点。代价写在明处:没有持久化队列、订阅缓存只在本节点刷新、脱敏只管 PASSWORD 字段。
「当前项目」不该是一条 where
多项目、多集群的后台里,「当前范围」常是前端下拉框加每张表手写的过滤。@EruptScope 把范围声明成一个普通 @Erupt 表单类:客户端只递一个值,EruptScopeService 每次请求对照当前用户的可选项重验,并改写列表查询、按 id 校验和新增 / 编辑,必填范围从不猜。边界写在明处:范围不是权限,要隔离用户仍须用按用户过滤的选项或数据权限。
节点不是 Spring 应用,是一份协议
传统分布式后台里,每接一个服务就要再接一遍网关、token 与权限。erupt-cloud 押反向:登录、菜单、校验、Excel、附件都由服务端代办,节点只交模型描述和数据读写;转发由 CloudSignature 做 HMAC 签名,Erupt-Enforced 声明服务端已查项。薄到 erupt-cloud-node-lite 约 2400 行、不依赖 Spring。代价写在明处:协议仍是 Draft v0,lite 节点未支持子表、树、文件上传,跨语言一致性测试在独立仓库。
声明一次,到处生效
低代码里的字段规则多半是设计器里的 UI 配置:浏览器拦得住,直接调写入接口未必。Erupt 的 @Edit 是页面与服务端共读的同一份注解,EruptValueValidator 在写入管线里把选项、长度、数值与日期边界再执行一遍,覆盖 8 类组件、5 个写入入口,连子表行与 Excel 导入也不例外。代价写在明处:时间类选择器不校验边界,choice-validate 默认开启会拒绝旧的越界写入。
改动历史不属于任何一个 DataProxy
字段历史在业务代码里通常是每个模型一份 xxx_history。erupt-revision 押反向:不碰 DataProxy,订阅管线已发的 EruptEditEvent,在调用方事务里写字段级 diff;回滚把旧值送回同一条 updateEruptData 管线,校验与钩子照常执行,回滚本身也留修订。代价写在明处:拖拽排序不发事件、绕过管线的写入看不见、历史写失败只打 warn。
一张表,八种视图
明道云、简道云、宜搭把视图做成平台里的对象,各带一套筛选与分组。@Vis 押反向:视图只是同一次 TableQuery 的投影,行级权限写在 DataProxy#beforeFetch 里对 8 种视图一次生效,列统计与列表共用 assembleQuery。代价也写明了:看板、日历、甘特的拖动写回还没走整行校验,也没有 verifyIdPermissions。
数据不在你库里的时候
数据在钉钉多维表、飞书多维表格、Airtable 或别人的 REST 接口里,宜搭、明道云、简道云的答案是"连接器 + 同步"。Erupt 押反向:不搬数据,换引擎——一行 @EruptDataProcessor,校验、DataProxy、权限、日志一条管线不动;任意 REST 的差异收进 EruptHttpAdapter 的 8 个钩子。代价也写在明处:5000 行上限、默认只下推等值条件、beforeFetch 只认等值片段、跨 HTTP 无事务。
让 AI 判断回到 if 语句里
工作流里的大模型节点吐出一段文本,下游条件分支再去猜它的意思。erupt-ai-decision 只回答三种类型化的问题——NOUL 是/否、CHOICE 多选一、SCORE 有序打分——每个答案都带概率分布,"拿不准"是一条 Optional.empty() 分支。对照宜搭、简道云、JeecgBoot、Dify:模型负责"有多像",代码负责"算不算",阈值永远写在你的 if 里。
从数据库反向生成模型
第 05 期我们说 Erupt 没有"生成"这个动词。现在 erupt-generator 能反读一个存量数据库,把列注释里的"0-待支付 1-已支付"读成 @ChoiceType、把外键约束读成按真实列标注的引用。两者不矛盾:若依、JeecgBoot 一张表生成一套分层,Erupt 一张表只生成一个 @Erupt 类,不写源码目录、不留运行时痕迹——生成一次,然后退场。
不依赖 Spring Security 的登录链
接 SSO 的常规路径是引 spring-security-oauth2-client、写 SecurityFilterChain、再挑一个 JWT 库。Erupt 一个都没引——不是造轮子的偏好,而是登录链一旦拆进 Filter 与外部 starter,"这个账号能不能进来"就再也不是一份判断。这一期讲那条自己走完的七关登录链:SSO Provider 是一张 @Erupt 表不是 yaml、从不读 id_token、token 不进 URL、锁定键是 account+IP 而不是 account。
远程主机的安全边界
浏览器里开一个 SSH 终端,国内只有两条成熟的路——上 JumpServer 这类堡垒机,另起一套账号体系与审计;或者装 1Panel / 宝塔,装上即 root、边界基本不存在。Erupt 押第三条:远程主机就是一个普通的 @Erupt 模型,走同一套菜单权限、同一套 DataProxy、同一套行过滤,不新增账号表也不新增常驻进程。代价是安全边界要一条条自己画——这一期把那几条线逐条摊开,包括两个明确"不做"。
记录评论为什么不绑定业务表
所有做后台的人都给某张表加过 remark 字段,然后加 remark_user、remark_time,然后建一张 xxx_comment 子表——下一个实体来了再来一遍。宜搭把评论挂在流程节点上,简道云挂在表单上。Erupt 押反向:一张表不认识任何业务实体,靠 (模型名, 主键字符串) 寻址;而在多节点部署里,记录在节点、评论在中心——这逼出了 @EruptRouter 的 cloudProxy 开关。
单元格编辑为什么走整行管线
后台表格集体向多维表格靠拢,双击就地改一个字段。体验好,但它在服务端开了一条只带一个字段的写入路径——跨字段规则跑不了、DataProxy 拿到残缺实体、只读形同虚设、afterFetch 的回显值会被写回。Erupt 押反向:单元格编辑不配拥有自己的路径,把整行捞出来打补丁,再原样走一遍编辑管线。七道关全在服务端。
模型图谱与静态审计
低代码平台画模型关系图,通常是为了"看起来专业"。erupt-atlas 押反向——图只是副产品,真正的输出是对运行时注册表的一次静态审计:循环依赖(Tarjan SCC)、共享物理表、孤儿模型、建了没挂菜单的模型、声明了权限却没长出按钮。三个 REST 端点返回结构化 JSON,能被人看,也能被 CI 断言。
注解里写的不是字符串,是有语法的代码
画布党最爱的反驳是"注解就是把 SQL 写成没高亮的哑字符串"。Erupt 押反向——用 JetBrains @Language 往自己的注解属性里注入 10 种嵌入式语言(hql/sql/VTL/markdown/java…),一行 sql="..." 在 IntelliJ 里有高亮、补全、报错;@Comment 再让同一个属性对人和 AI 都自描述。
ByteBuddy × JsonAnnotationProxy × @EruptDataProcessor:我们做了设计器,但它编译成一个真 @Erupt 类
在线表单设计器几乎都把设计稿存成一份 JSON DSL,运行时靠解释器渲染。erupt-designer 押反向:设计稿在运行时被 ByteBuddy 编译成一个真正的 @Erupt 类,复用与手写实体完全相同的管线——Gson、反射、校验、DataProxy、@EruptFlow,无重启、无生成代码、无解释器。
@Power × SHA512+Salt × PowerHandler:低代码的"安全"不该是上线前才补的那一栏
国内后台框架的安全是"配齐再上线"——RBAC、按钮权限、密码加密都是清单上的待办项。Erupt 押反向:安全是注解默认值。@Power 的 export/importable 默认 false,PowerHandler 在运行时收口,密码 MD5→SHA-512+盐 在改密时自动平滑迁移,无停机、无 rehash 脚本。
注解 × Spring × Git:史上最可控的低代码——没有"生成"这个动词
国内低代码 = 拖拽画布 / Node.js 在线脚本,给业务运营用。Erupt 押的是反向那条路——做给后端工程师的低代码:注解就是配置,扩展点都是 Spring Bean,真理在 Git 里,框架不向你源码目录写一个字节;17 个 LLM + A2A + Memory + @AiToolbox 是默认依赖,不是 AI 加件。
让 BI 看板自己回答"为什么变了"——Erupt Cube × LLM 的新姿势
传统 BI 给你"是什么",Erupt Cube × LLM 给你"为什么"。@EruptCube 注解定义语义层,LLM 在领域模型旁边长出三只眼睛(cubeList → cubeMetadata → cubeQuery),自己写 SQL、出图、写归因。这一期把第 01 期的 AI Harness 和第 03 期的"注解派"缝到一起。
当 MyBatis-Plus 还在卷 SQL DSL,Erupt 给 JPA 加了一整圈后台基础设施
一个 @Entity,在 Erupt 里能长出 10 种身份——UI、RBAC、REST API、Auto DDL、i18n、DataProxy、Lambda 查询、AI Agent、流程引擎、跨服务聚合。注解就是配置面,元数据 = UI = API = LLM Tool。
@Erupt × DataProxy × Handler:为什么我们没去做拖拽画布
当钉钉宜搭、简道云、JeecgBoot 全部押注"画布"或"画布生成代码",Erupt 仍然押注源代码本身——一行 @Erupt 注解、一个 DataProxy<T> 扩展点、一组 Handler 接口。这一期讲清楚为什么。
50+ LLM × A2A × Memory:Erupt 的 AI Harness 是怎么长出来的
17 个 provider、A2A 跨 Agent 协议、跨会话 Memory,外加一个 Java 注解就能挂上去的 Tool / MCP 调用——为什么我们认为 Java 后台不该被 ToolJet 那种"AI App Generator"叙事垄断。
想投稿专题?
专题不是发版日志,也不是模块手册——它讲的是一个想法在 Erupt 里如何落地。 如果你在使用 Erupt 时踩出过一条独特路径,欢迎在 GitHub Discussions 提案,被采纳的话我们会以专题形式出版。