repository·master·Indexed 25 days ago
https://github.com/erupts/eruptAn annotation-driven Java admin framework and AI harness that generates full-featured admin UIs from JPA entities with zero front-end code. It includes a production-grade AI harness for managing LLM providers, MCP tools, and agentic workflows via modules like erupt-ai and erupt-ai-claw. The ecosystem features a distributed architecture with erupt-cloud-server and erupt-cloud-node, a core runtime engine (erupt-core) for automatic CRUD API generation, and a comprehensive annotation system (erupt-annotation) for defining data model behavior.
The erupt-tpl module provides a unified EruptTemplate interface that acts as an abstraction layer for various template engines. This allows other Erupt modules—such as erupt-print, erupt-generator, and erupt-cloud-server—to render dynamic HTML, emails, and code templates without being tightly coupled to a specific underlying engine.
Supported pluggable engines include:
The erupt-upms module is the User & Permission Management System for the Erupt platform. It provides a comprehensive suite of identity and access management features including:
erupt-jpa module provides a relational database data layer for the Erupt framework. It is built on top of Spring Data JPA and connects @Erupt-annotated entities to any JPA-compatible database (such as MySQL, PostgreSQL, Oracle, or H2). It implements the Erupt data SPI, allowing the core engine to perform CRUD operations, pagination, and search automatically without requiring manual DAO boilerplate code.The erupt-monitor is a system monitoring dashboard for the Erupt platform. It provides real-time visibility into server health and application performance by surfacing metrics directly as standard Erupt admin UI pages. No custom frontend development is required to use it.
Key monitoring capabilities include:
oshi-core).erupt-notice module provides real-time notification capabilities for Erupt. It allows backend services to push system messages and alerts directly to logged-in users via WebSockets. It relies on the erupt-websocket module as its underlying transport layer.erupt-cloud-node acts as a worker node for Erupt distributed deployments. Upon startup, it registers itself with an erupt-cloud-server. Once registered, it receives proxied requests from the server and executes them locally. This architecture allows for a single, unified admin UI to manage data across multiple independently deployed Spring Boot applications by using Spring AOP for transparent request interception.The erupt-cloud-server acts as the control plane for Erupt distributed deployments. It is responsible for managing a fleet of erupt-cloud-node workers by:
It includes an admin UI for monitoring node health and management, built using erupt-admin with an Ant Design UI.
The erupt-print module provides print and report rendering capabilities for the Erupt framework. It uses Apache Velocity templates to generate printable HTML output based on data models annotated with @Erupt.
Key features include:
erupt-toolkit is a collection of shared utilities designed for the Erupt framework. It provides core infrastructure components used by modules like erupt-upms and erupt-job to handle common tasks such as caching, database interaction, and data manipulation.erupt-magic-api is a dynamic HTTP API builder for the Erupt framework, powered by magic-api. It allows you to create, edit, and publish REST endpoints at runtime using a web-based IDE. Because endpoints are defined via scripts that execute against your application's datasources, no recompilation or application restarts are required to deploy new APIs. It integrates with erupt-upms to provide access control for both the editor UI and the generated REST endpoints.erupt-excel module provides Excel import and export capabilities for Erupt data models. It is built on Apache POI and integrates transparently with the Erupt data layer. When data models are annotated, the module automatically provides Excel upload and download endpoints. It supports template-based export and field-level mapping using the @EruptField configuration.The erupt-terminal is a browser-based server terminal designed for the Erupt platform. It bridges a PTY (Pseudo-Terminal) shell—powered by pty4j—to an in-browser terminal interface using xterm.js via a WebSocket endpoint.
Key features include:
erupt-upms token and menu permission checks.