# geethu27/ai-resume-screening architecture

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

## Overview

Resume Screening System is a deterministic recruiter tool: a recruiter manages job requirements, uploads resumes, screens candidates, and reviews ranked results and score breakdowns. The React interface calls a Flask REST API; upload processing extracts resume text and entities, then screening compares skills, scores candidates, assigns statuses, and persists results. The README documents the principal workflow and capabilities; sampled source confirms key calls and storage behavior. Some route and UI internals are unsampled, so only documented relationships are shown for them.

Main entry points: [`backend/app.py`](https://github.com/geethu27/ai-resume-screening/blob/main/backend/app.py) (Flask application), [`frontend/src/App.jsx`](https://github.com/geethu27/ai-resume-screening/blob/main/frontend/src/App.jsx) (Application shell), [`backend/routes/resume_routes.py`](https://github.com/geethu27/ai-resume-screening/blob/main/backend/routes/resume_routes.py) (Resume endpoints), [`frontend/src/services/api.js`](https://github.com/geethu27/ai-resume-screening/blob/main/frontend/src/services/api.js) (API client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Recruiter interface"]
  node_appui["Application shell<br/>[App.jsx]"]
  node_dashboard["Dashboard<br/>[Dashboard.jsx]"]
  node_jobsui["Job management<br/>[Jobs.jsx]"]
  node_uploadui["Resume upload<br/>[ResumeUpload.jsx]"]
  node_screenui["Screening review<br/>[Screening.jsx]"]
  node_candidatesui["Candidate records<br/>[Candidates.jsx]"]
  node_modal["Detail modal<br/>[Modal.jsx]"]
  node_scorebadge["Score badge<br/>[ScoreBadge.jsx]"]
  node_apiclient["API client<br/>[api.js]"]
end

subgraph group_api["REST API"]
  node_flask["Flask application<br/>[app.py]"]
  node_auth["Recruiter authentication<br/>[auth_routes.py]"]
  node_jobroutes["Job endpoints<br/>[job_routes.py]"]
  node_resumeroutes["Resume endpoints<br/>[resume_routes.py]"]
  node_screenroutes["Screening endpoints"]
  node_candidateroutes["Candidate endpoints"]
end

subgraph group_processing["Screening pipeline"]
  node_filehandling["File validation<br/>[file_handler.py]"]
  node_parser["Resume text parser<br/>[resume_parser.py]"]
  node_preprocessor["Text preprocessing"]
  node_extractor["Entity extraction<br/>[skill_extractor.py]"]
  node_matcher["Requirements matcher<br/>[matching_engine.py]"]
  node_scorer["Deterministic scoring<br/>[scoring_engine.py]"]
  node_ranker["Candidate ranking<br/>[ranking_engine.py]"]
end

subgraph group_data["Persistence"]
  node_database[("Application database<br/>[database.py]")]
end

node_recruiter(("Recruiter"))

node_recruiter -->|"uses"| node_appui
node_appui -->|"routes to"| node_dashboard
node_appui -->|"routes to"| node_jobsui
node_appui -->|"routes to"| node_uploadui
node_appui -->|"routes to"| node_screenui
node_appui -->|"routes to"| node_candidatesui
node_screenui -->|"renders"| node_modal
node_screenui -->|"renders"| node_scorebadge
node_candidatesui -->|"renders"| node_modal
node_candidatesui -->|"renders"| node_scorebadge
node_dashboard -->|"requests data"| node_apiclient
node_jobsui -->|"requests jobs"| node_apiclient
node_uploadui -->|"uploads resumes"| node_apiclient
node_screenui -->|"requests screening"| node_apiclient
node_candidatesui -->|"requests candidates"| node_apiclient
node_apiclient -->|"sends HTTP"| node_flask
node_flask -->|"registers routes"| node_auth
node_flask -->|"registers routes"| node_jobroutes
node_flask -->|"registers routes"| node_resumeroutes
node_flask -->|"registers routes"| node_screenroutes
node_flask -->|"registers routes"| node_candidateroutes
node_resumeroutes -->|"saves upload"| node_filehandling
node_resumeroutes -->|"parses resume"| node_parser
node_resumeroutes -->|"preprocesses text"| node_preprocessor
node_resumeroutes -->|"extracts entities"| node_extractor
node_screenroutes -->|"matches skills"| node_matcher
node_screenroutes -->|"calculates score"| node_scorer
node_screenroutes -->|"ranks candidates"| node_ranker
node_screenroutes -->|"reads and writes"| node_database
node_resumeroutes -->|"stores records"| node_database
node_jobroutes -->|"stores jobs"| node_database
node_auth -->|"checks credentials"| node_database
node_candidateroutes -->|"reads candidates"| node_database
node_flask -->|"initializes"| node_database
node_matcher -->|"supplies match result"| node_scorer
node_scorer -->|"scores before ranking"| node_ranker

click node_appui "https://github.com/geethu27/ai-resume-screening/blob/main/frontend/src/App.jsx"
click node_dashboard "https://github.com/geethu27/ai-resume-screening/blob/main/frontend/src/pages/Dashboard.jsx"
click node_jobsui "https://github.com/geethu27/ai-resume-screening/blob/main/frontend/src/pages/Jobs.jsx"
click node_uploadui "https://github.com/geethu27/ai-resume-screening/blob/main/frontend/src/pages/ResumeUpload.jsx"
click node_screenui "https://github.com/geethu27/ai-resume-screening/blob/main/frontend/src/pages/Screening.jsx"
click node_candidatesui "https://github.com/geethu27/ai-resume-screening/blob/main/frontend/src/pages/Candidates.jsx"
click node_modal "https://github.com/geethu27/ai-resume-screening/blob/main/frontend/src/components/Modal.jsx"
click node_scorebadge "https://github.com/geethu27/ai-resume-screening/blob/main/frontend/src/components/ScoreBadge.jsx"
click node_apiclient "https://github.com/geethu27/ai-resume-screening/blob/main/frontend/src/services/api.js"
click node_flask "https://github.com/geethu27/ai-resume-screening/blob/main/backend/app.py"
click node_auth "https://github.com/geethu27/ai-resume-screening/blob/main/backend/routes/auth_routes.py"
click node_jobroutes "https://github.com/geethu27/ai-resume-screening/blob/main/backend/routes/job_routes.py"
click node_resumeroutes "https://github.com/geethu27/ai-resume-screening/blob/main/backend/routes/resume_routes.py"
click node_screenroutes "https://github.com/geethu27/ai-resume-screening/blob/main/backend/routes/screening_routes.py"
click node_candidateroutes "https://github.com/geethu27/ai-resume-screening/blob/main/backend/routes/candidate_routes.py"
click node_filehandling "https://github.com/geethu27/ai-resume-screening/blob/main/backend/utils/file_handler.py"
click node_parser "https://github.com/geethu27/ai-resume-screening/blob/main/backend/services/resume_parser.py"
click node_preprocessor "https://github.com/geethu27/ai-resume-screening/blob/main/backend/services/text_preprocessor.py"
click node_extractor "https://github.com/geethu27/ai-resume-screening/blob/main/backend/services/skill_extractor.py"
click node_matcher "https://github.com/geethu27/ai-resume-screening/blob/main/backend/services/matching_engine.py"
click node_scorer "https://github.com/geethu27/ai-resume-screening/blob/main/backend/services/scoring_engine.py"
click node_ranker "https://github.com/geethu27/ai-resume-screening/blob/main/backend/services/ranking_engine.py"
click node_database "https://github.com/geethu27/ai-resume-screening/blob/main/backend/models/database.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_appui,node_dashboard,node_jobsui,node_uploadui,node_screenui,node_candidatesui,node_modal,node_scorebadge,node_apiclient toneBlue
class node_flask,node_auth,node_jobroutes,node_resumeroutes,node_screenroutes,node_candidateroutes toneAmber
class node_filehandling,node_parser,node_preprocessor,node_extractor,node_matcher,node_scorer,node_ranker toneMint
class node_database toneRose
class node_recruiter toneIndigo
```

## Components

### Recruiter interface

- [Application shell](https://github.com/geethu27/ai-resume-screening/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Dashboard](https://github.com/geethu27/ai-resume-screening/blob/main/frontend/src/pages/Dashboard.jsx): `frontend/src/pages/Dashboard.jsx`
- [Job management](https://github.com/geethu27/ai-resume-screening/blob/main/frontend/src/pages/Jobs.jsx): `frontend/src/pages/Jobs.jsx`
- [Resume upload](https://github.com/geethu27/ai-resume-screening/blob/main/frontend/src/pages/ResumeUpload.jsx): `frontend/src/pages/ResumeUpload.jsx`
- [Screening review](https://github.com/geethu27/ai-resume-screening/blob/main/frontend/src/pages/Screening.jsx): `frontend/src/pages/Screening.jsx`
- [Candidate records](https://github.com/geethu27/ai-resume-screening/blob/main/frontend/src/pages/Candidates.jsx): `frontend/src/pages/Candidates.jsx`
- [Detail modal](https://github.com/geethu27/ai-resume-screening/blob/main/frontend/src/components/Modal.jsx): `frontend/src/components/Modal.jsx`
- [Score badge](https://github.com/geethu27/ai-resume-screening/blob/main/frontend/src/components/ScoreBadge.jsx): `frontend/src/components/ScoreBadge.jsx`
- [API client](https://github.com/geethu27/ai-resume-screening/blob/main/frontend/src/services/api.js): `frontend/src/services/api.js`

### REST API

- [Flask application](https://github.com/geethu27/ai-resume-screening/blob/main/backend/app.py): `backend/app.py`
- [Recruiter authentication](https://github.com/geethu27/ai-resume-screening/blob/main/backend/routes/auth_routes.py): `backend/routes/auth_routes.py`
- [Job endpoints](https://github.com/geethu27/ai-resume-screening/blob/main/backend/routes/job_routes.py): `backend/routes/job_routes.py`
- [Resume endpoints](https://github.com/geethu27/ai-resume-screening/blob/main/backend/routes/resume_routes.py): `backend/routes/resume_routes.py`
- [Screening endpoints](https://github.com/geethu27/ai-resume-screening/blob/main/backend/routes/screening_routes.py): `backend/routes/screening_routes.py`
- [Candidate endpoints](https://github.com/geethu27/ai-resume-screening/blob/main/backend/routes/candidate_routes.py): `backend/routes/candidate_routes.py`

### Screening pipeline

- [File validation](https://github.com/geethu27/ai-resume-screening/blob/main/backend/utils/file_handler.py): `backend/utils/file_handler.py`
- [Resume text parser](https://github.com/geethu27/ai-resume-screening/blob/main/backend/services/resume_parser.py): `backend/services/resume_parser.py`
- [Text preprocessing](https://github.com/geethu27/ai-resume-screening/blob/main/backend/services/text_preprocessor.py): `backend/services/text_preprocessor.py`
- [Entity extraction](https://github.com/geethu27/ai-resume-screening/blob/main/backend/services/skill_extractor.py): `backend/services/skill_extractor.py`
- [Requirements matcher](https://github.com/geethu27/ai-resume-screening/blob/main/backend/services/matching_engine.py): `backend/services/matching_engine.py`
- [Deterministic scoring](https://github.com/geethu27/ai-resume-screening/blob/main/backend/services/scoring_engine.py): `backend/services/scoring_engine.py`
- [Candidate ranking](https://github.com/geethu27/ai-resume-screening/blob/main/backend/services/ranking_engine.py): `backend/services/ranking_engine.py`

### Persistence

- [Application database](https://github.com/geethu27/ai-resume-screening/blob/main/backend/models/database.py): `backend/models/database.py`

### Other components

- **Recruiter**

## Connections

- Recruiter → Application shell: uses (evidence: `README.md`)
- Application shell → Dashboard: routes to (evidence: `frontend/src/App.jsx`)
- Application shell → Job management: routes to (evidence: `frontend/src/App.jsx`)
- Application shell → Resume upload: routes to (evidence: `frontend/src/App.jsx`)
- Application shell → Screening review: routes to (evidence: `frontend/src/App.jsx`)
- Application shell → Candidate records: routes to (evidence: `frontend/src/App.jsx`)
- Screening review → Detail modal: renders (evidence: `frontend/src/pages/Screening.jsx`)
- Screening review → Score badge: renders (evidence: `frontend/src/pages/Screening.jsx`)
- Candidate records → Detail modal: renders (evidence: `frontend/src/pages/Candidates.jsx`)
- Candidate records → Score badge: renders (evidence: `frontend/src/pages/Candidates.jsx`)
- Dashboard → API client: requests data (evidence: `frontend/src/pages/Dashboard.jsx`)
- Job management → API client: requests jobs (evidence: `frontend/src/pages/Jobs.jsx`)
- Resume upload → API client: uploads resumes (evidence: `frontend/src/services/api.js`)
- Screening review → API client: requests screening (evidence: `frontend/src/pages/Screening.jsx`)
- Candidate records → API client: requests candidates (evidence: `frontend/src/pages/Candidates.jsx`)
- API client → Flask application: sends HTTP (evidence: `README.md`)
- Flask application → Recruiter authentication: registers routes (evidence: `backend/app.py`)
- Flask application → Job endpoints: registers routes (evidence: `backend/app.py`)
- Flask application → Resume endpoints: registers routes (evidence: `backend/app.py`)
- Flask application → Screening endpoints: registers routes (evidence: `backend/app.py`)
- Flask application → Candidate endpoints: registers routes (evidence: `backend/app.py`)
- Resume endpoints → File validation: saves upload (evidence: `backend/routes/resume_routes.py`)
- Resume endpoints → Resume text parser: parses resume (evidence: `backend/routes/resume_routes.py`)
- Resume endpoints → Text preprocessing: preprocesses text (evidence: `backend/routes/resume_routes.py`)
- Resume endpoints → Entity extraction: extracts entities (evidence: `backend/routes/resume_routes.py`)
- Screening endpoints → Requirements matcher: matches skills (evidence: `backend/routes/screening_routes.py`)
- Screening endpoints → Deterministic scoring: calculates score (evidence: `backend/routes/screening_routes.py`)
- Screening endpoints → Candidate ranking: ranks candidates (evidence: `backend/routes/screening_routes.py`)
- Screening endpoints → Application database: reads and writes (evidence: `backend/routes/screening_routes.py`)
- Resume endpoints → Application database: stores records (evidence: `backend/routes/resume_routes.py`)
- Job endpoints → Application database: stores jobs (evidence: `backend/routes/job_routes.py`)
- Recruiter authentication → Application database: checks credentials (evidence: `backend/routes/auth_routes.py`)
- Candidate endpoints → Application database: reads candidates (evidence: `backend/routes/candidate_routes.py`)
- Flask application → Application database: initializes (evidence: `backend/app.py`)
- Requirements matcher → Deterministic scoring: supplies match result (evidence: `README.md`)
- Deterministic scoring → Candidate ranking: scores before ranking (evidence: `README.md`)
