# sanju1098/rag-chatbot architecture

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

- Interactive diagram: https://gitdiagram.com/sanju1098/rag-chatbot
- Repository: https://github.com/sanju1098/rag-chatbot

## Overview

AstraMind is a shared-library PDF question-answering app. Users upload PDFs for extraction, chunking, embedding, and storage; they then ask questions in chat, where retrieval selects relevant passages before Gemini streams an answer. The upload and retrieval paths are supported by the README and source-index references; unsampled internals are represented only at documented stages. The graph also includes document listing/deletion and the landing-page entry point, but omits presentation-only and legal pages.

Main entry points: [`src/app/upload/actions.ts`](https://github.com/sanju1098/rag-chatbot/blob/master/src/app/upload/actions.ts) (Upload actions), [`src/lib/search.ts`](https://github.com/sanju1098/rag-chatbot/blob/master/src/lib/search.ts) (Vector retrieval), [`src/app/api/chat/route.ts`](https://github.com/sanju1098/rag-chatbot/blob/master/src/app/api/chat/route.ts) (Chat API), [`src/lib/embeddings.ts`](https://github.com/sanju1098/rag-chatbot/blob/master/src/lib/embeddings.ts) (Embedding generation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web experience"]
  node_home["Landing page<br/>[page.tsx]"]
  node_upload_ui["Upload and library<br/>[page.tsx]"]
  node_chat_ui["Chat interface<br/>[page.tsx]"]
end

subgraph group_ingest["PDF ingestion"]
  node_upload_actions["Upload actions<br/>[actions.ts]"]
  node_pdf_parse["PDF extraction<br/>[pdf-utils.ts]"]
  node_chunking["Text chunking<br/>[chunking.ts]"]
end

subgraph group_rag["Chat and retrieval"]
  node_chat_route["Chat API<br/>[route.ts]"]
  node_search["Vector retrieval<br/>[search.ts]"]
end

subgraph group_data["Persistence and AI"]
  node_embedding["Embedding generation<br/>[embeddings.ts]"]
  node_db_config["Database connection<br/>[db-config.ts]"]
  node_schema["Document schema<br/>[db-schema.ts]"]
  node_neon[("Neon vector store")]
end

node_visitor(("User"))
node_gemini{{"Google Gemini"}}

node_visitor -->|"opens"| node_home
node_visitor -->|"uploads PDF"| node_upload_ui
node_visitor -->|"asks questions"| node_chat_ui
node_upload_ui -->|"submits and manages"| node_upload_actions
node_upload_actions -->|"extracts text"| node_pdf_parse
node_upload_actions -->|"chunks text"| node_chunking
node_upload_actions -->|"embeds chunks"| node_embedding
node_upload_actions -->|"stores documents"| node_neon
node_upload_actions -->|"uses schema"| node_schema
node_embedding -->|"requests embeddings"| node_gemini
node_chat_ui -->|"sends chat"| node_chat_route
node_chat_route -->|"retrieves passages"| node_search
node_search -->|"embeds query"| node_embedding
node_search -->|"matches vectors"| node_neon
node_search -->|"queries documents"| node_schema
node_chat_route -->|"streams answer"| node_gemini
node_db_config -->|"connects"| node_neon

click node_home "https://github.com/sanju1098/rag-chatbot/blob/master/src/app/page.tsx"
click node_upload_ui "https://github.com/sanju1098/rag-chatbot/blob/master/src/app/upload/page.tsx"
click node_chat_ui "https://github.com/sanju1098/rag-chatbot/blob/master/src/app/chat/page.tsx"
click node_upload_actions "https://github.com/sanju1098/rag-chatbot/blob/master/src/app/upload/actions.ts"
click node_pdf_parse "https://github.com/sanju1098/rag-chatbot/blob/master/src/lib/pdf-utils.ts"
click node_chunking "https://github.com/sanju1098/rag-chatbot/blob/master/src/lib/chunking.ts"
click node_embedding "https://github.com/sanju1098/rag-chatbot/blob/master/src/lib/embeddings.ts"
click node_chat_route "https://github.com/sanju1098/rag-chatbot/blob/master/src/app/api/chat/route.ts"
click node_search "https://github.com/sanju1098/rag-chatbot/blob/master/src/lib/search.ts"
click node_db_config "https://github.com/sanju1098/rag-chatbot/blob/master/src/lib/db-config.ts"
click node_schema "https://github.com/sanju1098/rag-chatbot/blob/master/src/lib/db-schema.ts"

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_home,node_upload_ui,node_chat_ui,node_visitor toneBlue
class node_upload_actions,node_pdf_parse,node_chunking toneAmber
class node_chat_route,node_search toneMint
class node_embedding,node_db_config,node_schema,node_neon toneRose
class node_gemini toneIndigo
```

## Components

### Web experience

- [Landing page](https://github.com/sanju1098/rag-chatbot/blob/master/src/app/page.tsx): `src/app/page.tsx`
- [Upload and library](https://github.com/sanju1098/rag-chatbot/blob/master/src/app/upload/page.tsx): `src/app/upload/page.tsx`
- [Chat interface](https://github.com/sanju1098/rag-chatbot/blob/master/src/app/chat/page.tsx): `src/app/chat/page.tsx`

### PDF ingestion

- [Upload actions](https://github.com/sanju1098/rag-chatbot/blob/master/src/app/upload/actions.ts): `src/app/upload/actions.ts`
- [PDF extraction](https://github.com/sanju1098/rag-chatbot/blob/master/src/lib/pdf-utils.ts): `src/lib/pdf-utils.ts`
- [Text chunking](https://github.com/sanju1098/rag-chatbot/blob/master/src/lib/chunking.ts): `src/lib/chunking.ts`

### Chat and retrieval

- [Chat API](https://github.com/sanju1098/rag-chatbot/blob/master/src/app/api/chat/route.ts): `src/app/api/chat/route.ts`
- [Vector retrieval](https://github.com/sanju1098/rag-chatbot/blob/master/src/lib/search.ts): `src/lib/search.ts`

### Persistence and AI

- [Embedding generation](https://github.com/sanju1098/rag-chatbot/blob/master/src/lib/embeddings.ts): `src/lib/embeddings.ts`
- [Database connection](https://github.com/sanju1098/rag-chatbot/blob/master/src/lib/db-config.ts): `src/lib/db-config.ts`
- [Document schema](https://github.com/sanju1098/rag-chatbot/blob/master/src/lib/db-schema.ts): `src/lib/db-schema.ts`
- **Neon vector store**

### Other components

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

## Connections

- User → Landing page: opens (evidence: `src/app/page.tsx`)
- User → Upload and library: uploads PDF (evidence: `README.md`)
- User → Chat interface: asks questions (evidence: `README.md`)
- Upload and library → Upload actions: submits and manages (evidence: `src/app/upload/page.tsx`)
- Upload actions → PDF extraction: extracts text (evidence: `src/app/upload/actions.ts`)
- Upload actions → Text chunking: chunks text (evidence: `src/app/upload/actions.ts`)
- Upload actions → Embedding generation: embeds chunks (evidence: `src/app/upload/actions.ts`)
- Upload actions → Neon vector store: stores documents (evidence: `README.md`)
- Upload actions → Document schema: uses schema (evidence: `src/app/upload/actions.ts`)
- Embedding generation → Google Gemini: requests embeddings (evidence: `README.md`)
- Chat interface → Chat API: sends chat (evidence: `README.md`)
- Chat API → Vector retrieval: retrieves passages (evidence: `src/app/api/chat/route.ts`)
- Vector retrieval → Embedding generation: embeds query (evidence: `src/lib/search.ts`)
- Vector retrieval → Neon vector store: matches vectors (evidence: `README.md`)
- Vector retrieval → Document schema: queries documents (evidence: `src/lib/search.ts`)
- Chat API → Google Gemini: streams answer (evidence: `README.md`)
- Database connection → Neon vector store: connects (evidence: `README.md`)
