# madhu-maneesh/vectorvault architecture

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

- Interactive diagram: https://gitdiagram.com/madhu-maneesh/vectorvault
- Repository: https://github.com/madhu-maneesh/vectorvault

## Overview

VectorVault is a document-question-answering RAG application. A user selects a PDF in the React interface, uploads it through the backend API, and later asks questions in chat. The backend parses and splits the PDF, embeds its text into Pinecone, then embeds each question, retrieves similar chunks, and asks Gemini to answer from that context. The README documents these capabilities; the sampled service shows the implementation, though its chunk sizes differ from those stated in the README. Chat requests from the UI are documented, but their fetch call was not visible in the excerpt.

Main entry points: [`backend/src/main/java/com/vectorvault/docqa/Service/ChatService.java`](https://github.com/madhu-maneesh/vectorvault/blob/main/backend/src/main/java/com/vectorvault/docqa/Service/ChatService.java) (Chat service), [`frontend/vectorvault/src/components/Homepage.jsx`](https://github.com/madhu-maneesh/vectorvault/blob/main/frontend/vectorvault/src/components/Homepage.jsx) (Upload and chat UI), [`backend/src/main/java/com/vectorvault/docqa/Controller/ChatController.java`](https://github.com/madhu-maneesh/vectorvault/blob/main/backend/src/main/java/com/vectorvault/docqa/Controller/ChatController.java) (Chat API), [`backend/src/main/java/com/vectorvault/docqa/Configurations/Googleconfig.java`](https://github.com/madhu-maneesh/vectorvault/blob/main/backend/src/main/java/com/vectorvault/docqa/Configurations/Googleconfig.java) (Gemini chat model)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Frontend"]
  node_ui["Upload and chat UI<br/>[Homepage.jsx]"]
  node_app["App shell<br/>[App.jsx]"]
end

subgraph group_api["API"]
  node_controller["Chat API"]
  node_service["Chat service<br/>[ChatService.java]"]
end

subgraph group_ingest["Document ingestion"]
  node_pdf["PDF parsing<br/>[ChatService.java]"]
  node_split["Text splitting<br/>[ChatService.java]"]
end

subgraph group_rag["Retrieval and answers"]
  node_embedding["Embedding models<br/>[ChatService.java]"]
  node_pinecone[("Vector store<br/>[ChatService.java]")]
  node_gemini["Gemini chat model<br/>[Googleconfig.java]"]
end

node_user(("User"))
node_google{{"Google Gemini"}}

node_user -->|"uses"| node_ui
node_app -->|"renders"| node_ui
node_ui -->|"uploads PDF"| node_controller
node_ui -.->|"asks question"| node_controller
node_controller -->|"delegates to"| node_service
node_service -->|"parses PDF"| node_pdf
node_service -->|"splits text"| node_split
node_service -->|"embeds text"| node_embedding
node_service -->|"stores vectors"| node_pinecone
node_service -->|"embeds query"| node_embedding
node_service -->|"searches vectors"| node_pinecone
node_service -->|"generates answer"| node_gemini
node_gemini -.->|"calls model"| node_google
node_embedding -.->|"creates embeddings"| node_google

click node_ui "https://github.com/madhu-maneesh/vectorvault/blob/main/frontend/vectorvault/src/components/Homepage.jsx"
click node_app "https://github.com/madhu-maneesh/vectorvault/blob/main/frontend/vectorvault/src/App.jsx"
click node_controller "https://github.com/madhu-maneesh/vectorvault/blob/main/backend/src/main/java/com/vectorvault/docqa/Controller/ChatController.java"
click node_service "https://github.com/madhu-maneesh/vectorvault/blob/main/backend/src/main/java/com/vectorvault/docqa/Service/ChatService.java"
click node_pdf "https://github.com/madhu-maneesh/vectorvault/blob/main/backend/src/main/java/com/vectorvault/docqa/Service/ChatService.java"
click node_split "https://github.com/madhu-maneesh/vectorvault/blob/main/backend/src/main/java/com/vectorvault/docqa/Service/ChatService.java"
click node_embedding "https://github.com/madhu-maneesh/vectorvault/blob/main/backend/src/main/java/com/vectorvault/docqa/Service/ChatService.java"
click node_pinecone "https://github.com/madhu-maneesh/vectorvault/blob/main/backend/src/main/java/com/vectorvault/docqa/Service/ChatService.java"
click node_gemini "https://github.com/madhu-maneesh/vectorvault/blob/main/backend/src/main/java/com/vectorvault/docqa/Configurations/Googleconfig.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_ui,node_app,node_user toneBlue
class node_controller,node_service toneAmber
class node_pdf,node_split toneMint
class node_embedding,node_pinecone,node_gemini toneRose
class node_google toneIndigo
```

## Components

### Frontend

- [Upload and chat UI](https://github.com/madhu-maneesh/vectorvault/blob/main/frontend/vectorvault/src/components/Homepage.jsx): `frontend/vectorvault/src/components/Homepage.jsx`
- [App shell](https://github.com/madhu-maneesh/vectorvault/blob/main/frontend/vectorvault/src/App.jsx): `frontend/vectorvault/src/App.jsx`

### API

- [Chat API](https://github.com/madhu-maneesh/vectorvault/blob/main/backend/src/main/java/com/vectorvault/docqa/Controller/ChatController.java): `backend/src/main/java/com/vectorvault/docqa/Controller/ChatController.java`
- [Chat service](https://github.com/madhu-maneesh/vectorvault/blob/main/backend/src/main/java/com/vectorvault/docqa/Service/ChatService.java): `backend/src/main/java/com/vectorvault/docqa/Service/ChatService.java`

### Document ingestion

- [PDF parsing](https://github.com/madhu-maneesh/vectorvault/blob/main/backend/src/main/java/com/vectorvault/docqa/Service/ChatService.java): `backend/src/main/java/com/vectorvault/docqa/Service/ChatService.java`
- [Text splitting](https://github.com/madhu-maneesh/vectorvault/blob/main/backend/src/main/java/com/vectorvault/docqa/Service/ChatService.java): `backend/src/main/java/com/vectorvault/docqa/Service/ChatService.java`

### Retrieval and answers

- [Embedding models](https://github.com/madhu-maneesh/vectorvault/blob/main/backend/src/main/java/com/vectorvault/docqa/Service/ChatService.java): `backend/src/main/java/com/vectorvault/docqa/Service/ChatService.java`
- [Vector store](https://github.com/madhu-maneesh/vectorvault/blob/main/backend/src/main/java/com/vectorvault/docqa/Service/ChatService.java): `backend/src/main/java/com/vectorvault/docqa/Service/ChatService.java`
- [Gemini chat model](https://github.com/madhu-maneesh/vectorvault/blob/main/backend/src/main/java/com/vectorvault/docqa/Configurations/Googleconfig.java): `backend/src/main/java/com/vectorvault/docqa/Configurations/Googleconfig.java`

### Other components

- **User**
- **Google Gemini**

## Connections

- User → Upload and chat UI: uses (evidence: `README.md`)
- App shell → Upload and chat UI: renders (evidence: `frontend/vectorvault/src/App.jsx`)
- Upload and chat UI → Chat API: uploads PDF (evidence: `frontend/vectorvault/src/components/Homepage.jsx`)
- Upload and chat UI → Chat API: asks question
- Chat API → Chat service: delegates to (evidence: `backend/src/main/java/com/vectorvault/docqa/Controller/ChatController.java`)
- Chat service → PDF parsing: parses PDF (evidence: `backend/src/main/java/com/vectorvault/docqa/Service/ChatService.java`)
- Chat service → Text splitting: splits text (evidence: `backend/src/main/java/com/vectorvault/docqa/Service/ChatService.java`)
- Chat service → Embedding models: embeds text (evidence: `backend/src/main/java/com/vectorvault/docqa/Service/ChatService.java`)
- Chat service → Vector store: stores vectors (evidence: `backend/src/main/java/com/vectorvault/docqa/Service/ChatService.java`)
- Chat service → Embedding models: embeds query (evidence: `backend/src/main/java/com/vectorvault/docqa/Service/ChatService.java`)
- Chat service → Vector store: searches vectors (evidence: `backend/src/main/java/com/vectorvault/docqa/Service/ChatService.java`)
- Chat service → Gemini chat model: generates answer (evidence: `backend/src/main/java/com/vectorvault/docqa/Service/ChatService.java`)
- Gemini chat model → Google Gemini: calls model
- Embedding models → Google Gemini: creates embeddings
