# skpradhan-repo/enterprise-rag architecture

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

- Interactive diagram: https://gitdiagram.com/skpradhan-repo/enterprise-rag
- Repository: https://github.com/skpradhan-repo/enterprise-rag

## Overview

Enterprise RAG Platform is a multi-tenant document-grounded AI application. Users authenticate, upload documents for asynchronous extraction and indexing, then ask questions in RAG chat and receive answers with source references; a separate demo calls the LLM without retrieval. The graph also includes conversation history, MCP tools, audit, and observability as documented capabilities. Some backend routes and integrations were not excerpted, so those links are shown only where documented or left unverified.

Main entry points: [`src/main/java/com/enterprise/rag/rag/ingestion/IngestionPipeline.java`](https://github.com/skpradhan-repo/enterprise-rag/blob/master/src/main/java/com/enterprise/rag/rag/ingestion/IngestionPipeline.java) (Ingestion pipeline), [`src/main/java/com/enterprise/rag/rag/orchestration/RagOrchestrator.java`](https://github.com/skpradhan-repo/enterprise-rag/blob/master/src/main/java/com/enterprise/rag/rag/orchestration/RagOrchestrator.java) (RAG orchestration), [`frontend/src/api/client.ts`](https://github.com/skpradhan-repo/enterprise-rag/blob/master/frontend/src/api/client.ts) (API client), [`frontend/src/App.tsx`](https://github.com/skpradhan-repo/enterprise-rag/blob/master/frontend/src/App.tsx) (Web app routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["User experience"]
  node_webapp["Web app routes<br/>[App.tsx]"]
  node_chatui["RAG chat UI<br/>[ChatWindow.tsx]"]
  node_docui["Document UI<br/>[DocumentsPage.tsx]"]
  node_demoui["LLM demo UI<br/>[LlmDemoPage.tsx]"]
  node_apiclient["API client<br/>[client.ts]"]
  node_api["Spring API"]
  node_conversations["Conversation history"]
end

subgraph group_identity["Identity and access"]
  node_authui["Frontend auth<br/>[AuthProvider.tsx]"]
  node_authorization["RAG authorization"]
end

subgraph group_documents["Document ingestion"]
  node_documentapi["Document API"]
  node_documentservice["Document management"]
  node_ingestion["Ingestion pipeline"]
  node_extract["Extraction and normalization"]
  node_chunk["Chunking"]
  node_docdb[("Document records")]
end

subgraph group_rag["RAG and AI"]
  node_pgvector[("PGVector")]
  node_embedding["Embedding service"]
  node_orchestrator["RAG orchestration"]
  node_retrieval["Tenant-scoped retrieval"]
end

subgraph group_platform["Enterprise services"]
  node_mcp["Authorized MCP tools"]
  node_audit["AI audit trail<br/>[AuditService.java]"]
  node_metrics["Prometheus metrics<br/>[RagMetrics.java]"]
end

node_user(("User"))
node_keycloak{{"Keycloak"}}
node_ollama{{"Ollama LLM"}}

node_user -->|"uses"| node_webapp
node_webapp -->|"routes to"| node_chatui
node_webapp -->|"routes to"| node_docui
node_webapp -->|"routes to"| node_demoui
node_chatui -->|"requests through"| node_apiclient
node_docui -.->|"requests through"| node_apiclient
node_demoui -.->|"requests through"| node_apiclient
node_authui -->|"authenticates with"| node_keycloak
node_apiclient -->|"attaches bearer token"| node_keycloak
node_apiclient -.->|"sends API requests"| node_api
node_api -.->|"dispatches RAG query"| node_orchestrator
node_documentapi -->|"delegates"| node_documentservice
node_documentservice -->|"persists metadata"| node_docdb
node_documentservice -->|"schedules after commit"| node_ingestion
node_ingestion -->|"extracts text"| node_extract
node_ingestion -->|"chunks text"| node_chunk
node_ingestion -->|"updates records"| node_docdb
node_ingestion -->|"stores embedded chunks"| node_pgvector
node_ingestion -.->|"embeds content"| node_embedding
node_orchestrator -.->|"retrieves context"| node_retrieval
node_retrieval -->|"searches vectors"| node_pgvector
node_retrieval -->|"builds tenant filter"| node_authorization
node_orchestrator -.->|"generates answer"| node_ollama
node_demoui -.->|"invokes via API"| node_ollama
node_api -.->|"manages chat history"| node_conversations
node_mcp -.->|"checks access"| node_authorization
node_orchestrator -.->|"records AI operations"| node_audit
node_orchestrator -.->|"reports metrics"| node_metrics

click node_webapp "https://github.com/skpradhan-repo/enterprise-rag/blob/master/frontend/src/App.tsx"
click node_chatui "https://github.com/skpradhan-repo/enterprise-rag/blob/master/frontend/src/components/ChatWindow.tsx"
click node_docui "https://github.com/skpradhan-repo/enterprise-rag/blob/master/frontend/src/pages/DocumentsPage.tsx"
click node_demoui "https://github.com/skpradhan-repo/enterprise-rag/blob/master/frontend/src/pages/LlmDemoPage.tsx"
click node_apiclient "https://github.com/skpradhan-repo/enterprise-rag/blob/master/frontend/src/api/client.ts"
click node_authui "https://github.com/skpradhan-repo/enterprise-rag/blob/master/frontend/src/auth/AuthProvider.tsx"
click node_api "https://github.com/skpradhan-repo/enterprise-rag/blob/master/src/main/java/com/enterprise/rag/api/controller/ChatController.java"
click node_documentapi "https://github.com/skpradhan-repo/enterprise-rag/blob/master/src/main/java/com/enterprise/rag/api/controller/DocumentController.java"
click node_documentservice "https://github.com/skpradhan-repo/enterprise-rag/blob/master/src/main/java/com/enterprise/rag/document/service/DocumentService.java"
click node_ingestion "https://github.com/skpradhan-repo/enterprise-rag/blob/master/src/main/java/com/enterprise/rag/rag/ingestion/IngestionPipeline.java"
click node_extract "https://github.com/skpradhan-repo/enterprise-rag/blob/master/src/main/java/com/enterprise/rag/rag/ingestion/DocumentExtractor.java"
click node_chunk "https://github.com/skpradhan-repo/enterprise-rag/blob/master/src/main/java/com/enterprise/rag/rag/chunking/ChunkingService.java"
click node_docdb "https://github.com/skpradhan-repo/enterprise-rag/blob/master/src/main/java/com/enterprise/rag/document/repository/DocumentRepository.java"
click node_embedding "https://github.com/skpradhan-repo/enterprise-rag/blob/master/src/main/java/com/enterprise/rag/ai/embedding/EmbeddingService.java"
click node_orchestrator "https://github.com/skpradhan-repo/enterprise-rag/blob/master/src/main/java/com/enterprise/rag/rag/orchestration/RagOrchestrator.java"
click node_retrieval "https://github.com/skpradhan-repo/enterprise-rag/blob/master/src/main/java/com/enterprise/rag/rag/retrieval/RetrievalService.java"
click node_authorization "https://github.com/skpradhan-repo/enterprise-rag/blob/master/src/main/java/com/enterprise/rag/security/authorization/RagAuthorizationService.java"
click node_conversations "https://github.com/skpradhan-repo/enterprise-rag/blob/master/src/main/java/com/enterprise/rag/conversation/service/ConversationService.java"
click node_mcp "https://github.com/skpradhan-repo/enterprise-rag/blob/master/src/main/java/com/enterprise/rag/mcp/server/tools/SearchKnowledgeTool.java"
click node_audit "https://github.com/skpradhan-repo/enterprise-rag/blob/master/src/main/java/com/enterprise/rag/audit/service/AuditService.java"
click node_metrics "https://github.com/skpradhan-repo/enterprise-rag/blob/master/src/main/java/com/enterprise/rag/observability/RagMetrics.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_chatui,node_docui,node_demoui,node_apiclient,node_api,node_conversations,node_user toneBlue
class node_authui,node_authorization toneAmber
class node_documentapi,node_documentservice,node_ingestion,node_extract,node_chunk,node_docdb toneMint
class node_pgvector,node_embedding,node_orchestrator,node_retrieval toneRose
class node_mcp,node_audit,node_metrics,node_keycloak,node_ollama toneIndigo
```

## Components

### User experience

- [Web app routes](https://github.com/skpradhan-repo/enterprise-rag/blob/master/frontend/src/App.tsx): `frontend/src/App.tsx`
- [RAG chat UI](https://github.com/skpradhan-repo/enterprise-rag/blob/master/frontend/src/components/ChatWindow.tsx): `frontend/src/components/ChatWindow.tsx`
- [Document UI](https://github.com/skpradhan-repo/enterprise-rag/blob/master/frontend/src/pages/DocumentsPage.tsx): `frontend/src/pages/DocumentsPage.tsx`
- [LLM demo UI](https://github.com/skpradhan-repo/enterprise-rag/blob/master/frontend/src/pages/LlmDemoPage.tsx): `frontend/src/pages/LlmDemoPage.tsx`
- [API client](https://github.com/skpradhan-repo/enterprise-rag/blob/master/frontend/src/api/client.ts): `frontend/src/api/client.ts`
- [Spring API](https://github.com/skpradhan-repo/enterprise-rag/blob/master/src/main/java/com/enterprise/rag/api/controller/ChatController.java): `src/main/java/com/enterprise/rag/api/controller/ChatController.java`
- [Conversation history](https://github.com/skpradhan-repo/enterprise-rag/blob/master/src/main/java/com/enterprise/rag/conversation/service/ConversationService.java): `src/main/java/com/enterprise/rag/conversation/service/ConversationService.java`

### Identity and access

- [Frontend auth](https://github.com/skpradhan-repo/enterprise-rag/blob/master/frontend/src/auth/AuthProvider.tsx): `frontend/src/auth/AuthProvider.tsx`
- [RAG authorization](https://github.com/skpradhan-repo/enterprise-rag/blob/master/src/main/java/com/enterprise/rag/security/authorization/RagAuthorizationService.java): `src/main/java/com/enterprise/rag/security/authorization/RagAuthorizationService.java`

### Document ingestion

- [Document API](https://github.com/skpradhan-repo/enterprise-rag/blob/master/src/main/java/com/enterprise/rag/api/controller/DocumentController.java): `src/main/java/com/enterprise/rag/api/controller/DocumentController.java`
- [Document management](https://github.com/skpradhan-repo/enterprise-rag/blob/master/src/main/java/com/enterprise/rag/document/service/DocumentService.java): `src/main/java/com/enterprise/rag/document/service/DocumentService.java`
- [Ingestion pipeline](https://github.com/skpradhan-repo/enterprise-rag/blob/master/src/main/java/com/enterprise/rag/rag/ingestion/IngestionPipeline.java): `src/main/java/com/enterprise/rag/rag/ingestion/IngestionPipeline.java`
- [Extraction and normalization](https://github.com/skpradhan-repo/enterprise-rag/blob/master/src/main/java/com/enterprise/rag/rag/ingestion/DocumentExtractor.java): `src/main/java/com/enterprise/rag/rag/ingestion/DocumentExtractor.java`
- [Chunking](https://github.com/skpradhan-repo/enterprise-rag/blob/master/src/main/java/com/enterprise/rag/rag/chunking/ChunkingService.java): `src/main/java/com/enterprise/rag/rag/chunking/ChunkingService.java`
- [Document records](https://github.com/skpradhan-repo/enterprise-rag/blob/master/src/main/java/com/enterprise/rag/document/repository/DocumentRepository.java): `src/main/java/com/enterprise/rag/document/repository/DocumentRepository.java`

### RAG and AI

- **PGVector**
- [Embedding service](https://github.com/skpradhan-repo/enterprise-rag/blob/master/src/main/java/com/enterprise/rag/ai/embedding/EmbeddingService.java): `src/main/java/com/enterprise/rag/ai/embedding/EmbeddingService.java`
- [RAG orchestration](https://github.com/skpradhan-repo/enterprise-rag/blob/master/src/main/java/com/enterprise/rag/rag/orchestration/RagOrchestrator.java): `src/main/java/com/enterprise/rag/rag/orchestration/RagOrchestrator.java`
- [Tenant-scoped retrieval](https://github.com/skpradhan-repo/enterprise-rag/blob/master/src/main/java/com/enterprise/rag/rag/retrieval/RetrievalService.java): `src/main/java/com/enterprise/rag/rag/retrieval/RetrievalService.java`

### Enterprise services

- [Authorized MCP tools](https://github.com/skpradhan-repo/enterprise-rag/blob/master/src/main/java/com/enterprise/rag/mcp/server/tools/SearchKnowledgeTool.java): `src/main/java/com/enterprise/rag/mcp/server/tools/SearchKnowledgeTool.java`
- [AI audit trail](https://github.com/skpradhan-repo/enterprise-rag/blob/master/src/main/java/com/enterprise/rag/audit/service/AuditService.java): `src/main/java/com/enterprise/rag/audit/service/AuditService.java`
- [Prometheus metrics](https://github.com/skpradhan-repo/enterprise-rag/blob/master/src/main/java/com/enterprise/rag/observability/RagMetrics.java): `src/main/java/com/enterprise/rag/observability/RagMetrics.java`

### Other components

- **User**
- **Keycloak**
- **Ollama LLM**

## Connections

- User → Web app routes: uses (evidence: `README.md`)
- Web app routes → RAG chat UI: routes to (evidence: `frontend/src/App.tsx`)
- Web app routes → Document UI: routes to (evidence: `frontend/src/App.tsx`)
- Web app routes → LLM demo UI: routes to (evidence: `frontend/src/App.tsx`)
- RAG chat UI → API client: requests through
- Document UI → API client: requests through
- LLM demo UI → API client: requests through
- Frontend auth → Keycloak: authenticates with (evidence: `frontend/src/auth/AuthProvider.tsx`)
- API client → Keycloak: attaches bearer token (evidence: `frontend/src/api/client.ts`)
- API client → Spring API: sends API requests
- Spring API → RAG orchestration: dispatches RAG query (evidence: `README.md`)
- Document API → Document management: delegates (evidence: `src/main/java/com/enterprise/rag/api/controller/DocumentController.java`)
- Document management → Document records: persists metadata (evidence: `src/main/java/com/enterprise/rag/document/service/DocumentService.java`)
- Document management → Ingestion pipeline: schedules after commit (evidence: `src/main/java/com/enterprise/rag/document/service/DocumentService.java`)
- Ingestion pipeline → Extraction and normalization: extracts text (evidence: `src/main/java/com/enterprise/rag/rag/ingestion/IngestionPipeline.java`)
- Ingestion pipeline → Chunking: chunks text (evidence: `src/main/java/com/enterprise/rag/rag/ingestion/IngestionPipeline.java`)
- Ingestion pipeline → Document records: updates records (evidence: `src/main/java/com/enterprise/rag/rag/ingestion/IngestionPipeline.java`)
- Ingestion pipeline → PGVector: stores embedded chunks (evidence: `src/main/java/com/enterprise/rag/rag/ingestion/IngestionPipeline.java`)
- Ingestion pipeline → Embedding service: embeds content (evidence: `README.md`)
- RAG orchestration → Tenant-scoped retrieval: retrieves context (evidence: `README.md`)
- Tenant-scoped retrieval → PGVector: searches vectors (evidence: `src/main/java/com/enterprise/rag/rag/retrieval/RetrievalService.java`)
- Tenant-scoped retrieval → RAG authorization: builds tenant filter (evidence: `src/main/java/com/enterprise/rag/rag/retrieval/RetrievalService.java`)
- RAG orchestration → Ollama LLM: generates answer (evidence: `README.md`)
- LLM demo UI → Ollama LLM: invokes via API (evidence: `README.md`)
- Spring API → Conversation history: manages chat history (evidence: `README.md`)
- Authorized MCP tools → RAG authorization: checks access (evidence: `src/main/java/com/enterprise/rag/security/authorization/RagAuthorizationService.java`)
- RAG orchestration → AI audit trail: records AI operations (evidence: `README.md`)
- RAG orchestration → Prometheus metrics: reports metrics (evidence: `README.md`)
