# shivam122gupta/resume_evalautor architecture

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

- Interactive diagram: https://gitdiagram.com/shivam122gupta/resume_evalautor
- Repository: https://github.com/shivam122gupta/resume_evalautor

## Overview

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: [`frontend/src/App.tsx`](https://github.com/shivam122gupta/resume_evalautor/blob/main/frontend/src/App.tsx) (Application state), [`backend/app/services/evaluation_service.py`](https://github.com/shivam122gupta/resume_evalautor/blob/main/backend/app/services/evaluation_service.py) (Batch evaluation), [`backend/app/main.py`](https://github.com/shivam122gupta/resume_evalautor/blob/main/backend/app/main.py) (FastAPI application), [`backend/app/existing_logic/parser.py`](https://github.com/shivam122gupta/resume_evalautor/blob/main/backend/app/existing_logic/parser.py) (Resume and job parser)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Recruiter interface"]
  node_app["Application state<br/>[App.tsx]"]
  node_submission["Job and resume input<br/>[ResumeUpload.tsx]"]
  node_api_client["API client<br/>[client.ts]"]
  node_results["Ranked results"]
  node_candidate_details["Candidate details"]
  node_history["Evaluation history"]
  node_export["CSV export<br/>[ExportButton.tsx]"]
  node_pwa["PWA controls<br/>[usePWA.ts]"]
end

subgraph group_api["API entry"]
  node_fastapi["FastAPI application<br/>[main.py]"]
  node_job_route["Job routes<br/>[jobs.py]"]
  node_evaluation_route["Evaluation route<br/>[evaluations.py]"]
  node_health_route["Health route<br/>[health.py]"]
end

subgraph group_pipeline["Evaluation pipeline"]
  node_evaluation_service["Batch evaluation"]
  node_job_service["Job analysis<br/>[job_service.py]"]
  node_resume_service["Resume extraction<br/>[resume_service.py]"]
  node_document_reader["Document reader<br/>[document_reader.py]"]
  node_parser["Resume and job parser<br/>[parser.py]"]
  node_matcher["Candidate matching<br/>[matcher.py]"]
  node_llm["LLM client<br/>[llm_service.py]"]
end

subgraph group_integrations["External services"]
  node_groq["Groq API"]
  node_api_service["Evaluation API"]
end

node_recruiter(("Recruiter"))

node_recruiter -->|"uses"| node_app
node_app -->|"renders"| node_submission
node_app -->|"submits"| node_api_client
node_api_client -->|"posts resumes"| node_api_service
node_api_service -->|"serves request"| node_fastapi
node_fastapi -->|"routes to"| node_health_route
node_fastapi -->|"routes to"| node_job_route
node_fastapi -->|"routes to"| node_evaluation_route
node_evaluation_route -->|"invokes"| node_evaluation_service
node_job_route -->|"invokes"| node_job_service
node_evaluation_service -->|"analyzes job"| node_job_service
node_evaluation_service -->|"extracts text"| node_resume_service
node_resume_service -->|"reads document"| node_document_reader
node_evaluation_service -->|"parses resume"| node_parser
node_evaluation_service -->|"scores candidate"| node_matcher
node_job_service -->|"parses job"| node_parser
node_parser -->|"requests completion"| node_llm
node_matcher -->|"uses parsed data"| node_parser
node_matcher -->|"requests completion"| node_llm
node_llm -->|"calls model"| node_groq
node_evaluation_service -->|"returns results"| node_api_service
node_app -->|"shows ranking"| node_results
node_app -->|"opens candidate"| node_candidate_details
node_app -->|"shows history"| node_history
node_results -->|"offers export"| node_export
node_app -->|"tracks install"| node_pwa

click node_app "https://github.com/shivam122gupta/resume_evalautor/blob/main/frontend/src/App.tsx"
click node_submission "https://github.com/shivam122gupta/resume_evalautor/blob/main/frontend/src/components/ResumeUpload.tsx"
click node_api_client "https://github.com/shivam122gupta/resume_evalautor/blob/main/frontend/src/api/client.ts"
click node_results "https://github.com/shivam122gupta/resume_evalautor/blob/main/frontend/src/components/CandidateRanking.tsx"
click node_candidate_details "https://github.com/shivam122gupta/resume_evalautor/blob/main/frontend/src/components/CandidateDetails.tsx"
click node_history "https://github.com/shivam122gupta/resume_evalautor/blob/main/frontend/src/components/EvaluationHistory.tsx"
click node_export "https://github.com/shivam122gupta/resume_evalautor/blob/main/frontend/src/components/ExportButton.tsx"
click node_pwa "https://github.com/shivam122gupta/resume_evalautor/blob/main/frontend/src/hooks/usePWA.ts"
click node_fastapi "https://github.com/shivam122gupta/resume_evalautor/blob/main/backend/app/main.py"
click node_job_route "https://github.com/shivam122gupta/resume_evalautor/blob/main/backend/app/api/routes/jobs.py"
click node_evaluation_route "https://github.com/shivam122gupta/resume_evalautor/blob/main/backend/app/api/routes/evaluations.py"
click node_health_route "https://github.com/shivam122gupta/resume_evalautor/blob/main/backend/app/api/routes/health.py"
click node_evaluation_service "https://github.com/shivam122gupta/resume_evalautor/blob/main/backend/app/services/evaluation_service.py"
click node_job_service "https://github.com/shivam122gupta/resume_evalautor/blob/main/backend/app/services/job_service.py"
click node_resume_service "https://github.com/shivam122gupta/resume_evalautor/blob/main/backend/app/services/resume_service.py"
click node_document_reader "https://github.com/shivam122gupta/resume_evalautor/blob/main/backend/app/existing_logic/document_reader.py"
click node_parser "https://github.com/shivam122gupta/resume_evalautor/blob/main/backend/app/existing_logic/parser.py"
click node_matcher "https://github.com/shivam122gupta/resume_evalautor/blob/main/backend/app/existing_logic/matcher.py"
click node_llm "https://github.com/shivam122gupta/resume_evalautor/blob/main/backend/app/services/llm_service.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_submission,node_api_client,node_results,node_candidate_details,node_history,node_export,node_pwa toneBlue
class node_fastapi,node_job_route,node_evaluation_route,node_health_route toneAmber
class node_evaluation_service,node_job_service,node_resume_service,node_document_reader,node_parser,node_matcher,node_llm toneMint
class node_groq,node_api_service toneRose
class node_recruiter toneIndigo
```

## Components

### Recruiter interface

- [Application state](https://github.com/shivam122gupta/resume_evalautor/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Job and resume input](https://github.com/shivam122gupta/resume_evalautor/blob/main/frontend/src/components/ResumeUpload.tsx): `frontend/src/components/ResumeUpload.tsx`
- [API client](https://github.com/shivam122gupta/resume_evalautor/blob/main/frontend/src/api/client.ts): `frontend/src/api/client.ts`
- [Ranked results](https://github.com/shivam122gupta/resume_evalautor/blob/main/frontend/src/components/CandidateRanking.tsx): `frontend/src/components/CandidateRanking.tsx`
- [Candidate details](https://github.com/shivam122gupta/resume_evalautor/blob/main/frontend/src/components/CandidateDetails.tsx): `frontend/src/components/CandidateDetails.tsx`
- [Evaluation history](https://github.com/shivam122gupta/resume_evalautor/blob/main/frontend/src/components/EvaluationHistory.tsx): `frontend/src/components/EvaluationHistory.tsx`
- [CSV export](https://github.com/shivam122gupta/resume_evalautor/blob/main/frontend/src/components/ExportButton.tsx): `frontend/src/components/ExportButton.tsx`
- [PWA controls](https://github.com/shivam122gupta/resume_evalautor/blob/main/frontend/src/hooks/usePWA.ts): `frontend/src/hooks/usePWA.ts`

### API entry

- [FastAPI application](https://github.com/shivam122gupta/resume_evalautor/blob/main/backend/app/main.py): `backend/app/main.py`
- [Job routes](https://github.com/shivam122gupta/resume_evalautor/blob/main/backend/app/api/routes/jobs.py): `backend/app/api/routes/jobs.py`
- [Evaluation route](https://github.com/shivam122gupta/resume_evalautor/blob/main/backend/app/api/routes/evaluations.py): `backend/app/api/routes/evaluations.py`
- [Health route](https://github.com/shivam122gupta/resume_evalautor/blob/main/backend/app/api/routes/health.py): `backend/app/api/routes/health.py`

### Evaluation pipeline

- [Batch evaluation](https://github.com/shivam122gupta/resume_evalautor/blob/main/backend/app/services/evaluation_service.py): `backend/app/services/evaluation_service.py`
- [Job analysis](https://github.com/shivam122gupta/resume_evalautor/blob/main/backend/app/services/job_service.py): `backend/app/services/job_service.py`
- [Resume extraction](https://github.com/shivam122gupta/resume_evalautor/blob/main/backend/app/services/resume_service.py): `backend/app/services/resume_service.py`
- [Document reader](https://github.com/shivam122gupta/resume_evalautor/blob/main/backend/app/existing_logic/document_reader.py): `backend/app/existing_logic/document_reader.py`
- [Resume and job parser](https://github.com/shivam122gupta/resume_evalautor/blob/main/backend/app/existing_logic/parser.py): `backend/app/existing_logic/parser.py`
- [Candidate matching](https://github.com/shivam122gupta/resume_evalautor/blob/main/backend/app/existing_logic/matcher.py): `backend/app/existing_logic/matcher.py`
- [LLM client](https://github.com/shivam122gupta/resume_evalautor/blob/main/backend/app/services/llm_service.py): `backend/app/services/llm_service.py`

### External services

- **Groq API**
- **Evaluation API**

### Other components

- **Recruiter**

## Connections

- Recruiter → Application state: uses (evidence: `README.md`)
- Application state → Job and resume input: renders (evidence: `frontend/src/App.tsx`)
- Application state → API client: submits (evidence: `frontend/src/App.tsx`)
- API client → Evaluation API: posts resumes (evidence: `frontend/src/api/client.ts`)
- Evaluation API → FastAPI application: serves request (evidence: `README.md`)
- FastAPI application → Health route: routes to (evidence: `backend/app/main.py`)
- FastAPI application → Job routes: routes to (evidence: `backend/app/main.py`)
- FastAPI application → Evaluation route: routes to (evidence: `backend/app/main.py`)
- Evaluation route → Batch evaluation: invokes (evidence: `backend/app/api/routes/evaluations.py`)
- Job routes → Job analysis: invokes (evidence: `backend/app/api/routes/jobs.py`)
- Batch evaluation → Job analysis: analyzes job (evidence: `backend/app/services/evaluation_service.py`)
- Batch evaluation → Resume extraction: extracts text (evidence: `backend/app/services/evaluation_service.py`)
- Resume extraction → Document reader: reads document (evidence: `backend/app/services/resume_service.py`)
- Batch evaluation → Resume and job parser: parses resume (evidence: `backend/app/services/evaluation_service.py`)
- Batch evaluation → Candidate matching: scores candidate (evidence: `backend/app/services/evaluation_service.py`)
- Job analysis → Resume and job parser: parses job (evidence: `backend/app/services/job_service.py`)
- Resume and job parser → LLM client: requests completion (evidence: `backend/app/existing_logic/parser.py`)
- Candidate matching → Resume and job parser: uses parsed data (evidence: `backend/app/existing_logic/matcher.py`)
- Candidate matching → LLM client: requests completion (evidence: `backend/app/existing_logic/matcher.py`)
- LLM client → Groq API: calls model (evidence: `backend/app/services/llm_service.py`)
- Batch evaluation → Evaluation API: returns results (evidence: `README.md`)
- Application state → Ranked results: shows ranking (evidence: `frontend/src/App.tsx`)
- Application state → Candidate details: opens candidate (evidence: `frontend/src/App.tsx`)
- Application state → Evaluation history: shows history (evidence: `frontend/src/App.tsx`)
- Ranked results → CSV export: offers export (evidence: `frontend/src/components/CandidateRanking.tsx`)
- Application state → PWA controls: tracks install (evidence: `frontend/src/App.tsx`)
