# 07gautammishra/ai_resume_checker architecture

> Architecture diagram of the GitHub repository 07gautammishra/ai_resume_checker, 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/07gautammishra/ai_resume_checker
- Repository: https://github.com/07gautammishra/ai_resume_checker

## Overview

Resume Roaster is a full-stack resume analytics and optimization product. Candidates authenticate, upload a PDF, receive parsed resume versions, request ATS and keyword analysis, apply AI rewrites as new versions, compare revisions, and view dashboard and insight metrics; they can also export a polished PDF. The backend serves these capabilities through Express controllers, Gemini and parsing services, and MongoDB models. Frontend-to-API links and several route-to-controller bindings are not shown in the excerpts, so those relationships are left unasserted or marked unverified.

Main entry points: [`backend/src/controllers/resume.controller.js`](https://github.com/07gautammishra/ai_resume_checker/blob/master/backend/src/controllers/resume.controller.js) (Resume operations), [`backend/src/server.js`](https://github.com/07gautammishra/ai_resume_checker/blob/master/backend/src/server.js) (HTTP server), [`frontend/src/api/client.js`](https://github.com/07gautammishra/ai_resume_checker/blob/master/frontend/src/api/client.js) (API client), [`backend/src/controllers/dashboard.controller.js`](https://github.com/07gautammishra/ai_resume_checker/blob/master/backend/src/controllers/dashboard.controller.js) (Dashboard metrics)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Candidate application"]
  node_app["Web application<br/>[App.jsx]"]
  node_resume_ui["Resume workflow<br/>[Resumes.jsx]"]
  node_analysis_ui["Analysis views<br/>[ResumeDetail.jsx]"]
  node_insights_ui["Insights<br/>[Insights.jsx]"]
  node_dashboard_ui["Dashboard<br/>[Dashboard.jsx]"]
  node_export_ui["PDF export<br/>[Export.jsx]"]
  node_api_client["API client<br/>[client.js]"]
end

subgraph group_api["Backend API"]
  node_server["HTTP server<br/>[server.js]"]
  node_auth_routes["Auth routes<br/>[auth.router.js]"]
  node_auth_controller["Authentication<br/>[auth.controller.js]"]
  node_resume_controller["Resume operations"]
  node_dashboard_controller["Dashboard metrics"]
  node_insights_controller["Resume insights"]
  node_activity_controller["Activity history"]
end

subgraph group_services["Resume processing"]
  node_pdf_parser["PDF extraction<br/>[pdfService.js]"]
  node_structured_parser["Resume parsing"]
  node_gemini["AI analysis<br/>[geminiService.js]"]
  node_diff["Version comparison<br/>[diffService.js]"]
end

subgraph group_data["Identity and persistence"]
  node_auth_middleware["Session verification<br/>[auth.js]"]
  node_jwt["JWT utilities<br/>[jwt.js]"]
  node_users[("User records<br/>[user.model.js]")]
  node_resumes[("Resume records<br/>[Resume.js]")]
  node_versions[("Version records<br/>[ResumeVersion.js]")]
  node_analyses[("Analysis records<br/>[Analysis.js]")]
end

node_candidate(("Candidate"))
node_gemini_service["Gemini API"]
node_mongo[("MongoDB")]

node_candidate -.->|"uses"| node_app
node_app -->|"presents"| node_resume_ui
node_app -->|"presents"| node_dashboard_ui
node_candidate -.->|"requests export"| node_export_ui
node_resume_ui -.->|"requests data"| node_api_client
node_analysis_ui -.->|"requests data"| node_api_client
node_insights_ui -.->|"requests data"| node_api_client
node_dashboard_ui -.->|"requests data"| node_api_client
node_api_client -.->|"calls API"| node_server
node_server -->|"mounts"| node_auth_routes
node_server -.->|"serves via routes"| node_resume_controller
node_server -.->|"serves via routes"| node_dashboard_controller
node_server -.->|"serves via routes"| node_insights_controller
node_server -.->|"serves via routes"| node_activity_controller
node_auth_routes -->|"dispatches"| node_auth_controller
node_auth_routes -->|"guards"| node_auth_middleware
node_auth_controller -->|"reads and writes"| node_users
node_auth_controller -->|"signs sessions"| node_jwt
node_auth_middleware -->|"verifies token"| node_jwt
node_auth_middleware -->|"loads user"| node_users
node_resume_controller -->|"extracts text"| node_pdf_parser
node_resume_controller -->|"parses resume"| node_structured_parser
node_resume_controller -->|"requests analysis"| node_gemini
node_gemini -.->|"generates analysis"| node_gemini_service
node_resume_controller -->|"compares versions"| node_diff
node_resume_controller -->|"reads and writes"| node_resumes
node_resume_controller -->|"reads and writes"| node_versions
node_resume_controller -->|"reads and writes"| node_analyses
node_dashboard_controller -->|"reads metrics"| node_resumes
node_dashboard_controller -->|"reads metrics"| node_versions
node_dashboard_controller -->|"reads metrics"| node_analyses
node_insights_controller -->|"reads"| node_resumes
node_insights_controller -->|"reads"| node_analyses
node_activity_controller -->|"reads"| node_resumes
node_activity_controller -->|"reads"| node_versions
node_activity_controller -->|"reads"| node_analyses

click node_app "https://github.com/07gautammishra/ai_resume_checker/blob/master/frontend/src/App.jsx"
click node_resume_ui "https://github.com/07gautammishra/ai_resume_checker/blob/master/frontend/src/pages/Resumes.jsx"
click node_analysis_ui "https://github.com/07gautammishra/ai_resume_checker/blob/master/frontend/src/pages/ResumeDetail.jsx"
click node_insights_ui "https://github.com/07gautammishra/ai_resume_checker/blob/master/frontend/src/pages/Insights.jsx"
click node_dashboard_ui "https://github.com/07gautammishra/ai_resume_checker/blob/master/frontend/src/pages/Dashboard.jsx"
click node_export_ui "https://github.com/07gautammishra/ai_resume_checker/blob/master/frontend/src/pages/Export.jsx"
click node_api_client "https://github.com/07gautammishra/ai_resume_checker/blob/master/frontend/src/api/client.js"
click node_server "https://github.com/07gautammishra/ai_resume_checker/blob/master/backend/src/server.js"
click node_auth_routes "https://github.com/07gautammishra/ai_resume_checker/blob/master/backend/src/routes/auth.router.js"
click node_auth_controller "https://github.com/07gautammishra/ai_resume_checker/blob/master/backend/src/controllers/auth.controller.js"
click node_resume_controller "https://github.com/07gautammishra/ai_resume_checker/blob/master/backend/src/controllers/resume.controller.js"
click node_dashboard_controller "https://github.com/07gautammishra/ai_resume_checker/blob/master/backend/src/controllers/dashboard.controller.js"
click node_insights_controller "https://github.com/07gautammishra/ai_resume_checker/blob/master/backend/src/controllers/insights.controller.js"
click node_activity_controller "https://github.com/07gautammishra/ai_resume_checker/blob/master/backend/src/controllers/activity.controller.js"
click node_pdf_parser "https://github.com/07gautammishra/ai_resume_checker/blob/master/backend/src/services/pdfService.js"
click node_structured_parser "https://github.com/07gautammishra/ai_resume_checker/blob/master/backend/src/services/structuredParser.js"
click node_gemini "https://github.com/07gautammishra/ai_resume_checker/blob/master/backend/src/services/geminiService.js"
click node_diff "https://github.com/07gautammishra/ai_resume_checker/blob/master/backend/src/services/diffService.js"
click node_auth_middleware "https://github.com/07gautammishra/ai_resume_checker/blob/master/backend/src/middleware/auth.js"
click node_jwt "https://github.com/07gautammishra/ai_resume_checker/blob/master/backend/src/utils/jwt.js"
click node_users "https://github.com/07gautammishra/ai_resume_checker/blob/master/backend/src/models/user.model.js"
click node_resumes "https://github.com/07gautammishra/ai_resume_checker/blob/master/backend/src/models/Resume.js"
click node_versions "https://github.com/07gautammishra/ai_resume_checker/blob/master/backend/src/models/ResumeVersion.js"
click node_analyses "https://github.com/07gautammishra/ai_resume_checker/blob/master/backend/src/models/Analysis.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_resume_ui,node_analysis_ui,node_insights_ui,node_dashboard_ui,node_export_ui,node_api_client toneBlue
class node_server,node_auth_routes,node_auth_controller,node_resume_controller,node_dashboard_controller,node_insights_controller,node_activity_controller,node_mongo toneAmber
class node_pdf_parser,node_structured_parser,node_gemini,node_diff,node_gemini_service toneMint
class node_auth_middleware,node_jwt,node_users,node_resumes,node_versions,node_analyses toneRose
class node_candidate toneIndigo
```

## Components

### Candidate application

- [Web application](https://github.com/07gautammishra/ai_resume_checker/blob/master/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Resume workflow](https://github.com/07gautammishra/ai_resume_checker/blob/master/frontend/src/pages/Resumes.jsx): `frontend/src/pages/Resumes.jsx`
- [Analysis views](https://github.com/07gautammishra/ai_resume_checker/blob/master/frontend/src/pages/ResumeDetail.jsx): `frontend/src/pages/ResumeDetail.jsx`
- [Insights](https://github.com/07gautammishra/ai_resume_checker/blob/master/frontend/src/pages/Insights.jsx): `frontend/src/pages/Insights.jsx`
- [Dashboard](https://github.com/07gautammishra/ai_resume_checker/blob/master/frontend/src/pages/Dashboard.jsx): `frontend/src/pages/Dashboard.jsx`
- [PDF export](https://github.com/07gautammishra/ai_resume_checker/blob/master/frontend/src/pages/Export.jsx): `frontend/src/pages/Export.jsx`
- [API client](https://github.com/07gautammishra/ai_resume_checker/blob/master/frontend/src/api/client.js): `frontend/src/api/client.js`

### Backend API

- [HTTP server](https://github.com/07gautammishra/ai_resume_checker/blob/master/backend/src/server.js): `backend/src/server.js`
- [Auth routes](https://github.com/07gautammishra/ai_resume_checker/blob/master/backend/src/routes/auth.router.js): `backend/src/routes/auth.router.js`
- [Authentication](https://github.com/07gautammishra/ai_resume_checker/blob/master/backend/src/controllers/auth.controller.js): `backend/src/controllers/auth.controller.js`
- [Resume operations](https://github.com/07gautammishra/ai_resume_checker/blob/master/backend/src/controllers/resume.controller.js): `backend/src/controllers/resume.controller.js`
- [Dashboard metrics](https://github.com/07gautammishra/ai_resume_checker/blob/master/backend/src/controllers/dashboard.controller.js): `backend/src/controllers/dashboard.controller.js`
- [Resume insights](https://github.com/07gautammishra/ai_resume_checker/blob/master/backend/src/controllers/insights.controller.js): `backend/src/controllers/insights.controller.js`
- [Activity history](https://github.com/07gautammishra/ai_resume_checker/blob/master/backend/src/controllers/activity.controller.js): `backend/src/controllers/activity.controller.js`

### Resume processing

- [PDF extraction](https://github.com/07gautammishra/ai_resume_checker/blob/master/backend/src/services/pdfService.js): `backend/src/services/pdfService.js`
- [Resume parsing](https://github.com/07gautammishra/ai_resume_checker/blob/master/backend/src/services/structuredParser.js): `backend/src/services/structuredParser.js`
- [AI analysis](https://github.com/07gautammishra/ai_resume_checker/blob/master/backend/src/services/geminiService.js): `backend/src/services/geminiService.js`
- [Version comparison](https://github.com/07gautammishra/ai_resume_checker/blob/master/backend/src/services/diffService.js): `backend/src/services/diffService.js`

### Identity and persistence

- [Session verification](https://github.com/07gautammishra/ai_resume_checker/blob/master/backend/src/middleware/auth.js): `backend/src/middleware/auth.js`
- [JWT utilities](https://github.com/07gautammishra/ai_resume_checker/blob/master/backend/src/utils/jwt.js): `backend/src/utils/jwt.js`
- [User records](https://github.com/07gautammishra/ai_resume_checker/blob/master/backend/src/models/user.model.js): `backend/src/models/user.model.js`
- [Resume records](https://github.com/07gautammishra/ai_resume_checker/blob/master/backend/src/models/Resume.js): `backend/src/models/Resume.js`
- [Version records](https://github.com/07gautammishra/ai_resume_checker/blob/master/backend/src/models/ResumeVersion.js): `backend/src/models/ResumeVersion.js`
- [Analysis records](https://github.com/07gautammishra/ai_resume_checker/blob/master/backend/src/models/Analysis.js): `backend/src/models/Analysis.js`

### Other components

- **Candidate**
- **Gemini API**
- **MongoDB**

## Connections

- Candidate → Web application: uses
- Web application → Resume workflow: presents
- Web application → Dashboard: presents
- Candidate → PDF export: requests export
- Resume workflow → API client: requests data
- Analysis views → API client: requests data
- Insights → API client: requests data
- Dashboard → API client: requests data
- API client → HTTP server: calls API
- HTTP server → Auth routes: mounts (evidence: `backend/src/server.js`)
- HTTP server → Resume operations: serves via routes
- HTTP server → Dashboard metrics: serves via routes
- HTTP server → Resume insights: serves via routes
- HTTP server → Activity history: serves via routes
- Auth routes → Authentication: dispatches (evidence: `backend/src/routes/auth.router.js`)
- Auth routes → Session verification: guards (evidence: `backend/src/routes/auth.router.js`)
- Authentication → User records: reads and writes (evidence: `backend/src/controllers/auth.controller.js`)
- Authentication → JWT utilities: signs sessions (evidence: `backend/src/controllers/auth.controller.js`)
- Session verification → JWT utilities: verifies token (evidence: `backend/src/middleware/auth.js`)
- Session verification → User records: loads user (evidence: `backend/src/middleware/auth.js`)
- Resume operations → PDF extraction: extracts text (evidence: `backend/src/controllers/resume.controller.js`)
- Resume operations → Resume parsing: parses resume (evidence: `backend/src/controllers/resume.controller.js`)
- Resume operations → AI analysis: requests analysis (evidence: `backend/src/controllers/resume.controller.js`)
- AI analysis → Gemini API: generates analysis
- Resume operations → Version comparison: compares versions (evidence: `backend/src/controllers/resume.controller.js`)
- Resume operations → Resume records: reads and writes (evidence: `backend/src/controllers/resume.controller.js`)
- Resume operations → Version records: reads and writes (evidence: `backend/src/controllers/resume.controller.js`)
- Resume operations → Analysis records: reads and writes (evidence: `backend/src/controllers/resume.controller.js`)
- Dashboard metrics → Resume records: reads metrics (evidence: `backend/src/controllers/dashboard.controller.js`)
- Dashboard metrics → Version records: reads metrics (evidence: `backend/src/controllers/dashboard.controller.js`)
- Dashboard metrics → Analysis records: reads metrics (evidence: `backend/src/controllers/dashboard.controller.js`)
- Resume insights → Resume records: reads (evidence: `backend/src/controllers/insights.controller.js`)
- Resume insights → Analysis records: reads (evidence: `backend/src/controllers/insights.controller.js`)
- Activity history → Resume records: reads (evidence: `backend/src/controllers/activity.controller.js`)
- Activity history → Version records: reads (evidence: `backend/src/controllers/activity.controller.js`)
- Activity history → Analysis records: reads (evidence: `backend/src/controllers/activity.controller.js`)
