amitksoftech/rag-mvp1

Purpose and Runtime

This is a Java/Spring Boot RAG MVP for uploading knowledge documents, storing their metadata and files, asynchronously ingesting content into a vector store, and presenting document/admin views. The application starts at src/main/java/com/ai/applications/rag/ragmvp1/Ragmvp1Application.java; Maven build/runtime dependencies are defined in pom.xml.

HTTP and Server-rendered UI

Spring MVC controllers expose the primary interaction surfaces: home/login, document upload/list/detail, and administrative operations. Server-rendered Thymeleaf-style templates form the UI rather than a separate frontend.

• src/main/java/com/ai/applications/rag/ragmvp1/controller/DocumentController.java

• src/main/java/com/ai/applications/rag/ragmvp1/controller/AdminController.java

• src/main/resources/templates/documents/upload.html

Document Lifecycle and Persistent Metadata

DocumentService coordinates document-facing lifecycle operations, while DocumentStorageService manages physical uploaded files. StoredDocument, status models, and KnowledgeDocument represent lifecycle/state and persisted knowledge-document metadata. Files are presently rooted under the repository’s data/uploads directory.

• src/main/java/com/ai/applications/rag/ragmvp1/service/DocumentService.java

• src/main/java/com/ai/applications/rag/ragmvp1/service/DocumentStorageService.java

• src/main/java/com/ai/applications/rag/ragmvp1/models/entity/KnowledgeDocument.java

Event-driven Asynchronous Ingestion

Upload completion is decoupled from processing through DocumentUploadedEvent. IngestionEventListener receives the event and delegates to IngestionProcessor; async execution is configured separately. This boundary lets upload requests persist/return independently of extraction, chunking, embedding, and index status transitions.

• src/main/java/com/ai/applications/rag/ragmvp1/models/DocumentUploadedEvent.java

• src/main/java/com/ai/applications/rag/ragmvp1/service/IngestionEventListener.java

• src/main/java/com/ai/applications/rag/ragmvp1/config/AsyncConfiguration.java

RAG Indexing Boundary

IngestionProcessor is the ingestion orchestration stage and EmbeddingIndexer is the explicit embedding/vector-index adapter boundary. Embedding and vector-store beans/properties are isolated in configuration, allowing provider or backing-store changes without restructuring controllers or document persistence.

• src/main/java/com/ai/applications/rag/ragmvp1/service/IngestionProcessor.java

• src/main/java/com/ai/applications/rag/ragmvp1/service/EmbeddingIndexer.java

• src/main/java/com/ai/applications/rag/ragmvp1/config/EmbeddingConfiguration.java

• src/main/java/com/ai/applications/rag/ragmvp1/config/VectorStoreConfiguration.java

Database, Security, and Administration

Spring Data repositories persist users and knowledge documents. Security authenticates against database users through a custom user-details service and configuration. Administrative document operations and ingestion statistics are surfaced through dedicated services/controller and template.

• src/main/java/com/ai/applications/rag/ragmvp1/repository/KnowledgeDocumentRepository.java

• src/main/java/com/ai/applications/rag/ragmvp1/security/SecurityConfiguration.java

• src/main/java/com/ai/applications/rag/ragmvp1/service/StatisticsService.java

Configuration and Infrastructure

Application properties define the operational wiring; typed storage/bootstrap properties support configurable startup and file-storage behavior. Material infrastructure consists of Spring Boot’s web, async, security, persistence, local file storage, embedding provider, and vector-store integration; exact providers are not inferable from the supplied tree.

• src/main/resources/application.yml

• src/main/java/com/ai/applications/rag/ragmvp1/config/StorageConfiguration.java

• src/main/java/com/ai/applications/rag/ragmvp1/config/BootstrapProperties.java