How shivam122gupta/resume_evalautor works
HireLens lets recruiters submit a job description and multiple resumes, then review ranked candidate scores and details. The main flow runs from the React evaluation form through the API client and FastAPI evaluation route into job parsing, resume extraction, parsing, and matching; the backend returns a ranked batch for presentation. The UI also provides evaluation history, comparison, export, and PWA features. Source excerpts establish the main orchestration and frontend calls; some component and route wiring is supported by the SOURCE INDEX or README rather than inspected implementation.
Main entry points: App.tsx Application state · evaluation_service.py Batch evaluation · main.py FastAPI application · parser.py Resume and job parser
Components 22
Recruiter interface
- Application state
frontend/src/App.tsx - Job and resume input
frontend/src/components/ResumeUpload.tsx - API client
frontend/src/api/client.ts - Ranked results
frontend/src/components/CandidateRanking.tsx - Candidate details
frontend/src/components/CandidateDetails.tsx - Evaluation history
frontend/src/components/EvaluationHistory.tsx - CSV export
frontend/src/components/ExportButton.tsx - PWA controls
frontend/src/hooks/usePWA.ts
API entry
- FastAPI application
backend/app/main.py - Job routes
backend/app/api/routes/jobs.py - Evaluation route
backend/app/api/routes/evaluations.py - Health route
backend/app/api/routes/health.py
Evaluation pipeline
- Batch evaluation
backend/app/services/evaluation_service.py - Job analysis
backend/app/services/job_service.py - Resume extraction
backend/app/services/resume_service.py - Document reader
backend/app/existing_logic/document_reader.py - Resume and job parser
backend/app/existing_logic/parser.py - Candidate matching
backend/app/existing_logic/matcher.py - LLM client
backend/app/services/llm_service.py
External services
- Groq API
- Evaluation API
Other components
- Recruiter
Connections 26
- Recruiter → Application state: uses
README.md - Application state → Job and resume input: renders
frontend/src/App.tsx - Application state → API client: submits
frontend/src/App.tsx - API client → Evaluation API: posts resumes
frontend/src/api/client.ts - Evaluation API → FastAPI application: serves request
README.md - FastAPI application → Health route: routes to
backend/app/main.py - FastAPI application → Job routes: routes to
backend/app/main.py - FastAPI application → Evaluation route: routes to
backend/app/main.py - Evaluation route → Batch evaluation: invokes
backend/app/api/routes/evaluations.py - Job routes → Job analysis: invokes
backend/app/api/routes/jobs.py - Batch evaluation → Job analysis: analyzes job
backend/app/services/evaluation_service.py - Batch evaluation → Resume extraction: extracts text
backend/app/services/evaluation_service.py - Resume extraction → Document reader: reads document
backend/app/services/resume_service.py - Batch evaluation → Resume and job parser: parses resume
backend/app/services/evaluation_service.py - Batch evaluation → Candidate matching: scores candidate
backend/app/services/evaluation_service.py - Job analysis → Resume and job parser: parses job
backend/app/services/job_service.py - Resume and job parser → LLM client: requests completion
backend/app/existing_logic/parser.py - Candidate matching → Resume and job parser: uses parsed data
backend/app/existing_logic/matcher.py - Candidate matching → LLM client: requests completion
backend/app/existing_logic/matcher.py - LLM client → Groq API: calls model
backend/app/services/llm_service.py - Batch evaluation → Evaluation API: returns results
README.md - Application state → Ranked results: shows ranking
frontend/src/App.tsx - Application state → Candidate details: opens candidate
frontend/src/App.tsx - Application state → Evaluation history: shows history
frontend/src/App.tsx - Ranked results → CSV export: offers export
frontend/src/components/CandidateRanking.tsx - Application state → PWA controls: tracks install
frontend/src/App.tsx