erupts/erupt

Erupt – 어노테이션 기반 Java 관리 프레임워크 (내장 AI 기능)

무엇인가요 – Erupt는 오픈소스 Java 라이브러리로, JPA 엔티티에 어노테이션을 추가하기만 하면 완전한 기능의 관리 UI를 자동 생성합니다. Spring Boot 스타터로 제공되어, 프론트엔드 코드 없이도, 컨트롤러 없이도, 몇 초 만에 실행 가능한 관리 패널을 구축할 수 있습니다.

AI/ML에서의 중요성 – 전통적인 CRUD 관리 UI 외에도, Erupt는 AI 핸드레스(erupt-ai)와 AI '클로우'(erupt-ai-claw) 모듈을 제공합니다. 이 모듈들을 통해:

• OpenAI, Claude, Gemini, Ollama 등 50개 이상의 LLM 제공업체 및 MCP 호환 도구 서버에 연결 가능.
• @AiToolbox / @Tool 어노테이션으로 Spring 빈을 AI 도구로 노출하고, 역할 기반 접근 제어 설정 가능.
• 폼 내부에서 텍스트 생성, 보완, 연속 작성이 가능한 필드 수준의 글쓰기 보조 기능 제공.
• AI 클로우를 통해 자연어로 서버와 상호작용 (질의, 데이터 생성/수정, 쉘 명령 실행, 파일 읽기/쓰기, 브라우저 제어 등).
• 다중 에이전트 워크플로우(A2A) 구축 및 사용자별 채팅 기록, 토큰 사용량, 장기 기억 관리 가능. 모든 설정은 서비스 재시작 없이 관리 UI에서 구성 가능.

핵심 기능

기능	제공되는 기능
1클래스 = 1페이지	JPA 엔티티에 @Erupt 어노테이션 → 자동 생성된 테이블, 폼, 검색, 페이징, 트리, 간트 차트, 카드 등.
빠른 시작	Java 17 + Spring Boot 3.x 기준 2~5초.
풍부한 UI 컴포넌트	30개 이상의 필드 유형 (날짜 선택기, 슬라이더, 지도, 코드 에디터, 마크다운, 서명, 자동완성 등).
RBAC 및 감사	내장된 사용자/역할 관리, 행 수준 필터, 컬럼 가시성, OpenAPI 생성.
다중 DB 지원	MySQL, PostgreSQL, Oracle, SQL Server, DM; MongoDB는 erupt-mongodb를 통해 지원.
Excel 임포트/익스포트, OpenAPI, 분산 구성 (erupt-cloud).
상용 확장 모듈	워크플로우, SaaS 테넌시, BI 큐브용 유료 모듈.

시작하기

1. 클론 및 실행 – git clone https://github.com/erupts/erupt && cd erupt && mvn spring-boot:run -pl erupt-sample -am. 샘플은 메모리 내 H2 DB를 사용하며, http://localhost:8080에서 접근 가능 (로그인 / erupt).
2. Docker – 전체 포함 이미지 erupts/erupt를 다운로드하고 docker run -p 8080:8080 erupts/erupt를 실행.
3. Maven 스타터 – 단일 종속성 xyz.erupt:erupt-spring-boot-starter (모든 선택적 모듈 포함 시 ‑starter‑all) 추가. 엔티티에 어노테이션을 추가하고 Spring Boot 앱을 시작하면 UI가 자동으로 표시됨.
4. 노코드 AI 기술 – 클라우드 코드(또는 다른 LLM)에 일반 영어로 시스템을 설명하면, AI 기술 서비스가 전체 관리 패널(엔티티, DB, CRUD, 권한 포함)을 자동 생성.

AI 전용 모듈

• erupt-ai – 프로덕션 수준의 LLM 통합. UI에서 제공업체 선택, 시스템 프롬프트 정의, 도구 노출, 역할 기반 도구 보안 강제, 채팅 기록 유지.
• erupt-ai-claw – 관리 서버 자체를 AI 기반 어시스턴트로 변환: 자연어로 데이터 질의, 쉘 명령 실행, 파일 I/O, 브라우저 제어, 70만 개 이상의 사전 구축된 '기술' 라이브러리 접근.

에코시스템 – 핵심 모듈은 Apache 2.0 라이선스로 영구 무료. 선택적 상용 모듈(Flow, SaaS, Cube)은 일회성 구매로 영구 라이선스 제공. erupt-cloud를 통해 여러 Spring Boot 서비스 간 중앙 집중형 구성 및 토폴로지 관리 가능.

텔레메트리 및 프라이버시 – 기본적으로 익명 사용 통계(버전, JDK, OS, DB 유형 등)가 전송됨. 비즈니스 데이터는 절대 전송되지 않음. erupt.telemetry.enabled: false 또는 ERUPT_TELEMETRY_DISABLED=1 환경 변수로 비활성화 가능.

라이선스 – Apache 2.0 (개인, 상업, 포크 용도로 무료).

---

결론 – Erupt는 Java 개발자가 즉시 프로덕션 준비된 관리 인터페이스를 구축할 수 있게 하며, AI 모듈을 통해 LLM 기반 도구, 에이전트, 자연어 작업을 관리 UI에 직접 통합할 수 있음. 프론트엔드 코드를 작성하지 않고도 가능합니다.