How midirushi/agentic-rag works
Smart Rag is an enterprise Agentic RAG conversation platform with a Vue admin/chat frontend and a Spring backend. The main user path is chat request → intent routing → retrieval or tool reasoning → streamed answer; document upload and evaluation are important parallel capabilities. The graph preserves the README-documented subsystems, but several links use README evidence because their implementation files were not sampled; unsampled frontend and backend details are not inferred beyond those documented capabilities.
Main entry points: ChatHandler.java Chat handler · HybridSearchService.java Hybrid search · ConversationMemoryService.java Conversation memory · LLMClient.java LLM clients
Components 31
User experience
- Vue application
frontend/src/App.vue - Chat and history
frontend/src/views/chat - Frontend API clients
frontend/src/service/api - Chat endpoint
src/main/java/com/smartrag/controller/ChatController.java
Conversation intelligence
- Chat handler
src/main/java/com/smartrag/service/ChatHandler.java - Intent router
src/main/java/com/smartrag/agent/RouterAgent.java - CRAG correction
src/main/java/com/smartrag/agent/CorrectiveRagAgent.java - ReAct orchestrator
src/main/java/com/smartrag/agent/AgentOrchestrator.java - Agent tools
src/main/java/com/smartrag/agent/tools
Knowledge pipeline
- Hybrid search
src/main/java/com/smartrag/service/HybridSearchService.java - Document management
src/main/java/com/smartrag/service/DocumentService.java - Chunked upload
src/main/java/com/smartrag/service/UploadService.java - File processing
src/main/java/com/smartrag/consumer/FileProcessingConsumer.java - Document parsing
src/main/java/com/smartrag/service/ParseService.java - Vectorization
src/main/java/com/smartrag/service/VectorizationService.java - Search index
src/main/java/com/smartrag/service/ElasticsearchService.java
Memory and quality
- Conversation memory
src/main/java/com/smartrag/service/ConversationMemoryService.java - Entity memory
src/main/java/com/smartrag/service/EntityMemoryService.java - RAGAS evaluation
src/main/java/com/smartrag/evaluation/EvaluationService.java
Platform services
- WebSocket updates
src/main/java/com/smartrag/handler/ChatWebSocketHandler.java - LLM clients
src/main/java/com/smartrag/client/LLMClient.java - Embedding API client
src/main/java/com/smartrag/client/EmbeddingClient.java - Authentication
src/main/java/com/smartrag/utils/JwtUtils.java - MySQL data
src/main/java/com/smartrag/repository - Redis cache
src/main/java/com/smartrag/repository/RedisRepository.java - Kafka queue
- MinIO storage
- Elasticsearch
Other components
- User
- LLM provider
- Web search
Connections 37
- User → Vue application: uses
README.md - Vue application → Chat and history: renders
frontend/src/App.vue - Chat and history → Frontend API clients: requests
- Frontend API clients → Chat endpoint: calls
- Chat endpoint → Chat handler: dispatches
- Chat handler → Intent router: routes intent
- Intent router → LLM clients: classifies with
src/main/java/com/smartrag/agent/RouterAgent.java - Intent router → Redis cache: caches decisions
src/main/java/com/smartrag/agent/RouterAgent.java - Chat handler → CRAG correction: corrects retrieval
README.md - Chat handler → ReAct orchestrator: starts reasoning
README.md - ReAct orchestrator → Agent tools: dispatches actions
README.md - Agent tools → Hybrid search: searches knowledge
README.md - Hybrid search → Embedding API client: creates vectors
src/main/java/com/smartrag/service/HybridSearchService.java - Hybrid search → Elasticsearch: hybrid queries
README.md - Hybrid search → MySQL data: loads permissions
src/main/java/com/smartrag/service/HybridSearchService.java - CRAG correction → Hybrid search: retries search
README.md - CRAG correction → Web search: falls back
README.md - ReAct orchestrator → LLM clients: reasons with
README.md - Chat handler → Conversation memory: uses history
README.md - Conversation memory → Entity memory: recalls entities
src/main/java/com/smartrag/service/ConversationMemoryService.java - Conversation memory → LLM clients: compresses history
src/main/java/com/smartrag/service/ConversationMemoryService.java - Conversation memory → MySQL data: persists summaries
src/main/java/com/smartrag/service/ConversationMemoryService.java - Chat handler → RAGAS evaluation: evaluates answers
README.md - RAGAS evaluation → MySQL data: stores scores
src/main/java/com/smartrag/evaluation/EvaluationService.java - RAGAS evaluation → WebSocket updates: pushes scores
src/main/java/com/smartrag/evaluation/EvaluationService.java - Chat handler → WebSocket updates: streams responses
README.md - User → Chunked upload: submits files
README.md - Chunked upload → Kafka queue: queues processing
README.md - Kafka queue → File processing: delivers tasks
README.md - File processing → Document parsing: parses files
README.md - Document parsing → Vectorization: chunks and vectorizes
README.md - Vectorization → Embedding API client: requests embeddings
README.md - Vectorization → Search index: indexes chunks
README.md - Search index → Elasticsearch: writes index
src/main/java/com/smartrag/service/ElasticsearchService.java - Document management → MinIO storage: stores files
README.md - Chat endpoint → Authentication: validates access
README.md - LLM clients → LLM provider: sends prompts
README.md