# sushaaanthh/careerforge-pro architecture

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

- Interactive diagram: https://gitdiagram.com/sushaaanthh/careerforge-pro
- Repository: https://github.com/sushaaanthh/careerforge-pro

## Overview

CareerForge Pro is a browser-based resume editor and AI career-document tool. Users enter resume details, analyze a job description for keywords, optimize resume bullets, preview the result, and export a PDF; they can also generate cover letters and manage saved resumes and Pro access. The frontend components and backend routes are visible in the excerpts, but several backend details are unsampled, so the graph groups related route behavior by capability and avoids inferring internal processing steps.

Main entry points: [`client/src/App.js`](https://github.com/sushaaanthh/careerforge-pro/blob/main/client/src/App.js) (Resume editor), [`client/src/components/Dashboard.jsx`](https://github.com/sushaaanthh/careerforge-pro/blob/main/client/src/components/Dashboard.jsx) (Dashboard), [`client/src/components/CoverLetterGenerator.jsx`](https://github.com/sushaaanthh/careerforge-pro/blob/main/client/src/components/CoverLetterGenerator.jsx) (Cover letter generator), [`client/src/utils/api.js`](https://github.com/sushaaanthh/careerforge-pro/blob/main/client/src/utils/api.js) (API URL and errors)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Resume workspace"]
  node_web["Web application<br/>[index.js]"]
  node_resume_editor["Resume editor<br/>[App.js]"]
  node_resume_state["Resume state slice<br/>[resumeSlice.js]"]
  node_preview["Live preview<br/>[LivePreview.jsx]"]
  node_dashboard["Dashboard<br/>[Dashboard.jsx]"]
  node_cover_letter_ui["Cover letter generator"]
  node_api_client["API URL and errors<br/>[api.js]"]
end

subgraph group_ai["AI document services"]
  node_ai_routes["JD analysis and optimization<br/>[index.js]"]
  node_cover_letter_service["Cover letter generation<br/>[index.js]"]
  node_pdf_service["PDF generation<br/>[index.js]"]
end

subgraph group_accounts["Documents and access"]
  node_account_routes["User and resume routes<br/>[index.js]"]
  node_resume_model[("Resume data model<br/>[models.js]")]
  node_billing_routes["Checkout and access<br/>[index.js]"]
end

subgraph group_integrations["External services"]
  node_groq["Groq inference"]
  node_mongo[("MongoDB")]
  node_stripe["Stripe"]
end

node_candidate(("Candidate"))
node_browser(("Browser PDF download"))

node_candidate -->|"opens"| node_web
node_web -->|"routes to"| node_resume_editor
node_resume_editor -->|"renders"| node_preview
node_resume_editor -->|"renders"| node_dashboard
node_resume_editor -->|"renders"| node_cover_letter_ui
node_resume_editor -->|"imports"| node_api_client
node_dashboard -->|"imports"| node_api_client
node_cover_letter_ui -->|"imports"| node_api_client
node_preview -->|"requests PDF"| node_api_client
node_resume_editor -->|"analyzes and optimizes"| node_ai_routes
node_ai_routes -->|"requests inference"| node_groq
node_cover_letter_ui -->|"requests letter"| node_cover_letter_service
node_cover_letter_service -->|"requests inference"| node_groq
node_preview -->|"sends HTML"| node_pdf_service
node_cover_letter_ui -->|"sends HTML"| node_pdf_service
node_pdf_service -.->|"returns PDF"| node_browser
node_dashboard -->|"fetches account and resumes"| node_account_routes
node_account_routes -->|"queries and creates"| node_resume_model
node_account_routes -->|"reads and writes"| node_mongo
node_dashboard -->|"starts checkout"| node_billing_routes
node_billing_routes -->|"creates checkout"| node_stripe
node_stripe -.->|"sends webhook events"| node_billing_routes
node_resume_editor -.->|"maintains resume data"| node_resume_state

click node_web "https://github.com/sushaaanthh/careerforge-pro/blob/main/client/src/index.js"
click node_resume_editor "https://github.com/sushaaanthh/careerforge-pro/blob/main/client/src/App.js"
click node_resume_state "https://github.com/sushaaanthh/careerforge-pro/blob/main/client/src/store/resumeSlice.js"
click node_preview "https://github.com/sushaaanthh/careerforge-pro/blob/main/client/src/components/LivePreview.jsx"
click node_dashboard "https://github.com/sushaaanthh/careerforge-pro/blob/main/client/src/components/Dashboard.jsx"
click node_cover_letter_ui "https://github.com/sushaaanthh/careerforge-pro/blob/main/client/src/components/CoverLetterGenerator.jsx"
click node_api_client "https://github.com/sushaaanthh/careerforge-pro/blob/main/client/src/utils/api.js"
click node_ai_routes "https://github.com/sushaaanthh/careerforge-pro/blob/main/server/index.js"
click node_cover_letter_service "https://github.com/sushaaanthh/careerforge-pro/blob/main/server/index.js"
click node_pdf_service "https://github.com/sushaaanthh/careerforge-pro/blob/main/server/index.js"
click node_account_routes "https://github.com/sushaaanthh/careerforge-pro/blob/main/server/index.js"
click node_resume_model "https://github.com/sushaaanthh/careerforge-pro/blob/main/server/src/models/models.js"
click node_billing_routes "https://github.com/sushaaanthh/careerforge-pro/blob/main/server/index.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_web,node_resume_editor,node_resume_state,node_preview,node_dashboard,node_cover_letter_ui,node_api_client,node_browser toneBlue
class node_ai_routes,node_cover_letter_service,node_pdf_service toneAmber
class node_account_routes,node_resume_model,node_billing_routes toneMint
class node_groq,node_mongo,node_stripe toneRose
class node_candidate toneIndigo
```

## Components

### Resume workspace

- [Web application](https://github.com/sushaaanthh/careerforge-pro/blob/main/client/src/index.js): `client/src/index.js`
- [Resume editor](https://github.com/sushaaanthh/careerforge-pro/blob/main/client/src/App.js): `client/src/App.js`
- [Resume state slice](https://github.com/sushaaanthh/careerforge-pro/blob/main/client/src/store/resumeSlice.js): `client/src/store/resumeSlice.js`
- [Live preview](https://github.com/sushaaanthh/careerforge-pro/blob/main/client/src/components/LivePreview.jsx): `client/src/components/LivePreview.jsx`
- [Dashboard](https://github.com/sushaaanthh/careerforge-pro/blob/main/client/src/components/Dashboard.jsx): `client/src/components/Dashboard.jsx`
- [Cover letter generator](https://github.com/sushaaanthh/careerforge-pro/blob/main/client/src/components/CoverLetterGenerator.jsx): `client/src/components/CoverLetterGenerator.jsx`
- [API URL and errors](https://github.com/sushaaanthh/careerforge-pro/blob/main/client/src/utils/api.js): `client/src/utils/api.js`

### AI document services

- [JD analysis and optimization](https://github.com/sushaaanthh/careerforge-pro/blob/main/server/index.js): `server/index.js`
- [Cover letter generation](https://github.com/sushaaanthh/careerforge-pro/blob/main/server/index.js): `server/index.js`
- [PDF generation](https://github.com/sushaaanthh/careerforge-pro/blob/main/server/index.js): `server/index.js`

### Documents and access

- [User and resume routes](https://github.com/sushaaanthh/careerforge-pro/blob/main/server/index.js): `server/index.js`
- [Resume data model](https://github.com/sushaaanthh/careerforge-pro/blob/main/server/src/models/models.js): `server/src/models/models.js`
- [Checkout and access](https://github.com/sushaaanthh/careerforge-pro/blob/main/server/index.js): `server/index.js`

### External services

- **Groq inference**
- **MongoDB**
- **Stripe**

### Other components

- **Candidate**
- **Browser PDF download**

## Connections

- Candidate → Web application: opens (evidence: `client/src/index.js`)
- Web application → Resume editor: routes to (evidence: `client/src/index.js`)
- Resume editor → Live preview: renders (evidence: `client/src/App.js`)
- Resume editor → Dashboard: renders (evidence: `client/src/App.js`)
- Resume editor → Cover letter generator: renders (evidence: `client/src/App.js`)
- Resume editor → API URL and errors: imports (evidence: `client/src/App.js`)
- Dashboard → API URL and errors: imports (evidence: `client/src/components/Dashboard.jsx`)
- Cover letter generator → API URL and errors: imports (evidence: `client/src/components/CoverLetterGenerator.jsx`)
- Live preview → API URL and errors: requests PDF (evidence: `client/src/components/LivePreview.jsx`)
- Resume editor → JD analysis and optimization: analyzes and optimizes (evidence: `client/src/App.js`)
- JD analysis and optimization → Groq inference: requests inference (evidence: `server/index.js`)
- Cover letter generator → Cover letter generation: requests letter (evidence: `client/src/components/CoverLetterGenerator.jsx`)
- Cover letter generation → Groq inference: requests inference (evidence: `server/index.js`)
- Live preview → PDF generation: sends HTML (evidence: `client/src/components/LivePreview.jsx`)
- Cover letter generator → PDF generation: sends HTML (evidence: `client/src/components/CoverLetterGenerator.jsx`)
- PDF generation → Browser PDF download: returns PDF
- Dashboard → User and resume routes: fetches account and resumes (evidence: `client/src/components/Dashboard.jsx`)
- User and resume routes → Resume data model: queries and creates (evidence: `server/index.js`)
- User and resume routes → MongoDB: reads and writes (evidence: `server/index.js`)
- Dashboard → Checkout and access: starts checkout (evidence: `client/src/components/Dashboard.jsx`)
- Checkout and access → Stripe: creates checkout (evidence: `server/index.js`)
- Stripe → Checkout and access: sends webhook events (evidence: `server/index.js`)
- Resume editor → Resume state slice: maintains resume data
