How gaganraj05/ai-resume-copilot works
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: document.py Document routes · main.py FastAPI app · resume_service.py Resume services · auth.py Authentication
Components 30
Client experience
- Landing page
frontend/src/pages/Home.jsx - Landing content
frontend/src/components/config/landingConfig.js - Waitlist form
frontend/src/components/home/forms/WaitListPopUp.jsx - Waitlist client
frontend/src/services/early.jsx
Resume API
- FastAPI app
backend/app/main.py - Authentication
backend/app/routes/auth.py - Document routes
backend/app/routes/document.py
Resume processing
- Celery worker
backend/app/worker/celery_app.py - Upload processing
backend/app/worker/tasks/document_processing.py - Document processing
backend/app/services/document_processing.py - Resume parser
backend/app/services/resume_parser.py - Tailoring agent
backend/app/agents/resume_copilot.py - Resume retrieval
backend/app/vector_search.py - Resume services
backend/app/services/resume_service.py - Resume tasks
backend/app/worker/tasks/resume_tasks.py
Persistence and retrieval
- User records
backend/app/models/User.py - Resume records
backend/app/models/Document.py - Tailored resumes
backend/app/models/TailoredResume.py - MongoDB
backend/app/services/db.py - Redis
backend/app/services/redis.py - ChromaDB
backend/app/services/chroma_client.py
Waitlist service
- Waitlist API
node-backend/server.js - Waitlist route
node-backend/routes/early.js - Signup handler
node-backend/controllers/early.js - Waitlist records
node-backend/models/Early_Users.js - Email queue
node-backend/queues/email.queue.js - Email worker
node-backend/queues/workers/email.worker.js - Email delivery
node-backend/services/email.service.js
Other components
- Visitor
- Gmail
Connections 36
- Visitor → Landing page: opens
- Landing page → Landing content: uses content
- Visitor → Waitlist form: submits signup
frontend/src/components/home/forms/WaitListPopUp.jsx - Waitlist form → Waitlist client: calls
frontend/src/components/home/forms/WaitListPopUp.jsx - Waitlist client → Waitlist API: posts signup
- Visitor → FastAPI app: uses API
- FastAPI app → Authentication: routes requests
backend/app/main.py - FastAPI app → Document routes: routes requests
backend/app/main.py - FastAPI app → MongoDB: initializes
backend/app/main.py - FastAPI app → Redis: initializes
backend/app/main.py - FastAPI app → ChromaDB: initializes
backend/app/main.py - Authentication → User records: reads and writes
backend/app/routes/auth.py - Authentication → Redis: stores OTP
backend/app/routes/auth.py - Authentication → MongoDB: persists users
backend/app/routes/auth.py - Document routes → Upload processing: dispatches
backend/app/routes/document.py - Document routes → Resume records: reads and writes
backend/app/routes/document.py - Document routes → Tailored resumes: reads and writes
backend/app/routes/document.py - Document routes → Tailoring agent: invokes tailoring
backend/app/routes/document.py - Document routes → Resume services: requests services
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
backend/app/vector_search.py - Tailoring agent → Resume services: saves result
- Resume services → Tailored resumes: stores tailored resume
backend/app/services/resume_service.py - Resume services → User records: loads user
backend/app/services/resume_service.py - Document routes → Resume tasks: dispatches tasks
backend/app/routes/document.py - Resume tasks → Resume services: calls
backend/app/worker/tasks/resume_tasks.py - Waitlist API → Waitlist route: mounts route
node-backend/server.js - Waitlist route → Signup handler: handles request
node-backend/routes/early.js - Signup handler → Waitlist records: checks and creates
node-backend/controllers/early.js - Signup handler → Email queue: enqueues email
node-backend/controllers/early.js - Email queue → Email worker: feeds jobs
node-backend/queues/index.js - Email worker → Email delivery: delivers job
node-backend/queues/workers/email.worker.js - Email delivery → Gmail: sends email
node-backend/services/email.service.js