From 71618853366472ddeeecd1cdad21aebd996031ce Mon Sep 17 00:00:00 2001 From: YuePeng Date: Thu, 4 Dec 2025 18:22:33 +0800 Subject: [PATCH 1/3] update readme --- erupt.svg | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/erupt.svg b/erupt.svg index d1d4720c7..f88916930 100644 --- a/erupt.svg +++ b/erupt.svg @@ -22,7 +22,7 @@ } .text:nth-child(1) { - stroke: #0b0f15; + stroke: #fff; animation-delay: -1s; } From dc8649e4ee79f313cbc1edfeb4d628ae8fb6a3a0 Mon Sep 17 00:00:00 2001 From: YuePeng Date: Thu, 4 Dec 2025 18:30:21 +0800 Subject: [PATCH 2/3] default lang en --- README-EN.md | 221 --------------------------------------------------- README-zh.md | 196 +++++++++++++++++++++++++++++++++++++++++++++ README.md | 82 +++++++++---------- 3 files changed, 234 insertions(+), 265 deletions(-) delete mode 100644 README-EN.md create mode 100644 README-zh.md diff --git a/README-EN.md b/README-EN.md deleted file mode 100644 index d11f098f5..000000000 --- a/README-EN.md +++ /dev/null @@ -1,221 +0,0 @@ -[中文](./README.md)   |   English - -

logo

- -

ERUPT   🚀   An Efficient Low-Code Engine for Developers

- -

Low-Code + AI, Making Development Easier

-

https://www.erupt.xyz

- ---- - -

- maven-central - license Apache 2.0 - GitHub stars - GitHub forks - gitcode - Gitee star - Gitee fork -

- -

- GitHub Repo   |   - GitCode Repo   |   - Gitee Repo   |   - Official Website   |   - Live Demo   |   - Module Ecosystem   |   - 📕 Documentation -

- ---- - -> A revolutionary low-code development framework designed to boost enterprise-level backend development efficiency, significantly reducing development costs and complexity. -> -> More than just a tool, it is a strategic choice for optimizing development processes, enhancing team productivity, and accelerating digital transformation. -> -> Erupt delivers efficiency, flexibility, and control—dramatically shortening development cycles and allowing you to focus on core business. - ---- - -## 🚀 Introduction | Intro - -**Erupt** is a universal low-code framework driven by Java annotations that dynamically renders and constructs pages and APIs. - -Zero front-end code, zero CURD, and automatic table creation — only one class file with annotation configuration is required to quickly develop enterprise-grade data management backends. - -Highly extensible, supporting CURD customization via `@DataProxy`, custom data sources, soft delete, LDAP, OSS, and more. - -## 🎯 Low-Code Engine | Engine - -#### Transparent Mechanics & High Configurability: - -* **Annotation-driven, flexible configuration:** Control model behavior, UI rendering, data validation, and processing through annotations like `@Erupt`, `@EruptField`, and their rich properties. -* **Open architecture:** Erupt’s modular core encourages developers to understand its internal mechanisms and adjust them as needed. -* **Detailed logs and debugging support:** Helps developers track issues and understand internal execution flows. - -#### Beyond Traditional Code Generators: - -* **Runtime interpretation over static generation:** Erupt dynamically constructs applications through annotation parsing, avoiding bloated, hard-to-maintain generated code. -* **Model-focused development:** Developers only need to define business models and annotations — Erupt handles UI rendering, data binding, API calls, and database interactions automatically. - -#### Deep Customization and Extensibility: - -* **Lifecycle hooks:** Key lifecycle points expose hooks for extending and adjusting behavior. -* **`@DataProxy` interface:** Inject custom logic during data operations (e.g., before add, after edit, on query) for validations, transformations, permission control, etc. -* **Custom components and views:** Easily integrate personalized front-end components or templates beyond built-in options. -* **Custom data sources and dialects:** Extend support for specific databases or create your own SQL dialect adapters. - -#### Embracing the Spring Boot Ecosystem: - -* **Non-intrusive design:** Built on Spring Boot with deep Spring Data JPA integration without interfering with other Spring or third-party libraries. -* **Standard JPA entities:** Erupt entity classes are standard JPA entities, reusable across other services or modules. -* **Easy to integrate into existing projects:** Erupt Cloud can be progressively integrated to enhance or replace backend modules in existing Spring Boot projects. - -> Since 2020, Erupt has been continuously optimized and upgraded. It's already used by hundreds of companies and thousands of developers. Hundreds have contributed feature suggestions and code. - -## 🥏 Beyond Code Generators - -While code generators improve efficiency, they produce large volumes of template code that are difficult to maintain and prone to technical debt once modified. - -Erupt offers a more elegant solution: - -* **Elevating configuration to code:** Erupt doesn’t generate code; it dynamically interprets annotations. Business logic is decoupled from core framework behavior — changing an annotation instantly updates system behavior. -* **Higher abstraction:** Erupt abstracts common backend features into standardized annotations and components. Developers focus solely on business model definitions. -* **Ongoing evolution and maintenance:** As a mature open-source framework, the Erupt team and community continuously enhance features and fix issues. You benefit from framework updates without maintaining generated code. - -![result](readme/view.png) -![result](readme/edit.png) - -```java -@Erupt( - name = "Simple Example", - power = @Power(importable = true, export = true) -) -@Table(name = "t_simple") // Database table name -@Entity -public class Simple extends BaseModel { - - @EruptField( - views = @View(title = "Text"), - edit = @Edit(title = "Text", notNull = true, search = @Search) - ) - private String input; - - @EruptField( - views = @View(title = "Number", sortable = true), - edit = @Edit(title = "Number", search = @Search) - ) - private Float number; - - @EruptField( - views = @View(title = "Boolean"), - edit = @Edit(title = "Boolean", search = @Search) - ) - private Boolean bool; - - @EruptField( - views = @View(title = "Date"), - edit = @Edit(title = "Date", search = @Search(vague = true)) - ) - private Date date; - - @EruptField( - views = @View(title = "Slider"), - edit = @Edit(title = "Slider", type = EditType.SLIDER, search = @Search, - sliderType = @SliderType(max = 90, markPoints = {0, 30, 60, 90}, dots = true)) - ) - private Integer slide; - - @EruptField( - views = @View(title = "Dropdown"), - edit = @Edit( - search = @Search, - title = "Dropdown", type = EditType.CHOICE, - choiceType = @ChoiceType(fetchHandler = SqlChoiceFetchHandler.class, - fetchHandlerParams = "select id,name from e_upms_menu" - ) - ) - ) - private Long choice; -} -``` - -[Feature Demo](https://www.erupt.xyz/#!/contrast) - -## ⛰ Screenshots - - - - - -## 🔗 Download and Usage - -No need to compile source code. Just add the following dependencies to your Spring Boot project: - -```xml - - - xyz.erupt - erupt-admin - LATEST-VERSION - - - - xyz.erupt - erupt-web - LATEST-VERSION - -``` - -> Latest version: maven-central - -[Detailed Installation Guide](https://www.yuque.com/erupts/erupt/tpq1l9) - -## 🌕 Live Demo - -Demo: [https://www.erupt.xyz/demo](https://www.erupt.xyz/demo) -Account/Password: `guest / guest` - -**Supports modern browsers and runs on Electron or other Web standard-based environments** - -## 🔭 Recommended Projects - -* [`Linq.J` – Object Query Language for JVM](https://github.com/erupts/Linq.J) -* [`magic-api` – Rapid API Development Framework](https://github.com/ssssssss-team/magic-api) -* [`Jpom` – Lightweight Online Build/Deploy/Monitoring Tool](https://gitee.com/dromara/Jpom) - -## 🧩 Join the Community - -QQ Group: 836044286 🔥 - -WeChat Group: Follow the **EruptGuide** public account to get the latest group QR code (updated weekly) - -**ERUPT — Empower Java Developers to Build Backends More Efficiently and Flexibly. Join Us to Explore the Future of Low-Code in Professional Development!** - -## ⛽️ Donate - -The author personally covers the costs of servers, domains, hosting, and maintenance. -Open source is not easy — a cup of coffee is appreciated 🙏 - -[Donate Here](https://www.yuque.com/erupts/erupt/mwf15h) - ---- - -### ⭐️ Licensed under Apache License 2.0 — Open Source and Free to Use. If You Like It, Please ⭐ Star the Project to Show Support! - ---- - -

- Official Website   |   - GITHUB   |   - Documentation -

- ---- - -

-Author: YuePeng   /   erupts@126.com -

-
diff --git a/README-zh.md b/README-zh.md new file mode 100644 index 000000000..03893e6e6 --- /dev/null +++ b/README-zh.md @@ -0,0 +1,196 @@ +中文   |   [English](README-zh.md) + +

logo

+ +

ERUPT   🚀   Low-code

+ +

注解驱动开发，零前端代码，零 CURD，自动建表，实现多维数据管理

+

https://www.erupt.xyz

+ +--- + +

+ maven-central + license Apache 2.0 + GitHub stars + GitHub forks + gitcode + Gitee star + Gitee fork +

+ +

+ GitHub   |   + GitCode   |   + Gitee   |   + 官方网站   |   + 框架生态   |   + 在线体验   |   + 📕 使用文档 +

+ +erupt + +--- + +## 🚀 低代码开发 +> @Erupt 注解可实现全场景开箱即用 + +- 可视化：表 / 树 / 甘特图 / 卡片 + 20+表单组件 +- 数据：全库兼容、API 数据源、自动建表/索引、LambdaQuery 多表查询、动态CURD +- API：OpenAPI 一键暴露、行列权限控制 +- 权限：UPMS / 类 / 行列 / 角色多维管控 +- 扩展：i18n、Cloud 集群、审计 & 事件日志、BI、SaaS、AI 大模型 +- Form 复用：Flow 流程、自定义节点、自定义按钮 + +## 快速开始 + +#### Annotation Example + +```java + +@Erupt( + name = "Simple", + power = @Power(importable = true, export = true), + @RowOperation( + title = "Custom Action", + mode = RowOperation.Mode.SINGLE, + operationHandler = OperationHandlerImpl.class + ) +) +@Table(name = "t_simple") //DB Table name +@Entity +public class Simple extends BaseModel { + + @EruptField( + views = @View(title = "Text"), + edit = @Edit(title = "Text", notNull = true, search = @Search) + ) + private String input; + + @EruptField( + views = @View(title = "Date"), + edit = @Edit(title = "Date", search = @Search(vague = true)) + ) + private Date date; + + @EruptField( + views = @View(title = "Slider"), + edit = @Edit(title = "Slider", type = EditType.SLIDER, search = @Search, + sliderType = @SliderType(max = 90, markPoints = {0, 30, 60, 90}, dots = true)) + ) + private Integer slide; + + @EruptField( + views = @View(title = "Choice Select"), + edit = @Edit( + search = @Search, + title = "Choice Select", type = EditType.CHOICE, + choiceType = @ChoiceType(fetchHandler = SqlChoiceFetchHandler.class, + fetchHandlerParams = "select id,name from e_upms_menu" + ) + ) + ) + private Long choice; + +} +``` + +#### JPA LambdaQuery + +```java +public void select() { + List list = eruptDao.lambdaQuery(EruptUser.class) + .like(EruptUser::getName, "e") + .isNull(EruptUser::getWhiteIp) + .in(EruptUser::getId, 1, 2, 3, 4) + .ge(EruptUser::getCreateTime, "2023-01-01") + .list(); +} +``` + +[功能体验](https://www.erupt.xyz/#!/contrast) + +## ⛰ 演示截图 + + + + + + + + + + + + + + + + + +
+ +## 🔗 下载使用 + +无需编译源代码，Spring Boot项目添加如下依赖即可 + +```xml + + + xyz.erupt + erupt-admin + ${LATEST-VERSION} + + + +xyz.erupt +erupt-web +${LATEST-VERSION} + +``` + +> 最新版本 +> +> maven-central + +[详细使用步骤](https://www.yuque.com/erupts/erupt/tpq1l9) + +## 🌕 在线体验 + +演示地址：[https://www.erupt.xyz/demo](https://www.erupt.xyz/demo) + +账号密码：`guest / guest` + +**支持主流现代浏览器，可直接运行在 Electron 等基于 Web 标准的环境上** + +## 🔭 开源推荐 + +[`Linq.J`：基于JVM的对象查询语言](https://github.com/erupts/Linq.J) + +[`magic-api`：接口快速开发框架](https://github.com/ssssssss-team/magic-api) + +[`Jpom`：简而轻的低侵入式在线构建、自动部署、日常运维、项目监控软件](https://gitee.com/dromara/Jpom) + +## 🤝 参与贡献 + +Erupt 是一个免费且开源的项目。我们欢迎任何人为 Erupt 做出贡献，以帮助改善 Erupt。包括但不限于：提交代码、反馈缺陷、交流想法，或分享你基于 +Erupt 的使用案例。同时，我们也欢迎用户在个人博客或社交媒体上分享 Erupt。 + +如果你想要贡献代码，请先阅读我们的[贡献指南](./CONTRIBUTING.md)。 + +请在 https://github.com/erupts/erupt 提交 [Issues](https://github.com/erupts/erupt/issues) +和 [Pull Requests](https://github.com/erupts/erupt/pulls)。 + +#### 感谢以下贡献者对 Erupt 做出的贡献： + +[![Contributors](https://contrib.rocks/image?repo=erupts/erupt)](https://github.com/erupts/erupt/graphs/contributors) + +

⭐️ 使用 Apache License 2.0 协议，源代码开源免费。开源不易，喜欢请给作者 Star 鼓励

+ +--- + +

+作者 ：YuePeng   /   erupts@126.com +

+
diff --git a/README.md b/README.md index ea4951054..56cf55940 100644 --- a/README.md +++ b/README.md @@ -1,10 +1,10 @@ -中文   |   [English](./README-EN.md) +English   |   [中文](README-zh.md)

logo

ERUPT   🚀   Low-code

-

注解驱动开发，零前端代码，零 CURD，自动建表，实现多维数据管理

+

Annotation-driven development, zero front-end code, zero CRUD, automatic table creation, multi-dimensional data management

https://www.erupt.xyz

--- @@ -23,32 +23,31 @@ GitHub   |   GitCode   |   Gitee   |   - 官方网站   |   - 框架生态   |   - 在线体验   |   - 📕 使用文档 + Official Website   |   + Framework Ecosystem   |   + Online Demo   |   + 📕 Documentation

erupt --- -## 🚀 低代码开发 -> @Erupt 注解可实现全场景开箱即用 +## 🚀 Low-code Development +> @Erupt annotation enables out-of-the-box functionality in all scenarios -- 可视化：表 / 树 / 甘特图 / 卡片 + 20+表单组件 -- 数据：全库兼容、API 数据源、自动建表/索引、LambdaQuery 多表查询、动态CURD -- API：OpenAPI 一键暴露、行列权限控制 -- 权限：UPMS / 类 / 行列 / 角色多维管控 -- 扩展：i18n、Cloud 集群、审计 & 事件日志、BI、SaaS、AI 大模型 -- Form 复用：Flow 流程、自定义节点、自定义按钮 +- Visualization: Tables / Trees / Gantt Charts / Cards + 20+ form components +- Data: Full database compatibility, API data sources, automatic table/index creation, LambdaQuery multi-table queries, dynamic CRUD +- API: One-click OpenAPI exposure, row/column permission control +- Permissions: UPMS / Class / Row/Column / Role multi-dimensional management +- Extensions: i18n, Cloud clustering, audit & event logs, BI, SaaS, AI large models +- Form Reusability: Flow processes, custom nodes, custom buttons -## 快速开始 +## Quick Start #### Annotation Example ```java - @Erupt( name = "Simple", power = @Power(importable = true, export = true), @@ -109,9 +108,9 @@ public void select() { } ``` -[功能体验](https://www.erupt.xyz/#!/contrast) +[Feature Demo](https://www.erupt.xyz/#!/contrast) -## ⛰ 演示截图 +## ⛰ Demo Screenshots @@ -129,23 +128,20 @@ public void select() { - - -
Mobile View
-## 🔗 下载使用 +## 🔗 Download and Use -无需编译源代码，Spring Boot项目添加如下依赖即可 +No need to compile source code. Simply add the following dependencies to your Spring Boot project: ```xml - + xyz.erupt erupt-admin ${LATEST-VERSION} - + xyz.erupt erupt-web @@ -153,47 +149,45 @@ public void select() { ``` -> 最新版本 +> Latest Version > > maven-central -[详细使用步骤](https://www.yuque.com/erupts/erupt/tpq1l9) +[Detailed Usage Steps](https://www.yuque.com/erupts/erupt/tpq1l9) -## 🌕 在线体验 +## 🌕 Online Demo -演示地址：[https://www.erupt.xyz/demo](https://www.erupt.xyz/demo) +Demo URL: [https://www.erupt.xyz/demo](https://www.erupt.xyz/demo) -账号密码：`guest / guest` +Username/Password: `guest / guest` -**支持主流现代浏览器，可直接运行在 Electron 等基于 Web 标准的环境上** +**Supports mainstream modern browsers and can run directly on Electron and other web-standard-based environments** -## 🔭 开源推荐 +## 🔭 Open Source Recommendations -[`Linq.J`：基于JVM的对象查询语言](https://github.com/erupts/Linq.J) +[`Linq.J`: Object query language based on JVM](https://github.com/erupts/Linq.J) -[`magic-api`：接口快速开发框架](https://github.com/ssssssss-team/magic-api) +[`magic-api`: Rapid interface development framework](https://github.com/ssssssss-team/magic-api) -[`Jpom`：简而轻的低侵入式在线构建、自动部署、日常运维、项目监控软件](https://gitee.com/dromara/Jpom) +[`Jpom`: Lightweight low-invasive online build, automatic deployment, daily operations and maintenance, project monitoring software](https://gitee.com/dromara/Jpom) -## 🤝 参与贡献 +## 🤝 Contributing -Erupt 是一个免费且开源的项目。我们欢迎任何人为 Erupt 做出贡献，以帮助改善 Erupt。包括但不限于：提交代码、反馈缺陷、交流想法，或分享你基于 -Erupt 的使用案例。同时，我们也欢迎用户在个人博客或社交媒体上分享 Erupt。 +Erupt is a free and open-source project. We welcome anyone to contribute to Erupt to help improve it. This includes but is not limited to: submitting code, reporting bugs, sharing ideas, or sharing your use cases based on Erupt. We also welcome users to share Erupt on personal blogs or social media. -如果你想要贡献代码，请先阅读我们的[贡献指南](./CONTRIBUTING.md)。 +If you want to contribute code, please read our [Contribution Guidelines](./CONTRIBUTING.md) first. -请在 https://github.com/erupts/erupt 提交 [Issues](https://github.com/erupts/erupt/issues) -和 [Pull Requests](https://github.com/erupts/erupt/pulls)。 +Please submit [Issues](https://github.com/erupts/erupt/issues) and [Pull Requests](https://github.com/erupts/erupt/pulls) at https://github.com/erupts/erupt. -#### 感谢以下贡献者对 Erupt 做出的贡献： +#### Thanks to the following contributors for their contributions to Erupt: [![Contributors](https://contrib.rocks/image?repo=erupts/erupt)](https://github.com/erupts/erupt/graphs/contributors) -

⭐️ 使用 Apache License 2.0 协议，源代码开源免费。开源不易，喜欢请给作者 Star 鼓励

+

⭐️ Licensed under Apache License 2.0, source code is free and open source. Open source is not easy, please give the author a Star if you like it

---

-作者 ：YuePeng   /   erupts@126.com +Author: YuePeng   /   erupts@126.com


From 1f71afa3a00159f528faa7f5b73785d35e03c86d Mon Sep 17 00:00:00 2001 From: YuePeng Date: Thu, 4 Dec 2025 18:34:11 +0800 Subject: [PATCH 3/3] default lang en --- README-zh.md | 2 +- README.md | 14 +++++++------- 2 files changed, 8 insertions(+), 8 deletions(-) diff --git a/README-zh.md b/README-zh.md index 03893e6e6..06cefc7b5 100644 --- a/README-zh.md +++ b/README-zh.md @@ -1,4 +1,4 @@ -中文   |   [English](README-zh.md) +中文   |   [English](README.md)

logo

diff --git a/README.md b/README.md index 56cf55940..38d37e99e 100644 --- a/README.md +++ b/README.md @@ -4,7 +4,7 @@ English   |   [中文](README-zh.md)

ERUPT   🚀   Low-code

-

Annotation-driven development, zero front-end code, zero CRUD, automatic table creation, multi-dimensional data management

+

Annotation-driven development, zero front-end code, zero CRUD, multi-dimensional data management

https://www.erupt.xyz

--- @@ -24,9 +24,9 @@ English   |   [中文](README-zh.md) GitCode   |   Gitee   |   Official Website   |   - Framework Ecosystem   |   + Ecosystem   |   Online Demo   |   - 📕 Documentation + Documentation

erupt @@ -141,11 +141,11 @@ No need to compile source code. Simply add the following dependencies to your Sp erupt-admin ${LATEST-VERSION} - + -xyz.erupt -erupt-web -${LATEST-VERSION} + xyz.erupt + erupt-web + ${LATEST-VERSION} ```