# iam-sharath/ai-resume-analyzer architecture

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

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

## Overview

This is a resume-to-job-description analyzer. A user submits a resume file and job description through the browser; the API accepts the request, extracts resume text, and analyzes skill overlap, similarity, and recommendations. Results are displayed in the frontend, which also has chart and PDF-report components. The excerpts establish the backend orchestration and UI chart calls; the API client’s HTTP wiring and PDF export invocation were not shown, so those links are marked unverified.

Main entry points: [`backend/src/services/skillMatcher.js`](https://github.com/iam-sharath/ai-resume-analyzer/blob/main/backend/src/services/skillMatcher.js) (Skill matcher), [`frontend/js/app.js`](https://github.com/iam-sharath/ai-resume-analyzer/blob/main/frontend/js/app.js) (Analyzer UI), [`backend/src/controllers/analyzerController.js`](https://github.com/iam-sharath/ai-resume-analyzer/blob/main/backend/src/controllers/analyzerController.js) (Analysis controller), [`frontend/js/api.js`](https://github.com/iam-sharath/ai-resume-analyzer/blob/main/frontend/js/api.js) (API client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Browser experience"]
  node_app["Analyzer UI<br/>[app.js]"]
  node_api_client["API client<br/>[api.js]"]
  node_charts["Result charts<br/>[charts.js]"]
  node_pdf_report["PDF report<br/>[pdfReport.js]"]
end

subgraph group_api["API handling"]
  node_server["API server<br/>[server.js]"]
  node_routes["Analyzer routes<br/>[analyzerRoutes.js]"]
  node_controller["Analysis controller"]
end

subgraph group_analysis["Resume analysis"]
  node_extractor["Resume extractor<br/>[textExtractor.js]"]
  node_matcher["Skill matcher<br/>[skillMatcher.js]"]
end

subgraph group_matching["Matching internals"]
  node_nlp["NLP processor<br/>[nlpProcessor.js]"]
  node_skills_db[("Skills catalog<br/>[skillsDatabase.js]")]
  node_tfidf["TF-IDF vectors<br/>[tfidf.js]"]
  node_similarity["Similarity metrics"]
end

node_user(("User"))

node_user -->|"submits resume"| node_app
node_app -->|"requests analysis"| node_api_client
node_api_client -.->|"sends request"| node_server
node_server -->|"mounts routes"| node_routes
node_routes -->|"dispatches requests"| node_controller
node_controller -->|"extracts file text"| node_extractor
node_extractor -->|"returns text"| node_controller
node_controller -->|"analyzes text"| node_matcher
node_matcher -->|"extracts skills"| node_nlp
node_nlp -->|"uses skill catalog"| node_skills_db
node_matcher -->|"uses weights and categories"| node_skills_db
node_matcher -->|"builds text vectors"| node_tfidf
node_matcher -->|"calculates similarity"| node_similarity
node_app -->|"creates charts"| node_charts
node_app -.->|"exports report"| node_pdf_report

click node_app "https://github.com/iam-sharath/ai-resume-analyzer/blob/main/frontend/js/app.js"
click node_api_client "https://github.com/iam-sharath/ai-resume-analyzer/blob/main/frontend/js/api.js"
click node_charts "https://github.com/iam-sharath/ai-resume-analyzer/blob/main/frontend/js/charts.js"
click node_pdf_report "https://github.com/iam-sharath/ai-resume-analyzer/blob/main/frontend/js/pdfReport.js"
click node_server "https://github.com/iam-sharath/ai-resume-analyzer/blob/main/backend/server.js"
click node_routes "https://github.com/iam-sharath/ai-resume-analyzer/blob/main/backend/src/routes/analyzerRoutes.js"
click node_controller "https://github.com/iam-sharath/ai-resume-analyzer/blob/main/backend/src/controllers/analyzerController.js"
click node_extractor "https://github.com/iam-sharath/ai-resume-analyzer/blob/main/backend/src/services/textExtractor.js"
click node_matcher "https://github.com/iam-sharath/ai-resume-analyzer/blob/main/backend/src/services/skillMatcher.js"
click node_nlp "https://github.com/iam-sharath/ai-resume-analyzer/blob/main/backend/src/services/nlpProcessor.js"
click node_skills_db "https://github.com/iam-sharath/ai-resume-analyzer/blob/main/backend/src/data/skillsDatabase.js"
click node_tfidf "https://github.com/iam-sharath/ai-resume-analyzer/blob/main/backend/src/utils/tfidf.js"
click node_similarity "https://github.com/iam-sharath/ai-resume-analyzer/blob/main/backend/src/utils/cosineSimilarity.js"

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_api_client,node_charts,node_pdf_report,node_user toneBlue
class node_server,node_routes,node_controller toneAmber
class node_extractor,node_matcher toneMint
class node_nlp,node_skills_db,node_tfidf,node_similarity toneRose
```

## Components

### Browser experience

- [Analyzer UI](https://github.com/iam-sharath/ai-resume-analyzer/blob/main/frontend/js/app.js): `frontend/js/app.js`
- [API client](https://github.com/iam-sharath/ai-resume-analyzer/blob/main/frontend/js/api.js): `frontend/js/api.js`
- [Result charts](https://github.com/iam-sharath/ai-resume-analyzer/blob/main/frontend/js/charts.js): `frontend/js/charts.js`
- [PDF report](https://github.com/iam-sharath/ai-resume-analyzer/blob/main/frontend/js/pdfReport.js): `frontend/js/pdfReport.js`

### API handling

- [API server](https://github.com/iam-sharath/ai-resume-analyzer/blob/main/backend/server.js): `backend/server.js`
- [Analyzer routes](https://github.com/iam-sharath/ai-resume-analyzer/blob/main/backend/src/routes/analyzerRoutes.js): `backend/src/routes/analyzerRoutes.js`
- [Analysis controller](https://github.com/iam-sharath/ai-resume-analyzer/blob/main/backend/src/controllers/analyzerController.js): `backend/src/controllers/analyzerController.js`

### Resume analysis

- [Resume extractor](https://github.com/iam-sharath/ai-resume-analyzer/blob/main/backend/src/services/textExtractor.js): `backend/src/services/textExtractor.js`
- [Skill matcher](https://github.com/iam-sharath/ai-resume-analyzer/blob/main/backend/src/services/skillMatcher.js): `backend/src/services/skillMatcher.js`

### Matching internals

- [NLP processor](https://github.com/iam-sharath/ai-resume-analyzer/blob/main/backend/src/services/nlpProcessor.js): `backend/src/services/nlpProcessor.js`
- [Skills catalog](https://github.com/iam-sharath/ai-resume-analyzer/blob/main/backend/src/data/skillsDatabase.js): `backend/src/data/skillsDatabase.js`
- [TF-IDF vectors](https://github.com/iam-sharath/ai-resume-analyzer/blob/main/backend/src/utils/tfidf.js): `backend/src/utils/tfidf.js`
- [Similarity metrics](https://github.com/iam-sharath/ai-resume-analyzer/blob/main/backend/src/utils/cosineSimilarity.js): `backend/src/utils/cosineSimilarity.js`

### Other components

- **User**

## Connections

- User → Analyzer UI: submits resume (evidence: `frontend/js/app.js`)
- Analyzer UI → API client: requests analysis (evidence: `frontend/js/app.js`)
- API client → API server: sends request
- API server → Analyzer routes: mounts routes (evidence: `backend/server.js`)
- Analyzer routes → Analysis controller: dispatches requests (evidence: `backend/src/routes/analyzerRoutes.js`)
- Analysis controller → Resume extractor: extracts file text (evidence: `backend/src/controllers/analyzerController.js`)
- Resume extractor → Analysis controller: returns text (evidence: `backend/src/controllers/analyzerController.js`)
- Analysis controller → Skill matcher: analyzes text (evidence: `backend/src/controllers/analyzerController.js`)
- Skill matcher → NLP processor: extracts skills (evidence: `backend/src/services/skillMatcher.js`)
- NLP processor → Skills catalog: uses skill catalog (evidence: `backend/src/services/nlpProcessor.js`)
- Skill matcher → Skills catalog: uses weights and categories (evidence: `backend/src/services/skillMatcher.js`)
- Skill matcher → TF-IDF vectors: builds text vectors (evidence: `backend/src/services/skillMatcher.js`)
- Skill matcher → Similarity metrics: calculates similarity (evidence: `backend/src/services/skillMatcher.js`)
- Analyzer UI → Result charts: creates charts (evidence: `frontend/js/app.js`)
- Analyzer UI → PDF report: exports report
