# girishelankonda/ai_resume_analyzer architecture

> Architecture diagram of the GitHub repository girishelankonda/ai_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/girishelankonda/ai_resume_analyzer
- Repository: https://github.com/girishelankonda/ai_resume_analyzer

## Overview

AI Resume Analyzer lets job seekers upload a PDF and job description, receive analysis, and revisit or enhance saved results. The backend parses and analyzes resumes, persists results, and exposes supporting features such as comparisons, cover letters, and interview questions; the React app provides login, dashboard, history, detail, and admin views. The graph covers the README’s major capabilities. Some UI and service internals are unsampled, so only documented or indexed relationships are shown.

Main entry points: [`backend_ai/Controllers/resume.js`](https://github.com/girishelankonda/ai_resume_analyzer/blob/main/backend_ai/Controllers/resume.js) (Resume workflows), [`backend_ai/services/resumeAnalysisService.js`](https://github.com/girishelankonda/ai_resume_analyzer/blob/main/backend_ai/services/resumeAnalysisService.js) (Resume analysis), [`mern_ai/src/utils/axios.js`](https://github.com/girishelankonda/ai_resume_analyzer/blob/main/mern_ai/src/utils/axios.js) (API client), [`backend_ai/services/cohereService.js`](https://github.com/girishelankonda/ai_resume_analyzer/blob/main/backend_ai/services/cohereService.js) (Cohere service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web application"]
  node_appui["App routes<br/>[App.jsx]"]
  node_login["Login<br/>[Login.jsx]"]
  node_auth["Auth state<br/>[AuthContext.jsx]"]
  node_firebase["Firebase auth<br/>[firebase.jsx]"]
  node_guard["Route guard<br/>[withAuthHOC.jsx]"]
  node_dashboard["Resume dashboard<br/>[Dashboard.jsx]"]
  node_results["Analysis results"]
  node_history["Resume history<br/>[History.jsx]"]
  node_detail["Analysis detail<br/>[AnalysisDetail.jsx]"]
  node_adminui["Admin dashboard<br/>[Admin.jsx]"]
  node_http["API client<br/>[axios.js]"]
end

subgraph group_api["API and persistence"]
  node_express["API application<br/>[app.js]"]
  node_resumeroutes["Resume routes<br/>[resume.js]"]
  node_userroutes["User routes<br/>[user.js]"]
  node_resumecontroller["Resume workflows<br/>[resume.js]"]
  node_usercontroller["User workflows<br/>[user.js]"]
  node_resumemodel[("Resume records<br/>[resume.js]")]
  node_usermodel[("User records<br/>[user.js]")]
  node_upload["PDF upload<br/>[multer.js]"]
end

subgraph group_analysis["Resume analysis"]
  node_analysisservice["Resume analysis"]
  node_ats["ATS scoring"]
  node_keywords["Keyword analysis<br/>[keywordService.js]"]
  node_quality["Quality assessment"]
  node_improvement["Resume improvement"]
  node_comparison["Resume comparison"]
  node_cover["Cover letters"]
  node_interview["Interview prep"]
end

subgraph group_ai["AI integrations"]
  node_cohere["Cohere service<br/>[cohereService.js]"]
  node_parser["AI response parser"]
end

node_seeker(("Job seeker"))
node_admin(("Administrator"))
node_cohereapi(("Cohere API"))
node_mongodb[("MongoDB")]
node_firebaseext(("Firebase"))

node_seeker -->|"signs in"| node_login
node_login -->|"authenticates"| node_firebase
node_login -->|"updates session"| node_auth
node_firebase -->|"authenticates with"| node_firebaseext
node_appui -->|"routes to"| node_dashboard
node_appui -->|"routes to"| node_history
node_appui -->|"routes to"| node_detail
node_appui -->|"routes to"| node_adminui
node_dashboard -->|"uses"| node_guard
node_history -->|"uses"| node_guard
node_detail -->|"uses"| node_guard
node_dashboard -->|"renders"| node_results
node_dashboard -->|"requests data"| node_http
node_history -->|"requests history"| node_http
node_detail -->|"requests analysis"| node_http
node_adminui -->|"requests data"| node_http
node_http -->|"calls API"| node_express
node_express -->|"mounts"| node_resumeroutes
node_express -->|"mounts"| node_userroutes
node_resumeroutes -->|"handles upload"| node_upload
node_resumeroutes -->|"dispatches to"| node_resumecontroller
node_userroutes -->|"dispatches to"| node_usercontroller
node_resumecontroller -->|"reads and writes"| node_resumemodel
node_resumecontroller -->|"analyzes resume"| node_analysisservice
node_resumecontroller -->|"improves sections"| node_improvement
node_resumecontroller -->|"compares resumes"| node_comparison
node_resumecontroller -->|"generates letters"| node_cover
node_resumecontroller -->|"generates questions"| node_interview
node_usercontroller -->|"reads and writes"| node_usermodel
node_express -->|"connects through"| node_mongodb
node_analysisservice -->|"builds and merges scores"| node_ats
node_analysisservice -->|"assesses quality"| node_quality
node_ats -->|"matches keywords"| node_keywords
node_analysisservice -->|"requests analysis"| node_cohere
node_analysisservice -->|"parses response"| node_parser
node_cohere -->|"sends prompts"| node_cohereapi
node_resumecontroller -.->|"persists results"| node_mongodb
node_improvement -->|"uses AI"| node_cohere
node_cover -->|"uses AI"| node_cohere
node_interview -->|"uses AI"| node_cohere

click node_appui "https://github.com/girishelankonda/ai_resume_analyzer/blob/main/mern_ai/src/App.jsx"
click node_login "https://github.com/girishelankonda/ai_resume_analyzer/blob/main/mern_ai/src/component/Login/Login.jsx"
click node_auth "https://github.com/girishelankonda/ai_resume_analyzer/blob/main/mern_ai/src/utils/AuthContext.jsx"
click node_firebase "https://github.com/girishelankonda/ai_resume_analyzer/blob/main/mern_ai/src/utils/firebase.jsx"
click node_guard "https://github.com/girishelankonda/ai_resume_analyzer/blob/main/mern_ai/src/utils/HOC/withAuthHOC.jsx"
click node_dashboard "https://github.com/girishelankonda/ai_resume_analyzer/blob/main/mern_ai/src/component/Dashboard/Dashboard.jsx"
click node_results "https://github.com/girishelankonda/ai_resume_analyzer/blob/main/mern_ai/src/component/AnalysisResults/AnalysisResults.jsx"
click node_history "https://github.com/girishelankonda/ai_resume_analyzer/blob/main/mern_ai/src/component/History/History.jsx"
click node_detail "https://github.com/girishelankonda/ai_resume_analyzer/blob/main/mern_ai/src/component/AnalysisDetail/AnalysisDetail.jsx"
click node_adminui "https://github.com/girishelankonda/ai_resume_analyzer/blob/main/mern_ai/src/component/Admin/Admin.jsx"
click node_http "https://github.com/girishelankonda/ai_resume_analyzer/blob/main/mern_ai/src/utils/axios.js"
click node_express "https://github.com/girishelankonda/ai_resume_analyzer/blob/main/backend_ai/app.js"
click node_resumeroutes "https://github.com/girishelankonda/ai_resume_analyzer/blob/main/backend_ai/Routes/resume.js"
click node_userroutes "https://github.com/girishelankonda/ai_resume_analyzer/blob/main/backend_ai/Routes/user.js"
click node_resumecontroller "https://github.com/girishelankonda/ai_resume_analyzer/blob/main/backend_ai/Controllers/resume.js"
click node_usercontroller "https://github.com/girishelankonda/ai_resume_analyzer/blob/main/backend_ai/Controllers/user.js"
click node_resumemodel "https://github.com/girishelankonda/ai_resume_analyzer/blob/main/backend_ai/Models/resume.js"
click node_usermodel "https://github.com/girishelankonda/ai_resume_analyzer/blob/main/backend_ai/Models/user.js"
click node_upload "https://github.com/girishelankonda/ai_resume_analyzer/blob/main/backend_ai/utils/multer.js"
click node_analysisservice "https://github.com/girishelankonda/ai_resume_analyzer/blob/main/backend_ai/services/resumeAnalysisService.js"
click node_ats "https://github.com/girishelankonda/ai_resume_analyzer/blob/main/backend_ai/services/atsScoringService.js"
click node_keywords "https://github.com/girishelankonda/ai_resume_analyzer/blob/main/backend_ai/services/keywordService.js"
click node_quality "https://github.com/girishelankonda/ai_resume_analyzer/blob/main/backend_ai/services/resumeQualityService.js"
click node_improvement "https://github.com/girishelankonda/ai_resume_analyzer/blob/main/backend_ai/services/resumeImprovementService.js"
click node_comparison "https://github.com/girishelankonda/ai_resume_analyzer/blob/main/backend_ai/services/comparisonService.js"
click node_cover "https://github.com/girishelankonda/ai_resume_analyzer/blob/main/backend_ai/services/coverLetterService.js"
click node_interview "https://github.com/girishelankonda/ai_resume_analyzer/blob/main/backend_ai/services/interviewQuestionService.js"
click node_cohere "https://github.com/girishelankonda/ai_resume_analyzer/blob/main/backend_ai/services/cohereService.js"
click node_parser "https://github.com/girishelankonda/ai_resume_analyzer/blob/main/backend_ai/services/aiResponseParser.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_appui,node_login,node_auth,node_firebase,node_guard,node_dashboard,node_results,node_history,node_detail,node_adminui,node_http toneBlue
class node_express,node_resumeroutes,node_userroutes,node_resumecontroller,node_usercontroller,node_resumemodel,node_usermodel,node_upload,node_mongodb toneAmber
class node_analysisservice,node_ats,node_keywords,node_quality,node_improvement,node_comparison,node_cover,node_interview,node_cohereapi toneMint
class node_cohere,node_parser toneRose
class node_seeker,node_admin,node_firebaseext toneIndigo
```

## Components

### Web application

- [App routes](https://github.com/girishelankonda/ai_resume_analyzer/blob/main/mern_ai/src/App.jsx): `mern_ai/src/App.jsx`
- [Login](https://github.com/girishelankonda/ai_resume_analyzer/blob/main/mern_ai/src/component/Login/Login.jsx): `mern_ai/src/component/Login/Login.jsx`
- [Auth state](https://github.com/girishelankonda/ai_resume_analyzer/blob/main/mern_ai/src/utils/AuthContext.jsx): `mern_ai/src/utils/AuthContext.jsx`
- [Firebase auth](https://github.com/girishelankonda/ai_resume_analyzer/blob/main/mern_ai/src/utils/firebase.jsx): `mern_ai/src/utils/firebase.jsx`
- [Route guard](https://github.com/girishelankonda/ai_resume_analyzer/blob/main/mern_ai/src/utils/HOC/withAuthHOC.jsx): `mern_ai/src/utils/HOC/withAuthHOC.jsx`
- [Resume dashboard](https://github.com/girishelankonda/ai_resume_analyzer/blob/main/mern_ai/src/component/Dashboard/Dashboard.jsx): `mern_ai/src/component/Dashboard/Dashboard.jsx`
- [Analysis results](https://github.com/girishelankonda/ai_resume_analyzer/blob/main/mern_ai/src/component/AnalysisResults/AnalysisResults.jsx): `mern_ai/src/component/AnalysisResults/AnalysisResults.jsx`
- [Resume history](https://github.com/girishelankonda/ai_resume_analyzer/blob/main/mern_ai/src/component/History/History.jsx): `mern_ai/src/component/History/History.jsx`
- [Analysis detail](https://github.com/girishelankonda/ai_resume_analyzer/blob/main/mern_ai/src/component/AnalysisDetail/AnalysisDetail.jsx): `mern_ai/src/component/AnalysisDetail/AnalysisDetail.jsx`
- [Admin dashboard](https://github.com/girishelankonda/ai_resume_analyzer/blob/main/mern_ai/src/component/Admin/Admin.jsx): `mern_ai/src/component/Admin/Admin.jsx`
- [API client](https://github.com/girishelankonda/ai_resume_analyzer/blob/main/mern_ai/src/utils/axios.js): `mern_ai/src/utils/axios.js`

### API and persistence

- [API application](https://github.com/girishelankonda/ai_resume_analyzer/blob/main/backend_ai/app.js): `backend_ai/app.js`
- [Resume routes](https://github.com/girishelankonda/ai_resume_analyzer/blob/main/backend_ai/Routes/resume.js): `backend_ai/Routes/resume.js`
- [User routes](https://github.com/girishelankonda/ai_resume_analyzer/blob/main/backend_ai/Routes/user.js): `backend_ai/Routes/user.js`
- [Resume workflows](https://github.com/girishelankonda/ai_resume_analyzer/blob/main/backend_ai/Controllers/resume.js): `backend_ai/Controllers/resume.js`
- [User workflows](https://github.com/girishelankonda/ai_resume_analyzer/blob/main/backend_ai/Controllers/user.js): `backend_ai/Controllers/user.js`
- [Resume records](https://github.com/girishelankonda/ai_resume_analyzer/blob/main/backend_ai/Models/resume.js): `backend_ai/Models/resume.js`
- [User records](https://github.com/girishelankonda/ai_resume_analyzer/blob/main/backend_ai/Models/user.js): `backend_ai/Models/user.js`
- [PDF upload](https://github.com/girishelankonda/ai_resume_analyzer/blob/main/backend_ai/utils/multer.js): `backend_ai/utils/multer.js`

### Resume analysis

- [Resume analysis](https://github.com/girishelankonda/ai_resume_analyzer/blob/main/backend_ai/services/resumeAnalysisService.js): `backend_ai/services/resumeAnalysisService.js`
- [ATS scoring](https://github.com/girishelankonda/ai_resume_analyzer/blob/main/backend_ai/services/atsScoringService.js): `backend_ai/services/atsScoringService.js`
- [Keyword analysis](https://github.com/girishelankonda/ai_resume_analyzer/blob/main/backend_ai/services/keywordService.js): `backend_ai/services/keywordService.js`
- [Quality assessment](https://github.com/girishelankonda/ai_resume_analyzer/blob/main/backend_ai/services/resumeQualityService.js): `backend_ai/services/resumeQualityService.js`
- [Resume improvement](https://github.com/girishelankonda/ai_resume_analyzer/blob/main/backend_ai/services/resumeImprovementService.js): `backend_ai/services/resumeImprovementService.js`
- [Resume comparison](https://github.com/girishelankonda/ai_resume_analyzer/blob/main/backend_ai/services/comparisonService.js): `backend_ai/services/comparisonService.js`
- [Cover letters](https://github.com/girishelankonda/ai_resume_analyzer/blob/main/backend_ai/services/coverLetterService.js): `backend_ai/services/coverLetterService.js`
- [Interview prep](https://github.com/girishelankonda/ai_resume_analyzer/blob/main/backend_ai/services/interviewQuestionService.js): `backend_ai/services/interviewQuestionService.js`

### AI integrations

- [Cohere service](https://github.com/girishelankonda/ai_resume_analyzer/blob/main/backend_ai/services/cohereService.js): `backend_ai/services/cohereService.js`
- [AI response parser](https://github.com/girishelankonda/ai_resume_analyzer/blob/main/backend_ai/services/aiResponseParser.js): `backend_ai/services/aiResponseParser.js`

### Other components

- **Job seeker**
- **Administrator**
- **Cohere API**
- **MongoDB**
- **Firebase**

## Connections

- Job seeker → Login: signs in (evidence: `README.md`)
- Login → Firebase auth: authenticates (evidence: `mern_ai/src/component/Login/Login.jsx`)
- Login → Auth state: updates session (evidence: `mern_ai/src/component/Login/Login.jsx`)
- Firebase auth → Firebase: authenticates with (evidence: `README.md`)
- App routes → Resume dashboard: routes to (evidence: `mern_ai/src/App.jsx`)
- App routes → Resume history: routes to (evidence: `mern_ai/src/App.jsx`)
- App routes → Analysis detail: routes to (evidence: `mern_ai/src/App.jsx`)
- App routes → Admin dashboard: routes to (evidence: `mern_ai/src/App.jsx`)
- Resume dashboard → Route guard: uses (evidence: `mern_ai/src/component/Dashboard/Dashboard.jsx`)
- Resume history → Route guard: uses (evidence: `mern_ai/src/component/History/History.jsx`)
- Analysis detail → Route guard: uses (evidence: `mern_ai/src/component/AnalysisDetail/AnalysisDetail.jsx`)
- Resume dashboard → Analysis results: renders (evidence: `mern_ai/src/component/Dashboard/Dashboard.jsx`)
- Resume dashboard → API client: requests data (evidence: `mern_ai/src/component/Dashboard/Dashboard.jsx`)
- Resume history → API client: requests history (evidence: `mern_ai/src/component/History/History.jsx`)
- Analysis detail → API client: requests analysis (evidence: `mern_ai/src/component/AnalysisDetail/AnalysisDetail.jsx`)
- Admin dashboard → API client: requests data (evidence: `mern_ai/src/component/Admin/Admin.jsx`)
- API client → API application: calls API (evidence: `README.md`)
- API application → Resume routes: mounts (evidence: `backend_ai/app.js`)
- API application → User routes: mounts (evidence: `backend_ai/app.js`)
- Resume routes → PDF upload: handles upload (evidence: `backend_ai/Routes/resume.js`)
- Resume routes → Resume workflows: dispatches to (evidence: `backend_ai/Routes/resume.js`)
- User routes → User workflows: dispatches to (evidence: `backend_ai/Routes/user.js`)
- Resume workflows → Resume records: reads and writes (evidence: `backend_ai/Controllers/resume.js`)
- Resume workflows → Resume analysis: analyzes resume (evidence: `backend_ai/Controllers/resume.js`)
- Resume workflows → Resume improvement: improves sections (evidence: `backend_ai/Controllers/resume.js`)
- Resume workflows → Resume comparison: compares resumes (evidence: `backend_ai/Controllers/resume.js`)
- Resume workflows → Cover letters: generates letters (evidence: `backend_ai/Controllers/resume.js`)
- Resume workflows → Interview prep: generates questions (evidence: `backend_ai/Controllers/resume.js`)
- User workflows → User records: reads and writes (evidence: `backend_ai/Controllers/user.js`)
- API application → MongoDB: connects through (evidence: `backend_ai/app.js`)
- Resume analysis → ATS scoring: builds and merges scores (evidence: `backend_ai/services/resumeAnalysisService.js`)
- Resume analysis → Quality assessment: assesses quality (evidence: `backend_ai/services/resumeAnalysisService.js`)
- ATS scoring → Keyword analysis: matches keywords (evidence: `backend_ai/services/atsScoringService.js`)
- Resume analysis → Cohere service: requests analysis (evidence: `backend_ai/services/resumeAnalysisService.js`)
- Resume analysis → AI response parser: parses response (evidence: `backend_ai/services/resumeAnalysisService.js`)
- Cohere service → Cohere API: sends prompts (evidence: `backend_ai/services/cohereService.js`)
- Resume workflows → MongoDB: persists results
- Resume improvement → Cohere service: uses AI (evidence: `backend_ai/services/resumeImprovementService.js`)
- Cover letters → Cohere service: uses AI (evidence: `backend_ai/services/coverLetterService.js`)
- Interview prep → Cohere service: uses AI (evidence: `backend_ai/services/interviewQuestionService.js`)
