# rudipp/ai-powered-resume-screening architecture

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

## Overview

This is a Flask resume-screening and recruiting application. Recruiters submit a job description and resume files; the app invokes screening and presents ranked candidate matches. The repository also includes candidate-facing pages and a separate resume-search capability. The graph reflects the sampled screening and search code plus documented matching features; several app routes and candidate workflows were not fully excerpted, so their internal relationships are not expanded.

Main entry points: [`app.py`](https://github.com/rudipp/ai-powered-resume-screening/blob/master/app.py) (Flask app), [`screen.py`](https://github.com/rudipp/ai-powered-resume-screening/blob/master/screen.py) (Resume screening), [`search.py`](https://github.com/rudipp/ai-powered-resume-screening/blob/master/search.py) (Resume search), [`Original_Resumes`](https://github.com/rudipp/ai-powered-resume-screening/tree/master/Original_Resumes) (Resume files)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_flask_app["Flask app<br/>[app.py]"]
  node_templates["Recruiting pages"]
end

subgraph group_matching["Resume matching"]
  node_screening["Resume screening<br/>[screen.py]"]
end

subgraph group_search["Resume search"]
  node_search["Resume search<br/>[search.py]"]
  node_pdf_extract["PDF extraction<br/>[pdf2txt.py]"]
end

subgraph group_data["Recruiting data"]
  node_resume_files["Resume files"]
  node_job_files["Job descriptions"]
end

node_recruiter(("Recruiter"))
node_candidate(("Candidate"))

node_recruiter -->|"submits screening"| node_flask_app
node_candidate -.->|"uses portal"| node_flask_app
node_flask_app -->|"invokes screening"| node_screening
node_screening -->|"reads resumes"| node_resume_files
node_screening -->|"reads description"| node_job_files
node_screening -.->|"returns matches"| node_flask_app
node_flask_app -->|"renders pages"| node_templates
node_flask_app -->|"invokes search"| node_search
node_search -->|"searches resumes"| node_resume_files
node_search -->|"uses extraction"| node_pdf_extract

click node_flask_app "https://github.com/rudipp/ai-powered-resume-screening/blob/master/app.py"
click node_templates "https://github.com/rudipp/ai-powered-resume-screening/tree/master/templates"
click node_screening "https://github.com/rudipp/ai-powered-resume-screening/blob/master/screen.py"
click node_resume_files "https://github.com/rudipp/ai-powered-resume-screening/tree/master/Original_Resumes"
click node_job_files "https://github.com/rudipp/ai-powered-resume-screening/tree/master/Job_Description"
click node_search "https://github.com/rudipp/ai-powered-resume-screening/blob/master/search.py"
click node_pdf_extract "https://github.com/rudipp/ai-powered-resume-screening/blob/master/pdf2txt.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_flask_app,node_templates toneBlue
class node_screening toneAmber
class node_search,node_pdf_extract toneMint
class node_resume_files,node_job_files toneRose
class node_recruiter,node_candidate toneIndigo
```

## Components

### Web application

- [Flask app](https://github.com/rudipp/ai-powered-resume-screening/blob/master/app.py): `app.py`
- [Recruiting pages](https://github.com/rudipp/ai-powered-resume-screening/tree/master/templates): `templates`

### Resume matching

- [Resume screening](https://github.com/rudipp/ai-powered-resume-screening/blob/master/screen.py): `screen.py`

### Resume search

- [Resume search](https://github.com/rudipp/ai-powered-resume-screening/blob/master/search.py): `search.py`
- [PDF extraction](https://github.com/rudipp/ai-powered-resume-screening/blob/master/pdf2txt.py): `pdf2txt.py`

### Recruiting data

- [Resume files](https://github.com/rudipp/ai-powered-resume-screening/tree/master/Original_Resumes): `Original_Resumes`
- [Job descriptions](https://github.com/rudipp/ai-powered-resume-screening/tree/master/Job_Description): `Job_Description`

### Other components

- **Recruiter**
- **Candidate**

## Connections

- Recruiter → Flask app: submits screening (evidence: `README.md`)
- Candidate → Flask app: uses portal
- Flask app → Resume screening: invokes screening (evidence: `app.py`)
- Resume screening → Resume files: reads resumes (evidence: `screen.py`)
- Resume screening → Job descriptions: reads description (evidence: `screen.py`)
- Resume screening → Flask app: returns matches (evidence: `app.py`)
- Flask app → Recruiting pages: renders pages (evidence: `app.py`)
- Flask app → Resume search: invokes search (evidence: `app.py`)
- Resume search → Resume files: searches resumes (evidence: `search.py`)
- Resume search → PDF extraction: uses extraction (evidence: `search.py`)
