How erupts/erupt works
Erupt is a runtime, model-driven enterprise application platform with an AI harness. A user request enters through the admin/API surface; runtime model metadata drives generated-at-runtime views, permission-aware operations, and data access. AI capabilities extend that platform with chat and tool use, retrieval, decisioning, canvas generation, coding-agent workflows, and scheduled staff integrations. The graph combines README-described platform behavior with source-index-supported links; several module paths represent substantial subsystems whose internals were not sampled, so their unverified connections are omitted.
Main entry points: LLMService.java Chat orchestration · RagService.java RAG service · EruptModel.java Business model · EruptCoreService.java Runtime registry
Components 20
Runtime Platform
- Business model
erupt-core/src/main/java/xyz/erupt/core/view/EruptModel.java - Field metadata
erupt-core/src/main/java/xyz/erupt/core/view/EruptFieldModel.java - Runtime registry
erupt-core/src/main/java/xyz/erupt/core/service/EruptCoreService.java - Data operations
erupt-core/src/main/java/xyz/erupt/core/service/EruptModifyService.java - JPA access
erupt-data/erupt-data-jpa/src/main/java/xyz/erupt/jpa/dao/EruptDao.java - Session storage
erupt-upms/src/main/java/xyz/erupt/upms/service/EruptSessionService.java
AI Harness
- AI API
erupt-ai/erupt-ai/src/main/java/xyz/erupt/ai/controller/ChatController.java - Chat orchestration
erupt-ai/erupt-ai/src/main/java/xyz/erupt/ai/service/LLMService.java - LLM runtime
erupt-ai/erupt-ai/src/main/java/xyz/erupt/ai/core/LlmCore.java - LLM providers
erupt-ai/erupt-ai/src/main/java/xyz/erupt/ai/llm - MCP and A2A
erupt-ai/erupt-ai/src/main/java/xyz/erupt/ai/mcp
Knowledge and Decisions
- Retrieval API
erupt-ai/erupt-ai-rag/src/main/java/xyz/erupt/ai_rag/controller/RagController.java - RAG service
erupt-ai/erupt-ai-rag/src/main/java/xyz/erupt/ai_rag/service/RagService.java - Vector stores
erupt-ai/erupt-ai-rag/src/main/java/xyz/erupt/ai_rag/core/VectorStoreCore.java - Decision engine
erupt-ai/erupt-ai-decision/src/main/java/xyz/erupt/decision/core
Agent Workflows
- AI canvas
erupt-ai/erupt-ai-canvas/src/main/java/xyz/erupt/ai_canvas - Claw agents
erupt-ai/erupt-ai-claw/src/main/java/xyz/erupt/ai_claw - Coding workflows
erupt-ai/erupt-ai-dev/src/main/java/xyz/erupt/ai_dev - AI staff
erupt-ai/erupt-ai-staff/src/main/java/xyz/erupt/ai_staff
Other components
- Admin user
Connections 18
- Admin user → Runtime registry: uses model-driven app
README.md - Business model → Runtime registry: registered at runtime
erupt-core/src/main/java/xyz/erupt/core/service/EruptCoreService.java - Business model → Field metadata: defines fields
erupt-core/src/main/java/xyz/erupt/core/view/EruptModel.java - Runtime registry → Data operations: serves model operations
erupt-core/src/main/java/xyz/erupt/core/service/EruptModifyService.java - Data operations → JPA access: persists through
erupt-core/src/main/java/xyz/erupt/core/service/EruptModifyService.java - Admin user → AI API: requests chat
- AI API → Chat orchestration: dispatches chat
- Chat orchestration → LLM runtime: requests completion
erupt-ai/erupt-ai/src/main/java/xyz/erupt/ai/service/LLMService.java - Chat orchestration → LLM providers: uses provider
- Chat orchestration → MCP and A2A: offers agent tools
- Retrieval API → RAG service: routes retrieval
erupt-ai/erupt-ai-rag/src/main/java/xyz/erupt/ai_rag/controller/RagController.java - RAG service → Vector stores: uses vector core
erupt-ai/erupt-ai-rag/src/main/java/xyz/erupt/ai_rag/service/RagService.java - RAG service → Business model: embeds knowledge records
erupt-ai/erupt-ai-rag/src/main/java/xyz/erupt/ai_rag/service/RagService.java - Admin user → Decision engine: evaluates decisions
- Admin user → AI canvas: builds canvas
- Admin user → Claw agents: invokes agent
- Admin user → Coding workflows: directs coding agent
- Admin user → AI staff: configures AI staff