# gaganraj05/ai-resume-copilot architecture

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

## Overview

AI Resume Copilot combines a React landing/waitlist experience with a FastAPI resume assistant and a separate Node waitlist service. The main user workflow is resume upload, asynchronous parsing and indexing, then job-description-based retrieval, iterative tailoring, and persistence; users can also generate and retrieve cover letters and use account authentication. The graph retains the separately implemented waitlist and email flow. Some AI and document-processing links rely on README descriptions because those implementations were not excerpted.

Main entry points: [`backend/app/routes/document.py`](https://github.com/gaganraj05/ai-resume-copilot/blob/main/backend/app/routes/document.py) (Document routes), [`backend/app/main.py`](https://github.com/gaganraj05/ai-resume-copilot/blob/main/backend/app/main.py) (FastAPI app), [`backend/app/services/resume_service.py`](https://github.com/gaganraj05/ai-resume-copilot/blob/main/backend/app/services/resume_service.py) (Resume services), [`backend/app/routes/auth.py`](https://github.com/gaganraj05/ai-resume-copilot/blob/main/backend/app/routes/auth.py) (Authentication)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Client experience"]
  node_landing["Landing page<br/>[Home.jsx]"]
  node_landing_config["Landing content<br/>[landingConfig.js]"]
  node_waitlist_form["Waitlist form<br/>[WaitListPopUp.jsx]"]
  node_early_client["Waitlist client<br/>[early.jsx]"]
end

subgraph group_api["Resume API"]
  node_fastapi["FastAPI app<br/>[main.py]"]
  node_auth["Authentication<br/>[auth.py]"]
  node_documents["Document routes<br/>[document.py]"]
end

subgraph group_ai["Resume processing"]
  node_celery["Celery worker<br/>[celery_app.py]"]
  node_upload_task["Upload processing"]
  node_doc_processing["Document processing"]
  node_resume_parser["Resume parser<br/>[resume_parser.py]"]
  node_copilot["Tailoring agent<br/>[resume_copilot.py]"]
  node_vector_search["Resume retrieval<br/>[vector_search.py]"]
  node_resume_service["Resume services<br/>[resume_service.py]"]
  node_resume_tasks["Resume tasks<br/>[resume_tasks.py]"]
end

subgraph group_state["Persistence and retrieval"]
  node_user_model[("User records<br/>[User.py]")]
  node_document_model[("Resume records<br/>[Document.py]")]
  node_tailored_model[("Tailored resumes<br/>[TailoredResume.py]")]
  node_mongo[("MongoDB<br/>[db.py]")]
  node_redis[("Redis<br/>[redis.py]")]
  node_chroma[("ChromaDB<br/>[chroma_client.py]")]
end

subgraph group_waitlist["Waitlist service"]
  node_node_server["Waitlist API<br/>[server.js]"]
  node_early_route["Waitlist route<br/>[early.js]"]
  node_early_controller["Signup handler<br/>[early.js]"]
  node_early_users[("Waitlist records<br/>[Early_Users.js]")]
  node_email_queue["Email queue<br/>[email.queue.js]"]
  node_email_worker["Email worker<br/>[email.worker.js]"]
  node_email_service["Email delivery<br/>[email.service.js]"]
end

node_visitor(("Visitor"))
node_mail_provider(("Gmail"))

node_visitor -->|"opens"| node_landing
node_landing -->|"uses content"| node_landing_config
node_visitor -->|"submits signup"| node_waitlist_form
node_waitlist_form -->|"calls"| node_early_client
node_early_client -.->|"posts signup"| node_node_server
node_visitor -->|"uses API"| node_fastapi
node_fastapi -->|"routes requests"| node_auth
node_fastapi -->|"routes requests"| node_documents
node_fastapi -->|"initializes"| node_mongo
node_fastapi -->|"initializes"| node_redis
node_fastapi -->|"initializes"| node_chroma
node_auth -->|"reads and writes"| node_user_model
node_auth -->|"stores OTP"| node_redis
node_auth -->|"persists users"| node_mongo
node_documents -->|"dispatches"| node_upload_task
node_documents -->|"reads and writes"| node_document_model
node_documents -->|"reads and writes"| node_tailored_model
node_documents -->|"invokes tailoring"| node_copilot
node_documents -->|"requests services"| node_resume_service
node_upload_task -.->|"processes upload"| node_doc_processing
node_doc_processing -.->|"parses resume"| node_resume_parser
node_doc_processing -.->|"indexes embeddings"| node_chroma
node_copilot -.->|"retrieves context"| node_vector_search
node_vector_search -->|"searches"| node_chroma
node_copilot -.->|"saves result"| node_resume_service
node_resume_service -->|"stores tailored resume"| node_tailored_model
node_resume_service -->|"loads user"| node_user_model
node_documents -->|"dispatches tasks"| node_resume_tasks
node_resume_tasks -->|"calls"| node_resume_service
node_node_server -->|"mounts route"| node_early_route
node_early_route -->|"handles request"| node_early_controller
node_early_controller -->|"checks and creates"| node_early_users
node_early_controller -->|"enqueues email"| node_email_queue
node_email_queue -->|"feeds jobs"| node_email_worker
node_email_worker -->|"delivers job"| node_email_service
node_email_service -->|"sends email"| node_mail_provider

click node_landing "https://github.com/gaganraj05/ai-resume-copilot/blob/main/frontend/src/pages/Home.jsx"
click node_landing_config "https://github.com/gaganraj05/ai-resume-copilot/blob/main/frontend/src/components/config/landingConfig.js"
click node_waitlist_form "https://github.com/gaganraj05/ai-resume-copilot/blob/main/frontend/src/components/home/forms/WaitListPopUp.jsx"
click node_early_client "https://github.com/gaganraj05/ai-resume-copilot/blob/main/frontend/src/services/early.jsx"
click node_fastapi "https://github.com/gaganraj05/ai-resume-copilot/blob/main/backend/app/main.py"
click node_auth "https://github.com/gaganraj05/ai-resume-copilot/blob/main/backend/app/routes/auth.py"
click node_documents "https://github.com/gaganraj05/ai-resume-copilot/blob/main/backend/app/routes/document.py"
click node_user_model "https://github.com/gaganraj05/ai-resume-copilot/blob/main/backend/app/models/User.py"
click node_document_model "https://github.com/gaganraj05/ai-resume-copilot/blob/main/backend/app/models/Document.py"
click node_tailored_model "https://github.com/gaganraj05/ai-resume-copilot/blob/main/backend/app/models/TailoredResume.py"
click node_mongo "https://github.com/gaganraj05/ai-resume-copilot/blob/main/backend/app/services/db.py"
click node_redis "https://github.com/gaganraj05/ai-resume-copilot/blob/main/backend/app/services/redis.py"
click node_celery "https://github.com/gaganraj05/ai-resume-copilot/blob/main/backend/app/worker/celery_app.py"
click node_upload_task "https://github.com/gaganraj05/ai-resume-copilot/blob/main/backend/app/worker/tasks/document_processing.py"
click node_doc_processing "https://github.com/gaganraj05/ai-resume-copilot/blob/main/backend/app/services/document_processing.py"
click node_resume_parser "https://github.com/gaganraj05/ai-resume-copilot/blob/main/backend/app/services/resume_parser.py"
click node_copilot "https://github.com/gaganraj05/ai-resume-copilot/blob/main/backend/app/agents/resume_copilot.py"
click node_vector_search "https://github.com/gaganraj05/ai-resume-copilot/blob/main/backend/app/vector_search.py"
click node_chroma "https://github.com/gaganraj05/ai-resume-copilot/blob/main/backend/app/services/chroma_client.py"
click node_resume_service "https://github.com/gaganraj05/ai-resume-copilot/blob/main/backend/app/services/resume_service.py"
click node_resume_tasks "https://github.com/gaganraj05/ai-resume-copilot/blob/main/backend/app/worker/tasks/resume_tasks.py"
click node_node_server "https://github.com/gaganraj05/ai-resume-copilot/blob/main/node-backend/server.js"
click node_early_route "https://github.com/gaganraj05/ai-resume-copilot/blob/main/node-backend/routes/early.js"
click node_early_controller "https://github.com/gaganraj05/ai-resume-copilot/blob/main/node-backend/controllers/early.js"
click node_early_users "https://github.com/gaganraj05/ai-resume-copilot/blob/main/node-backend/models/Early_Users.js"
click node_email_queue "https://github.com/gaganraj05/ai-resume-copilot/blob/main/node-backend/queues/email.queue.js"
click node_email_worker "https://github.com/gaganraj05/ai-resume-copilot/blob/main/node-backend/queues/workers/email.worker.js"
click node_email_service "https://github.com/gaganraj05/ai-resume-copilot/blob/main/node-backend/services/email.service.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_landing,node_landing_config,node_waitlist_form,node_early_client toneBlue
class node_fastapi,node_auth,node_documents toneAmber
class node_celery,node_upload_task,node_doc_processing,node_resume_parser,node_copilot,node_vector_search,node_resume_service,node_resume_tasks toneMint
class node_user_model,node_document_model,node_tailored_model,node_mongo,node_redis,node_chroma toneRose
class node_node_server,node_early_route,node_early_controller,node_early_users,node_email_queue,node_email_worker,node_email_service,node_visitor,node_mail_provider toneIndigo
```

## Components

### Client experience

- [Landing page](https://github.com/gaganraj05/ai-resume-copilot/blob/main/frontend/src/pages/Home.jsx): `frontend/src/pages/Home.jsx`
- [Landing content](https://github.com/gaganraj05/ai-resume-copilot/blob/main/frontend/src/components/config/landingConfig.js): `frontend/src/components/config/landingConfig.js`
- [Waitlist form](https://github.com/gaganraj05/ai-resume-copilot/blob/main/frontend/src/components/home/forms/WaitListPopUp.jsx): `frontend/src/components/home/forms/WaitListPopUp.jsx`
- [Waitlist client](https://github.com/gaganraj05/ai-resume-copilot/blob/main/frontend/src/services/early.jsx): `frontend/src/services/early.jsx`

### Resume API

- [FastAPI app](https://github.com/gaganraj05/ai-resume-copilot/blob/main/backend/app/main.py): `backend/app/main.py`
- [Authentication](https://github.com/gaganraj05/ai-resume-copilot/blob/main/backend/app/routes/auth.py): `backend/app/routes/auth.py`
- [Document routes](https://github.com/gaganraj05/ai-resume-copilot/blob/main/backend/app/routes/document.py): `backend/app/routes/document.py`

### Resume processing

- [Celery worker](https://github.com/gaganraj05/ai-resume-copilot/blob/main/backend/app/worker/celery_app.py): `backend/app/worker/celery_app.py`
- [Upload processing](https://github.com/gaganraj05/ai-resume-copilot/blob/main/backend/app/worker/tasks/document_processing.py): `backend/app/worker/tasks/document_processing.py`
- [Document processing](https://github.com/gaganraj05/ai-resume-copilot/blob/main/backend/app/services/document_processing.py): `backend/app/services/document_processing.py`
- [Resume parser](https://github.com/gaganraj05/ai-resume-copilot/blob/main/backend/app/services/resume_parser.py): `backend/app/services/resume_parser.py`
- [Tailoring agent](https://github.com/gaganraj05/ai-resume-copilot/blob/main/backend/app/agents/resume_copilot.py): `backend/app/agents/resume_copilot.py`
- [Resume retrieval](https://github.com/gaganraj05/ai-resume-copilot/blob/main/backend/app/vector_search.py): `backend/app/vector_search.py`
- [Resume services](https://github.com/gaganraj05/ai-resume-copilot/blob/main/backend/app/services/resume_service.py): `backend/app/services/resume_service.py`
- [Resume tasks](https://github.com/gaganraj05/ai-resume-copilot/blob/main/backend/app/worker/tasks/resume_tasks.py): `backend/app/worker/tasks/resume_tasks.py`

### Persistence and retrieval

- [User records](https://github.com/gaganraj05/ai-resume-copilot/blob/main/backend/app/models/User.py): `backend/app/models/User.py`
- [Resume records](https://github.com/gaganraj05/ai-resume-copilot/blob/main/backend/app/models/Document.py): `backend/app/models/Document.py`
- [Tailored resumes](https://github.com/gaganraj05/ai-resume-copilot/blob/main/backend/app/models/TailoredResume.py): `backend/app/models/TailoredResume.py`
- [MongoDB](https://github.com/gaganraj05/ai-resume-copilot/blob/main/backend/app/services/db.py): `backend/app/services/db.py`
- [Redis](https://github.com/gaganraj05/ai-resume-copilot/blob/main/backend/app/services/redis.py): `backend/app/services/redis.py`
- [ChromaDB](https://github.com/gaganraj05/ai-resume-copilot/blob/main/backend/app/services/chroma_client.py): `backend/app/services/chroma_client.py`

### Waitlist service

- [Waitlist API](https://github.com/gaganraj05/ai-resume-copilot/blob/main/node-backend/server.js): `node-backend/server.js`
- [Waitlist route](https://github.com/gaganraj05/ai-resume-copilot/blob/main/node-backend/routes/early.js): `node-backend/routes/early.js`
- [Signup handler](https://github.com/gaganraj05/ai-resume-copilot/blob/main/node-backend/controllers/early.js): `node-backend/controllers/early.js`
- [Waitlist records](https://github.com/gaganraj05/ai-resume-copilot/blob/main/node-backend/models/Early_Users.js): `node-backend/models/Early_Users.js`
- [Email queue](https://github.com/gaganraj05/ai-resume-copilot/blob/main/node-backend/queues/email.queue.js): `node-backend/queues/email.queue.js`
- [Email worker](https://github.com/gaganraj05/ai-resume-copilot/blob/main/node-backend/queues/workers/email.worker.js): `node-backend/queues/workers/email.worker.js`
- [Email delivery](https://github.com/gaganraj05/ai-resume-copilot/blob/main/node-backend/services/email.service.js): `node-backend/services/email.service.js`

### Other components

- **Visitor**
- **Gmail**

## Connections

- Visitor → Landing page: opens
- Landing page → Landing content: uses content
- Visitor → Waitlist form: submits signup (evidence: `frontend/src/components/home/forms/WaitListPopUp.jsx`)
- Waitlist form → Waitlist client: calls (evidence: `frontend/src/components/home/forms/WaitListPopUp.jsx`)
- Waitlist client → Waitlist API: posts signup
- Visitor → FastAPI app: uses API
- FastAPI app → Authentication: routes requests (evidence: `backend/app/main.py`)
- FastAPI app → Document routes: routes requests (evidence: `backend/app/main.py`)
- FastAPI app → MongoDB: initializes (evidence: `backend/app/main.py`)
- FastAPI app → Redis: initializes (evidence: `backend/app/main.py`)
- FastAPI app → ChromaDB: initializes (evidence: `backend/app/main.py`)
- Authentication → User records: reads and writes (evidence: `backend/app/routes/auth.py`)
- Authentication → Redis: stores OTP (evidence: `backend/app/routes/auth.py`)
- Authentication → MongoDB: persists users (evidence: `backend/app/routes/auth.py`)
- Document routes → Upload processing: dispatches (evidence: `backend/app/routes/document.py`)
- Document routes → Resume records: reads and writes (evidence: `backend/app/routes/document.py`)
- Document routes → Tailored resumes: reads and writes (evidence: `backend/app/routes/document.py`)
- Document routes → Tailoring agent: invokes tailoring (evidence: `backend/app/routes/document.py`)
- Document routes → Resume services: requests services (evidence: `backend/app/routes/document.py`)
- Upload processing → Document processing: processes upload
- Document processing → Resume parser: parses resume
- Document processing → ChromaDB: indexes embeddings
- Tailoring agent → Resume retrieval: retrieves context
- Resume retrieval → ChromaDB: searches (evidence: `backend/app/vector_search.py`)
- Tailoring agent → Resume services: saves result
- Resume services → Tailored resumes: stores tailored resume (evidence: `backend/app/services/resume_service.py`)
- Resume services → User records: loads user (evidence: `backend/app/services/resume_service.py`)
- Document routes → Resume tasks: dispatches tasks (evidence: `backend/app/routes/document.py`)
- Resume tasks → Resume services: calls (evidence: `backend/app/worker/tasks/resume_tasks.py`)
- Waitlist API → Waitlist route: mounts route (evidence: `node-backend/server.js`)
- Waitlist route → Signup handler: handles request (evidence: `node-backend/routes/early.js`)
- Signup handler → Waitlist records: checks and creates (evidence: `node-backend/controllers/early.js`)
- Signup handler → Email queue: enqueues email (evidence: `node-backend/controllers/early.js`)
- Email queue → Email worker: feeds jobs (evidence: `node-backend/queues/index.js`)
- Email worker → Email delivery: delivers job (evidence: `node-backend/queues/workers/email.worker.js`)
- Email delivery → Gmail: sends email (evidence: `node-backend/services/email.service.js`)
