# midirushi/agentic-rag architecture

> Architecture diagram of the GitHub repository midirushi/agentic-rag, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/midirushi/agentic-rag
- Repository: https://github.com/midirushi/agentic-rag

## Overview

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: [`src/main/java/com/smartrag/service/ChatHandler.java`](https://github.com/midirushi/agentic-rag/blob/main/src/main/java/com/smartrag/service/ChatHandler.java) (Chat handler), [`src/main/java/com/smartrag/service/HybridSearchService.java`](https://github.com/midirushi/agentic-rag/blob/main/src/main/java/com/smartrag/service/HybridSearchService.java) (Hybrid search), [`src/main/java/com/smartrag/service/ConversationMemoryService.java`](https://github.com/midirushi/agentic-rag/blob/main/src/main/java/com/smartrag/service/ConversationMemoryService.java) (Conversation memory), [`src/main/java/com/smartrag/client/LLMClient.java`](https://github.com/midirushi/agentic-rag/blob/main/src/main/java/com/smartrag/client/LLMClient.java) (LLM clients)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["User experience"]
  node_webapp["Vue application<br/>[App.vue]"]
  node_chat_views["Chat and history"]
  node_frontend_api["Frontend API clients"]
  node_chat_api["Chat endpoint"]
end

subgraph group_conversation["Conversation intelligence"]
  node_chat_handler["Chat handler<br/>[ChatHandler.java]"]
  node_router["Intent router<br/>[RouterAgent.java]"]
  node_corrective["CRAG correction"]
  node_orchestrator["ReAct orchestrator"]
  node_tools["Agent tools"]
end

subgraph group_knowledge["Knowledge pipeline"]
  node_hybrid_search["Hybrid search"]
  node_documents["Document management"]
  node_upload["Chunked upload<br/>[UploadService.java]"]
  node_file_worker["File processing"]
  node_parse["Document parsing<br/>[ParseService.java]"]
  node_vectorize["Vectorization"]
  node_es_index[("Search index")]
end

subgraph group_memory_quality["Memory and quality"]
  node_memory["Conversation memory"]
  node_entity_memory["Entity memory"]
  node_evaluation["RAGAS evaluation"]
end

subgraph group_platform["Platform services"]
  node_websocket["WebSocket updates"]
  node_llm["LLM clients<br/>[LLMClient.java]"]
  node_embedding["Embedding API client"]
  node_auth["Authentication<br/>[JwtUtils.java]"]
  node_mysql[("MySQL data")]
  node_redis[("Redis cache")]
  node_kafka["Kafka queue"]
  node_minio[("MinIO storage")]
  node_elasticsearch[("Elasticsearch")]
end

node_user(("User"))
node_external_llm(("LLM provider"))
node_external_web(("Web search"))

node_user -->|"uses"| node_webapp
node_webapp -->|"renders"| node_chat_views
node_chat_views -.->|"requests"| node_frontend_api
node_frontend_api -.->|"calls"| node_chat_api
node_chat_api -.->|"dispatches"| node_chat_handler
node_chat_handler -.->|"routes intent"| node_router
node_router -->|"classifies with"| node_llm
node_router -->|"caches decisions"| node_redis
node_chat_handler -.->|"corrects retrieval"| node_corrective
node_chat_handler -.->|"starts reasoning"| node_orchestrator
node_orchestrator -.->|"dispatches actions"| node_tools
node_tools -.->|"searches knowledge"| node_hybrid_search
node_hybrid_search -->|"creates vectors"| node_embedding
node_hybrid_search -->|"hybrid queries"| node_elasticsearch
node_hybrid_search -->|"loads permissions"| node_mysql
node_corrective -.->|"retries search"| node_hybrid_search
node_corrective -.->|"falls back"| node_external_web
node_orchestrator -.->|"reasons with"| node_llm
node_chat_handler -.->|"uses history"| node_memory
node_memory -->|"recalls entities"| node_entity_memory
node_memory -->|"compresses history"| node_llm
node_memory -->|"persists summaries"| node_mysql
node_chat_handler -.->|"evaluates answers"| node_evaluation
node_evaluation -->|"stores scores"| node_mysql
node_evaluation -->|"pushes scores"| node_websocket
node_chat_handler -.->|"streams responses"| node_websocket
node_user -.->|"submits files"| node_upload
node_upload -.->|"queues processing"| node_kafka
node_kafka -.->|"delivers tasks"| node_file_worker
node_file_worker -.->|"parses files"| node_parse
node_parse -.->|"chunks and vectorizes"| node_vectorize
node_vectorize -.->|"requests embeddings"| node_embedding
node_vectorize -.->|"indexes chunks"| node_es_index
node_es_index -->|"writes index"| node_elasticsearch
node_documents -.->|"stores files"| node_minio
node_chat_api -.->|"validates access"| node_auth
node_llm -.->|"sends prompts"| node_external_llm

click node_webapp "https://github.com/midirushi/agentic-rag/blob/main/frontend/src/App.vue"
click node_chat_views "https://github.com/midirushi/agentic-rag/tree/main/frontend/src/views/chat"
click node_frontend_api "https://github.com/midirushi/agentic-rag/tree/main/frontend/src/service/api"
click node_chat_api "https://github.com/midirushi/agentic-rag/blob/main/src/main/java/com/smartrag/controller/ChatController.java"
click node_chat_handler "https://github.com/midirushi/agentic-rag/blob/main/src/main/java/com/smartrag/service/ChatHandler.java"
click node_router "https://github.com/midirushi/agentic-rag/blob/main/src/main/java/com/smartrag/agent/RouterAgent.java"
click node_corrective "https://github.com/midirushi/agentic-rag/blob/main/src/main/java/com/smartrag/agent/CorrectiveRagAgent.java"
click node_orchestrator "https://github.com/midirushi/agentic-rag/blob/main/src/main/java/com/smartrag/agent/AgentOrchestrator.java"
click node_tools "https://github.com/midirushi/agentic-rag/tree/main/src/main/java/com/smartrag/agent/tools"
click node_hybrid_search "https://github.com/midirushi/agentic-rag/blob/main/src/main/java/com/smartrag/service/HybridSearchService.java"
click node_documents "https://github.com/midirushi/agentic-rag/blob/main/src/main/java/com/smartrag/service/DocumentService.java"
click node_upload "https://github.com/midirushi/agentic-rag/blob/main/src/main/java/com/smartrag/service/UploadService.java"
click node_file_worker "https://github.com/midirushi/agentic-rag/blob/main/src/main/java/com/smartrag/consumer/FileProcessingConsumer.java"
click node_parse "https://github.com/midirushi/agentic-rag/blob/main/src/main/java/com/smartrag/service/ParseService.java"
click node_vectorize "https://github.com/midirushi/agentic-rag/blob/main/src/main/java/com/smartrag/service/VectorizationService.java"
click node_es_index "https://github.com/midirushi/agentic-rag/blob/main/src/main/java/com/smartrag/service/ElasticsearchService.java"
click node_memory "https://github.com/midirushi/agentic-rag/blob/main/src/main/java/com/smartrag/service/ConversationMemoryService.java"
click node_entity_memory "https://github.com/midirushi/agentic-rag/blob/main/src/main/java/com/smartrag/service/EntityMemoryService.java"
click node_evaluation "https://github.com/midirushi/agentic-rag/blob/main/src/main/java/com/smartrag/evaluation/EvaluationService.java"
click node_websocket "https://github.com/midirushi/agentic-rag/blob/main/src/main/java/com/smartrag/handler/ChatWebSocketHandler.java"
click node_llm "https://github.com/midirushi/agentic-rag/blob/main/src/main/java/com/smartrag/client/LLMClient.java"
click node_embedding "https://github.com/midirushi/agentic-rag/blob/main/src/main/java/com/smartrag/client/EmbeddingClient.java"
click node_auth "https://github.com/midirushi/agentic-rag/blob/main/src/main/java/com/smartrag/utils/JwtUtils.java"
click node_mysql "https://github.com/midirushi/agentic-rag/tree/main/src/main/java/com/smartrag/repository"
click node_redis "https://github.com/midirushi/agentic-rag/blob/main/src/main/java/com/smartrag/repository/RedisRepository.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_webapp,node_chat_views,node_frontend_api,node_chat_api,node_user toneBlue
class node_chat_handler,node_router,node_corrective,node_orchestrator,node_tools toneAmber
class node_hybrid_search,node_documents,node_upload,node_file_worker,node_parse,node_vectorize,node_es_index toneMint
class node_memory,node_entity_memory,node_evaluation toneRose
class node_websocket,node_llm,node_embedding,node_auth,node_mysql,node_redis,node_kafka,node_minio,node_elasticsearch,node_external_llm,node_external_web toneIndigo
```

## Components

### User experience

- [Vue application](https://github.com/midirushi/agentic-rag/blob/main/frontend/src/App.vue): `frontend/src/App.vue`
- [Chat and history](https://github.com/midirushi/agentic-rag/tree/main/frontend/src/views/chat): `frontend/src/views/chat`
- [Frontend API clients](https://github.com/midirushi/agentic-rag/tree/main/frontend/src/service/api): `frontend/src/service/api`
- [Chat endpoint](https://github.com/midirushi/agentic-rag/blob/main/src/main/java/com/smartrag/controller/ChatController.java): `src/main/java/com/smartrag/controller/ChatController.java`

### Conversation intelligence

- [Chat handler](https://github.com/midirushi/agentic-rag/blob/main/src/main/java/com/smartrag/service/ChatHandler.java): `src/main/java/com/smartrag/service/ChatHandler.java`
- [Intent router](https://github.com/midirushi/agentic-rag/blob/main/src/main/java/com/smartrag/agent/RouterAgent.java): `src/main/java/com/smartrag/agent/RouterAgent.java`
- [CRAG correction](https://github.com/midirushi/agentic-rag/blob/main/src/main/java/com/smartrag/agent/CorrectiveRagAgent.java): `src/main/java/com/smartrag/agent/CorrectiveRagAgent.java`
- [ReAct orchestrator](https://github.com/midirushi/agentic-rag/blob/main/src/main/java/com/smartrag/agent/AgentOrchestrator.java): `src/main/java/com/smartrag/agent/AgentOrchestrator.java`
- [Agent tools](https://github.com/midirushi/agentic-rag/tree/main/src/main/java/com/smartrag/agent/tools): `src/main/java/com/smartrag/agent/tools`

### Knowledge pipeline

- [Hybrid search](https://github.com/midirushi/agentic-rag/blob/main/src/main/java/com/smartrag/service/HybridSearchService.java): `src/main/java/com/smartrag/service/HybridSearchService.java`
- [Document management](https://github.com/midirushi/agentic-rag/blob/main/src/main/java/com/smartrag/service/DocumentService.java): `src/main/java/com/smartrag/service/DocumentService.java`
- [Chunked upload](https://github.com/midirushi/agentic-rag/blob/main/src/main/java/com/smartrag/service/UploadService.java): `src/main/java/com/smartrag/service/UploadService.java`
- [File processing](https://github.com/midirushi/agentic-rag/blob/main/src/main/java/com/smartrag/consumer/FileProcessingConsumer.java): `src/main/java/com/smartrag/consumer/FileProcessingConsumer.java`
- [Document parsing](https://github.com/midirushi/agentic-rag/blob/main/src/main/java/com/smartrag/service/ParseService.java): `src/main/java/com/smartrag/service/ParseService.java`
- [Vectorization](https://github.com/midirushi/agentic-rag/blob/main/src/main/java/com/smartrag/service/VectorizationService.java): `src/main/java/com/smartrag/service/VectorizationService.java`
- [Search index](https://github.com/midirushi/agentic-rag/blob/main/src/main/java/com/smartrag/service/ElasticsearchService.java): `src/main/java/com/smartrag/service/ElasticsearchService.java`

### Memory and quality

- [Conversation memory](https://github.com/midirushi/agentic-rag/blob/main/src/main/java/com/smartrag/service/ConversationMemoryService.java): `src/main/java/com/smartrag/service/ConversationMemoryService.java`
- [Entity memory](https://github.com/midirushi/agentic-rag/blob/main/src/main/java/com/smartrag/service/EntityMemoryService.java): `src/main/java/com/smartrag/service/EntityMemoryService.java`
- [RAGAS evaluation](https://github.com/midirushi/agentic-rag/blob/main/src/main/java/com/smartrag/evaluation/EvaluationService.java): `src/main/java/com/smartrag/evaluation/EvaluationService.java`

### Platform services

- [WebSocket updates](https://github.com/midirushi/agentic-rag/blob/main/src/main/java/com/smartrag/handler/ChatWebSocketHandler.java): `src/main/java/com/smartrag/handler/ChatWebSocketHandler.java`
- [LLM clients](https://github.com/midirushi/agentic-rag/blob/main/src/main/java/com/smartrag/client/LLMClient.java): `src/main/java/com/smartrag/client/LLMClient.java`
- [Embedding API client](https://github.com/midirushi/agentic-rag/blob/main/src/main/java/com/smartrag/client/EmbeddingClient.java): `src/main/java/com/smartrag/client/EmbeddingClient.java`
- [Authentication](https://github.com/midirushi/agentic-rag/blob/main/src/main/java/com/smartrag/utils/JwtUtils.java): `src/main/java/com/smartrag/utils/JwtUtils.java`
- [MySQL data](https://github.com/midirushi/agentic-rag/tree/main/src/main/java/com/smartrag/repository): `src/main/java/com/smartrag/repository`
- [Redis cache](https://github.com/midirushi/agentic-rag/blob/main/src/main/java/com/smartrag/repository/RedisRepository.java): `src/main/java/com/smartrag/repository/RedisRepository.java`
- **Kafka queue**
- **MinIO storage**
- **Elasticsearch**

### Other components

- **User**
- **LLM provider**
- **Web search**

## Connections

- User → Vue application: uses (evidence: `README.md`)
- Vue application → Chat and history: renders (evidence: `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 (evidence: `src/main/java/com/smartrag/agent/RouterAgent.java`)
- Intent router → Redis cache: caches decisions (evidence: `src/main/java/com/smartrag/agent/RouterAgent.java`)
- Chat handler → CRAG correction: corrects retrieval (evidence: `README.md`)
- Chat handler → ReAct orchestrator: starts reasoning (evidence: `README.md`)
- ReAct orchestrator → Agent tools: dispatches actions (evidence: `README.md`)
- Agent tools → Hybrid search: searches knowledge (evidence: `README.md`)
- Hybrid search → Embedding API client: creates vectors (evidence: `src/main/java/com/smartrag/service/HybridSearchService.java`)
- Hybrid search → Elasticsearch: hybrid queries (evidence: `README.md`)
- Hybrid search → MySQL data: loads permissions (evidence: `src/main/java/com/smartrag/service/HybridSearchService.java`)
- CRAG correction → Hybrid search: retries search (evidence: `README.md`)
- CRAG correction → Web search: falls back (evidence: `README.md`)
- ReAct orchestrator → LLM clients: reasons with (evidence: `README.md`)
- Chat handler → Conversation memory: uses history (evidence: `README.md`)
- Conversation memory → Entity memory: recalls entities (evidence: `src/main/java/com/smartrag/service/ConversationMemoryService.java`)
- Conversation memory → LLM clients: compresses history (evidence: `src/main/java/com/smartrag/service/ConversationMemoryService.java`)
- Conversation memory → MySQL data: persists summaries (evidence: `src/main/java/com/smartrag/service/ConversationMemoryService.java`)
- Chat handler → RAGAS evaluation: evaluates answers (evidence: `README.md`)
- RAGAS evaluation → MySQL data: stores scores (evidence: `src/main/java/com/smartrag/evaluation/EvaluationService.java`)
- RAGAS evaluation → WebSocket updates: pushes scores (evidence: `src/main/java/com/smartrag/evaluation/EvaluationService.java`)
- Chat handler → WebSocket updates: streams responses (evidence: `README.md`)
- User → Chunked upload: submits files (evidence: `README.md`)
- Chunked upload → Kafka queue: queues processing (evidence: `README.md`)
- Kafka queue → File processing: delivers tasks (evidence: `README.md`)
- File processing → Document parsing: parses files (evidence: `README.md`)
- Document parsing → Vectorization: chunks and vectorizes (evidence: `README.md`)
- Vectorization → Embedding API client: requests embeddings (evidence: `README.md`)
- Vectorization → Search index: indexes chunks (evidence: `README.md`)
- Search index → Elasticsearch: writes index (evidence: `src/main/java/com/smartrag/service/ElasticsearchService.java`)
- Document management → MinIO storage: stores files (evidence: `README.md`)
- Chat endpoint → Authentication: validates access (evidence: `README.md`)
- LLM clients → LLM provider: sends prompts (evidence: `README.md`)
