# sanskritimishra10/ai_codebase_onboarding_assistant architecture

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

- Interactive diagram: https://gitdiagram.com/sanskritimishra10/ai_codebase_onboarding_assistant
- Repository: https://github.com/sanskritimishra10/ai_codebase_onboarding_assistant

## Overview

This is an AI codebase onboarding assistant: developers upload a repository, inspect its analysis, index its source, then ask questions and receive answers with source references. The graph follows the documented workflow and sampled calls across the frontend, API, ingestion/indexing, and retrieval-answering layers. The vector index and uploaded repositories are represented as stores; conversations are in-memory. Several UI and backend links are supported by the SOURCE INDEX or README rather than complete excerpts, so unsampled internals are not expanded.

Main entry points: [`backend/app/api/repository.py`](https://github.com/sanskritimishra10/ai_codebase_onboarding_assistant/blob/main/backend/app/api/repository.py) (Repository endpoints), [`frontend/src/services/api.js`](https://github.com/sanskritimishra10/ai_codebase_onboarding_assistant/blob/main/frontend/src/services/api.js) (API client), [`frontend/src/components/ChatWindow.jsx`](https://github.com/sanskritimishra10/ai_codebase_onboarding_assistant/blob/main/frontend/src/components/ChatWindow.jsx) (Chat window), [`backend/app/services/rag_service.py`](https://github.com/sanskritimishra10/ai_codebase_onboarding_assistant/blob/main/backend/app/services/rag_service.py) (RAG orchestrator)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Frontend"]
  node_home["Upload page<br/>[Home.jsx]"]
  node_upload["File upload<br/>[FileUpload.jsx]"]
  node_repo_page["Repository page<br/>[Repository.jsx]"]
  node_chat_page["Chat page<br/>[Chat.jsx]"]
  node_chat_window["Chat window<br/>[ChatWindow.jsx]"]
  node_chat_message["Chat messages<br/>[ChatMessage.jsx]"]
  node_source_card["Source cards<br/>[SourceCard.jsx]"]
  node_api_client["API client<br/>[api.js]"]
end

subgraph group_api["API"]
  node_backend["FastAPI app<br/>[main.py]"]
  node_repository_api["Repository endpoints<br/>[repository.py]"]
  node_conversation_api["Conversation endpoints<br/>[conversation.py]"]
end

subgraph group_repository["Repository processing"]
  node_repository_service["Repository storage"]
  node_archive_utils["Archive safety<br/>[file_utils.py]"]
  node_analysis["Repository analysis"]
  node_ingestion["Source ingestion"]
  node_chunker["Code chunking<br/>[code_chunker.py]"]
  node_vector_store[("Vector index<br/>[vector_store.py]")]
  node_embedding["Embeddings"]
  node_uploads[("Uploaded repositories")]
end

subgraph group_assistant["Chat and retrieval"]
  node_rag["RAG orchestrator<br/>[rag_service.py]"]
  node_llm["Query and answer LLM<br/>[llm_service.py]"]
  node_conversations[("Conversation state")]
end

node_developer(("Developer"))
node_hf["Hugging Face inference"]

node_developer -->|"uploads ZIP"| node_upload
node_home -->|"renders"| node_upload
node_upload -->|"calls upload"| node_api_client
node_repo_page -->|"requests analysis/index"| node_api_client
node_chat_page -->|"loads conversations"| node_api_client
node_chat_page -->|"renders"| node_chat_window
node_chat_window -->|"renders"| node_chat_message
node_chat_window -->|"renders"| node_source_card
node_chat_window -->|"asks questions"| node_api_client
node_api_client -->|"HTTP requests"| node_repository_api
node_api_client -->|"HTTP requests"| node_conversation_api
node_backend -->|"registers router"| node_repository_api
node_backend -->|"registers router"| node_conversation_api
node_repository_api -->|"saves upload"| node_repository_service
node_repository_service -->|"extracts safely"| node_archive_utils
node_repository_service -.->|"stores files"| node_uploads
node_repository_api -->|"analyzes repository"| node_analysis
node_repository_api -->|"reads source"| node_ingestion
node_ingestion -->|"filters sensitive files"| node_archive_utils
node_repository_api -->|"chunks documents"| node_chunker
node_repository_api -->|"indexes repository"| node_vector_store
node_vector_store -->|"generates vectors"| node_embedding
node_vector_store -->|"uses chunks"| node_chunker
node_repository_api -->|"answers questions"| node_rag
node_repository_api -->|"creates conversations"| node_conversations
node_conversation_api -->|"manages history"| node_conversations
node_rag -->|"searches chunks"| node_vector_store
node_rag -->|"rewrites and generates"| node_llm
node_rag -->|"reads and saves messages"| node_conversations
node_llm -->|"calls inference"| node_hf

click node_home "https://github.com/sanskritimishra10/ai_codebase_onboarding_assistant/blob/main/frontend/src/pages/Home.jsx"
click node_upload "https://github.com/sanskritimishra10/ai_codebase_onboarding_assistant/blob/main/frontend/src/components/FileUpload.jsx"
click node_repo_page "https://github.com/sanskritimishra10/ai_codebase_onboarding_assistant/blob/main/frontend/src/pages/Repository.jsx"
click node_chat_page "https://github.com/sanskritimishra10/ai_codebase_onboarding_assistant/blob/main/frontend/src/pages/Chat.jsx"
click node_chat_window "https://github.com/sanskritimishra10/ai_codebase_onboarding_assistant/blob/main/frontend/src/components/ChatWindow.jsx"
click node_chat_message "https://github.com/sanskritimishra10/ai_codebase_onboarding_assistant/blob/main/frontend/src/components/ChatMessage.jsx"
click node_source_card "https://github.com/sanskritimishra10/ai_codebase_onboarding_assistant/blob/main/frontend/src/components/SourceCard.jsx"
click node_api_client "https://github.com/sanskritimishra10/ai_codebase_onboarding_assistant/blob/main/frontend/src/services/api.js"
click node_backend "https://github.com/sanskritimishra10/ai_codebase_onboarding_assistant/blob/main/backend/app/main.py"
click node_repository_api "https://github.com/sanskritimishra10/ai_codebase_onboarding_assistant/blob/main/backend/app/api/repository.py"
click node_conversation_api "https://github.com/sanskritimishra10/ai_codebase_onboarding_assistant/blob/main/backend/app/api/conversation.py"
click node_repository_service "https://github.com/sanskritimishra10/ai_codebase_onboarding_assistant/blob/main/backend/app/services/repository_service.py"
click node_archive_utils "https://github.com/sanskritimishra10/ai_codebase_onboarding_assistant/blob/main/backend/app/utils/file_utils.py"
click node_analysis "https://github.com/sanskritimishra10/ai_codebase_onboarding_assistant/blob/main/backend/app/services/repository_analyzer.py"
click node_ingestion "https://github.com/sanskritimishra10/ai_codebase_onboarding_assistant/blob/main/backend/app/services/repository_ingestion.py"
click node_chunker "https://github.com/sanskritimishra10/ai_codebase_onboarding_assistant/blob/main/backend/app/services/code_chunker.py"
click node_vector_store "https://github.com/sanskritimishra10/ai_codebase_onboarding_assistant/blob/main/backend/app/services/vector_store.py"
click node_embedding "https://github.com/sanskritimishra10/ai_codebase_onboarding_assistant/blob/main/backend/app/services/embedding_service.py"
click node_rag "https://github.com/sanskritimishra10/ai_codebase_onboarding_assistant/blob/main/backend/app/services/rag_service.py"
click node_llm "https://github.com/sanskritimishra10/ai_codebase_onboarding_assistant/blob/main/backend/app/services/llm_service.py"
click node_conversations "https://github.com/sanskritimishra10/ai_codebase_onboarding_assistant/blob/main/backend/app/services/conversation_service.py"
click node_uploads "https://github.com/sanskritimishra10/ai_codebase_onboarding_assistant/tree/main/storage/uploads"

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_home,node_upload,node_repo_page,node_chat_page,node_chat_window,node_chat_message,node_source_card,node_api_client toneBlue
class node_backend,node_repository_api,node_conversation_api toneAmber
class node_repository_service,node_archive_utils,node_analysis,node_ingestion,node_chunker,node_vector_store,node_embedding,node_uploads toneMint
class node_rag,node_llm,node_conversations toneRose
class node_developer,node_hf toneIndigo
```

## Components

### Frontend

- [Upload page](https://github.com/sanskritimishra10/ai_codebase_onboarding_assistant/blob/main/frontend/src/pages/Home.jsx): `frontend/src/pages/Home.jsx`
- [File upload](https://github.com/sanskritimishra10/ai_codebase_onboarding_assistant/blob/main/frontend/src/components/FileUpload.jsx): `frontend/src/components/FileUpload.jsx`
- [Repository page](https://github.com/sanskritimishra10/ai_codebase_onboarding_assistant/blob/main/frontend/src/pages/Repository.jsx): `frontend/src/pages/Repository.jsx`
- [Chat page](https://github.com/sanskritimishra10/ai_codebase_onboarding_assistant/blob/main/frontend/src/pages/Chat.jsx): `frontend/src/pages/Chat.jsx`
- [Chat window](https://github.com/sanskritimishra10/ai_codebase_onboarding_assistant/blob/main/frontend/src/components/ChatWindow.jsx): `frontend/src/components/ChatWindow.jsx`
- [Chat messages](https://github.com/sanskritimishra10/ai_codebase_onboarding_assistant/blob/main/frontend/src/components/ChatMessage.jsx): `frontend/src/components/ChatMessage.jsx`
- [Source cards](https://github.com/sanskritimishra10/ai_codebase_onboarding_assistant/blob/main/frontend/src/components/SourceCard.jsx): `frontend/src/components/SourceCard.jsx`
- [API client](https://github.com/sanskritimishra10/ai_codebase_onboarding_assistant/blob/main/frontend/src/services/api.js): `frontend/src/services/api.js`

### API

- [FastAPI app](https://github.com/sanskritimishra10/ai_codebase_onboarding_assistant/blob/main/backend/app/main.py): `backend/app/main.py`
- [Repository endpoints](https://github.com/sanskritimishra10/ai_codebase_onboarding_assistant/blob/main/backend/app/api/repository.py): `backend/app/api/repository.py`
- [Conversation endpoints](https://github.com/sanskritimishra10/ai_codebase_onboarding_assistant/blob/main/backend/app/api/conversation.py): `backend/app/api/conversation.py`

### Repository processing

- [Repository storage](https://github.com/sanskritimishra10/ai_codebase_onboarding_assistant/blob/main/backend/app/services/repository_service.py): `backend/app/services/repository_service.py`
- [Archive safety](https://github.com/sanskritimishra10/ai_codebase_onboarding_assistant/blob/main/backend/app/utils/file_utils.py): `backend/app/utils/file_utils.py`
- [Repository analysis](https://github.com/sanskritimishra10/ai_codebase_onboarding_assistant/blob/main/backend/app/services/repository_analyzer.py): `backend/app/services/repository_analyzer.py`
- [Source ingestion](https://github.com/sanskritimishra10/ai_codebase_onboarding_assistant/blob/main/backend/app/services/repository_ingestion.py): `backend/app/services/repository_ingestion.py`
- [Code chunking](https://github.com/sanskritimishra10/ai_codebase_onboarding_assistant/blob/main/backend/app/services/code_chunker.py): `backend/app/services/code_chunker.py`
- [Vector index](https://github.com/sanskritimishra10/ai_codebase_onboarding_assistant/blob/main/backend/app/services/vector_store.py): `backend/app/services/vector_store.py`
- [Embeddings](https://github.com/sanskritimishra10/ai_codebase_onboarding_assistant/blob/main/backend/app/services/embedding_service.py): `backend/app/services/embedding_service.py`
- [Uploaded repositories](https://github.com/sanskritimishra10/ai_codebase_onboarding_assistant/tree/main/storage/uploads): `storage/uploads`

### Chat and retrieval

- [RAG orchestrator](https://github.com/sanskritimishra10/ai_codebase_onboarding_assistant/blob/main/backend/app/services/rag_service.py): `backend/app/services/rag_service.py`
- [Query and answer LLM](https://github.com/sanskritimishra10/ai_codebase_onboarding_assistant/blob/main/backend/app/services/llm_service.py): `backend/app/services/llm_service.py`
- [Conversation state](https://github.com/sanskritimishra10/ai_codebase_onboarding_assistant/blob/main/backend/app/services/conversation_service.py): `backend/app/services/conversation_service.py`

### Other components

- **Developer**
- **Hugging Face inference**

## Connections

- Developer → File upload: uploads ZIP (evidence: `README.md`)
- Upload page → File upload: renders (evidence: `frontend/src/pages/Home.jsx`)
- File upload → API client: calls upload (evidence: `frontend/src/components/FileUpload.jsx`)
- Repository page → API client: requests analysis/index (evidence: `frontend/src/pages/Repository.jsx`)
- Chat page → API client: loads conversations (evidence: `frontend/src/pages/Chat.jsx`)
- Chat page → Chat window: renders (evidence: `frontend/src/pages/Chat.jsx`)
- Chat window → Chat messages: renders (evidence: `frontend/src/components/ChatWindow.jsx`)
- Chat window → Source cards: renders (evidence: `frontend/src/components/ChatWindow.jsx`)
- Chat window → API client: asks questions (evidence: `frontend/src/components/ChatWindow.jsx`)
- API client → Repository endpoints: HTTP requests (evidence: `frontend/src/services/api.js`)
- API client → Conversation endpoints: HTTP requests (evidence: `frontend/src/services/api.js`)
- FastAPI app → Repository endpoints: registers router (evidence: `backend/app/main.py`)
- FastAPI app → Conversation endpoints: registers router (evidence: `backend/app/main.py`)
- Repository endpoints → Repository storage: saves upload (evidence: `backend/app/api/repository.py`)
- Repository storage → Archive safety: extracts safely (evidence: `backend/app/services/repository_service.py`)
- Repository storage → Uploaded repositories: stores files
- Repository endpoints → Repository analysis: analyzes repository (evidence: `backend/app/api/repository.py`)
- Repository endpoints → Source ingestion: reads source (evidence: `backend/app/api/repository.py`)
- Source ingestion → Archive safety: filters sensitive files (evidence: `backend/app/services/repository_ingestion.py`)
- Repository endpoints → Code chunking: chunks documents (evidence: `backend/app/api/repository.py`)
- Repository endpoints → Vector index: indexes repository (evidence: `backend/app/api/repository.py`)
- Vector index → Embeddings: generates vectors (evidence: `backend/app/services/vector_store.py`)
- Vector index → Code chunking: uses chunks (evidence: `backend/app/services/vector_store.py`)
- Repository endpoints → RAG orchestrator: answers questions (evidence: `backend/app/api/repository.py`)
- Repository endpoints → Conversation state: creates conversations (evidence: `backend/app/api/repository.py`)
- Conversation endpoints → Conversation state: manages history (evidence: `backend/app/api/conversation.py`)
- RAG orchestrator → Vector index: searches chunks (evidence: `backend/app/services/rag_service.py`)
- RAG orchestrator → Query and answer LLM: rewrites and generates (evidence: `backend/app/services/rag_service.py`)
- RAG orchestrator → Conversation state: reads and saves messages (evidence: `backend/app/services/rag_service.py`)
- Query and answer LLM → Hugging Face inference: calls inference (evidence: `backend/app/services/llm_service.py`)
