# arunchandrasekar07/devmind architecture

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

- Interactive diagram: https://gitdiagram.com/arunchandrasekar07/devmind
- Repository: https://github.com/arunchandrasekar07/devmind

## Overview

DevMind is a repository-aware AI assistant. The main workflow is project setup and repository upload, followed by parsing, chunking, embedding and indexing; users then ask project-specific questions and receive context-grounded AI responses. Authentication, project management and analytics are supporting product stages. The graph reflects documented frontend-to-API flow and source-indexed backend relationships; frontend wiring and some backend internals were not excerpted, so uncertain links are omitted.

Main entry points: [`backend/app/main.py`](https://github.com/arunchandrasekar07/devmind/blob/main/backend/app/main.py) (FastAPI Application), [`backend/app/services/ingestion/pipeline.py`](https://github.com/arunchandrasekar07/devmind/blob/main/backend/app/services/ingestion/pipeline.py) (Ingestion Pipeline), [`backend/app/services/project_service.py`](https://github.com/arunchandrasekar07/devmind/blob/main/backend/app/services/project_service.py) (Project Service), [`frontend/src/app`](https://github.com/arunchandrasekar07/devmind/tree/main/frontend/src/app) (Next.js Interface)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["User Experience"]
  node_webapp["Next.js Interface"]
  node_project_ui["Project Workspace<br/>[page.tsx]"]
  node_upload_ui["Repository Upload<br/>[FileUploadZone.tsx]"]
  node_chat_ui["Chat Interface<br/>[page.tsx]"]
  node_voice["Voice Input<br/>[useVoiceInput.ts]"]
  node_analytics_ui["Analytics Dashboard<br/>[page.tsx]"]
  node_api_client["API Client<br/>[api.ts]"]
end

subgraph group_api["API and Identity"]
  node_fastapi["FastAPI Application<br/>[main.py]"]
  node_auth_routes["Authentication Routes<br/>[auth.py]"]
  node_auth_service["Authentication Service<br/>[auth_service.py]"]
  node_auth_middleware["Token Authentication<br/>[auth.py]"]
  node_project_routes["Project Routes<br/>[projects.py]"]
  node_document_routes["Document Routes<br/>[documents.py]"]
  node_chat_routes["Chat Routes<br/>[chat.py]"]
  node_project_service["Project Service<br/>[project_service.py]"]
end

subgraph group_indexing["Repository Indexing"]
  node_ingestion["Ingestion Pipeline<br/>[pipeline.py]"]
  node_parser["File Parsing<br/>[file_parser.py]"]
  node_chunker["Code Chunking<br/>[chunker.py]"]
end

subgraph group_intelligence["AI Answering"]
  node_embedder["Embedding Generation<br/>[embedder.py]"]
  node_rag["RAG Orchestrator<br/>[rag_pipeline.py]"]
  node_retriever["Semantic Retrieval<br/>[retriever.py]"]
  node_llm["Multi-Provider LLM<br/>[llm_client.py]"]
end

subgraph group_state["Persistent State"]
  node_database["Database Sessions<br/>[database.py]"]
  node_repository_store[("Repository and App Data<br/>[document.py]")]
  node_user_model[("User Records<br/>[user.py]")]
  node_project_model[("Project Records<br/>[project.py]")]
  node_chat_model[("Conversation Records<br/>[chat.py]")]
end

node_developer(("Developer"))
node_supabase_auth["Supabase Auth"]
node_llm_providers["LLM Providers"]

node_developer -->|"uses"| node_webapp
node_webapp -->|"calls API"| node_fastapi
node_webapp -.->|"opens workspace"| node_project_ui
node_project_ui -.->|"offers upload"| node_upload_ui
node_project_ui -.->|"opens chat"| node_chat_ui
node_chat_ui -.->|"accepts voice"| node_voice
node_webapp -.->|"shows analytics"| node_analytics_ui
node_api_client -.->|"sends requests"| node_fastapi
node_fastapi -->|"routes auth"| node_auth_routes
node_fastapi -->|"routes projects"| node_project_routes
node_fastapi -->|"routes documents"| node_document_routes
node_fastapi -->|"routes chat"| node_chat_routes
node_auth_routes -->|"authenticates users"| node_auth_service
node_auth_routes -->|"requires identity"| node_auth_middleware
node_auth_middleware -->|"validates tokens"| node_auth_service
node_auth_service -->|"manages credentials"| node_supabase_auth
node_project_routes -->|"manages projects"| node_project_service
node_document_routes -->|"ingests files"| node_ingestion
node_document_routes -->|"updates projects"| node_project_service
node_chat_routes -->|"queries context"| node_rag
node_chat_routes -->|"loads project"| node_project_service
node_ingestion -->|"parses files"| node_parser
node_ingestion -->|"chunks code"| node_chunker
node_ingestion -->|"embeds chunks"| node_embedder
node_rag -->|"retrieves context"| node_retriever
node_rag -->|"generates answers"| node_llm
node_retriever -->|"embeds queries"| node_embedder
node_llm -.->|"routes generation"| node_llm_providers
node_project_service -->|"reads and writes"| node_project_model
node_project_service -->|"updates counters"| node_repository_store
node_ingestion -->|"stores chunks"| node_repository_store
node_database -->|"backs models"| node_repository_store
node_database -->|"backs models"| node_user_model
node_database -->|"backs models"| node_project_model
node_chat_routes -->|"uses conversations"| node_chat_model
node_auth_service -->|"syncs profiles"| node_user_model

click node_webapp "https://github.com/arunchandrasekar07/devmind/tree/main/frontend/src/app"
click node_project_ui "https://github.com/arunchandrasekar07/devmind/blob/main/frontend/src/app/dashboard/projects/%5Bid%5D/page.tsx"
click node_upload_ui "https://github.com/arunchandrasekar07/devmind/blob/main/frontend/src/components/project/FileUploadZone.tsx"
click node_chat_ui "https://github.com/arunchandrasekar07/devmind/blob/main/frontend/src/app/dashboard/projects/%5Bid%5D/chat/page.tsx"
click node_voice "https://github.com/arunchandrasekar07/devmind/blob/main/frontend/src/lib/hooks/useVoiceInput.ts"
click node_analytics_ui "https://github.com/arunchandrasekar07/devmind/blob/main/frontend/src/app/dashboard/projects/%5Bid%5D/analytics/page.tsx"
click node_api_client "https://github.com/arunchandrasekar07/devmind/blob/main/frontend/src/lib/api.ts"
click node_fastapi "https://github.com/arunchandrasekar07/devmind/blob/main/backend/app/main.py"
click node_auth_routes "https://github.com/arunchandrasekar07/devmind/blob/main/backend/app/routers/auth.py"
click node_auth_service "https://github.com/arunchandrasekar07/devmind/blob/main/backend/app/services/auth_service.py"
click node_auth_middleware "https://github.com/arunchandrasekar07/devmind/blob/main/backend/app/middleware/auth.py"
click node_project_routes "https://github.com/arunchandrasekar07/devmind/blob/main/backend/app/routers/projects.py"
click node_document_routes "https://github.com/arunchandrasekar07/devmind/blob/main/backend/app/routers/documents.py"
click node_chat_routes "https://github.com/arunchandrasekar07/devmind/blob/main/backend/app/routers/chat.py"
click node_ingestion "https://github.com/arunchandrasekar07/devmind/blob/main/backend/app/services/ingestion/pipeline.py"
click node_parser "https://github.com/arunchandrasekar07/devmind/blob/main/backend/app/services/ingestion/file_parser.py"
click node_chunker "https://github.com/arunchandrasekar07/devmind/blob/main/backend/app/services/ingestion/chunker.py"
click node_embedder "https://github.com/arunchandrasekar07/devmind/blob/main/backend/app/services/ai/embedder.py"
click node_rag "https://github.com/arunchandrasekar07/devmind/blob/main/backend/app/services/ai/rag_pipeline.py"
click node_retriever "https://github.com/arunchandrasekar07/devmind/blob/main/backend/app/services/ai/retriever.py"
click node_llm "https://github.com/arunchandrasekar07/devmind/blob/main/backend/app/services/ai/llm_client.py"
click node_project_service "https://github.com/arunchandrasekar07/devmind/blob/main/backend/app/services/project_service.py"
click node_database "https://github.com/arunchandrasekar07/devmind/blob/main/backend/app/database.py"
click node_repository_store "https://github.com/arunchandrasekar07/devmind/blob/main/backend/app/models/document.py"
click node_user_model "https://github.com/arunchandrasekar07/devmind/blob/main/backend/app/models/user.py"
click node_project_model "https://github.com/arunchandrasekar07/devmind/blob/main/backend/app/models/project.py"
click node_chat_model "https://github.com/arunchandrasekar07/devmind/blob/main/backend/app/models/chat.py"

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_webapp,node_project_ui,node_upload_ui,node_chat_ui,node_voice,node_analytics_ui,node_api_client toneBlue
class node_fastapi,node_auth_routes,node_auth_service,node_auth_middleware,node_project_routes,node_document_routes,node_chat_routes,node_project_service toneAmber
class node_ingestion,node_parser,node_chunker toneMint
class node_embedder,node_rag,node_retriever,node_llm toneRose
class node_database,node_repository_store,node_user_model,node_project_model,node_chat_model,node_developer,node_supabase_auth,node_llm_providers toneIndigo
```

## Components

### User Experience

- [Next.js Interface](https://github.com/arunchandrasekar07/devmind/tree/main/frontend/src/app): `frontend/src/app`
- [Project Workspace](https://github.com/arunchandrasekar07/devmind/blob/main/frontend/src/app/dashboard/projects/%5Bid%5D/page.tsx): `frontend/src/app/dashboard/projects/[id]/page.tsx`
- [Repository Upload](https://github.com/arunchandrasekar07/devmind/blob/main/frontend/src/components/project/FileUploadZone.tsx): `frontend/src/components/project/FileUploadZone.tsx`
- [Chat Interface](https://github.com/arunchandrasekar07/devmind/blob/main/frontend/src/app/dashboard/projects/%5Bid%5D/chat/page.tsx): `frontend/src/app/dashboard/projects/[id]/chat/page.tsx`
- [Voice Input](https://github.com/arunchandrasekar07/devmind/blob/main/frontend/src/lib/hooks/useVoiceInput.ts): `frontend/src/lib/hooks/useVoiceInput.ts`
- [Analytics Dashboard](https://github.com/arunchandrasekar07/devmind/blob/main/frontend/src/app/dashboard/projects/%5Bid%5D/analytics/page.tsx): `frontend/src/app/dashboard/projects/[id]/analytics/page.tsx`
- [API Client](https://github.com/arunchandrasekar07/devmind/blob/main/frontend/src/lib/api.ts): `frontend/src/lib/api.ts`

### API and Identity

- [FastAPI Application](https://github.com/arunchandrasekar07/devmind/blob/main/backend/app/main.py): `backend/app/main.py`
- [Authentication Routes](https://github.com/arunchandrasekar07/devmind/blob/main/backend/app/routers/auth.py): `backend/app/routers/auth.py`
- [Authentication Service](https://github.com/arunchandrasekar07/devmind/blob/main/backend/app/services/auth_service.py): `backend/app/services/auth_service.py`
- [Token Authentication](https://github.com/arunchandrasekar07/devmind/blob/main/backend/app/middleware/auth.py): `backend/app/middleware/auth.py`
- [Project Routes](https://github.com/arunchandrasekar07/devmind/blob/main/backend/app/routers/projects.py): `backend/app/routers/projects.py`
- [Document Routes](https://github.com/arunchandrasekar07/devmind/blob/main/backend/app/routers/documents.py): `backend/app/routers/documents.py`
- [Chat Routes](https://github.com/arunchandrasekar07/devmind/blob/main/backend/app/routers/chat.py): `backend/app/routers/chat.py`
- [Project Service](https://github.com/arunchandrasekar07/devmind/blob/main/backend/app/services/project_service.py): `backend/app/services/project_service.py`

### Repository Indexing

- [Ingestion Pipeline](https://github.com/arunchandrasekar07/devmind/blob/main/backend/app/services/ingestion/pipeline.py): `backend/app/services/ingestion/pipeline.py`
- [File Parsing](https://github.com/arunchandrasekar07/devmind/blob/main/backend/app/services/ingestion/file_parser.py): `backend/app/services/ingestion/file_parser.py`
- [Code Chunking](https://github.com/arunchandrasekar07/devmind/blob/main/backend/app/services/ingestion/chunker.py): `backend/app/services/ingestion/chunker.py`

### AI Answering

- [Embedding Generation](https://github.com/arunchandrasekar07/devmind/blob/main/backend/app/services/ai/embedder.py): `backend/app/services/ai/embedder.py`
- [RAG Orchestrator](https://github.com/arunchandrasekar07/devmind/blob/main/backend/app/services/ai/rag_pipeline.py): `backend/app/services/ai/rag_pipeline.py`
- [Semantic Retrieval](https://github.com/arunchandrasekar07/devmind/blob/main/backend/app/services/ai/retriever.py): `backend/app/services/ai/retriever.py`
- [Multi-Provider LLM](https://github.com/arunchandrasekar07/devmind/blob/main/backend/app/services/ai/llm_client.py): `backend/app/services/ai/llm_client.py`

### Persistent State

- [Database Sessions](https://github.com/arunchandrasekar07/devmind/blob/main/backend/app/database.py): `backend/app/database.py`
- [Repository and App Data](https://github.com/arunchandrasekar07/devmind/blob/main/backend/app/models/document.py): `backend/app/models/document.py`
- [User Records](https://github.com/arunchandrasekar07/devmind/blob/main/backend/app/models/user.py): `backend/app/models/user.py`
- [Project Records](https://github.com/arunchandrasekar07/devmind/blob/main/backend/app/models/project.py): `backend/app/models/project.py`
- [Conversation Records](https://github.com/arunchandrasekar07/devmind/blob/main/backend/app/models/chat.py): `backend/app/models/chat.py`

### Other components

- **Developer**
- **Supabase Auth**
- **LLM Providers**

## Connections

- Developer → Next.js Interface: uses (evidence: `README.md`)
- Next.js Interface → FastAPI Application: calls API (evidence: `README.md`)
- Next.js Interface → Project Workspace: opens workspace
- Project Workspace → Repository Upload: offers upload
- Project Workspace → Chat Interface: opens chat
- Chat Interface → Voice Input: accepts voice
- Next.js Interface → Analytics Dashboard: shows analytics
- API Client → FastAPI Application: sends requests
- FastAPI Application → Authentication Routes: routes auth (evidence: `backend/app/main.py`)
- FastAPI Application → Project Routes: routes projects (evidence: `backend/app/main.py`)
- FastAPI Application → Document Routes: routes documents (evidence: `backend/app/main.py`)
- FastAPI Application → Chat Routes: routes chat (evidence: `backend/app/main.py`)
- Authentication Routes → Authentication Service: authenticates users (evidence: `backend/app/routers/auth.py`)
- Authentication Routes → Token Authentication: requires identity (evidence: `backend/app/routers/auth.py`)
- Token Authentication → Authentication Service: validates tokens (evidence: `backend/app/middleware/auth.py`)
- Authentication Service → Supabase Auth: manages credentials (evidence: `backend/app/services/auth_service.py`)
- Project Routes → Project Service: manages projects (evidence: `backend/app/routers/projects.py`)
- Document Routes → Ingestion Pipeline: ingests files (evidence: `backend/app/routers/documents.py`)
- Document Routes → Project Service: updates projects (evidence: `backend/app/routers/documents.py`)
- Chat Routes → RAG Orchestrator: queries context (evidence: `backend/app/routers/chat.py`)
- Chat Routes → Project Service: loads project (evidence: `backend/app/routers/chat.py`)
- Ingestion Pipeline → File Parsing: parses files (evidence: `backend/app/services/ingestion/pipeline.py`)
- Ingestion Pipeline → Code Chunking: chunks code (evidence: `backend/app/services/ingestion/pipeline.py`)
- Ingestion Pipeline → Embedding Generation: embeds chunks (evidence: `backend/app/services/ingestion/pipeline.py`)
- RAG Orchestrator → Semantic Retrieval: retrieves context (evidence: `backend/app/services/ai/rag_pipeline.py`)
- RAG Orchestrator → Multi-Provider LLM: generates answers (evidence: `backend/app/services/ai/rag_pipeline.py`)
- Semantic Retrieval → Embedding Generation: embeds queries (evidence: `backend/app/services/ai/retriever.py`)
- Multi-Provider LLM → LLM Providers: routes generation (evidence: `README.md`)
- Project Service → Project Records: reads and writes (evidence: `backend/app/services/project_service.py`)
- Project Service → Repository and App Data: updates counters (evidence: `backend/app/services/ingestion/pipeline.py`)
- Ingestion Pipeline → Repository and App Data: stores chunks (evidence: `backend/app/services/ingestion/pipeline.py`)
- Database Sessions → Repository and App Data: backs models (evidence: `backend/app/models/document.py`)
- Database Sessions → User Records: backs models (evidence: `backend/app/models/user.py`)
- Database Sessions → Project Records: backs models (evidence: `backend/app/models/project.py`)
- Chat Routes → Conversation Records: uses conversations (evidence: `backend/app/routers/chat.py`)
- Authentication Service → User Records: syncs profiles (evidence: `backend/app/services/auth_service.py`)
