How akash-sharma8/vectorlens-interactive-vector-search-document-q-a works
This is a full-stack local vector-search and RAG application. Users register or sign in, then search and benchmark a persistent demo vector collection, manage text/PDF documents, retrieve cited passages, and ask Ollama to generate answers. The API coordinates authentication, retrieval, persistence, and AI calls; the shared core provides vector indexes and distance metrics. The graph preserves the documented PCA visualization and separate document-search stage. Some routes and integrations are represented from README or import-index evidence because their source was not excerpted.
Main entry points: app.ts API routes · hnsw.ts HNSW index · Dashboard.tsx Dashboard · vector-db.ts Demo vector index
Components 26
Web interface
- Web app
apps/web/app/layout.tsx - Auth gate
apps/web/components/AuthGate.tsx - Dashboard
apps/web/components/Dashboard.tsx - Chat panel
apps/web/components/ChatPanel.tsx - PCA plot
apps/web/components/ScatterPlot.tsx - API client
apps/web/components/api.ts
API and identity
- API routes
apps/api/src/app.ts - Authentication
apps/api/src/auth.ts - Request context
apps/api/src/request-context.ts - PostgreSQL
apps/api/src/database.ts - Demo vector storage
apps/api/src/vector-repository.ts
Documents and RAG
- Chat orchestration
apps/api/src/chats.ts - PDF extraction
apps/api/src/pdf.ts - Chunk preparation
apps/api/src/document-chunks.ts - Document storage and search
apps/api/src/document-repository.ts - Ollama adapter
apps/api/src/ollama.ts
Vector engine
- Demo vector index
packages/core/src/vector-db.ts - Document index
packages/core/src/document-db.ts - HNSW index
packages/core/src/hnsw.ts - KD-tree index
packages/core/src/kd-tree.ts - Brute-force search
packages/core/src/brute-force.ts - Distance metrics
packages/core/src/distance.ts - Search heap
packages/core/src/heap.ts - PCA projection
packages/core/src/pca.ts
Other components
- User
- Ollama service
Connections 35
- User → Web app: uses
- Web app → Auth gate: renders
- Auth gate → API client: requests auth
apps/web/components/AuthGate.tsx - Auth gate → Dashboard: renders
apps/web/components/AuthGate.tsx - Dashboard → API client: requests data
apps/web/components/Dashboard.tsx - Dashboard → Chat panel: renders
apps/web/components/Dashboard.tsx - Dashboard → PCA plot: renders
apps/web/components/Dashboard.tsx - API client → API routes: calls API
- API routes → Authentication: installs routes
apps/api/src/app.ts - API routes → Chat orchestration: installs routes
apps/api/src/app.ts - API routes → Request context: sets user scope
apps/api/src/app.ts - Authentication → PostgreSQL: uses
apps/api/src/auth.ts - Chat orchestration → Document storage and search: retrieves passages
apps/api/src/chats.ts - Chat orchestration → Ollama adapter: generates answers
apps/api/src/chats.ts - API routes → PDF extraction: extracts uploads
apps/api/src/app.ts - API routes → Chunk preparation: prepares text
apps/api/src/app.ts - API routes → Document storage and search: stores and searches
apps/api/src/app.ts - Document storage and search → PostgreSQL: reads and writes
apps/api/src/document-repository.ts - API routes → Ollama adapter: embeds and checks
apps/api/src/app.ts - Ollama adapter → Ollama service: sends model requests
apps/api/src/ollama.ts - API routes → Demo vector storage: loads vectors
apps/api/src/app.ts - Demo vector storage → PostgreSQL: reads and writes
apps/api/src/vector-repository.ts - API routes → Demo vector index: searches and benchmarks
apps/api/src/app.ts - API routes → Document index: searches in memory
apps/api/src/app.ts - Demo vector index → HNSW index: dispatches search
packages/core/src/vector-db.ts - Demo vector index → KD-tree index: dispatches search
packages/core/src/vector-db.ts - Demo vector index → Brute-force search: dispatches search
packages/core/src/vector-db.ts - Document index → HNSW index: uses index
packages/core/src/document-db.ts - Document index → Brute-force search: uses index
packages/core/src/document-db.ts - HNSW index → Distance metrics: measures distance
packages/core/src/hnsw.ts - HNSW index → Search heap: uses candidates
packages/core/src/hnsw.ts - HNSW index → Brute-force search: compares neighbors
packages/core/src/hnsw.ts - KD-tree index → Distance metrics: measures distance
packages/core/src/kd-tree.ts - KD-tree index → Search heap: uses candidates
packages/core/src/kd-tree.ts - PCA plot → PCA projection: projects vectors
apps/web/components/ScatterPlot.tsx