Skip to content

Changelog โ€‹

2.4.0 (2026-11-01) Spring Boot 3.5.16 โ€‹

Before you upgrade

Read the V 2.4.0 Upgrade Guide: export is on by default, choice values and declared form limits are now enforced on the server, erupt.init-method-enum is replaced by erupt.init-modules-menu, deployments behind a reverse proxy need erupt.upms.trusted-proxies, the user / role / org / post tables gain a tenant_id column, erupt-cloud nodes must be upgraded together, and there are database changes.

๐Ÿฆž Open-sourced erupt-share: a signed-in user issues a link to a form or to any menu page they hold, so visitors without an account can fill the form or read a report / dashboard / canvas; links expire, cap visits, may ask a password and can be switched off; the visitor's session holds only what the target needs and every other endpoint answers 403

๐Ÿฆž Open-sourced erupt-webhook: subscribe to the add / update / delete events of chosen models; each committed change is POSTed as JSON to an external URL, HMAC-SHA256 signed, with custom headers, three attempts, a log row per delivery and one-click resend

๐Ÿฆž Open-sourced erupt-config: key/value settings layered by Spring profile and served as a property source to @Value / Environment / @ConfigurationProperties; a save applies without a restart and other instances refresh over Redis; 17 item types, secrets masked

๐Ÿฆž Open-sourced erupt-revision: every add / update / cell edit / delete leaves a field-level revision; the record panel shows the history and rolls an update back; the revision table doubles as a recycle bin that restores deleted records; @Power(revision = false) opts a model out

๐Ÿฆž Open-sourced erupt-file-center: a Finder-style file center over the upload directory, local folders, S3 buckets and SFTP directories with inline preview of images, video, audio, PDF and text; upload, new folder, rename and delete are granted by a separate Write button

๐Ÿฆž Open-sourced erupt-ai-dev: projects span several git repositories; an approved requirement from the pool is developed in its own workspace by a coding CLI installed on the server (Claude Code, Codex, OpenCode, Kimi Code, Cursor CLI, Qwen Code or any CLI), progress and QA verdicts come back over MCP, and a human accepts before a rebase-and-push; ships with the new erupt-git support module

๐Ÿฆž Open-sourced erupt-cloud-node-lite: declare models with erupt's annotations in plain Java / Kotlin, Solon, Quarkus, Micronaut, Vert.x, Ktor or any servlet container, while the erupt server renders the UI and checks access

๐Ÿฆž Open-sourced erupt-sdk: services written in Python, Go, TypeScript, PHP, .NET, Rust, Ruby or Swift run as erupt-cloud nodes and turn their models into admin pages; each SDK has zero dependencies or the standard library only, is generated from the same node protocol and annotation JSON Schema, and passes the same conformance suite

๐Ÿฆž Open-sourced erupt-k8s-dashboard, a ready-made Kubernetes admin: add the dependency and get Pod, Deployment, StatefulSet, DaemonSet, Service, ConfigMap, Event, Namespace and Node pages with logs, web terminal, scale, restart and YAML editing, switched per cluster and namespace (see erupt-data-k8s)

๐ŸŒŸ SAML 2.0 single sign-on: erupt-sso supports SAML next to OAuth2 (SAML, ADFS and Microsoft Entra ID presets), exports SP metadata for the IdP and verifies with the JDK's XML-DSig API only; tenants can configure providers of their own

๐ŸŒŸ @EruptScope global context: pick a cluster, project or company once in the page header and every model declaring that scope filters by it and prefills it on add; picks are checked against the user's options on every request, so editing the header cannot step outside them

๐ŸŒŸ Multi-tenant upms tables: users, roles, orgs and posts, plus the login log, operation log, comment and revision tables, carry a Hibernate @TenantId column, so tenant users share the platform's tables without seeing each other and accounts and codes are unique per tenant; erupt-tenant drops its own user tables and erupt-flow keeps definitions and instances per tenant

๐ŸŒŸ Three new @Vis views: TIMELINE, MAP (AMap, Baidu, Tencent, Tianditu, Google or OSM, converting coordinate systems per vendor) and CUBE (a grid of erupt-cube charts inside the model page, filtered by the list's search)

๐ŸŒŸ Board swimlanes swimlaneField, column sums sumField and WIP limits; calendar mode (month / week / year) and drag-to-reschedule; gantt dependencies dependencyField and milestones milestoneField; grouped tables @TableView(groupField) with collapsible groups and subtotals

๐ŸŒŸ Column statistics @View(statistic = SUM | AVG | COUNT | ...): totals over every row the list query matches, not the page; native aggregates on JPA / JDBC / Mongo, an in-memory fallback for computed columns

๐ŸŒŸ Batch edit: a toolbar button sets one field on all selected rows; every row runs the full cell-edit pipeline and the batch rolls back if one is rejected; @Power(batchEdit = false) turns it off

๐ŸŒŸ Export formats: Excel, CSV, JSON, JSON Lines or Markdown from the export button, more through a TableCodec bean; an Excel export now imports back as it is

๐ŸŒŸ Components inferred from the Java type: an @Erupt field becomes a reference table / tree, Collection<@Erupt> a sub-table, Collection<Enum> a multi-select, Map a key/value editor, and an enum field a dropdown of its constants; DateType.Type.AUTO follows LocalDate / LocalDateTime / LocalTime

๐ŸŒŸ Declared limits enforced on the server: INPUT length, NUMBER / SLIDER ranges, RATE bounds, TAGS count and allowed values, DATE FUTURE / HISTORY and ranges, and every sub-table row's rules apply to API calls too; erupt.choice-validate is on by default, so CHOICE / MULTI_CHOICE values must be among the user's options

๐ŸŒŸ Module center: System Management lists installed modules by group with their docs and switches a module's menus off; the sidebar shows section titles per module group and root menus are re-sorted by purpose; module menus reconcile by fingerprint, so new menus and buttons arrive on upgrade while admin edits are kept, without .erupt/*.loaded marker files

๐ŸŒŸ The erupt-cloud server does the work for its nodes: power and payload checks, HMAC request signing, references, Excel, uploads, static options, cell / batch edit, drag sort and board / calendar / gantt writes, shrinking the node protocol to nine endpoints; nodes registering invoke take options, onchange, buttons and row operations through /erupt-api/invoke

๐ŸŒŸ Material and Terminal skins: a Material 3 / Google Workspace shell and a phosphor console; the lock screen can switch theme, skin and color

๐ŸŒŸ Built-in print: label position, columns, border, font size, title, paper and margins set before printing; one-to-many, many-to-many and multi-form fields print as tables, and printing through a hidden iframe reflows to the paper

๐ŸŒŸ erupt-cube cubes in YAML / JSON files: one cube per cube/**/*.yml|json file, joinable with annotated cubes, with a JSON Schema for IDE completion

๐ŸŒŸ erupt-tenant subscription lifecycle: packages carry trial days, the status (active / grace / expired) is derived from the expire date, sessions of an expired or locked tenant end on their next request, and TenantSubscriptionService#extend hooks your own billing; the tenant login page offers the tenant's own SSO providers

๐ŸŒŸ erupt-data-http adapter hooks: EruptHttpAdapter covers every stage of a request, templates take ${} properties and #{} SpEL with the current user and beans, and three paging styles plus envelope unwrapping are built in

๐ŸŒŸ OpenAPI 3.1 spec: openapi/erupt.json, generated from controller Javadoc, covers every core, upms, tpl and excel endpoint

๐ŸŒŸ The home page gains an account security tile (password age, MFA state) and an AI prompt box; the MCP endpoint takes module-level grants through McpAuthenticator, typed tool schemas from langchain4j, and runs calls made for a user in that user's tenant and rights

๐Ÿงฉ @Power(export) is on by default and, like add / edit / delete, decided by the role's menu buttons; @View(export = false) keeps a column out; importable stays opt-in

๐Ÿงฉ @ReferenceTreeType(leafOnly = true) lets only leaf nodes be picked, thanks to chenxiaolong8023 for the contribution

๐Ÿงฉ Masonry layout for the card view: @CardView(layout = CardView.Layout.MASONRY) keeps each cover's own aspect ratio and packs cards into staggered columns

๐Ÿงฉ EditType.MAP fields can hold a typed Location (coordinates, name, address, coordinate system); a String field switches without a migration

๐ŸŒŸ Map vendors: EditType.MAP fields and the MAP view share eruptSiteConfig.map and run on AMap, Baidu, Tencent, Tianditu, Google or OpenStreetMap (no key needed); the frontend converts coordinates by Location.crs, so switching vendors needs no data migration

๐Ÿงฉ spring.jpa.open-in-view: false supported: findDataById initializes collection fields inside the lookup, so detail, print, templates and record history no longer rely on open-in-view keeping the EntityManager open; @EruptDataSource models included

๐Ÿงฉ erupt-data-s3: a typed S3ObjectModel base class, @EruptS3 attributes left empty fall back to erupt.s3.*, and checksums are computed only where required on custom endpoints for MinIO / OSS and other S3-compatible stores

๐Ÿงฉ X-Forwarded-For is believed only from a trusted proxy (erupt.upms.trusted-proxies, loopback and private ranges by default), so a forged header no longer bypasses the login lock or the IP whitelist

๐Ÿงฉ Performance: DataProxy chains cached per model, @Match SpEL cached, deterministic LambdaQuery placeholders that hit Hibernate's query cache, one count query to check row access for a batch, lazy EruptRole.users, and modules reference users through the slim EruptUserVo

๐Ÿงฉ Builds on JDK 27; dependency updates include gson 2.14, guava 33.7, commons-lang3 3.21, POI 5.5.1, AWS SDK 2.55, ShedLock 7.10 and JSch 2.28.7; the Requesty and OrcaRouter LLM adapters are removed; erupt-ai-decision drops its HTTP endpoints (the Java API is unchanged)

๐Ÿงฉ Copy buttons work on plain http; theme.menuGroups hides the sidebar section titles; the erupt-start scaffold lists the 2.4.0 modules

๐Ÿž Fixed formula fields breaking column comments, thanks to AryanGupta833 for the contribution

๐Ÿž erupt-flow fixes: gateway conditions on multi-choice, tags and many-to-many fields never matching; an unreadable flush error when a reviewer resolves to nobody; an NPE for instances without a form row; standalone approval details missing task context, hiding urge and withdraw

Database Changes โ€‹

Show schema changes and SQL (MySQL syntax; convert for other databases)

Schema changes are applied by JPA / Hibernate at startup. Run them by hand only when automatic DDL is disabled (spring.jpa.hibernate.ddl-auto=none or validate).

This release touches:

  • e_upms_user, e_upms_role, e_upms_org, e_upms_post gain tenant_id; the account / code unique constraint becomes tenant + account / code
  • e_upms_login_log, e_upms_operate_log gain tenant_id
  • e_upms_sso gains tenant_id and idp_certificate, e_upms_sso_bind gains tenant_id (with erupt-sso)
  • e_record_comment gains tenant_id (with erupt-comment)
  • e_flow, e_flow_group, e_flow_instance gain tenant_id (with erupt-flow)
  • e_tenant_package gains trial_days (with erupt-tenant); the tenant-side user / role / org tables are no longer used, see the upgrade guide

Tables of new modules are created by Hibernate, no manual step:

  • erupt-upms: e_upms_module (module menu fingerprints and switches, default admin and telemetry instance state)
  • erupt-share: e_share_link
  • erupt-webhook: e_webhook, e_webhook_log
  • erupt-config: e_config_profile, e_config_item
  • erupt-revision: e_record_revision
  • erupt-ai-dev: e_ai_dev_project, e_ai_dev_project_repo, e_ai_dev_project_member, e_ai_dev_requirement, e_ai_dev_requirement_review, e_ai_dev_requirement_delivery, e_ai_dev_agent_session, e_ai_dev_agent_event

e_upms_user / e_upms_role / e_upms_org / e_upms_post (erupt-upms)

sql
ALTER TABLE e_upms_user ADD COLUMN tenant_id VARCHAR(64) NOT NULL DEFAULT '0' COMMENT 'Tenant, 0 = platform';
ALTER TABLE e_upms_role ADD COLUMN tenant_id VARCHAR(64) NOT NULL DEFAULT '0' COMMENT 'Tenant, 0 = platform';
ALTER TABLE e_upms_org  ADD COLUMN tenant_id VARCHAR(64) NOT NULL DEFAULT '0' COMMENT 'Tenant, 0 = platform';
ALTER TABLE e_upms_post ADD COLUMN tenant_id VARCHAR(64) NOT NULL DEFAULT '0' COMMENT 'Tenant, 0 = platform';

ALTER TABLE e_upms_user ADD CONSTRAINT uk_upms_user_account UNIQUE (tenant_id, account);
ALTER TABLE e_upms_role ADD CONSTRAINT uk_upms_role_code    UNIQUE (tenant_id, code);
ALTER TABLE e_upms_org  ADD CONSTRAINT uk_upms_org_code     UNIQUE (tenant_id, code);
ALTER TABLE e_upms_post ADD CONSTRAINT uk_upms_post_code    UNIQUE (tenant_id, code);

Projects without erupt-tenant may keep the old single-column unique index on account / code. Projects with erupt-tenant must drop it, otherwise two tenants cannot use the same account; index names differ per database, so look them up first with SHOW INDEX FROM e_upms_user WHERE Non_unique = 0;.

e_upms_login_log / e_upms_operate_log (erupt-upms)

sql
ALTER TABLE e_upms_login_log   ADD COLUMN tenant_id VARCHAR(64) NOT NULL DEFAULT '0' COMMENT 'Tenant';
ALTER TABLE e_upms_operate_log ADD COLUMN tenant_id VARCHAR(64) NOT NULL DEFAULT '0' COMMENT 'Tenant';

e_upms_sso / e_upms_sso_bind (erupt-sso)

sql
ALTER TABLE e_upms_sso      ADD COLUMN tenant_id       VARCHAR(64) NOT NULL DEFAULT '0' COMMENT 'Tenant';
ALTER TABLE e_upms_sso      ADD COLUMN idp_certificate LONGTEXT    COMMENT 'SAML IdP signing certificate';
ALTER TABLE e_upms_sso_bind ADD COLUMN tenant_id       VARCHAR(64) NOT NULL DEFAULT '0' COMMENT 'Tenant';
ALTER TABLE e_upms_sso      ADD CONSTRAINT uk_upms_sso_code UNIQUE (tenant_id, code);

e_record_comment (erupt-comment)

sql
ALTER TABLE e_record_comment ADD COLUMN tenant_id VARCHAR(64) NOT NULL DEFAULT '0' COMMENT 'Tenant';

e_flow / e_flow_group / e_flow_instance (erupt-flow)

sql
ALTER TABLE e_flow          ADD COLUMN tenant_id VARCHAR(64) NOT NULL DEFAULT '0' COMMENT 'Tenant';
ALTER TABLE e_flow_group    ADD COLUMN tenant_id VARCHAR(64) NOT NULL DEFAULT '0' COMMENT 'Tenant';
ALTER TABLE e_flow_instance ADD COLUMN tenant_id VARCHAR(64) NOT NULL DEFAULT '0' COMMENT 'Tenant';

e_tenant_package (erupt-tenant)

sql
ALTER TABLE e_tenant_package ADD COLUMN trial_days INT COMMENT 'Trial days';

2.3.0 (2026-09-24) Spring Boot 3.5.16 โ€‹

Before you upgrade

Read the V 2.3.0 Upgrade Guide: the login lock is on by default, a password change signs out other sessions, logoPath: null in app.js now means "no logo", and there are database changes.

๐Ÿฆž Open-sourced erupt-sso: OAuth2 authorization code + PKCE with 17 provider presets (Keycloak, Okta, Auth0, Entra ID, GitHub, Feishu, DingTalk, WeCom, WeChat and more): pick the type, paste the credentials, done. Providers are rows configured in the admin, no restart; the code is exchanged server side and the token never travels in a URL

๐Ÿฆž Open-sourced erupt-comment: a comment stream on any record with one-level replies, pinned / resolved threads and per-row counts; an @mention sends an erupt-notice that deep-links to the record; @Power(comment = false) opts a model out

๐Ÿฆž Open-sourced erupt-ai-decision: yes/no, choice and score questions answered by a System One decision model as typed answers with a probability distribution, so code branches on a threshold instead of parsing a sentence; supports TypeSafe Jev and the self-hostable open-source Laya

๐Ÿฆž Open-sourced the erupt-data-dingtalk (DingTalk Notable) and erupt-data-airtable data sources, sharing one REST-table base with Feishu and Notion

๐ŸŒŸ New ICON edit component: picks from the full Font Awesome catalogue and renders the icon in tables

๐ŸŒŸ New KEY_VALUE edit component: edits a JSON object stored as a String or as a Map on a JSON column

๐ŸŒŸ New TRANSFER edit component: handles many-to-many relations as a searchable two-list transfer, and @MultiChoiceType(type = TRANSFER) gives value lists the same widget

๐ŸŒŸ Tables support multi-level headers: adjacent columns sharing @View(group) merge under one parent header while column settings keep working per column

๐ŸŒŸ Form panel: record forms open centered, docked to the side or fullscreen and keep unsaved input when switching; the title bar offers previous / next, a view-edit toggle, copy link, delete, AI assistant and print; ?id= deep-links open a record

๐ŸŒŸ Login page layouts: four new layouts (cover / wide / wallpaper / poster) and a configurable login picture (theme.loginLayout / theme.loginBackground), switchable from the login page itself

๐ŸŒŸ Workspace and Classic skins: Workspace is a Slack / Feishu style shell with 32 light and dark frame presets; Classic is the Ant Design Pro navy sidebar; the Brutalist skin was redrawn against raft.build

๐ŸŒŸ Install as a desktop app (PWA): the manifest is generated from the site config, the header doubles as a draggable title bar, and pwa.icon / pwa.shortcuts / faviconPath are configurable

๐ŸŒŸ Two-factor authentication (MFA): TOTP codes, self-enrolled from the avatar menu; after the password a 6-digit code is required before a session is issued; recovery codes are single-use and stored hashed, and an admin can reset MFA in one click

๐ŸŒŸ Login lock: ten failed passwords for one account from one IP lock the pair for ten minutes (erupt.upms.login-lock), a wrong captcha counts too; changing a password signs out the account's other sessions

๐ŸŒŸ erupt-notice gains provider-backed channels: Feishu, DingTalk, WeCom and Slack push notifications through the erupt-sso provider row's own credentials; any user who has signed in through that provider can be reached, no separate bot setup. EruptSsoBindService lets other modules read a user's identifier and profile snapshot at the provider

๐ŸŒŸ erupt-generator rewritten: read the schema of any registered datasource and turn tables into entities: comments become titles, foreign keys become references, documented enum values become @Choice; preview in the code editor drawer, download several classes as a zip

๐ŸŒŸ S3AttachmentProxy: erupt-data-s3 ships a ready-made attachment proxy; set erupt.s3.* and every upload lands in S3 / MinIO / OSS / COS / R2; the attachment domain now comes from the backend, no app.js edit needed

๐ŸŒŸ erupt-remote SFTP file transfer: a file panel next to the SSH terminal browses remote directories, uploads by drag-and-drop, downloads, creates folders and deletes files; switchable per host and sharing the terminal's credentials and authorization

๐Ÿงฉ New ViewType.AVATAR round avatar view type, used by the user table

๐Ÿงฉ @Tree(maxLevel) caps a tree's depth: the UI stops offering "add child" at the limit and the server refuses any save that would place a node deeper

๐Ÿงฉ @Layout(tableTruncate = false) wraps overflowing cells instead of truncating, so a crowded operation column keeps every action reachable

๐Ÿงฉ @BoolType(type) picks a switch or radios, default AUTO: a required field renders as a switch, others as radios; a null table cell no longer shows an empty tag

๐Ÿงฉ theme.customizable = false locks the branding side of the appearance (theme color, header color, skin, menu mode) for everyone; light/dark and compact stay per-user

๐Ÿงฉ app.js logo keys: leave out for the default, null / '' for none; a collapsed sidebar without a logo shows the site's initial instead of the Erupt mark; new faviconPath

๐Ÿงฉ "Publish to menu" in reports, the designer, Atlas and AI Canvas lets you pick the menu icon

๐Ÿงฉ Profile and lock screen: users change their own avatar and display name (LoginProxy.beforeUpdateProfile can veto); a lock screen in the avatar menu unlocks with the password without issuing a new session

๐Ÿงฉ IP whitelist accepts IPv4 / IPv6 CIDR ranges, thanks to chenxiaolong8023 for the contribution

๐Ÿงฉ erupt-atlas "Used by": modules report what a model is used for through EruptUsageProvider (flow forms and custom nodes, menus, cube dashboards, print templates, row-operation forms); table views now fill the screen

๐Ÿž Fixed every scheduled job failing with a missing ShedLock LockProvider when redis-session is on and the host application component-scans xyz.erupt; a job without a lock is now skipped and logged instead of running unlocked on every node

๐Ÿž Fixed week pickers throwing a RangeError

๐Ÿž Fixed print entries showing despite @Power(print = false)

๐Ÿž Fixed @View(column) on a COMBINE field not reaching the table (Gitee IKGOKN)

๐Ÿž Fixed item.xxx in @View(template) reading the stored value instead of the cell's display text

Database Changes โ€‹

INFO

Hibernate applies these changes automatically at startup; run them by hand only when automatic DDL is disabled (spring.jpa.hibernate.ddl-auto=none or validate).

This release changes:

  • e_upms_user: three new columns (MFA)
  • e_generator_class, e_generator_field: new columns (when erupt-generator is used)
  • e_remote_host: one new column (when erupt-remote is used)

Tables for newly introduced modules are created by Hibernate automatically, nothing to run by hand:

  • erupt-sso: e_upms_sso, e_upms_sso_role, e_upms_sso_bind
  • erupt-comment: e_record_comment
  • erupt-ai-decision: e_ai_decision_def, e_ai_decision_model, e_ai_decision_question
Show SQL (MySQL syntax; adapt for other databases)

New columns on e_upms_user (erupt-upms)

sql
ALTER TABLE e_upms_user ADD COLUMN mfa_enabled        BIT(1)        COMMENT 'two-factor authentication enabled';
ALTER TABLE e_upms_user ADD COLUMN mfa_secret         VARCHAR(64)   COMMENT 'TOTP secret';
ALTER TABLE e_upms_user ADD COLUMN mfa_recovery_codes VARCHAR(2000) COMMENT 'hashed recovery codes, JSON array';

New columns on e_generator_class (erupt-generator)

sql
ALTER TABLE e_generator_class ADD COLUMN super_class  VARCHAR(255) COMMENT 'parent class';
ALTER TABLE e_generator_class ADD COLUMN package_name VARCHAR(255) COMMENT 'package';

New columns on e_generator_field (erupt-generator)

sql
ALTER TABLE e_generator_field ADD COLUMN column_name    VARCHAR(255) COMMENT 'column name';
ALTER TABLE e_generator_field ADD COLUMN java_type      VARCHAR(255) COMMENT 'java type';
ALTER TABLE e_generator_field ADD COLUMN length         INT          COMMENT 'length';
ALTER TABLE e_generator_field ADD COLUMN type_code      VARCHAR(255) COMMENT 'JDBC type code';
ALTER TABLE e_generator_field ADD COLUMN primary_key    BIT(1)       COMMENT 'primary key';
ALTER TABLE e_generator_field ADD COLUMN auto_increment BIT(1)       COMMENT 'auto increment';

New column on e_remote_host (erupt-remote)

sql
ALTER TABLE e_remote_host ADD COLUMN file_transfer BIT(1) DEFAULT b'1' COMMENT 'SFTP file transfer allowed on this SSH host';

2.2.0 (2026-09-15) Spring Boot 3.5.16 โ€‹

Breaking changes

Read the V 2.2.0 Upgrade Guide before upgrading.

erupt-designer data moves to an embedded SQLite file: business data no longer lives in the main database's e_designer_data table and is not migrated automatically; the file needs its own backup and a persistent volume.

Table structures change too โ€” see Database Changes at the end of this release.

๐Ÿฆž Open-sourced erupt-atlas: the relations already implied by your annotations, drawn as a graph โ€” lineage tracing, dependency layers, a module coupling matrix, impact analysis, and a structural audit for cycles, shared tables and orphan models.

๐Ÿฆž Open-sourced erupt-remote: remote hosts in the browser โ€” VNC desktops and SSH shells over one WebSocket, credentials stored AES-GCM encrypted, and the VNC authentication answered server-side so the password never reaches the front end.

๐ŸŒŸ Tables gain bitable-style editing: double-click a cell to change one field in place, without opening the row form. The server validates the whole row, so DataProxy, the operate log and the edit event behave exactly as a form submission โ€” gated by @Power(cellEdit) on the model and @Edit(cellEdit) on the field.

๐ŸŒŸ AI writing assistant on text fields: generate, polish, continue, shorten or expand a value with the rest of the form as the brief. Streams over SSE and persists nothing; @Edit(prompt) is that field's authoring guidance.

๐ŸŒŸ erupt-ai goes multimodal: attach images with the paper-clip button or a clipboard paste and send them alongside the text. Images are persisted with the message and carried along when the history context is rebuilt, regenerated or edit-resent.

๐ŸŒŸ New Liquid Glass skin: the sidebar becomes a translucent pane of glass โ€” backdrop blur, specular top edge โ€” floating on an ambient color field, switchable against the default and Brutalist skins from the settings drawer.

๐ŸŒŸ New dark theme: light / dark / auto, where auto follows the OS live, and charts, code editors and Markdown previews follow along; compact mode combines freely with it.

๐ŸŒŸ TPL fields now talk to the form both ways: a template reads every sibling field's value and writes back formData and editExpr, so a custom editor is no longer cut off from the form it lives in.

๐Ÿงฉ Theme color and header color are now set with a color picker and remembered; the default theme color is rgb(22, 119, 255).

๐Ÿงฉ Menu layout offers single-column, split and dual-column modes โ€” dual being a first-level icon rail plus the selected category's children โ€” and menu names can show under the icons when the sidebar is collapsed.

๐Ÿงฉ A dark sidebar can be turned on on its own while the rest of the UI stays light.

๐Ÿงฉ The login page gained a skin dropdown and a theme color picker, so the first screen can be dressed before signing in.

๐Ÿงฉ Multi-tab improvements: pages opened from a row operation or a link (remote host, AI canvas, cube dashboard, form designer) name their tab after their data and close it on back.

๐Ÿงฉ The menu tree expands one level by default, so a large menu no longer fills the screen at once.

๐Ÿงฉ Upgraded to Font Awesome 7, taking available icons from 675 to 1992; legacy FA4 class names keep working.

๐Ÿงฉ The micro-frontend container switched to the iframe sandbox, so Vite / ESM sub-apps load correctly and several micro-frontend menus can be open at once.

๐Ÿงฉ New micro-frontend link menu type: opens an external URL in the micro-frontend container when the target refuses framing.

๐Ÿงฉ Gantt charts and the Markdown editor load their libraries on demand, only when a page actually shows one.

๐Ÿงฉ TEXTAREA gained configuration: max length, visible row bounds, and @ / # mentions (static candidates plus a TagsFetchHandler, served on demand).

๐Ÿงฉ AUTO_COMPLETE supports static values; handler is no longer required.

๐Ÿงฉ The NUMBER input ignores the mouse wheel, so scrolling a page can no longer nudge a value.

๐Ÿงฉ Tree view labels now go through @EruptI18n translation, so tree pages such as Menu Management follow the console language instead of showing their authored text.

๐Ÿงฉ erupt-designer stores its data in an embedded SQLite file: one real table per published design, with filtering, sorting and paging pushed down as SQL regardless of the host database.

๐Ÿงฉ erupt-ai-canvas enhancements: a canvas binds several data models, each with its own add / edit / delete permission; generation runs asynchronously, plus page validation and publish versions.

๐Ÿงฉ A model picker in the chat input toolbar switches models mid-conversation; shown only when more than one enabled model exists, and hidden when the model is pinned through ?llm=.

๐Ÿงฉ The AI now replies in the language the console is set to, instead of drifting to Chinese whatever language the question was asked in.

๐Ÿงฉ Added erupt.ai.request-timeout, raising the LLM read timeout to 15 minutes by default (langchain4j defaults to 60s, which cuts off long non-streaming generations).

๐Ÿงฉ erupt-print templates are authored with CKEditor, matching the storage format the frontend print-template editor expects (Velocity tokens plus widget markup).

๐Ÿงฉ Added anonymous telemetry โ€” version and module stats only, and it can be turned off at any time.

๐Ÿงฉ User and role lists are no longer scoped to their creator โ€” visibility is decided by menu and role permissions. Review those two menu grants after upgrading; see the upgrade guide.

๐Ÿงฉ WebSocket pushes go through a per-connection async queue, so business threads never block on slow clients.

๐Ÿงฉ ip2region loads its xdb file on demand instead of shipping the database in the jar.

๐Ÿž Fixed 64-bit id precision loss in the browser: erupt-api responses returning bare Map / Collection bypassed Gson's safe-number serialization.

๐Ÿž Fixed scheduled jobs crashing with redis-session enabled โ€” the LockProvider is now resolved from the Spring container. Thanks to chenxiaolong8023 for the contribution.

๐Ÿž Fixed sub-table row corruption caused by unstable temporary primary keys.

๐Ÿž Fixed the drag-sort grip appearing on placeholder and measuring rows.

๐Ÿž Fixed the designer copying a field along with its original field id.

Database Changes โ€‹

INFO

Schema changes are applied automatically by JPA / Hibernate at startup. Run these manually only if automatic DDL is disabled (spring.jpa.hibernate.ddl-auto=none or validate).

This release adds the table e_ai_canvas_model, drops two columns from e_ai_canvas after migrating them, adds one column to e_ai_chat_message, and leaves e_designer_data unused. Adding erupt-remote also creates e_remote_host, which Hibernate builds on its own.

Show the SQL (MySQL syntax; translate for other databases)

New table e_ai_canvas_model (erupt-ai-canvas)

sql
CREATE TABLE e_ai_canvas_model
(
    id           BIGINT NOT NULL AUTO_INCREMENT,
    canvas_id    BIGINT,
    data_type    VARCHAR(255),
    model        VARCHAR(255),
    purpose      VARCHAR(255),
    allow_add    BIT(1),
    allow_edit   BIT(1),
    allow_delete BIT(1),
    PRIMARY KEY (id)
);
ALTER TABLE e_ai_canvas_model ADD CONSTRAINT fk_ai_canvas_model_canvas FOREIGN KEY (canvas_id) REFERENCES e_ai_canvas (id);

Changed columns on e_ai_canvas (erupt-ai-canvas)

Model bindings moved into e_ai_canvas_model. Migrate the data first, then drop the old columns:

sql
INSERT INTO e_ai_canvas_model (canvas_id, data_type, model, allow_add, allow_edit, allow_delete)
SELECT id, data_type, target_model, 0, 0, 0 FROM e_ai_canvas WHERE target_model IS NOT NULL;

ALTER TABLE e_ai_canvas DROP COLUMN data_type;
ALTER TABLE e_ai_canvas DROP COLUMN target_model;

New column on e_ai_chat_message (erupt-ai)

sql
ALTER TABLE e_ai_chat_message ADD COLUMN images LONGTEXT COMMENT 'JSON array of image attachment paths sent with a user message';

e_designer_data is no longer used (erupt-designer)

Designer business data moves to an embedded SQLite file (data/designer.db by default). The table is neither read nor written any more, and Hibernate will not drop it for you. Nothing is migrated automatically, so drop it by hand only once you are sure nothing in it is still needed (or it has been exported):

sql
-- Irreversible: confirm the data is migrated or no longer needed first
DROP TABLE e_designer_data;

The design config table e_designer is still in use โ€” do not drop it.

2.1.1 (2026-08-30) Spring Boot 3.5.16 โ€‹

๐ŸŒŸ Added the MULTI_FORM edit type โ€” one-to-many child rows are edited directly as inline form blocks, ideal when child tables have many fields.

๐ŸŒŸ @Layout added the formSteps step-form wizard mode: DIVIDE fields delimit the steps, splitting long forms into guided stages.

๐ŸŒŸ erupt-cube added a Map report type: ECharts-based choropleth maps with a GeoJSON map registry and region-click drill-down linkage.

๐Ÿงฉ @Search added lockOperator โ€” the query operator is enforced server-side so crafted requests cannot bypass frontend query restrictions.

๐Ÿงฉ Choice and reference field search now supports IN / NOT_IN multi-select queries, matching multiple options at once.

๐Ÿงฉ DATE picker added a QUARTER mode plus min / max selectable date bounds.

๐Ÿงฉ NUMBER input enhanced with decimal precision, step size, prefix/suffix units, and thousands separator.

๐Ÿงฉ COLOR picker added configuration for alpha channel, preset swatches, and color value text.

๐Ÿงฉ erupt-job supports cluster deduplication: with redis-session enabled, each scheduled job runs on exactly one node across the cluster.

๐Ÿงฉ Security hardening: nested sub-model requests (TAB, COMBINE, reference fields, etc.) are now authorized against their parent's menu permission.

๐Ÿงฉ ADD/EDIT function permissions are auto-generated for FORM-type menus โ€” no manual configuration needed.

๐Ÿงฉ Sidebar menu gained a toolbar: refresh, reset, expand all, and split mode.

๐Ÿงฉ Tree views support batch delete with checkboxes.

๐Ÿงฉ Table column widths are computed from measured text for better accuracy; overly long header breadcrumbs are truncated with ellipsis; the multi-tab bar is hidden on mobile.

๐Ÿงฉ Added the OrcaRouter LLM provider โ€” thanks to XiaoHuo888-hue for the contribution.

๐Ÿž Fixed RAG knowledge-base ingestion failing for remote attachments and stale embedding clients after configuration changes.

๐Ÿž Fixed the TIME search filter being blank and unusable.

๐Ÿž Fixed Markdown fields not displaying asynchronously loaded content โ€” thanks to chenxiaolong8023 for the contribution.

๐Ÿž Fixed left-join queries in erupt-cube semantic models.

๐Ÿž Fixed the fixed-mode multi-tab bar overlapping page content.

2.1.0 (2026-08-23) Spring Boot 3.5.16 โ€‹

๐Ÿฆž 15 modules open-sourced โ€ƒ ๐Ÿ”Œ 13+ data connectors โ€ƒ ๐Ÿค– Major AI upgrades

๐Ÿฆž Open-sourced the Erupt Report module (formerly the commercial erupt-bi) โ€” define reports and charts in pure SQL, multi-dimensional analytics with zero frontend code.

๐Ÿฆž Open-sourced the erupt-ai-canvas module: generate a complete page from one sentence โ€” SSE streaming generation, version rollback, element picking, multi-device preview, one-click publish to menu, with live data from the Erupt backend.

๐Ÿฆž Open-sourced the erupt-ai-rag module: knowledge bases with vector retrieval (RAG), pluggable embedding models and vector stores (pgvector, Redis, etc.), with Agentic RAG support.

๐Ÿฆž Open-sourced the erupt-ai-staff module: AI digital employees bound to real system accounts, inheriting UPMS permissions, running Cron-scheduled tasks, and pushing work reports to DingTalk, WeCom, Feishu, or Slack.

๐Ÿฆž Open-sourced the erupt-data connector layer: where data lives, admin follows โ€” one unified data-source interface, letting the same annotated model perform CRUD, pagination, and search over any data. 11 new data-source modules:

ModuleDescription
erupt-data-jdbcPlain JDBC single-table data source, no JPA mapping needed โ€” supports ClickHouse, Doris, TDengine, DM, and other JDBC-driver-only databases
erupt-data-httpREST APIs as data sources โ€” map any HTTP service to a manageable admin table
erupt-data-esElasticsearch data source for managing and full-text searching index data
erupt-data-redisVisual management of Redis key-value data
erupt-data-memoryIn-memory data source โ€” manage data without a database
erupt-data-fileFiles as tables, supporting CSV, JSONL, TSV, INI, and more
erupt-data-k8sVisual management of Kubernetes cluster resources
erupt-data-ldapLDAP directory service data source
erupt-data-feishuFeishu Bitable data source
erupt-data-notionNotion data source
erupt-data-s3S3 object storage data source

๐ŸŒŸ erupt-cube gains a SQL Port: a PostgreSQL-compatible wire-protocol port (Calcite query pushdown) โ€” any BI tool can connect to the semantic layer as if it were PostgreSQL.

๐ŸŒŸ erupt-ai-claw enhancements: sandboxed file and shell tools, an Agent Skills library with skill sedimentation, an Erupt model CRUD toolbox, and JVM/Spring runtime diagnostics tools.

๐ŸŒŸ erupt-cloud enhancements: node lifecycle management, resource reporting, routing failover and graceful shutdown, plus support for mounting erupt-flow, erupt-ai-claw, and erupt-monitor.

๐ŸŒŸ erupt-flow gains Flex automation nodes: HTTP request, script, data, variable (JS expression resolution), notify, and wait-callback โ€” flows can now perform automated actions without human steps.

๐ŸŒŸ New erupt-docker all-in-one image โ€” spin up a complete Erupt environment with a single command.

๐ŸŒŸ AI chat can now be stopped mid-generation; partial output is kept and marked as interrupted.

๐Ÿงฉ erupt-monitor adds an Erupt class registry page listing runtime models, with one-click publish to menu.

๐Ÿงฉ @Power adds an ai switch to control AI availability per entity.

๐Ÿงฉ Admin UI refresh: new Brutalist theme with one-click toggle, redesigned login screens and brand logo.

๐Ÿงฉ Table columns now filter dynamically based on @Vis field visibility.

๐Ÿž Fixed the change-password API failing when pwd-transfer-encrypt = false.

๐Ÿž Fixed operation-log recording errors caused by masking failures.

Breaking Changes

  • erupt-jpa has been renamed to erupt-data-jpa, and erupt-mongodb to erupt-data-mongodb (both now part of the erupt-data connector layer) โ€” update the artifactId in your Maven dependencies.
  • The AMIS integration module in erupt-tpl-ui has been removed; migrate to another template engine integration if you were using it.

2.0.4 (2026-07-19) Spring Boot 3.5.16 โ€‹

๐ŸŒŸ New BUTTON edit type โ€” an in-form button that calls a backend handler with all current form values, supporting form population and dynamic field configuration.

๐ŸŒŸ New @DragSort row drag sorting โ€” reorder table rows by dragging, with the result automatically persisted to the sort field.

๐ŸŒŸ New PROGRESS view type โ€” display numeric columns as progress bars; the SLIDER edit type contributes its max value automatically.

๐ŸŒŸ New PASSWORD view type โ€” sensitive fields are masked and the actual value is never sent to the client.

๐Ÿงฉ PASSWORD edit type security hardening: edit echo returns only a mask placeholder; submitting it unchanged keeps the stored password.

๐ŸŒŸ Card view now supports card selection, with selected-state styling wired to action buttons.

๐Ÿงฉ Built-in forms for AI models, MCP servers, agents, and scheduled jobs gain test/validation buttons for one-click connection and configuration checks.

๐Ÿงฉ erupt-ai supports an embedded chat mode; the LLM apiKey is now masked with the password view.

๐Ÿงฉ More lenient date parsing, accepting a wider range of date/time input formats.

๐Ÿž Fixed password fields not being masked in operation logs.

๐Ÿž Fixed swapped "Hidden" and "Disable" labels in the menu status enum.

๐Ÿž Fixed an error caused by the AI chat drawer opening outside the Angular zone.

2.0.3 (2026-07-04) Spring Boot 3.5.16 โ€‹

๐ŸŒŸ New erupt-spring-boot-starter and erupt-spring-boot-starter-all starters โ€” integrate Erupt core or every feature module with a single dependency.

๐ŸŒŸ New CALLOUT edit type โ€” render static guidance content inside forms with HTML support and card/info/warning styles; the field is neither collected nor persisted.

๐ŸŒŸ @Search adds an operator property to specify the default query operator per field; AUTO resolves by edit type.

๐ŸŒŸ erupt-print templates now support block-level template variables, with a new editor variable plugin, automatic print-variable generation, and loading feedback in print preview.

๐Ÿงฉ Operation logging enhanced: new record-operate-log-max-body-size property caps the recorded request body size, with improved request-context cleanup.

๐Ÿงฉ Admin home page visual refresh: animated blueprint background, collapsible sidebar, and refined terminal tab styling.

๐Ÿž Fixed unbounded captcha image height parameter that could be abused to generate oversized images.

๐Ÿž Fixed a deserialization error in erupt-designer when the form view field is null.

2.0.1 (2026-06-29) Spring Boot 3.5.15 โ€‹

๐Ÿš€ New modules ร—2 โ€ƒ ๐ŸŒŸ New features ร—21 โ€ƒ ๐ŸŽจ Frontend 50+ updates

WARNING

2.0.0 contains multiple breaking changes. Please read the 1.14.x โ†’ 2.0.0 Upgrade Guide before upgrading.

๐Ÿš€ Open-sourced erupt-designer โ€” visually design Erupt entity models at runtime and publish them to the menu with one click.

๐Ÿš€ Open-sourced erupt-print โ€” define print templates and variables for any Erupt entity and print rows with a single click.

๐ŸŒŸ erupt-monitor completely rewritten: new diagnostics system covering JVM, HikariCP pool, HTTP stats, and Redis health metrics.

๐ŸŒŸ erupt-ai: LLM requests now support agentPrompt and contextPrompt for context-aware prompt injection per invocation.

๐ŸŒŸ @Vis adds Calendar (CALENDAR) and Board (BOARD) view types for richer data visualization.

๐ŸŒŸ @Power adds a copy toggle โ€” supports one-click row duplication in tables.

๐ŸŒŸ @Layout adds collapseActionButton โ€” collapses the view-details, edit, and delete buttons into a dropdown menu.

๐ŸŒŸ New @GroupType annotation โ€” group fields inside a collapsible panel (EditType.GROUP).

๐ŸŒŸ @Erupt and @Edit gain a prompt field for AI agent prompt configuration.

๐ŸŒŸ New PASSWORD edit type โ€” password fields render and transmit more securely.

๐ŸŒŸ Open search support โ€” INPUT, NUMBER, and other components now let users choose the search operator (equals, not-equals, contains, range, etc.) directly in the search bar.

๐ŸŒŸ Dynamic dropdown refresh โ€” ChoiceFetchHandler / AutoCompleteHandler / TagsFetchHandler can now reload options on demand.

๐ŸŒŸ Selection Handler interfaces are now generic โ€” callbacks can directly access other form fields for cascading linkage.

๐ŸŒŸ New FormView โ€” dedicated backend endpoint with DataProxy.formViewBehavior / formSave hooks for single-record full-page form scenarios.

๐ŸŒŸ Excel export supports exporting only selected rows.

๐ŸŒŸ Password encryption upgraded from MD5 to SHA-512 with salt for significantly improved security โ€” thanks to ๆฎต้น้น for the contribution (!35).

๐ŸŒŸ Spring Boot upgraded to 3.5.15.

๐ŸŒŸ Operation logs now record the entity state before modification/deletion โ€” the previous field values are visible in log details.

๐ŸŒŸ erupt-ai adds Requesty as a new LLM provider.

๐ŸŒŸ OpenAPI: new getAppid endpoint to retrieve appid information by token.

๐ŸŒŸ EruptLambdaQuery adds or() support for building OR-logic composite queries.

๐ŸŒŸ erupt-cube: new drillFields dimension filtering and drillMeasure measure-level drill-down support.

๐ŸŒŸ erupt-cube: Cube annotations gain a prompt field for AI-readable semantic descriptions.

๐Ÿงฉ dependField now uses getter-style references with IDE field-name auto-complete.

๐Ÿงฉ erupt-designer: button permissions are now auto-generated when publishing a menu.

๐Ÿž Fixed: Ollama model configuration was missing the baseUrl parameter โ€” thanks to canjian215215 for the contribution.

๐ŸŽจ Frontend Complete Overhaul (erupt-web 2.0)

Angular 20 โ†’ 21. The entire UI layer has been rewritten from architecture to interaction.

  • New login page and preloader animation; new Split Menu mode (first-level nav on left, second-level alongside)
  • Sidebar width is draggable and persisted; favourites support drag-and-drop reordering; responsive layout optimized for mobile
  • Table: column drag-sort, column pinning, column density, row copy, persistent search state, collapsible search panel
  • Left-tree panel is collapsible; table-tree layout supports fullscreen mode
  • AI side panel embedded in table / tree views โ€” chat with AI about visible data without leaving the page
  • erupt-ai chat: wide-screen mode, session search, input-history navigation
  • Code editor: smart hints and fullscreen mode; attachment component: drag-sort and batch update
  • MultiChoice / Checkbox gain a select-all button; Choice shows color dots; input shows real-time character count
  • Tree view: sort, node locate; BI / Monitor modules gain fullscreen improvements
  • Terminal module (erupt-terminal) UI integrated โ€” multi-tab switching with real-time WebSocket communication
  • Table and modal now support dynamic action buttons โ€” visibility can be controlled based on row data state
  • erupt-flow approval UI fully redesigned with mobile-responsive master-detail layout and accessibility improvements
  • TAGS component supports joinSeparator = "[]" JSON array format for tag value storage and parsing

1.14.x โ†’ 2.0.0 Upgrade Guide โ€‹

Full guide: /en/guide/upgrade

Breaking Changes

  • Password encryption upgraded: MD5 โ†’ SHA-512 with salt. The upgrade is backward compatible โ€” existing users can still log in with their current passwords; only new and reset passwords will use SHA-512 + salt going forward. Thanks to ๆฎต้น้น for this security improvement.
  • DataProxy.extraContent signature changed: A second parameter Collection<Map<String, Object>> list has been added. Any class that overrides this method must update its signature.
  • AutoCompleteHandler, ChoiceFetchHandler, TagsFetchHandler require a generic type parameter: The fetchFilter method's formData parameter (Map<String,Object>) has been replaced with the actual model object (generic T).
  • Excel import template format changed from .xls to .xlsx: Users with cached or bookmarked download links must re-download the template.
  • @Search.vague removed: The vague property has been deleted. Remove all vague = true / vague = false from your code โ€” advanced search is now the default behaviour.
  • EruptApiModel deleted: The response model is now R<T>. Replace EruptApiModel.PromptWay with R.PromptWay throughout your code.
  • ChoiceTrigger interface removed: Use @ChoiceType.fetchHandler instead.
  • Login / change-password endpoints switched to HTTP POST: /login and /change-pwd changed from GET to POST. Custom login pages must be updated accordingly.

Legacy Versions โ€‹

Changelogs and documentation for the 1.x release line have moved to the Legacy Versions page.

Contributors

The avatar of contributor named as YuePeng YuePeng

Changelog

Released under the Apache-2.0 License.