# keerti1010/documind-ai architecture

> Architecture diagram of the GitHub repository keerti1010/documind-ai, 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/keerti1010/documind-ai
- Repository: https://github.com/keerti1010/documind-ai

## Overview

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: [`backend/controllers/documentController.js`](https://github.com/keerti1010/documind-ai/blob/main/backend/controllers/documentController.js) (Document controller), [`backend/server.js`](https://github.com/keerti1010/documind-ai/blob/main/backend/server.js) (Express server), [`backend/middleware/authMiddleware.js`](https://github.com/keerti1010/documind-ai/blob/main/backend/middleware/authMiddleware.js) (Token verification), [`frontend/src/App.tsx`](https://github.com/keerti1010/documind-ai/blob/main/frontend/src/App.tsx) (React app)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["User interface"]
  node_web["React app<br/>[App.tsx]"]
  node_auth_ui["Authentication UI<br/>[AuthContext.tsx]"]
  node_doc_ui["Document library<br/>[Documents.tsx]"]
  node_chat_ui["Assistant and history<br/>[Assistant.tsx]"]
  node_api_client["HTTP client<br/>[api.ts]"]
  node_auth_service["Auth service<br/>[auth.ts]"]
  node_doc_service["Document service<br/>[documents.ts]"]
  node_conversation_service["Conversation service<br/>[conversations.ts]"]
end

subgraph group_api["Backend API"]
  node_server["Express server<br/>[server.js]"]
  node_auth_routes["Auth routes<br/>[authRoutes.js]"]
  node_auth_controller["Auth controller<br/>[authController.js]"]
  node_auth_middleware["Token verification<br/>[authMiddleware.js]"]
  node_document_routes["Document routes<br/>[documentRoutes.js]"]
  node_conversation_routes["Conversation routes"]
  node_conversation_controller["Conversation management"]
  node_message_routes["Message routes<br/>[messageRoutes.js]"]
  node_message_controller["Message controller"]
end

subgraph group_documents["Document processing"]
  node_document_controller["Document controller"]
  node_pdf_extract["PDF extraction"]
  node_ocr["OCR fallback<br/>[ocrService.js]"]
  node_visual_extract["Visual extraction"]
  node_rag["Chunk retrieval and answers<br/>[ragService.js]"]
end

subgraph group_persistence["Data and AI"]
  node_supabase[("Supabase")]
  node_gemini["Google Gemini"]
end

node_user(("User"))

node_user -->|"uses"| node_web
node_web -->|"provides"| node_auth_ui
node_web -->|"provides"| node_doc_ui
node_web -->|"provides"| node_chat_ui
node_auth_ui -->|"uses"| node_auth_service
node_auth_service -->|"uses"| node_api_client
node_doc_ui -.->|"uses"| node_doc_service
node_chat_ui -.->|"uses"| node_conversation_service
node_doc_service -.->|"uses"| node_api_client
node_conversation_service -.->|"uses"| node_api_client
node_api_client -->|"sends API requests"| node_server
node_server -->|"mounts"| node_auth_routes
node_server -->|"mounts"| node_document_routes
node_server -->|"mounts"| node_conversation_routes
node_server -->|"mounts"| node_message_routes
node_auth_routes -->|"dispatches"| node_auth_controller
node_auth_routes -->|"protects"| node_auth_middleware
node_auth_controller -->|"authenticates users"| node_supabase
node_auth_middleware -->|"verifies token"| node_supabase
node_document_routes -->|"dispatches"| node_document_controller
node_document_routes -->|"protects"| node_auth_middleware
node_document_controller -->|"extracts and chunks"| node_pdf_extract
node_document_controller -->|"calls"| node_ocr
node_document_controller -->|"calls"| node_visual_extract
node_document_controller -->|"stores files and chunks"| node_supabase
node_document_controller -->|"generates document answer"| node_rag
node_ocr -->|"uses OCR"| node_gemini
node_visual_extract -->|"uses visual extraction"| node_gemini
node_conversation_routes -->|"dispatches"| node_conversation_controller
node_conversation_routes -->|"protects"| node_auth_middleware
node_conversation_controller -->|"persists conversations"| node_supabase
node_message_routes -->|"dispatches"| node_message_controller
node_message_routes -->|"protects"| node_auth_middleware
node_message_controller -->|"requests answer"| node_rag
node_message_controller -->|"persists messages"| node_supabase
node_rag -->|"reads document chunks"| node_supabase
node_rag -->|"generates response"| node_gemini

click node_web "https://github.com/keerti1010/documind-ai/blob/main/frontend/src/App.tsx"
click node_auth_ui "https://github.com/keerti1010/documind-ai/blob/main/frontend/src/context/AuthContext.tsx"
click node_doc_ui "https://github.com/keerti1010/documind-ai/blob/main/frontend/src/pages/Documents.tsx"
click node_chat_ui "https://github.com/keerti1010/documind-ai/blob/main/frontend/src/pages/Assistant.tsx"
click node_api_client "https://github.com/keerti1010/documind-ai/blob/main/frontend/src/services/api.ts"
click node_auth_service "https://github.com/keerti1010/documind-ai/blob/main/frontend/src/services/auth.ts"
click node_doc_service "https://github.com/keerti1010/documind-ai/blob/main/frontend/src/services/documents.ts"
click node_conversation_service "https://github.com/keerti1010/documind-ai/blob/main/frontend/src/services/conversations.ts"
click node_server "https://github.com/keerti1010/documind-ai/blob/main/backend/server.js"
click node_auth_routes "https://github.com/keerti1010/documind-ai/blob/main/backend/routes/authRoutes.js"
click node_auth_controller "https://github.com/keerti1010/documind-ai/blob/main/backend/controllers/authController.js"
click node_auth_middleware "https://github.com/keerti1010/documind-ai/blob/main/backend/middleware/authMiddleware.js"
click node_document_routes "https://github.com/keerti1010/documind-ai/blob/main/backend/routes/documentRoutes.js"
click node_document_controller "https://github.com/keerti1010/documind-ai/blob/main/backend/controllers/documentController.js"
click node_pdf_extract "https://github.com/keerti1010/documind-ai/blob/main/backend/controllers/documentController.js"
click node_ocr "https://github.com/keerti1010/documind-ai/blob/main/backend/services/ocrService.js"
click node_visual_extract "https://github.com/keerti1010/documind-ai/blob/main/backend/services/visualExtraction.js"
click node_rag "https://github.com/keerti1010/documind-ai/blob/main/backend/services/ragService.js"
click node_conversation_routes "https://github.com/keerti1010/documind-ai/blob/main/backend/routes/conversationRoutes.js"
click node_conversation_controller "https://github.com/keerti1010/documind-ai/blob/main/backend/controllers/conversationController.js"
click node_message_routes "https://github.com/keerti1010/documind-ai/blob/main/backend/routes/messageRoutes.js"
click node_message_controller "https://github.com/keerti1010/documind-ai/blob/main/backend/controllers/messageController.js"

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_web,node_auth_ui,node_doc_ui,node_chat_ui,node_api_client,node_auth_service,node_doc_service,node_conversation_service,node_user toneBlue
class node_server,node_auth_routes,node_auth_controller,node_auth_middleware,node_document_routes,node_conversation_routes,node_conversation_controller,node_message_routes,node_message_controller toneAmber
class node_document_controller,node_pdf_extract,node_ocr,node_visual_extract,node_rag toneMint
class node_supabase,node_gemini toneRose
```

## Components

### User interface

- [React app](https://github.com/keerti1010/documind-ai/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Authentication UI](https://github.com/keerti1010/documind-ai/blob/main/frontend/src/context/AuthContext.tsx): `frontend/src/context/AuthContext.tsx`
- [Document library](https://github.com/keerti1010/documind-ai/blob/main/frontend/src/pages/Documents.tsx): `frontend/src/pages/Documents.tsx`
- [Assistant and history](https://github.com/keerti1010/documind-ai/blob/main/frontend/src/pages/Assistant.tsx): `frontend/src/pages/Assistant.tsx`
- [HTTP client](https://github.com/keerti1010/documind-ai/blob/main/frontend/src/services/api.ts): `frontend/src/services/api.ts`
- [Auth service](https://github.com/keerti1010/documind-ai/blob/main/frontend/src/services/auth.ts): `frontend/src/services/auth.ts`
- [Document service](https://github.com/keerti1010/documind-ai/blob/main/frontend/src/services/documents.ts): `frontend/src/services/documents.ts`
- [Conversation service](https://github.com/keerti1010/documind-ai/blob/main/frontend/src/services/conversations.ts): `frontend/src/services/conversations.ts`

### Backend API

- [Express server](https://github.com/keerti1010/documind-ai/blob/main/backend/server.js): `backend/server.js`
- [Auth routes](https://github.com/keerti1010/documind-ai/blob/main/backend/routes/authRoutes.js): `backend/routes/authRoutes.js`
- [Auth controller](https://github.com/keerti1010/documind-ai/blob/main/backend/controllers/authController.js): `backend/controllers/authController.js`
- [Token verification](https://github.com/keerti1010/documind-ai/blob/main/backend/middleware/authMiddleware.js): `backend/middleware/authMiddleware.js`
- [Document routes](https://github.com/keerti1010/documind-ai/blob/main/backend/routes/documentRoutes.js): `backend/routes/documentRoutes.js`
- [Conversation routes](https://github.com/keerti1010/documind-ai/blob/main/backend/routes/conversationRoutes.js): `backend/routes/conversationRoutes.js`
- [Conversation management](https://github.com/keerti1010/documind-ai/blob/main/backend/controllers/conversationController.js): `backend/controllers/conversationController.js`
- [Message routes](https://github.com/keerti1010/documind-ai/blob/main/backend/routes/messageRoutes.js): `backend/routes/messageRoutes.js`
- [Message controller](https://github.com/keerti1010/documind-ai/blob/main/backend/controllers/messageController.js): `backend/controllers/messageController.js`

### Document processing

- [Document controller](https://github.com/keerti1010/documind-ai/blob/main/backend/controllers/documentController.js): `backend/controllers/documentController.js`
- [PDF extraction](https://github.com/keerti1010/documind-ai/blob/main/backend/controllers/documentController.js): `backend/controllers/documentController.js`
- [OCR fallback](https://github.com/keerti1010/documind-ai/blob/main/backend/services/ocrService.js): `backend/services/ocrService.js`
- [Visual extraction](https://github.com/keerti1010/documind-ai/blob/main/backend/services/visualExtraction.js): `backend/services/visualExtraction.js`
- [Chunk retrieval and answers](https://github.com/keerti1010/documind-ai/blob/main/backend/services/ragService.js): `backend/services/ragService.js`

### Data and AI

- **Supabase**
- **Google Gemini**

### Other components

- **User**

## Connections

- User → React app: uses (evidence: `README.md`)
- React app → Authentication UI: provides (evidence: `README.md`)
- React app → Document library: provides (evidence: `README.md`)
- React app → Assistant and history: provides (evidence: `README.md`)
- Authentication UI → Auth service: uses (evidence: `frontend/src/context/AuthContext.tsx`)
- Auth service → HTTP client: uses (evidence: `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 (evidence: `README.md`)
- Express server → Auth routes: mounts (evidence: `backend/server.js`)
- Express server → Document routes: mounts (evidence: `backend/server.js`)
- Express server → Conversation routes: mounts (evidence: `backend/server.js`)
- Express server → Message routes: mounts (evidence: `backend/server.js`)
- Auth routes → Auth controller: dispatches (evidence: `backend/routes/authRoutes.js`)
- Auth routes → Token verification: protects (evidence: `backend/routes/authRoutes.js`)
- Auth controller → Supabase: authenticates users (evidence: `backend/controllers/authController.js`)
- Token verification → Supabase: verifies token (evidence: `backend/middleware/authMiddleware.js`)
- Document routes → Document controller: dispatches (evidence: `backend/routes/documentRoutes.js`)
- Document routes → Token verification: protects (evidence: `backend/routes/documentRoutes.js`)
- Document controller → PDF extraction: extracts and chunks (evidence: `backend/controllers/documentController.js`)
- Document controller → OCR fallback: calls (evidence: `backend/controllers/documentController.js`)
- Document controller → Visual extraction: calls (evidence: `backend/controllers/documentController.js`)
- Document controller → Supabase: stores files and chunks (evidence: `backend/controllers/documentController.js`)
- Document controller → Chunk retrieval and answers: generates document answer (evidence: `backend/controllers/documentController.js`)
- OCR fallback → Google Gemini: uses OCR (evidence: `README.md`)
- Visual extraction → Google Gemini: uses visual extraction (evidence: `README.md`)
- Conversation routes → Conversation management: dispatches (evidence: `backend/routes/conversationRoutes.js`)
- Conversation routes → Token verification: protects (evidence: `backend/routes/conversationRoutes.js`)
- Conversation management → Supabase: persists conversations (evidence: `backend/controllers/conversationController.js`)
- Message routes → Message controller: dispatches (evidence: `backend/routes/messageRoutes.js`)
- Message routes → Token verification: protects (evidence: `backend/routes/messageRoutes.js`)
- Message controller → Chunk retrieval and answers: requests answer (evidence: `backend/controllers/messageController.js`)
- Message controller → Supabase: persists messages (evidence: `backend/controllers/messageController.js`)
- Chunk retrieval and answers → Supabase: reads document chunks (evidence: `backend/services/ragService.js`)
- Chunk retrieval and answers → Google Gemini: generates response (evidence: `README.md`)
