# lingamalisha/ai-resume-checker architecture

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

- Interactive diagram: https://gitdiagram.com/lingamalisha/ai-resume-checker
- Repository: https://github.com/lingamalisha/ai-resume-checker

## Overview

SmartResume AI is a resume-analysis web app. Users register or sign in, reach a protected dashboard, upload a resume with a job description, and view analysis feedback, match score, skill gaps, and a generated cover letter; they can revisit saved analyses or download a PDF report. The backend excerpt shows PDF text extraction, Gemini analysis, and resume-history endpoints. Evidence is incomplete for upload-client calls, persistence wiring, and some OAuth response details, so those connections are omitted or marked unverified.

Main entry points: [`server/index.js`](https://github.com/lingamalisha/ai-resume-checker/blob/main/server/index.js) (API server), [`src/App.jsx`](https://github.com/lingamalisha/ai-resume-checker/blob/main/src/App.jsx) (App routes), [`src/components/auth/LoginPage.jsx`](https://github.com/lingamalisha/ai-resume-checker/blob/main/src/components/auth/LoginPage.jsx) (Login and signup), [`src/context/AuthContext.jsx`](https://github.com/lingamalisha/ai-resume-checker/blob/main/src/context/AuthContext.jsx) (Auth state)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web experience"]
  node_app["App routes<br/>[App.jsx]"]
  node_dashboard["Dashboard<br/>[App.jsx]"]
  node_upload["Resume upload<br/>[UploadSection.jsx]"]
  node_results["Analysis results"]
  node_report["PDF report<br/>[reportGenerator.js]"]
end

subgraph group_identity["Identity"]
  node_authpages["Login and signup<br/>[LoginPage.jsx]"]
  node_oauthcallback["OAuth callback<br/>[OAuthCallback.jsx]"]
  node_guard["Route guard<br/>[ProtectedRoute.jsx]"]
  node_authcontext["Auth state<br/>[AuthContext.jsx]"]
end

subgraph group_analysis["Resume analysis"]
  node_api["API server<br/>[index.js]"]
  node_pdfextract["PDF extraction<br/>[index.js]"]
  node_gemini["Gemini analysis<br/>[index.js]"]
end

subgraph group_storage["Persistence"]
  node_user["User model<br/>[User.js]"]
  node_resume["Resume model<br/>[Resume.js]"]
  node_sqlite[("SQLite initializer<br/>[db.js]")]
end

node_candidate(("Candidate"))
node_google["Google OAuth"]
node_github["GitHub OAuth"]

node_candidate -->|"uses"| node_app
node_app -->|"routes to"| node_authpages
node_app -->|"routes to"| node_dashboard
node_app -->|"routes to"| node_oauthcallback
node_app -->|"protects route"| node_guard
node_dashboard -->|"renders"| node_upload
node_dashboard -->|"renders"| node_results
node_results -->|"generates report"| node_report
node_authpages -->|"calls login"| node_authcontext
node_guard -->|"reads auth state"| node_authcontext
node_authcontext -->|"posts credentials"| node_api
node_authpages -->|"starts OAuth"| node_api
node_api -->|"redirects to"| node_google
node_api -->|"redirects to"| node_github
node_oauthcallback -->|"navigates to"| node_dashboard
node_upload -.->|"submits resume"| node_api
node_api -->|"extracts text"| node_pdfextract
node_api -->|"requests analysis"| node_gemini
node_api -->|"queries users"| node_user
node_api -->|"reads and writes"| node_resume
node_api -->|"serves history"| node_dashboard

click node_app "https://github.com/lingamalisha/ai-resume-checker/blob/main/src/App.jsx"
click node_dashboard "https://github.com/lingamalisha/ai-resume-checker/blob/main/src/App.jsx"
click node_upload "https://github.com/lingamalisha/ai-resume-checker/blob/main/src/components/UploadSection.jsx"
click node_results "https://github.com/lingamalisha/ai-resume-checker/blob/main/src/components/ResultsDashboard.jsx"
click node_report "https://github.com/lingamalisha/ai-resume-checker/blob/main/src/lib/reportGenerator.js"
click node_authpages "https://github.com/lingamalisha/ai-resume-checker/blob/main/src/components/auth/LoginPage.jsx"
click node_oauthcallback "https://github.com/lingamalisha/ai-resume-checker/blob/main/src/components/auth/OAuthCallback.jsx"
click node_guard "https://github.com/lingamalisha/ai-resume-checker/blob/main/src/components/auth/ProtectedRoute.jsx"
click node_authcontext "https://github.com/lingamalisha/ai-resume-checker/blob/main/src/context/AuthContext.jsx"
click node_api "https://github.com/lingamalisha/ai-resume-checker/blob/main/server/index.js"
click node_pdfextract "https://github.com/lingamalisha/ai-resume-checker/blob/main/server/index.js"
click node_gemini "https://github.com/lingamalisha/ai-resume-checker/blob/main/server/index.js"
click node_user "https://github.com/lingamalisha/ai-resume-checker/blob/main/server/models/User.js"
click node_resume "https://github.com/lingamalisha/ai-resume-checker/blob/main/server/models/Resume.js"
click node_sqlite "https://github.com/lingamalisha/ai-resume-checker/blob/main/server/db.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_dashboard,node_upload,node_results,node_report toneBlue
class node_authpages,node_oauthcallback,node_guard,node_authcontext toneAmber
class node_api,node_pdfextract,node_gemini toneMint
class node_user,node_resume,node_sqlite toneRose
class node_candidate,node_google,node_github toneIndigo
```

## Components

### Web experience

- [App routes](https://github.com/lingamalisha/ai-resume-checker/blob/main/src/App.jsx): `src/App.jsx`
- [Dashboard](https://github.com/lingamalisha/ai-resume-checker/blob/main/src/App.jsx): `src/App.jsx`
- [Resume upload](https://github.com/lingamalisha/ai-resume-checker/blob/main/src/components/UploadSection.jsx): `src/components/UploadSection.jsx`
- [Analysis results](https://github.com/lingamalisha/ai-resume-checker/blob/main/src/components/ResultsDashboard.jsx): `src/components/ResultsDashboard.jsx`
- [PDF report](https://github.com/lingamalisha/ai-resume-checker/blob/main/src/lib/reportGenerator.js): `src/lib/reportGenerator.js`

### Identity

- [Login and signup](https://github.com/lingamalisha/ai-resume-checker/blob/main/src/components/auth/LoginPage.jsx): `src/components/auth/LoginPage.jsx`
- [OAuth callback](https://github.com/lingamalisha/ai-resume-checker/blob/main/src/components/auth/OAuthCallback.jsx): `src/components/auth/OAuthCallback.jsx`
- [Route guard](https://github.com/lingamalisha/ai-resume-checker/blob/main/src/components/auth/ProtectedRoute.jsx): `src/components/auth/ProtectedRoute.jsx`
- [Auth state](https://github.com/lingamalisha/ai-resume-checker/blob/main/src/context/AuthContext.jsx): `src/context/AuthContext.jsx`

### Resume analysis

- [API server](https://github.com/lingamalisha/ai-resume-checker/blob/main/server/index.js): `server/index.js`
- [PDF extraction](https://github.com/lingamalisha/ai-resume-checker/blob/main/server/index.js): `server/index.js`
- [Gemini analysis](https://github.com/lingamalisha/ai-resume-checker/blob/main/server/index.js): `server/index.js`

### Persistence

- [User model](https://github.com/lingamalisha/ai-resume-checker/blob/main/server/models/User.js): `server/models/User.js`
- [Resume model](https://github.com/lingamalisha/ai-resume-checker/blob/main/server/models/Resume.js): `server/models/Resume.js`
- [SQLite initializer](https://github.com/lingamalisha/ai-resume-checker/blob/main/server/db.js): `server/db.js`

### Other components

- **Candidate**
- **Google OAuth**
- **GitHub OAuth**

## Connections

- Candidate → App routes: uses (evidence: `src/App.jsx`)
- App routes → Login and signup: routes to (evidence: `src/App.jsx`)
- App routes → Dashboard: routes to (evidence: `src/App.jsx`)
- App routes → OAuth callback: routes to (evidence: `src/App.jsx`)
- App routes → Route guard: protects route (evidence: `src/App.jsx`)
- Dashboard → Resume upload: renders (evidence: `src/App.jsx`)
- Dashboard → Analysis results: renders (evidence: `src/App.jsx`)
- Analysis results → PDF report: generates report (evidence: `src/components/ResultsDashboard.jsx`)
- Login and signup → Auth state: calls login (evidence: `src/components/auth/LoginPage.jsx`)
- Route guard → Auth state: reads auth state (evidence: `src/components/auth/ProtectedRoute.jsx`)
- Auth state → API server: posts credentials (evidence: `src/context/AuthContext.jsx`)
- Login and signup → API server: starts OAuth (evidence: `src/components/auth/LoginPage.jsx`)
- API server → Google OAuth: redirects to (evidence: `server/index.js`)
- API server → GitHub OAuth: redirects to (evidence: `server/index.js`)
- OAuth callback → Dashboard: navigates to (evidence: `src/components/auth/OAuthCallback.jsx`)
- Resume upload → API server: submits resume
- API server → PDF extraction: extracts text (evidence: `server/index.js`)
- API server → Gemini analysis: requests analysis (evidence: `server/index.js`)
- API server → User model: queries users (evidence: `server/index.js`)
- API server → Resume model: reads and writes (evidence: `server/index.js`)
- API server → Dashboard: serves history (evidence: `server/index.js`)
