# karan26raj/resume-analyzer architecture

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

- Interactive diagram: https://gitdiagram.com/karan26raj/resume-analyzer
- Repository: https://github.com/karan26raj/resume-analyzer

## Overview

ResumeIQ is a resume-and-job assistant: users manage resumes and job listings, then use matching, analysis, rewriting, interview preparation, semantic search, and an AI assistant. The client routes authenticated users to feature pages and calls a FastAPI service; the backend exposes domain APIs and supports document embeddings and indexing. Evidence is strongest for routing, authentication, and embedding search/indexing. Other feature pages and API implementations are unsampled, so their internal calls and storage relationships are not asserted.

Main entry points: [`server/app/main.py`](https://github.com/karan26raj/resume-analyzer/blob/main/server/app/main.py) (FastAPI application), [`client/src/App.jsx`](https://github.com/karan26raj/resume-analyzer/blob/main/client/src/App.jsx) (Application routes), [`server/app/api/embeddings.py`](https://github.com/karan26raj/resume-analyzer/blob/main/server/app/api/embeddings.py) (Embeddings API), [`server/app/services/rag.py`](https://github.com/karan26raj/resume-analyzer/blob/main/server/app/services/rag.py) (Retrieval augmented generation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web client"]
  node_app["Application routes<br/>[App.jsx]"]
  node_api_services["API service calls<br/>[services.js]"]
  node_api_client["HTTP client<br/>[client.js]"]
  node_search_page["Semantic search<br/>[SearchPage.jsx]"]
  node_analysis_page["Resume analysis<br/>[AnalysisPage.jsx]"]
  node_assistant_page["AI assistant<br/>[AssistantPage.jsx]"]
  node_dashboard_page["Dashboard<br/>[DashboardPage.jsx]"]
  node_interview_page["Interview prep<br/>[InterviewPage.jsx]"]
  node_jobs_page["Job management<br/>[JobsPage.jsx]"]
  node_resumes_page["Resume management<br/>[ResumesPage.jsx]"]
  node_rewrite_page["Resume rewriting<br/>[RewritePage.jsx]"]
end

subgraph group_domain["Domain APIs"]
  node_auth_api["Authentication API<br/>[auth.py]"]
  node_analysis_api["Analysis API<br/>[analysis.py]"]
  node_assistant_api["Assistant API<br/>[assistant.py]"]
  node_embeddings_api["Embeddings API<br/>[embeddings.py]"]
  node_interview_api["Interview API<br/>[interview.py]"]
  node_jobs_api["Jobs API<br/>[jobs.py]"]
  node_recommendations_api["Recommendations API<br/>[recommendations.py]"]
  node_resumes_api["Resumes API<br/>[resumes.py]"]
  node_rewrite_api["Rewrite API<br/>[rewrite.py]"]
end

subgraph group_ai["AI and retrieval"]
  node_embedding_service["Embedding generation<br/>[embeddings.py]"]
  node_indexing_service["Document indexing<br/>[indexing.py]"]
  node_vector_store[("Vector search store<br/>[vector_store.py]")]
  node_gemini["Gemini integration<br/>[gemini.py]"]
  node_rag["Retrieval augmented generation<br/>[rag.py]"]
end

subgraph group_platform["Platform"]
  node_server["FastAPI application<br/>[main.py]"]
  node_database[("SQL database access<br/>[database.py]")]
  node_worker_tasks["Indexing task worker<br/>[tasks.py]"]
end

node_user(("User"))

node_user -.->|"uses"| node_app
node_app -->|"routes to"| node_analysis_page
node_app -->|"routes to"| node_assistant_page
node_app -->|"routes to"| node_dashboard_page
node_app -->|"routes to"| node_interview_page
node_app -->|"routes to"| node_jobs_page
node_app -->|"routes to"| node_resumes_page
node_app -->|"routes to"| node_rewrite_page
node_app -->|"routes to"| node_search_page
node_search_page -->|"requests search"| node_api_services
node_api_services -->|"calls"| node_api_client
node_server -->|"registers router"| node_auth_api
node_server -->|"registers router"| node_analysis_api
node_server -->|"registers router"| node_assistant_api
node_server -->|"registers router"| node_embeddings_api
node_server -->|"registers router"| node_interview_api
node_server -->|"registers router"| node_jobs_api
node_server -->|"registers router"| node_recommendations_api
node_server -->|"registers router"| node_resumes_api
node_server -->|"registers router"| node_rewrite_api
node_embeddings_api -->|"creates vectors"| node_embedding_service
node_embeddings_api -->|"indexes documents"| node_indexing_service
node_embeddings_api -->|"searches chunks"| node_vector_store
node_embedding_service -->|"requests embeddings"| node_gemini
node_rag -->|"uses generation"| node_gemini
node_rag -->|"uses retrieval"| node_vector_store
node_rag -->|"uses embeddings"| node_embedding_service
node_worker_tasks -->|"runs indexing"| node_indexing_service

click node_app "https://github.com/karan26raj/resume-analyzer/blob/main/client/src/App.jsx"
click node_api_services "https://github.com/karan26raj/resume-analyzer/blob/main/client/src/api/services.js"
click node_api_client "https://github.com/karan26raj/resume-analyzer/blob/main/client/src/api/client.js"
click node_search_page "https://github.com/karan26raj/resume-analyzer/blob/main/client/src/pages/SearchPage.jsx"
click node_analysis_page "https://github.com/karan26raj/resume-analyzer/blob/main/client/src/pages/AnalysisPage.jsx"
click node_assistant_page "https://github.com/karan26raj/resume-analyzer/blob/main/client/src/pages/AssistantPage.jsx"
click node_dashboard_page "https://github.com/karan26raj/resume-analyzer/blob/main/client/src/pages/DashboardPage.jsx"
click node_interview_page "https://github.com/karan26raj/resume-analyzer/blob/main/client/src/pages/InterviewPage.jsx"
click node_jobs_page "https://github.com/karan26raj/resume-analyzer/blob/main/client/src/pages/JobsPage.jsx"
click node_resumes_page "https://github.com/karan26raj/resume-analyzer/blob/main/client/src/pages/ResumesPage.jsx"
click node_rewrite_page "https://github.com/karan26raj/resume-analyzer/blob/main/client/src/pages/RewritePage.jsx"
click node_auth_api "https://github.com/karan26raj/resume-analyzer/blob/main/server/app/api/auth.py"
click node_analysis_api "https://github.com/karan26raj/resume-analyzer/blob/main/server/app/api/analysis.py"
click node_assistant_api "https://github.com/karan26raj/resume-analyzer/blob/main/server/app/api/assistant.py"
click node_embeddings_api "https://github.com/karan26raj/resume-analyzer/blob/main/server/app/api/embeddings.py"
click node_interview_api "https://github.com/karan26raj/resume-analyzer/blob/main/server/app/api/interview.py"
click node_jobs_api "https://github.com/karan26raj/resume-analyzer/blob/main/server/app/api/jobs.py"
click node_recommendations_api "https://github.com/karan26raj/resume-analyzer/blob/main/server/app/api/recommendations.py"
click node_resumes_api "https://github.com/karan26raj/resume-analyzer/blob/main/server/app/api/resumes.py"
click node_rewrite_api "https://github.com/karan26raj/resume-analyzer/blob/main/server/app/api/rewrite.py"
click node_embedding_service "https://github.com/karan26raj/resume-analyzer/blob/main/server/app/services/embeddings.py"
click node_indexing_service "https://github.com/karan26raj/resume-analyzer/blob/main/server/app/services/indexing.py"
click node_vector_store "https://github.com/karan26raj/resume-analyzer/blob/main/server/app/ai/vector_store.py"
click node_gemini "https://github.com/karan26raj/resume-analyzer/blob/main/server/app/ai/gemini.py"
click node_rag "https://github.com/karan26raj/resume-analyzer/blob/main/server/app/services/rag.py"
click node_server "https://github.com/karan26raj/resume-analyzer/blob/main/server/app/main.py"
click node_database "https://github.com/karan26raj/resume-analyzer/blob/main/server/app/core/database.py"
click node_worker_tasks "https://github.com/karan26raj/resume-analyzer/blob/main/server/app/worker/tasks.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_app,node_api_services,node_api_client,node_search_page,node_analysis_page,node_assistant_page,node_dashboard_page,node_interview_page,node_jobs_page,node_resumes_page,node_rewrite_page,node_user toneBlue
class node_auth_api,node_analysis_api,node_assistant_api,node_embeddings_api,node_interview_api,node_jobs_api,node_recommendations_api,node_resumes_api,node_rewrite_api toneAmber
class node_embedding_service,node_indexing_service,node_vector_store,node_gemini,node_rag toneMint
class node_server,node_database,node_worker_tasks toneRose
```

## Components

### Web client

- [Application routes](https://github.com/karan26raj/resume-analyzer/blob/main/client/src/App.jsx): `client/src/App.jsx`
- [API service calls](https://github.com/karan26raj/resume-analyzer/blob/main/client/src/api/services.js): `client/src/api/services.js`
- [HTTP client](https://github.com/karan26raj/resume-analyzer/blob/main/client/src/api/client.js): `client/src/api/client.js`
- [Semantic search](https://github.com/karan26raj/resume-analyzer/blob/main/client/src/pages/SearchPage.jsx): `client/src/pages/SearchPage.jsx`
- [Resume analysis](https://github.com/karan26raj/resume-analyzer/blob/main/client/src/pages/AnalysisPage.jsx): `client/src/pages/AnalysisPage.jsx`
- [AI assistant](https://github.com/karan26raj/resume-analyzer/blob/main/client/src/pages/AssistantPage.jsx): `client/src/pages/AssistantPage.jsx`
- [Dashboard](https://github.com/karan26raj/resume-analyzer/blob/main/client/src/pages/DashboardPage.jsx): `client/src/pages/DashboardPage.jsx`
- [Interview prep](https://github.com/karan26raj/resume-analyzer/blob/main/client/src/pages/InterviewPage.jsx): `client/src/pages/InterviewPage.jsx`
- [Job management](https://github.com/karan26raj/resume-analyzer/blob/main/client/src/pages/JobsPage.jsx): `client/src/pages/JobsPage.jsx`
- [Resume management](https://github.com/karan26raj/resume-analyzer/blob/main/client/src/pages/ResumesPage.jsx): `client/src/pages/ResumesPage.jsx`
- [Resume rewriting](https://github.com/karan26raj/resume-analyzer/blob/main/client/src/pages/RewritePage.jsx): `client/src/pages/RewritePage.jsx`

### Domain APIs

- [Authentication API](https://github.com/karan26raj/resume-analyzer/blob/main/server/app/api/auth.py): `server/app/api/auth.py`
- [Analysis API](https://github.com/karan26raj/resume-analyzer/blob/main/server/app/api/analysis.py): `server/app/api/analysis.py`
- [Assistant API](https://github.com/karan26raj/resume-analyzer/blob/main/server/app/api/assistant.py): `server/app/api/assistant.py`
- [Embeddings API](https://github.com/karan26raj/resume-analyzer/blob/main/server/app/api/embeddings.py): `server/app/api/embeddings.py`
- [Interview API](https://github.com/karan26raj/resume-analyzer/blob/main/server/app/api/interview.py): `server/app/api/interview.py`
- [Jobs API](https://github.com/karan26raj/resume-analyzer/blob/main/server/app/api/jobs.py): `server/app/api/jobs.py`
- [Recommendations API](https://github.com/karan26raj/resume-analyzer/blob/main/server/app/api/recommendations.py): `server/app/api/recommendations.py`
- [Resumes API](https://github.com/karan26raj/resume-analyzer/blob/main/server/app/api/resumes.py): `server/app/api/resumes.py`
- [Rewrite API](https://github.com/karan26raj/resume-analyzer/blob/main/server/app/api/rewrite.py): `server/app/api/rewrite.py`

### AI and retrieval

- [Embedding generation](https://github.com/karan26raj/resume-analyzer/blob/main/server/app/services/embeddings.py): `server/app/services/embeddings.py`
- [Document indexing](https://github.com/karan26raj/resume-analyzer/blob/main/server/app/services/indexing.py): `server/app/services/indexing.py`
- [Vector search store](https://github.com/karan26raj/resume-analyzer/blob/main/server/app/ai/vector_store.py): `server/app/ai/vector_store.py`
- [Gemini integration](https://github.com/karan26raj/resume-analyzer/blob/main/server/app/ai/gemini.py): `server/app/ai/gemini.py`
- [Retrieval augmented generation](https://github.com/karan26raj/resume-analyzer/blob/main/server/app/services/rag.py): `server/app/services/rag.py`

### Platform

- [FastAPI application](https://github.com/karan26raj/resume-analyzer/blob/main/server/app/main.py): `server/app/main.py`
- [SQL database access](https://github.com/karan26raj/resume-analyzer/blob/main/server/app/core/database.py): `server/app/core/database.py`
- [Indexing task worker](https://github.com/karan26raj/resume-analyzer/blob/main/server/app/worker/tasks.py): `server/app/worker/tasks.py`

### Other components

- **User**

## Connections

- User → Application routes: uses
- Application routes → Resume analysis: routes to (evidence: `client/src/App.jsx`)
- Application routes → AI assistant: routes to (evidence: `client/src/App.jsx`)
- Application routes → Dashboard: routes to (evidence: `client/src/App.jsx`)
- Application routes → Interview prep: routes to (evidence: `client/src/App.jsx`)
- Application routes → Job management: routes to (evidence: `client/src/App.jsx`)
- Application routes → Resume management: routes to (evidence: `client/src/App.jsx`)
- Application routes → Resume rewriting: routes to (evidence: `client/src/App.jsx`)
- Application routes → Semantic search: routes to (evidence: `client/src/App.jsx`)
- Semantic search → API service calls: requests search (evidence: `client/src/pages/SearchPage.jsx`)
- API service calls → HTTP client: calls (evidence: `client/src/api/services.js`)
- FastAPI application → Authentication API: registers router (evidence: `server/app/main.py`)
- FastAPI application → Analysis API: registers router (evidence: `server/app/main.py`)
- FastAPI application → Assistant API: registers router (evidence: `server/app/main.py`)
- FastAPI application → Embeddings API: registers router (evidence: `server/app/main.py`)
- FastAPI application → Interview API: registers router (evidence: `server/app/main.py`)
- FastAPI application → Jobs API: registers router (evidence: `server/app/main.py`)
- FastAPI application → Recommendations API: registers router (evidence: `server/app/main.py`)
- FastAPI application → Resumes API: registers router (evidence: `server/app/main.py`)
- FastAPI application → Rewrite API: registers router (evidence: `server/app/main.py`)
- Embeddings API → Embedding generation: creates vectors (evidence: `server/app/api/embeddings.py`)
- Embeddings API → Document indexing: indexes documents (evidence: `server/app/api/embeddings.py`)
- Embeddings API → Vector search store: searches chunks (evidence: `server/app/api/embeddings.py`)
- Embedding generation → Gemini integration: requests embeddings (evidence: `server/app/services/embeddings.py`)
- Retrieval augmented generation → Gemini integration: uses generation (evidence: `server/app/services/rag.py`)
- Retrieval augmented generation → Vector search store: uses retrieval (evidence: `server/app/services/rag.py`)
- Retrieval augmented generation → Embedding generation: uses embeddings (evidence: `server/app/services/rag.py`)
- Indexing task worker → Document indexing: runs indexing (evidence: `server/app/worker/tasks.py`)
