# deepakpadhi986/ai-resume-analyzer architecture

> Architecture diagram of the GitHub repository deepakpadhi986/ai-resume-analyzer, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/deepakpadhi986/ai-resume-analyzer
- Repository: https://github.com/deepakpadhi986/ai-resume-analyzer

## Overview

AI Resume Analyzer is a Streamlit application for applicants and recruiters. The main workflow is: an applicant uploads a PDF, the app extracts resume fields and skills, enriches location data, predicts a career field and experience level, generates recommendations and a score, then displays and stores the result. Separate admin and feedback routes support tabular analytics, CSV-oriented data access, ratings, and comments. The sampled code confirms parsing, MySQL writes/reads, geolocation, scoring, and feedback; some documented UI branches are represented at their enclosing App.py path.

Main entry points: [`App/App.py`](https://github.com/deepakpadhi986/ai-resume-analyzer/blob/main/App/App.py) (Streamlit App), [`pyresparser/resume_parser.py`](https://github.com/deepakpadhi986/ai-resume-analyzer/blob/main/pyresparser/resume_parser.py) (Resume Parser), [`App/Uploaded_Resumes`](https://github.com/deepakpadhi986/ai-resume-analyzer/tree/main/App/Uploaded_Resumes) (Uploaded PDFs), [`App/Courses.py`](https://github.com/deepakpadhi986/ai-resume-analyzer/blob/main/App/Courses.py) (Course Catalog)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Applicant Experience"]
  node_streamlit_app["Streamlit App<br/>[App.py]"]
end

subgraph group_analysis["Resume Analysis"]
  node_resume_parser["Resume Parser<br/>[resume_parser.py]"]
  node_resume_analysis["Resume Analysis<br/>[App.py]"]
  node_role_recommendation["Role Recommendations<br/>[App.py]"]
  node_score_guidance["Score And Tips<br/>[App.py]"]
end

subgraph group_content["Guidance Content"]
  node_course_catalog["Course Catalog<br/>[Courses.py]"]
  node_media_guidance["Video Guidance<br/>[Courses.py]"]
end

subgraph group_operations["Admin Operations"]
  node_applicant_store["Applicant Data Access<br/>[App.py]"]
  node_feedback_workflow["Feedback Workflow<br/>[App.py]"]
  node_admin_analytics["Admin Analytics<br/>[App.py]"]
  node_uploaded_pdfs["Uploaded PDFs"]
  node_mysql_cv[("CV MySQL Database")]
end

node_applicant(("Applicant"))
node_administrator(("Administrator"))
node_location_service["Geolocation Service"]

node_applicant -->|"uploads resume"| node_streamlit_app
node_streamlit_app -->|"parses PDF"| node_resume_parser
node_resume_parser -->|"returns fields"| node_streamlit_app
node_streamlit_app -->|"analyzes skills"| node_resume_analysis
node_streamlit_app -->|"predicts roles"| node_role_recommendation
node_streamlit_app -->|"calculates score"| node_score_guidance
node_streamlit_app -.->|"resolves location"| node_location_service
node_streamlit_app -->|"selects courses"| node_course_catalog
node_streamlit_app -->|"shows videos"| node_media_guidance
node_streamlit_app -->|"stores results"| node_applicant_store
node_applicant_store -->|"writes applicant data"| node_mysql_cv
node_streamlit_app -->|"saves PDFs"| node_uploaded_pdfs
node_applicant -->|"submits feedback"| node_feedback_workflow
node_feedback_workflow -->|"writes feedback"| node_mysql_cv
node_feedback_workflow -->|"reads comments"| node_mysql_cv
node_administrator -->|"opens admin view"| node_streamlit_app
node_streamlit_app -->|"renders analytics"| node_admin_analytics
node_admin_analytics -->|"reads applicant data"| node_mysql_cv
node_admin_analytics -->|"reads feedback"| node_mysql_cv
node_admin_analytics -->|"views saved PDFs"| node_uploaded_pdfs

click node_streamlit_app "https://github.com/deepakpadhi986/ai-resume-analyzer/blob/main/App/App.py"
click node_resume_parser "https://github.com/deepakpadhi986/ai-resume-analyzer/blob/main/pyresparser/resume_parser.py"
click node_resume_analysis "https://github.com/deepakpadhi986/ai-resume-analyzer/blob/main/App/App.py"
click node_role_recommendation "https://github.com/deepakpadhi986/ai-resume-analyzer/blob/main/App/App.py"
click node_score_guidance "https://github.com/deepakpadhi986/ai-resume-analyzer/blob/main/App/App.py"
click node_course_catalog "https://github.com/deepakpadhi986/ai-resume-analyzer/blob/main/App/Courses.py"
click node_media_guidance "https://github.com/deepakpadhi986/ai-resume-analyzer/blob/main/App/Courses.py"
click node_applicant_store "https://github.com/deepakpadhi986/ai-resume-analyzer/blob/main/App/App.py"
click node_feedback_workflow "https://github.com/deepakpadhi986/ai-resume-analyzer/blob/main/App/App.py"
click node_admin_analytics "https://github.com/deepakpadhi986/ai-resume-analyzer/blob/main/App/App.py"
click node_uploaded_pdfs "https://github.com/deepakpadhi986/ai-resume-analyzer/tree/main/App/Uploaded_Resumes"

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_streamlit_app toneBlue
class node_resume_parser,node_resume_analysis,node_role_recommendation,node_score_guidance toneAmber
class node_course_catalog,node_media_guidance toneMint
class node_applicant_store,node_feedback_workflow,node_admin_analytics,node_uploaded_pdfs,node_mysql_cv toneRose
class node_applicant,node_administrator,node_location_service toneIndigo
```

## Components

### Applicant Experience

- [Streamlit App](https://github.com/deepakpadhi986/ai-resume-analyzer/blob/main/App/App.py): `App/App.py`

### Resume Analysis

- [Resume Parser](https://github.com/deepakpadhi986/ai-resume-analyzer/blob/main/pyresparser/resume_parser.py): `pyresparser/resume_parser.py`
- [Resume Analysis](https://github.com/deepakpadhi986/ai-resume-analyzer/blob/main/App/App.py): `App/App.py`
- [Role Recommendations](https://github.com/deepakpadhi986/ai-resume-analyzer/blob/main/App/App.py): `App/App.py`
- [Score And Tips](https://github.com/deepakpadhi986/ai-resume-analyzer/blob/main/App/App.py): `App/App.py`

### Guidance Content

- [Course Catalog](https://github.com/deepakpadhi986/ai-resume-analyzer/blob/main/App/Courses.py): `App/Courses.py`
- [Video Guidance](https://github.com/deepakpadhi986/ai-resume-analyzer/blob/main/App/Courses.py): `App/Courses.py`

### Admin Operations

- [Applicant Data Access](https://github.com/deepakpadhi986/ai-resume-analyzer/blob/main/App/App.py): `App/App.py`
- [Feedback Workflow](https://github.com/deepakpadhi986/ai-resume-analyzer/blob/main/App/App.py): `App/App.py`
- [Admin Analytics](https://github.com/deepakpadhi986/ai-resume-analyzer/blob/main/App/App.py): `App/App.py`
- [Uploaded PDFs](https://github.com/deepakpadhi986/ai-resume-analyzer/tree/main/App/Uploaded_Resumes): `App/Uploaded_Resumes`
- **CV MySQL Database**

### Other components

- **Applicant**
- **Administrator**
- **Geolocation Service**

## Connections

- Applicant → Streamlit App: uploads resume
- Streamlit App → Resume Parser: parses PDF
- Resume Parser → Streamlit App: returns fields
- Streamlit App → Resume Analysis: analyzes skills
- Streamlit App → Role Recommendations: predicts roles
- Streamlit App → Score And Tips: calculates score
- Streamlit App → Geolocation Service: resolves location
- Streamlit App → Course Catalog: selects courses
- Streamlit App → Video Guidance: shows videos
- Streamlit App → Applicant Data Access: stores results
- Applicant Data Access → CV MySQL Database: writes applicant data
- Streamlit App → Uploaded PDFs: saves PDFs
- Applicant → Feedback Workflow: submits feedback
- Feedback Workflow → CV MySQL Database: writes feedback
- Feedback Workflow → CV MySQL Database: reads comments
- Administrator → Streamlit App: opens admin view
- Streamlit App → Admin Analytics: renders analytics
- Admin Analytics → CV MySQL Database: reads applicant data
- Admin Analytics → CV MySQL Database: reads feedback
- Admin Analytics → Uploaded PDFs: views saved PDFs
