How atharvpatil322/qna-rag-application works
This is a multi-user document Q&A product: users authenticate, upload PDFs, and ask contextual questions; admins can inspect and rebuild the vector index. The frontend provides chat, document, account, and settings surfaces, while the FastAPI backend coordinates processing, retrieval, persistence, and inference. Document upload has an explicitly streamed progress path, and chat passes through a controller to its service. The README documents the broader RAG, storage, and recovery capabilities; unsampled implementation links are shown only when supported by that documentation.
Main entry points: App.tsx Web application · document_service.py Document service · main.py FastAPI application · upload_routes.py Upload routes
Components 28
Web client
- Web application
frontend/src/App.tsx - Authentication screens
frontend/src/pages/auth - Chat experience
frontend/src/components/chat/ChatInterface.tsx - Document screens
frontend/src/components/documents - Account and settings
frontend/src/pages - API client
frontend/src/lib/api.ts
API and workflows
- FastAPI application
server/main.py - Auth routes
server/app/routes/auth_routes.py - Auth controller
server/app/controllers/auth_controller.py - Upload routes
server/app/routes/upload_routes.py - Upload controller
server/app/controllers/upload_controller.py - Chat routes
server/app/routes/chat_routes.py - Chat controller
server/app/controllers/chat_controller.py - User service
server/app/services/user_service.py
Document and RAG
- Document service
server/app/services/document_service.py - PDF processing
server/app/utils/document_processor.py - Chat service
server/app/services/chat_service.py - LLM providers
server/app/llm/providers.py - Vector search
server/app/db/milvus_vector_store.py
Persistence and identity
- PostgreSQL
server/app/db/postgres.py - MongoDB
server/app/db/mongodb.py - Authentication service
server/app/services/auth_service.py - JWT and passwords
server/app/utils/auth.py
Administration
- Vector recovery
server/app/services/vector_rebuild_service.py - Admin vector controller
server/app/controllers/admin_vector_controller.py - Progress events
server/app/utils/sse.py
Other components
- User
- Administrator
Connections 33
- User → Web application: uses
- Administrator → Web application: manages
- Web application → Authentication screens: routes
frontend/src/App.tsx - Web application → Chat experience: routes
- Web application → Document screens: routes
- Web application → Account and settings: routes
frontend/src/App.tsx - Web application → API client: calls
- API client → FastAPI application: sends requests
- FastAPI application → Auth routes: registers routes
server/main.py - FastAPI application → Upload routes: registers routes
server/main.py - FastAPI application → Chat routes: registers routes
server/main.py - Auth routes → Auth controller: dispatches
- Auth controller → Authentication service: delegates
server/app/controllers/auth_controller.py - Authentication service → PostgreSQL: reads and writes
server/app/services/auth_service.py - Authentication service → JWT and passwords: uses
server/app/services/auth_service.py - Auth controller → User service: delegates
- Upload routes → Document service: processes upload
server/app/routes/upload_routes.py - Upload routes → Upload controller: dispatches
server/app/routes/upload_routes.py - Upload routes → Progress events: streams events
server/app/routes/upload_routes.py - Document service → PDF processing: extracts and chunks
server/app/services/document_service.py - Document service → Vector search: stores embeddings
server/app/services/document_service.py - Document service → MongoDB: stores documents
server/app/services/document_service.py - Document service → PostgreSQL: stores metadata
server/app/services/document_service.py - Chat routes → Chat controller: dispatches
- Chat controller → Chat service: processes chat
server/app/controllers/chat_controller.py - Chat controller → Vector search: gets vector store
server/app/controllers/chat_controller.py - Chat service → Vector search: retrieves context
- Chat service → LLM providers: generates answers
- Chat service → MongoDB: stores conversations
- Admin vector controller → Vector recovery: rebuilds vectors
server/app/controllers/admin_vector_controller.py - Vector recovery → MongoDB: reads backup
server/app/services/vector_rebuild_service.py - Vector recovery → Vector search: restores index
server/app/services/vector_rebuild_service.py - Admin vector controller → Progress events: emits progress
server/app/controllers/admin_vector_controller.py