How thakshil/jobradar-ai works
JobRadar AI takes a candidate from resume upload through document and skill analysis, aggregated job search, skill-match ranking, and dashboard presentation or Excel export. The React client calls a FastAPI API; the backend keeps session data and search results in memory and queries external job boards. The graph preserves the documented Adzuna, Remotive, and Jobicy integrations and filtering/caching behavior. Source excerpts show the upload, API orchestration, resume parsing, provider fetches, scoring, and export; dashboard search wiring is only partly excerpted, so its backend connection is documented by the README.
Main entry points: main.py FastAPI endpoints · job_search.py Search orchestration · Dashboard.jsx Match dashboard · Upload.jsx Resume upload
Components 16
Web client
- SPA routes
frontend/src/App.jsx - Resume upload
frontend/src/pages/Upload.jsx - Match dashboard
frontend/src/pages/Dashboard.jsx
API and session
- FastAPI endpoints
backend/main.py - Session state
backend/main.py
Resume and matching
- Resume parser
backend/resume_parser.py - Match scoring
backend/job_search.py
Job discovery
- Search orchestration
backend/job_search.py - Adzuna search
backend/job_search.py - Remotive search
backend/job_search.py - Jobicy search
backend/job_search.py - Result cache
backend/job_search.py - Search filters
backend/job_search.py
Results delivery
- Excel export
backend/excel_export.py
Other components
- Candidate
- Job boards
Connections 23
- Candidate → Resume upload: selects resume
frontend/src/pages/Upload.jsx - SPA routes → Resume upload: routes to
frontend/src/App.jsx - SPA routes → Match dashboard: routes to
frontend/src/App.jsx - Resume upload → FastAPI endpoints: uploads file
README.md - FastAPI endpoints → Resume parser: parses resume
backend/main.py - FastAPI endpoints → Session state: stores session
backend/main.py - Match dashboard → FastAPI endpoints: requests jobs
README.md - FastAPI endpoints → Session state: reads resume
backend/main.py - FastAPI endpoints → Search orchestration: starts search
backend/main.py - Search orchestration → Adzuna search: queries
README.md - Search orchestration → Remotive search: queries
README.md - Search orchestration → Jobicy search: queries
README.md - Adzuna search → Job boards: fetches listings
backend/job_search.py - Remotive search → Job boards: fetches listings
backend/job_search.py - Jobicy search → Job boards: fetches listings
backend/job_search.py - Search orchestration → Result cache: checks and saves
README.md - Search orchestration → Match scoring: scores listings
backend/job_search.py - Search orchestration → Search filters: filters results
backend/job_search.py - FastAPI endpoints → Session state: stores jobs
backend/main.py - FastAPI endpoints → Match dashboard: returns ranked results
README.md - Match dashboard → FastAPI endpoints: requests spreadsheet
README.md - FastAPI endpoints → Excel export: generates workbook
backend/main.py - Excel export → Match dashboard: streams workbook
README.md