# giridharreddy1/resume-analyzer architecture

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

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

## Overview

ResumeIQ is a resume-analysis application: a user signs in, uploads a PDF, and receives text preview, component scores, ATS essentials, and AI-generated feedback. The React application stores accounts and sessions in browser localStorage; its upload request reaches a FastAPI endpoint, which extracts text and invokes separate analysis modules before assembling the response. The source tree also contains a Vite starter App.tsx alongside the ResumeIQ App.jsx; the provided entry points show both variants. Backend calls are visible in main.py; the grammar, readability, and ATS internals are not fully sampled.

Main entry points: [`resume-analyzer/backend/main.py`](https://github.com/giridharreddy1/resume-analyzer/blob/main/resume-analyzer/backend/main.py) (Upload endpoint), [`frontend/src/App.jsx`](https://github.com/giridharreddy1/resume-analyzer/blob/main/frontend/src/App.jsx) (ResumeIQ interface), [`frontend/src/AuthContext.jsx`](https://github.com/giridharreddy1/resume-analyzer/blob/main/frontend/src/AuthContext.jsx) (Local auth), [`frontend/src/App.tsx`](https://github.com/giridharreddy1/resume-analyzer/blob/main/frontend/src/App.tsx) (Vite starter UI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["ResumeIQ client"]
  node_resume_app["ResumeIQ interface<br/>[App.jsx]"]
  node_auth["Local auth<br/>[AuthContext.jsx]"]
  node_browser_store[("Browser storage")]
  node_starter_app["Vite starter UI<br/>[App.tsx]"]
end

subgraph group_api["Analysis API"]
  node_upload_api["Upload endpoint<br/>[main.py]"]
end

subgraph group_analysis["Resume analysis"]
  node_pdf_parser["PDF extraction<br/>[parser.py]"]
  node_structure["Structure scoring<br/>[scoring.py]"]
  node_grammar["Grammar scoring<br/>[grammar.py]"]
  node_readability["Readability scoring<br/>[readability.py]"]
  node_ats["ATS checks<br/>[ats_checks.py]"]
  node_ai_feedback["AI feedback<br/>[ai_analysis.py]"]
end

node_user(("Resume user"))
node_browser(("Web browser"))

node_user -->|"uses"| node_resume_app
node_resume_app -->|"uses auth"| node_auth
node_auth -->|"reads/writes"| node_browser_store
node_browser -->|"runs"| node_resume_app
node_browser -->|"runs"| node_starter_app
node_resume_app -->|"posts PDF"| node_upload_api
node_upload_api -->|"extracts text"| node_pdf_parser
node_upload_api -->|"scores structure"| node_structure
node_upload_api -->|"scores grammar"| node_grammar
node_upload_api -->|"scores readability"| node_readability
node_upload_api -->|"checks ATS"| node_ats
node_upload_api -->|"analyzes resume"| node_ai_feedback
node_upload_api -->|"returns results"| node_resume_app

click node_resume_app "https://github.com/giridharreddy1/resume-analyzer/blob/main/frontend/src/App.jsx"
click node_auth "https://github.com/giridharreddy1/resume-analyzer/blob/main/frontend/src/AuthContext.jsx"
click node_starter_app "https://github.com/giridharreddy1/resume-analyzer/blob/main/frontend/src/App.tsx"
click node_upload_api "https://github.com/giridharreddy1/resume-analyzer/blob/main/resume-analyzer/backend/main.py"
click node_pdf_parser "https://github.com/giridharreddy1/resume-analyzer/blob/main/resume-analyzer/backend/utils/parser.py"
click node_structure "https://github.com/giridharreddy1/resume-analyzer/blob/main/resume-analyzer/backend/utils/scoring.py"
click node_grammar "https://github.com/giridharreddy1/resume-analyzer/blob/main/resume-analyzer/backend/utils/grammar.py"
click node_readability "https://github.com/giridharreddy1/resume-analyzer/blob/main/resume-analyzer/backend/utils/readability.py"
click node_ats "https://github.com/giridharreddy1/resume-analyzer/blob/main/resume-analyzer/backend/utils/ats_checks.py"
click node_ai_feedback "https://github.com/giridharreddy1/resume-analyzer/blob/main/resume-analyzer/backend/utils/ai_analysis.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_resume_app,node_auth,node_browser_store,node_starter_app,node_user,node_browser toneBlue
class node_upload_api toneAmber
class node_pdf_parser,node_structure,node_grammar,node_readability,node_ats,node_ai_feedback toneMint
```

## Components

### ResumeIQ client

- [ResumeIQ interface](https://github.com/giridharreddy1/resume-analyzer/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Local auth](https://github.com/giridharreddy1/resume-analyzer/blob/main/frontend/src/AuthContext.jsx): `frontend/src/AuthContext.jsx`
- **Browser storage**
- [Vite starter UI](https://github.com/giridharreddy1/resume-analyzer/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`

### Analysis API

- [Upload endpoint](https://github.com/giridharreddy1/resume-analyzer/blob/main/resume-analyzer/backend/main.py): `resume-analyzer/backend/main.py`

### Resume analysis

- [PDF extraction](https://github.com/giridharreddy1/resume-analyzer/blob/main/resume-analyzer/backend/utils/parser.py): `resume-analyzer/backend/utils/parser.py`
- [Structure scoring](https://github.com/giridharreddy1/resume-analyzer/blob/main/resume-analyzer/backend/utils/scoring.py): `resume-analyzer/backend/utils/scoring.py`
- [Grammar scoring](https://github.com/giridharreddy1/resume-analyzer/blob/main/resume-analyzer/backend/utils/grammar.py): `resume-analyzer/backend/utils/grammar.py`
- [Readability scoring](https://github.com/giridharreddy1/resume-analyzer/blob/main/resume-analyzer/backend/utils/readability.py): `resume-analyzer/backend/utils/readability.py`
- [ATS checks](https://github.com/giridharreddy1/resume-analyzer/blob/main/resume-analyzer/backend/utils/ats_checks.py): `resume-analyzer/backend/utils/ats_checks.py`
- [AI feedback](https://github.com/giridharreddy1/resume-analyzer/blob/main/resume-analyzer/backend/utils/ai_analysis.py): `resume-analyzer/backend/utils/ai_analysis.py`

### Other components

- **Resume user**
- **Web browser**

## Connections

- Resume user → ResumeIQ interface: uses (evidence: `frontend/src/App.jsx`)
- ResumeIQ interface → Local auth: uses auth (evidence: `frontend/src/App.jsx`)
- Local auth → Browser storage: reads/writes (evidence: `frontend/src/AuthContext.jsx`)
- Web browser → ResumeIQ interface: runs
- Web browser → Vite starter UI: runs
- ResumeIQ interface → Upload endpoint: posts PDF (evidence: `frontend/src/App.jsx`)
- Upload endpoint → PDF extraction: extracts text (evidence: `resume-analyzer/backend/main.py`)
- Upload endpoint → Structure scoring: scores structure (evidence: `resume-analyzer/backend/main.py`)
- Upload endpoint → Grammar scoring: scores grammar (evidence: `resume-analyzer/backend/main.py`)
- Upload endpoint → Readability scoring: scores readability (evidence: `resume-analyzer/backend/main.py`)
- Upload endpoint → ATS checks: checks ATS (evidence: `resume-analyzer/backend/main.py`)
- Upload endpoint → AI feedback: analyzes resume (evidence: `resume-analyzer/backend/main.py`)
- Upload endpoint → ResumeIQ interface: returns results (evidence: `frontend/src/App.jsx`)
