Architecture

Architecture at a Glance

From any data source to any UI, every layer is pluggable. Click any capability to jump to its docs:

ARCHITECTURE AT A GLANCE

Any data source, to any UI. Every layer is pluggable.

Nine layers from entry points to runtime: any data source at the bottom, DataProxy intercepting anything in the middle with security spanning the whole chain, AI embedded as a kernel capability, views and components generated from annotations, topped by a modern UI that works out of the box.

⚡Fast startupBoots in 2s ~ 5s🍃Spring Boot native3.x · JDK 17+🤖AI Native19 LLM · MCP📦Lightweight0.8 MB gzip first screen🧩Extensible everywhereComponents · pages · annotations · plugins🔑Flexible loginCaptcha · QR · LDAP / SSO🔓Truly open sourceApache-2.0🔁Steady iterationSince 2019 · 60+ releases

L9Access LayerHumans, systems and AI: three entry points, one backend

HumansBrowser and mobile

Web browserMobile responsiveMicro-frontend embeddingFrontend / backend separationCustom login page12 languages

SystemsAPIs and messaging

REST APIsOpen API appid + secretMagic-API online APIsWebSocket real-time pushNotification channels: email / in-appExcel import / export

AIDirect access for models and agents

MCP Server → Cursor / Claude CodeA2A agent interopAI Claw: chat with your dataAI Staff channel pusherupt-skill Claude skills

↕ serve

L8UI LayerAngular frontend · zero frontend code

Appearance

3 skins: Default / Brutalist / Liquid GlassLight / Dark / System16 theme colors + custom pickerCompact mode1,992 iconsColor-weak / grayscale mode

Navigation

Menu: single / split / double columnMulti-tab pagesBreadcrumbMenu searchResizable sidebar / tree panelHelp entry

Interaction

Draggable modalsBackend-triggered messages / modalsNotification centerFull-screen watermarkFull-screen mode

Devices & access

Mobile responsive12 languagesRTL layoutCustom login pageMicro-frontend containerFrontend / backend separation

↕ render

L7View LayerOne model · many views · switch at the top

View types

TableTreeTree + TableBoardCalendarCardGanttDrill-down

Table features

Cell editingDrag sortCustom row operationsColumn show / pin / reorderMulti-field sortSwitchable search operatorsSummary rowsAuto refreshCopy rowPer-model remembered prefs

Forms

Step formFormViewDetail drawerField linkage OnChangeConditional render @IfRender

Output & pages

Excel import / exportPrint layoutsSQL reports & chartsTPL custom pagesAI Canvas one-line pages

↕ compose

L6Component Layer35 edit components · switch by changing one enum

Basic

AUTOINPUTPASSWORDTEXTAREANUMBERSLIDERDATEBOOLEANMAPCOLORRATE

Selection

CHOICEMULTI_CHOICETAGSAUTO_COMPLETE

Media & editors

ATTACHMENTHTML_EDITORCODE_EDITORMARKDOWNSIGNATURE

Relations

REFERENCE_TABLEREFERENCE_TREECHECKBOXTAB_TREETAB_TABLE_REFERTAB_TABLE_ADDMULTI_FORMCOMBINE

Layout & misc

GROUPDIVIDECALLOUTBUTTONTPLHIDDENEMPTY@View 20+ cell renderersCustom upload OSS / local

↕ annotation-driven · auto-generated

L5Model LayerAnnotation-driven · one Java class declares it all

Class-level

@Erupt@Power@RowOperation@Drill@Filter@OrderBy@Tree@LinkTree@Layout@DragSort@Vis@FormSteps@Tpl

Field-level

@EruptField@View@Edit@Search@Dynamic@IfRender@OnChange

Entry & extension

@EruptScanExtend annotationsVirtual fieldsSoft deleteHot build, no restartSaaS multi-tenant PRO

Modeling tools

Designer: drag-and-drop modeling at runtimeGenerator: code generationAtlas: model graph / lineageEZDML modeling

↕ schema as tools · annotations as prompts

L4Intelligence LayerAI as a kernel capability: models are tools, annotations are prompts

Models & knowledge

19 LLM adaptersEmbedding modelsVector storesRAG / Agentic RAGMultimodal image inputThinking mode

Agents & tools

Expert agentsAI Roles@AiToolbox / @Tool registrationEruptModelTools model CRUD@Power(ai) per-model switchAI call audit

Open protocols

MCP ServerA2AOpenAI-compatible endpoints

AI apps

AI writing assistant @Edit(prompt)AI Canvas one-line pagesAI Claw: chat with your dataAI Staff digital workersMermaid / math / code rendering

↕ tool calls · authorization · audit

L3Proxy & SecurityDataProxy intercepts anything · security spans the chain

DataProxyHooks across the whole CRUD lifecycle

validatebeforeAdd / afterAddbeforeUpdate / afterUpdatebeforeDelete / afterDeletebeforeFetch condition injectionafterFetch result shapingsearchCondition defaultsaddBehavior / editBehavioralert page noticeextraContent custom HTMLextraRow summary rowsexcelImport / excelExportprint contentformViewBehavior / formSave@PreDataProxy inheritancePostDataProxy global interceptEvent listenersEruptDao / LambdaQueryCustom REST APIsMagic-API online APIs

Security & PermissionsUPMS built in, from login to every button

User / Role / Menu / Org / Post / Dict@Power add / delete / edit / query / detailsImport / export / print / copy togglesCell-edit & AI dual togglesPowerHandler dynamic permissionsButton & API permission stringsRow-level data permission via beforeFetchCustom login via LoginProxyToken validationCaptcha / IP whitelistSalted SHA-512 password storageWeChat QR / third-party token loginLDAP / SSO integrationLogin log / operation logOpen API appid + secretMCP Bearer authAI call auditWatermark against screenshotsTenant data isolation PRO

↕ unified read / write

L2Data Source LayerAny data source · unified modeling · customizable

Relational

MySQLPostgreSQLOracleSQL ServerH2JDBC single table

NoSQL & search

MongoDBElasticsearchRedisIn-memory

Files & APIs

Files CSV / JSONL / TSV / INIHTTP REST APIS3 object storage

Platforms & directories

KubernetesLDAPFeishu BitableNotion

Extension

Multiple data sourcesCustom data sourceEruptDao / LambdaQuery

↕ deploy · dispatch · monitor

L1Runtime & Ops LayerA standard Spring Boot project, from single node to distributed

Runtime

Spring Boot 3.xJDK 17+Integrate into existing projectsMultiple data sourcesConfigurationHot build

Deployment

Single Jar deploymentFrontend / backend separationDocker deploymentRedis SessionUpgrade guide

Distributed

erupt-cloud distributed config centerCloud Server registration & dispatchCloud Node micro-nodesJob scheduler, cluster-deduplicated

Ops & monitoring

Monitor: service / diagnostics / cacheErupt class registryTerminal in the browserRemote VNC / SSHLogin log / operation logAnonymous telemetry, opt-out

Modules45 official and community modules, opt-in, versioned with the core

AI 6

AI HarnessAI ClawAI CanvasAI RAGAI StaffAI Skills ↗

Core 4

UpmsTplWebDesigner

Data 13

JpaMongoDBJdbcHttpEsRedisMemoryFileK8sLdapFeishuNotionS3

Tools 14

TerminalRemoteAtlasWebSocketGeneratorJobNoticeMonitorMagic-APIPrintReportCloudCloud ServerCloud Node

PRO 3

Flow engineTenant multi-tenancyCube metrics

Community 5

DslPf4jEZDMLMP CrawlerVote

Browse all modules →

---

Class Capabilities

Feature Map

Functional Architecture

---

Layered Architecture

Erupt follows a modular layered design — each layer has clear responsibilities and can be pulled in on demand.

Request Lifecycle

The full pipeline of a CRUD request inside the framework:

DataProxy Lifecycle

DataProxy is Erupt's Service layer and exposes lifecycle hooks for every CRUD action:

Annotation-Driven Pipeline

How a Java class turns into a complete admin page:

Module Dependencies

Distributed Architecture (erupt-cloud)

Contributors

YuePeng

Claude Opus 5 (1M context)

Changelog

Last edited 2 minutes ago

View full history

f3752b9-filter: add a role-based row-level data filtering example