# vanshchaudhary2404/interviewforge architecture

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

## Overview

InterviewForge is a mock-interview product: candidates sign in, configure a Technical or HR interview (optionally using resume analysis), answer timed questions, and review saved performance reports. The client also supports interview history and credit purchases. The graph combines sampled call/import evidence with README-documented product flows; some client-to-API links are documented only at the product level, not in sampled request code.

Main entry points: [`server/controllers/interview.controller.js`](https://github.com/vanshchaudhary2404/interviewforge/blob/main/server/controllers/interview.controller.js) (Interview handler), [`client/src/App.jsx`](https://github.com/vanshchaudhary2404/interviewforge/blob/main/client/src/App.jsx) (App routes), [`server/controllers/payment.controller.js`](https://github.com/vanshchaudhary2404/interviewforge/blob/main/server/controllers/payment.controller.js) (Payment handler), [`server/index.js`](https://github.com/vanshchaudhary2404/interviewforge/blob/main/server/index.js) (Express API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["React client"]
  node_app["App routes<br/>[App.jsx]"]
  node_authpage["Google sign-in<br/>[Auth.jsx]"]
  node_navbar["Navigation<br/>[Navbar.jsx]"]
  node_setup["Interview setup<br/>[Step1SetUp.jsx]"]
  node_session["Timed interview<br/>[Step2Interview.jsx]"]
  node_timer["Question timer<br/>[Timer.jsx]"]
  node_reportview["Report display<br/>[Step3Report.jsx]"]
  node_history["Interview history"]
  node_pricing["Credit plans<br/>[Pricing.jsx]"]
  node_interviewpage["Interview workflow<br/>[InterviewPage.jsx]"]
  node_reportpage["Report route"]
  node_userstate["User state<br/>[userSlice.js]"]
end

subgraph group_identity["Identity and access"]
  node_auth["Auth handler<br/>[auth.controller.js]"]
  node_authguard["JWT guard<br/>[isAuth.js]"]
  node_userhandler["User handler<br/>[user.controller.js]"]
  node_userstore[("User records<br/>[user.model.js]")]
end

subgraph group_interviews["Interview services"]
  node_interviewhandler["Interview handler"]
  node_interviewstore[("Interview records<br/>[interview.model.js]")]
end

subgraph group_commerce["Credits and payments"]
  node_paymentpage["Payment plans<br/>[Pricing.jsx]"]
  node_paymenthandler["Payment handler"]
  node_paymentstore[("Payment records<br/>[payment.model.js]")]
end

node_candidate(("Candidate"))
node_firebase["Firebase Auth"]
node_api["Express API<br/>[index.js]"]
node_openrouter["OpenRouter AI"]
node_razorpay["Razorpay"]

node_candidate -->|"uses"| node_app
node_app -->|"routes to"| node_authpage
node_app -->|"routes to"| node_interviewpage
node_app -->|"routes to"| node_history
node_app -->|"routes to"| node_reportpage
node_app -->|"routes to"| node_pricing
node_app -->|"updates"| node_userstate
node_authpage -->|"signs in with"| node_firebase
node_authpage -->|"submits profile"| node_auth
node_authpage -->|"sets user"| node_userstate
node_interviewpage -->|"renders"| node_setup
node_interviewpage -->|"renders"| node_session
node_interviewpage -->|"renders"| node_reportview
node_session -->|"uses"| node_timer
node_setup -->|"requests questions"| node_interviewhandler
node_session -->|"submits answers"| node_interviewhandler
node_reportpage -->|"renders"| node_reportview
node_reportview -->|"requests report"| node_interviewhandler
node_history -->|"requests history"| node_interviewhandler
node_pricing -->|"requests purchase"| node_paymenthandler
node_api -->|"routes requests"| node_auth
node_api -->|"routes requests"| node_userhandler
node_api -->|"routes requests"| node_interviewhandler
node_api -->|"routes requests"| node_paymenthandler
node_auth -->|"reads or creates"| node_userstore
node_auth -->|"issues token for"| node_userstore
node_authguard -.->|"guards requests"| node_api
node_userhandler -->|"reads"| node_userstore
node_interviewhandler -->|"checks credits"| node_userstore
node_interviewhandler -->|"creates and updates"| node_interviewstore
node_interviewhandler -->|"requests AI"| node_openrouter
node_paymenthandler -->|"creates order"| node_razorpay
node_paymenthandler -->|"creates and updates"| node_paymentstore
node_paymenthandler -->|"adds credits"| node_userstore
node_paymentpage -->|"starts payment"| node_paymenthandler

click node_app "https://github.com/vanshchaudhary2404/interviewforge/blob/main/client/src/App.jsx"
click node_authpage "https://github.com/vanshchaudhary2404/interviewforge/blob/main/client/src/pages/Auth.jsx"
click node_navbar "https://github.com/vanshchaudhary2404/interviewforge/blob/main/client/src/components/Navbar.jsx"
click node_setup "https://github.com/vanshchaudhary2404/interviewforge/blob/main/client/src/components/Step1SetUp.jsx"
click node_session "https://github.com/vanshchaudhary2404/interviewforge/blob/main/client/src/components/Step2Interview.jsx"
click node_timer "https://github.com/vanshchaudhary2404/interviewforge/blob/main/client/src/components/Timer.jsx"
click node_reportview "https://github.com/vanshchaudhary2404/interviewforge/blob/main/client/src/components/Step3Report.jsx"
click node_history "https://github.com/vanshchaudhary2404/interviewforge/blob/main/client/src/pages/InterviewHistory.jsx"
click node_pricing "https://github.com/vanshchaudhary2404/interviewforge/blob/main/client/src/pages/Pricing.jsx"
click node_interviewpage "https://github.com/vanshchaudhary2404/interviewforge/blob/main/client/src/pages/InterviewPage.jsx"
click node_reportpage "https://github.com/vanshchaudhary2404/interviewforge/blob/main/client/src/pages/InterviewReport.jsx"
click node_userstate "https://github.com/vanshchaudhary2404/interviewforge/blob/main/client/src/redux/userSlice.js"
click node_api "https://github.com/vanshchaudhary2404/interviewforge/blob/main/server/index.js"
click node_auth "https://github.com/vanshchaudhary2404/interviewforge/blob/main/server/controllers/auth.controller.js"
click node_authguard "https://github.com/vanshchaudhary2404/interviewforge/blob/main/server/middlewares/isAuth.js"
click node_userhandler "https://github.com/vanshchaudhary2404/interviewforge/blob/main/server/controllers/user.controller.js"
click node_interviewhandler "https://github.com/vanshchaudhary2404/interviewforge/blob/main/server/controllers/interview.controller.js"
click node_interviewstore "https://github.com/vanshchaudhary2404/interviewforge/blob/main/server/models/interview.model.js"
click node_userstore "https://github.com/vanshchaudhary2404/interviewforge/blob/main/server/models/user.model.js"
click node_paymentpage "https://github.com/vanshchaudhary2404/interviewforge/blob/main/client/src/pages/Pricing.jsx"
click node_paymenthandler "https://github.com/vanshchaudhary2404/interviewforge/blob/main/server/controllers/payment.controller.js"
click node_paymentstore "https://github.com/vanshchaudhary2404/interviewforge/blob/main/server/models/payment.model.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_authpage,node_navbar,node_setup,node_session,node_timer,node_reportview,node_history,node_pricing,node_interviewpage,node_reportpage,node_userstate toneBlue
class node_auth,node_authguard,node_userhandler,node_userstore toneAmber
class node_interviewhandler,node_interviewstore,node_api,node_openrouter toneMint
class node_paymentpage,node_paymenthandler,node_paymentstore toneRose
class node_candidate,node_firebase,node_razorpay toneIndigo
```

## Components

### React client

- [App routes](https://github.com/vanshchaudhary2404/interviewforge/blob/main/client/src/App.jsx): `client/src/App.jsx`
- [Google sign-in](https://github.com/vanshchaudhary2404/interviewforge/blob/main/client/src/pages/Auth.jsx): `client/src/pages/Auth.jsx`
- [Navigation](https://github.com/vanshchaudhary2404/interviewforge/blob/main/client/src/components/Navbar.jsx): `client/src/components/Navbar.jsx`
- [Interview setup](https://github.com/vanshchaudhary2404/interviewforge/blob/main/client/src/components/Step1SetUp.jsx): `client/src/components/Step1SetUp.jsx`
- [Timed interview](https://github.com/vanshchaudhary2404/interviewforge/blob/main/client/src/components/Step2Interview.jsx): `client/src/components/Step2Interview.jsx`
- [Question timer](https://github.com/vanshchaudhary2404/interviewforge/blob/main/client/src/components/Timer.jsx): `client/src/components/Timer.jsx`
- [Report display](https://github.com/vanshchaudhary2404/interviewforge/blob/main/client/src/components/Step3Report.jsx): `client/src/components/Step3Report.jsx`
- [Interview history](https://github.com/vanshchaudhary2404/interviewforge/blob/main/client/src/pages/InterviewHistory.jsx): `client/src/pages/InterviewHistory.jsx`
- [Credit plans](https://github.com/vanshchaudhary2404/interviewforge/blob/main/client/src/pages/Pricing.jsx): `client/src/pages/Pricing.jsx`
- [Interview workflow](https://github.com/vanshchaudhary2404/interviewforge/blob/main/client/src/pages/InterviewPage.jsx): `client/src/pages/InterviewPage.jsx`
- [Report route](https://github.com/vanshchaudhary2404/interviewforge/blob/main/client/src/pages/InterviewReport.jsx): `client/src/pages/InterviewReport.jsx`
- [User state](https://github.com/vanshchaudhary2404/interviewforge/blob/main/client/src/redux/userSlice.js): `client/src/redux/userSlice.js`

### Identity and access

- [Auth handler](https://github.com/vanshchaudhary2404/interviewforge/blob/main/server/controllers/auth.controller.js): `server/controllers/auth.controller.js`
- [JWT guard](https://github.com/vanshchaudhary2404/interviewforge/blob/main/server/middlewares/isAuth.js): `server/middlewares/isAuth.js`
- [User handler](https://github.com/vanshchaudhary2404/interviewforge/blob/main/server/controllers/user.controller.js): `server/controllers/user.controller.js`
- [User records](https://github.com/vanshchaudhary2404/interviewforge/blob/main/server/models/user.model.js): `server/models/user.model.js`

### Interview services

- [Interview handler](https://github.com/vanshchaudhary2404/interviewforge/blob/main/server/controllers/interview.controller.js): `server/controllers/interview.controller.js`
- [Interview records](https://github.com/vanshchaudhary2404/interviewforge/blob/main/server/models/interview.model.js): `server/models/interview.model.js`

### Credits and payments

- [Payment plans](https://github.com/vanshchaudhary2404/interviewforge/blob/main/client/src/pages/Pricing.jsx): `client/src/pages/Pricing.jsx`
- [Payment handler](https://github.com/vanshchaudhary2404/interviewforge/blob/main/server/controllers/payment.controller.js): `server/controllers/payment.controller.js`
- [Payment records](https://github.com/vanshchaudhary2404/interviewforge/blob/main/server/models/payment.model.js): `server/models/payment.model.js`

### Other components

- **Candidate**
- **Firebase Auth**
- [Express API](https://github.com/vanshchaudhary2404/interviewforge/blob/main/server/index.js): `server/index.js`
- **OpenRouter AI**
- **Razorpay**

## Connections

- Candidate → App routes: uses (evidence: `README.md`)
- App routes → Google sign-in: routes to (evidence: `client/src/App.jsx`)
- App routes → Interview workflow: routes to (evidence: `client/src/App.jsx`)
- App routes → Interview history: routes to (evidence: `client/src/App.jsx`)
- App routes → Report route: routes to (evidence: `client/src/App.jsx`)
- App routes → Credit plans: routes to (evidence: `client/src/App.jsx`)
- App routes → User state: updates (evidence: `client/src/App.jsx`)
- Google sign-in → Firebase Auth: signs in with (evidence: `client/src/pages/Auth.jsx`)
- Google sign-in → Auth handler: submits profile (evidence: `README.md`)
- Google sign-in → User state: sets user (evidence: `client/src/pages/Auth.jsx`)
- Interview workflow → Interview setup: renders (evidence: `client/src/pages/InterviewPage.jsx`)
- Interview workflow → Timed interview: renders (evidence: `client/src/pages/InterviewPage.jsx`)
- Interview workflow → Report display: renders (evidence: `client/src/pages/InterviewPage.jsx`)
- Timed interview → Question timer: uses (evidence: `client/src/components/Step2Interview.jsx`)
- Interview setup → Interview handler: requests questions (evidence: `README.md`)
- Timed interview → Interview handler: submits answers (evidence: `README.md`)
- Report route → Report display: renders (evidence: `client/src/pages/InterviewReport.jsx`)
- Report display → Interview handler: requests report (evidence: `README.md`)
- Interview history → Interview handler: requests history (evidence: `README.md`)
- Credit plans → Payment handler: requests purchase (evidence: `README.md`)
- Express API → Auth handler: routes requests (evidence: `server/index.js`)
- Express API → User handler: routes requests (evidence: `server/index.js`)
- Express API → Interview handler: routes requests (evidence: `server/index.js`)
- Express API → Payment handler: routes requests (evidence: `server/index.js`)
- Auth handler → User records: reads or creates (evidence: `server/controllers/auth.controller.js`)
- Auth handler → User records: issues token for (evidence: `server/controllers/auth.controller.js`)
- JWT guard → Express API: guards requests
- User handler → User records: reads (evidence: `server/controllers/user.controller.js`)
- Interview handler → User records: checks credits (evidence: `server/controllers/interview.controller.js`)
- Interview handler → Interview records: creates and updates (evidence: `server/controllers/interview.controller.js`)
- Interview handler → OpenRouter AI: requests AI (evidence: `server/controllers/interview.controller.js`)
- Payment handler → Razorpay: creates order (evidence: `server/controllers/payment.controller.js`)
- Payment handler → Payment records: creates and updates (evidence: `server/controllers/payment.controller.js`)
- Payment handler → User records: adds credits (evidence: `server/controllers/payment.controller.js`)
- Payment plans → Payment handler: starts payment (evidence: `README.md`)
