How keerti1010/documind-ai works
DocuMind AI lets users upload PDFs and ask document-grounded questions, then browse persistent conversations and source references. The main path runs from the React interface through the Express API into PDF extraction, chunk storage, retrieval, and Gemini answer generation. Authentication, document-library operations, and conversation history are supporting capabilities. Backend control-flow edges follow the sampled routes and controllers; broader frontend and integration links rely on README descriptions because their implementation files were not sampled.
Main entry points: documentController.js Document controller · server.js Express server · authMiddleware.js Token verification · App.tsx React app
Components 25
User interface
- React app
frontend/src/App.tsx - Authentication UI
frontend/src/context/AuthContext.tsx - Document library
frontend/src/pages/Documents.tsx - Assistant and history
frontend/src/pages/Assistant.tsx - HTTP client
frontend/src/services/api.ts - Auth service
frontend/src/services/auth.ts - Document service
frontend/src/services/documents.ts - Conversation service
frontend/src/services/conversations.ts
Backend API
- Express server
backend/server.js - Auth routes
backend/routes/authRoutes.js - Auth controller
backend/controllers/authController.js - Token verification
backend/middleware/authMiddleware.js - Document routes
backend/routes/documentRoutes.js - Conversation routes
backend/routes/conversationRoutes.js - Conversation management
backend/controllers/conversationController.js - Message routes
backend/routes/messageRoutes.js - Message controller
backend/controllers/messageController.js
Document processing
- Document controller
backend/controllers/documentController.js - PDF extraction
backend/controllers/documentController.js - OCR fallback
backend/services/ocrService.js - Visual extraction
backend/services/visualExtraction.js - Chunk retrieval and answers
backend/services/ragService.js
Data and AI
- Supabase
- Google Gemini
Other components
- User
Connections 37
- User → React app: uses
README.md - React app → Authentication UI: provides
README.md - React app → Document library: provides
README.md - React app → Assistant and history: provides
README.md - Authentication UI → Auth service: uses
frontend/src/context/AuthContext.tsx - Auth service → HTTP client: uses
frontend/src/services/auth.ts - Document library → Document service: uses
- Assistant and history → Conversation service: uses
- Document service → HTTP client: uses
- Conversation service → HTTP client: uses
- HTTP client → Express server: sends API requests
README.md - Express server → Auth routes: mounts
backend/server.js - Express server → Document routes: mounts
backend/server.js - Express server → Conversation routes: mounts
backend/server.js - Express server → Message routes: mounts
backend/server.js - Auth routes → Auth controller: dispatches
backend/routes/authRoutes.js - Auth routes → Token verification: protects
backend/routes/authRoutes.js - Auth controller → Supabase: authenticates users
backend/controllers/authController.js - Token verification → Supabase: verifies token
backend/middleware/authMiddleware.js - Document routes → Document controller: dispatches
backend/routes/documentRoutes.js - Document routes → Token verification: protects
backend/routes/documentRoutes.js - Document controller → PDF extraction: extracts and chunks
backend/controllers/documentController.js - Document controller → OCR fallback: calls
backend/controllers/documentController.js - Document controller → Visual extraction: calls
backend/controllers/documentController.js - Document controller → Supabase: stores files and chunks
backend/controllers/documentController.js - Document controller → Chunk retrieval and answers: generates document answer
backend/controllers/documentController.js - OCR fallback → Google Gemini: uses OCR
README.md - Visual extraction → Google Gemini: uses visual extraction
README.md - Conversation routes → Conversation management: dispatches
backend/routes/conversationRoutes.js - Conversation routes → Token verification: protects
backend/routes/conversationRoutes.js - Conversation management → Supabase: persists conversations
backend/controllers/conversationController.js - Message routes → Message controller: dispatches
backend/routes/messageRoutes.js - Message routes → Token verification: protects
backend/routes/messageRoutes.js - Message controller → Chunk retrieval and answers: requests answer
backend/controllers/messageController.js - Message controller → Supabase: persists messages
backend/controllers/messageController.js - Chunk retrieval and answers → Supabase: reads document chunks
backend/services/ragService.js - Chunk retrieval and answers → Google Gemini: generates response
README.md