How skpradhan-repo/enterprise-rag works
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: IngestionPipeline.java Ingestion pipeline · RagOrchestrator.java RAG orchestration · client.ts API client · App.tsx Web app routes
Components 25
User experience
- Web app routes
frontend/src/App.tsx - RAG chat UI
frontend/src/components/ChatWindow.tsx - Document UI
frontend/src/pages/DocumentsPage.tsx - LLM demo UI
frontend/src/pages/LlmDemoPage.tsx - API client
frontend/src/api/client.ts - Spring API
src/main/java/com/enterprise/rag/api/controller/ChatController.java - Conversation history
src/main/java/com/enterprise/rag/conversation/service/ConversationService.java
Identity and access
- Frontend auth
frontend/src/auth/AuthProvider.tsx - RAG authorization
src/main/java/com/enterprise/rag/security/authorization/RagAuthorizationService.java
Document ingestion
- Document API
src/main/java/com/enterprise/rag/api/controller/DocumentController.java - Document management
src/main/java/com/enterprise/rag/document/service/DocumentService.java - Ingestion pipeline
src/main/java/com/enterprise/rag/rag/ingestion/IngestionPipeline.java - Extraction and normalization
src/main/java/com/enterprise/rag/rag/ingestion/DocumentExtractor.java - Chunking
src/main/java/com/enterprise/rag/rag/chunking/ChunkingService.java - Document records
src/main/java/com/enterprise/rag/document/repository/DocumentRepository.java
RAG and AI
- PGVector
- Embedding service
src/main/java/com/enterprise/rag/ai/embedding/EmbeddingService.java - RAG orchestration
src/main/java/com/enterprise/rag/rag/orchestration/RagOrchestrator.java - Tenant-scoped retrieval
src/main/java/com/enterprise/rag/rag/retrieval/RetrievalService.java
Enterprise services
- Authorized MCP tools
src/main/java/com/enterprise/rag/mcp/server/tools/SearchKnowledgeTool.java - AI audit trail
src/main/java/com/enterprise/rag/audit/service/AuditService.java - Prometheus metrics
src/main/java/com/enterprise/rag/observability/RagMetrics.java
Other components
- User
- Keycloak
- Ollama LLM
Connections 28
- User → Web app routes: uses
README.md - Web app routes → RAG chat UI: routes to
frontend/src/App.tsx - Web app routes → Document UI: routes to
frontend/src/App.tsx - Web app routes → LLM demo UI: routes to
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
frontend/src/auth/AuthProvider.tsx - API client → Keycloak: attaches bearer token
frontend/src/api/client.ts - API client → Spring API: sends API requests
- Spring API → RAG orchestration: dispatches RAG query
README.md - Document API → Document management: delegates
src/main/java/com/enterprise/rag/api/controller/DocumentController.java - Document management → Document records: persists metadata
src/main/java/com/enterprise/rag/document/service/DocumentService.java - Document management → Ingestion pipeline: schedules after commit
src/main/java/com/enterprise/rag/document/service/DocumentService.java - Ingestion pipeline → Extraction and normalization: extracts text
src/main/java/com/enterprise/rag/rag/ingestion/IngestionPipeline.java - Ingestion pipeline → Chunking: chunks text
src/main/java/com/enterprise/rag/rag/ingestion/IngestionPipeline.java - Ingestion pipeline → Document records: updates records
src/main/java/com/enterprise/rag/rag/ingestion/IngestionPipeline.java - Ingestion pipeline → PGVector: stores embedded chunks
src/main/java/com/enterprise/rag/rag/ingestion/IngestionPipeline.java - Ingestion pipeline → Embedding service: embeds content
README.md - RAG orchestration → Tenant-scoped retrieval: retrieves context
README.md - Tenant-scoped retrieval → PGVector: searches vectors
src/main/java/com/enterprise/rag/rag/retrieval/RetrievalService.java - Tenant-scoped retrieval → RAG authorization: builds tenant filter
src/main/java/com/enterprise/rag/rag/retrieval/RetrievalService.java - RAG orchestration → Ollama LLM: generates answer
README.md - LLM demo UI → Ollama LLM: invokes via API
README.md - Spring API → Conversation history: manages chat history
README.md - Authorized MCP tools → RAG authorization: checks access
src/main/java/com/enterprise/rag/security/authorization/RagAuthorizationService.java - RAG orchestration → AI audit trail: records AI operations
README.md - RAG orchestration → Prometheus metrics: reports metrics
README.md