# pransu2308/interviewiq architecture

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

## Overview

InterviewIQ is a React/MERN interview-preparation product. Users authenticate, configure a practice session (including resume analysis), receive AI-generated questions, submit timed answers, and review scored reports; they can also browse history and purchase credits. The graph captures documented UI routing and sampled backend calls. Some frontend API wiring and unsampled route/controller details are not shown, so their links are omitted rather than inferred.

Main entry points: [`client/src/App.jsx`](https://github.com/pransu2308/interviewiq/blob/main/client/src/App.jsx) (Application routes), [`server/index.js`](https://github.com/pransu2308/interviewiq/blob/main/server/index.js) (Express API), [`server/models/user.model.js`](https://github.com/pransu2308/interviewiq/blob/main/server/models/user.model.js) (User records), [`client/src/pages/InterviewPage.jsx`](https://github.com/pransu2308/interviewiq/blob/main/client/src/pages/InterviewPage.jsx) (Interview workflow)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web experience"]
  node_app["Application routes<br/>[App.jsx]"]
  node_home["Home and navigation<br/>[Home.jsx]"]
end

subgraph group_identity["Identity and profiles"]
  node_authui["Authentication UI<br/>[Auth.jsx]"]
  node_authmodal["Auth modal<br/>[AuthModel.jsx]"]
  node_userstate["User state<br/>[userSlice.js]"]
  node_authroutes["Auth routes<br/>[auth.route.js]"]
  node_authcontroller["Authentication<br/>[auth.controller.js]"]
  node_useroutes["User routes<br/>[user.route.js]"]
  node_usercontroller["Profile lookup<br/>[user.controller.js]"]
  node_guard["JWT guard<br/>[isAuth.js]"]
end

subgraph group_practice["Interview practice"]
  node_sessionui["Session setup<br/>[Step1SetUp.jsx]"]
  node_interviewui["Live interview<br/>[Step2Interview.jsx]"]
  node_timer["Answer timer<br/>[Timer.jsx]"]
  node_reportui["Interview report<br/>[Step3Report.jsx]"]
  node_interviewpage["Interview workflow<br/>[InterviewPage.jsx]"]
  node_history["Interview history"]
  node_reportpage["Report page"]
  node_interviewroutes["Interview routes<br/>[interview.route.js]"]
  node_interviewcontroller["Interview operations"]
  node_ai["OpenRouter service"]
end

subgraph group_commerce["Credits and payments"]
  node_pricing["Plans and credits<br/>[Pricing.jsx]"]
  node_paymentsroutes["Payment routes<br/>[payment.route.js]"]
  node_paymentcontroller["Payment operations"]
  node_razorpay["Razorpay service"]
end

subgraph group_platform["API and persistence"]
  node_server["Express API<br/>[index.js]"]
  node_users[("User records<br/>[user.model.js]")]
  node_interviews[("Interview records<br/>[interview.model.js]")]
  node_payments[("Payment records<br/>[payment.model.js]")]
end

node_user(("Interview candidate"))
node_mongodb[("MongoDB")]
node_openrouter["OpenRouter API"]
node_razorpayext["Razorpay"]

node_user -->|"uses"| node_app
node_app -->|"routes to"| node_home
node_app -->|"routes to"| node_authui
node_app -->|"routes to"| node_interviewpage
node_app -->|"routes to"| node_history
node_app -->|"routes to"| node_pricing
node_app -->|"routes to"| node_reportpage
node_home -->|"opens"| node_authmodal
node_authmodal -->|"renders"| node_authui
node_app -->|"dispatches user"| node_userstate
node_app -->|"requests current user"| node_server
node_interviewpage -->|"renders"| node_sessionui
node_interviewpage -->|"renders"| node_interviewui
node_interviewpage -->|"renders"| node_reportui
node_interviewui -->|"uses"| node_timer
node_reportpage -->|"renders"| node_reportui
node_server -->|"mounts"| node_authroutes
node_server -->|"mounts"| node_useroutes
node_server -->|"mounts"| node_interviewroutes
node_server -->|"mounts"| node_paymentsroutes
node_authroutes -->|"dispatches to"| node_authcontroller
node_useroutes -->|"guards"| node_guard
node_useroutes -->|"dispatches to"| node_usercontroller
node_interviewroutes -->|"guards"| node_guard
node_interviewroutes -->|"dispatches to"| node_interviewcontroller
node_paymentsroutes -->|"guards"| node_guard
node_paymentsroutes -->|"dispatches to"| node_paymentcontroller
node_authcontroller -->|"reads and writes"| node_users
node_usercontroller -->|"reads"| node_users
node_interviewcontroller -->|"reads and updates"| node_users
node_interviewcontroller -->|"creates and updates"| node_interviews
node_interviewcontroller -->|"requests analysis"| node_ai
node_ai -->|"sends prompts"| node_openrouter
node_paymentcontroller -->|"creates and updates"| node_payments
node_paymentcontroller -->|"adds credits"| node_users
node_paymentcontroller -->|"creates orders"| node_razorpay
node_razorpay -->|"submits order"| node_razorpayext
node_users -.->|"persists"| node_mongodb
node_interviews -.->|"persists"| node_mongodb
node_payments -.->|"persists"| node_mongodb

click node_app "https://github.com/pransu2308/interviewiq/blob/main/client/src/App.jsx"
click node_home "https://github.com/pransu2308/interviewiq/blob/main/client/src/pages/Home.jsx"
click node_authui "https://github.com/pransu2308/interviewiq/blob/main/client/src/pages/Auth.jsx"
click node_authmodal "https://github.com/pransu2308/interviewiq/blob/main/client/src/components/AuthModel.jsx"
click node_sessionui "https://github.com/pransu2308/interviewiq/blob/main/client/src/components/Step1SetUp.jsx"
click node_interviewui "https://github.com/pransu2308/interviewiq/blob/main/client/src/components/Step2Interview.jsx"
click node_timer "https://github.com/pransu2308/interviewiq/blob/main/client/src/components/Timer.jsx"
click node_reportui "https://github.com/pransu2308/interviewiq/blob/main/client/src/components/Step3Report.jsx"
click node_interviewpage "https://github.com/pransu2308/interviewiq/blob/main/client/src/pages/InterviewPage.jsx"
click node_history "https://github.com/pransu2308/interviewiq/blob/main/client/src/pages/InterviewHistory.jsx"
click node_reportpage "https://github.com/pransu2308/interviewiq/blob/main/client/src/pages/InterviewReport.jsx"
click node_pricing "https://github.com/pransu2308/interviewiq/blob/main/client/src/pages/Pricing.jsx"
click node_userstate "https://github.com/pransu2308/interviewiq/blob/main/client/src/redux/userSlice.js"
click node_server "https://github.com/pransu2308/interviewiq/blob/main/server/index.js"
click node_authroutes "https://github.com/pransu2308/interviewiq/blob/main/server/routes/auth.route.js"
click node_authcontroller "https://github.com/pransu2308/interviewiq/blob/main/server/controllers/auth.controller.js"
click node_useroutes "https://github.com/pransu2308/interviewiq/blob/main/server/routes/user.route.js"
click node_usercontroller "https://github.com/pransu2308/interviewiq/blob/main/server/controllers/user.controller.js"
click node_guard "https://github.com/pransu2308/interviewiq/blob/main/server/middlewares/isAuth.js"
click node_interviewroutes "https://github.com/pransu2308/interviewiq/blob/main/server/routes/interview.route.js"
click node_interviewcontroller "https://github.com/pransu2308/interviewiq/blob/main/server/controllers/interview.controller.js"
click node_ai "https://github.com/pransu2308/interviewiq/blob/main/server/services/openRouter.service.js"
click node_paymentsroutes "https://github.com/pransu2308/interviewiq/blob/main/server/routes/payment.route.js"
click node_paymentcontroller "https://github.com/pransu2308/interviewiq/blob/main/server/controllers/payment.controller.js"
click node_razorpay "https://github.com/pransu2308/interviewiq/blob/main/server/services/razorpay.service.js"
click node_users "https://github.com/pransu2308/interviewiq/blob/main/server/models/user.model.js"
click node_interviews "https://github.com/pransu2308/interviewiq/blob/main/server/models/interview.model.js"
click node_payments "https://github.com/pransu2308/interviewiq/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_home,node_user toneBlue
class node_authui,node_authmodal,node_userstate,node_authroutes,node_authcontroller,node_useroutes,node_usercontroller,node_guard,node_mongodb toneAmber
class node_sessionui,node_interviewui,node_timer,node_reportui,node_interviewpage,node_history,node_reportpage,node_interviewroutes,node_interviewcontroller,node_ai,node_openrouter toneMint
class node_pricing,node_paymentsroutes,node_paymentcontroller,node_razorpay toneRose
class node_server,node_users,node_interviews,node_payments,node_razorpayext toneIndigo
```

## Components

### Web experience

- [Application routes](https://github.com/pransu2308/interviewiq/blob/main/client/src/App.jsx): `client/src/App.jsx`
- [Home and navigation](https://github.com/pransu2308/interviewiq/blob/main/client/src/pages/Home.jsx): `client/src/pages/Home.jsx`

### Identity and profiles

- [Authentication UI](https://github.com/pransu2308/interviewiq/blob/main/client/src/pages/Auth.jsx): `client/src/pages/Auth.jsx`
- [Auth modal](https://github.com/pransu2308/interviewiq/blob/main/client/src/components/AuthModel.jsx): `client/src/components/AuthModel.jsx`
- [User state](https://github.com/pransu2308/interviewiq/blob/main/client/src/redux/userSlice.js): `client/src/redux/userSlice.js`
- [Auth routes](https://github.com/pransu2308/interviewiq/blob/main/server/routes/auth.route.js): `server/routes/auth.route.js`
- [Authentication](https://github.com/pransu2308/interviewiq/blob/main/server/controllers/auth.controller.js): `server/controllers/auth.controller.js`
- [User routes](https://github.com/pransu2308/interviewiq/blob/main/server/routes/user.route.js): `server/routes/user.route.js`
- [Profile lookup](https://github.com/pransu2308/interviewiq/blob/main/server/controllers/user.controller.js): `server/controllers/user.controller.js`
- [JWT guard](https://github.com/pransu2308/interviewiq/blob/main/server/middlewares/isAuth.js): `server/middlewares/isAuth.js`

### Interview practice

- [Session setup](https://github.com/pransu2308/interviewiq/blob/main/client/src/components/Step1SetUp.jsx): `client/src/components/Step1SetUp.jsx`
- [Live interview](https://github.com/pransu2308/interviewiq/blob/main/client/src/components/Step2Interview.jsx): `client/src/components/Step2Interview.jsx`
- [Answer timer](https://github.com/pransu2308/interviewiq/blob/main/client/src/components/Timer.jsx): `client/src/components/Timer.jsx`
- [Interview report](https://github.com/pransu2308/interviewiq/blob/main/client/src/components/Step3Report.jsx): `client/src/components/Step3Report.jsx`
- [Interview workflow](https://github.com/pransu2308/interviewiq/blob/main/client/src/pages/InterviewPage.jsx): `client/src/pages/InterviewPage.jsx`
- [Interview history](https://github.com/pransu2308/interviewiq/blob/main/client/src/pages/InterviewHistory.jsx): `client/src/pages/InterviewHistory.jsx`
- [Report page](https://github.com/pransu2308/interviewiq/blob/main/client/src/pages/InterviewReport.jsx): `client/src/pages/InterviewReport.jsx`
- [Interview routes](https://github.com/pransu2308/interviewiq/blob/main/server/routes/interview.route.js): `server/routes/interview.route.js`
- [Interview operations](https://github.com/pransu2308/interviewiq/blob/main/server/controllers/interview.controller.js): `server/controllers/interview.controller.js`
- [OpenRouter service](https://github.com/pransu2308/interviewiq/blob/main/server/services/openRouter.service.js): `server/services/openRouter.service.js`

### Credits and payments

- [Plans and credits](https://github.com/pransu2308/interviewiq/blob/main/client/src/pages/Pricing.jsx): `client/src/pages/Pricing.jsx`
- [Payment routes](https://github.com/pransu2308/interviewiq/blob/main/server/routes/payment.route.js): `server/routes/payment.route.js`
- [Payment operations](https://github.com/pransu2308/interviewiq/blob/main/server/controllers/payment.controller.js): `server/controllers/payment.controller.js`
- [Razorpay service](https://github.com/pransu2308/interviewiq/blob/main/server/services/razorpay.service.js): `server/services/razorpay.service.js`

### API and persistence

- [Express API](https://github.com/pransu2308/interviewiq/blob/main/server/index.js): `server/index.js`
- [User records](https://github.com/pransu2308/interviewiq/blob/main/server/models/user.model.js): `server/models/user.model.js`
- [Interview records](https://github.com/pransu2308/interviewiq/blob/main/server/models/interview.model.js): `server/models/interview.model.js`
- [Payment records](https://github.com/pransu2308/interviewiq/blob/main/server/models/payment.model.js): `server/models/payment.model.js`

### Other components

- **Interview candidate**
- **MongoDB**
- **OpenRouter API**
- **Razorpay**

## Connections

- Interview candidate → Application routes: uses (evidence: `client/src/App.jsx`)
- Application routes → Home and navigation: routes to (evidence: `client/src/App.jsx`)
- Application routes → Authentication UI: routes to (evidence: `client/src/App.jsx`)
- Application routes → Interview workflow: routes to (evidence: `client/src/App.jsx`)
- Application routes → Interview history: routes to (evidence: `client/src/App.jsx`)
- Application routes → Plans and credits: routes to (evidence: `client/src/App.jsx`)
- Application routes → Report page: routes to (evidence: `client/src/App.jsx`)
- Home and navigation → Auth modal: opens (evidence: `client/src/pages/Home.jsx`)
- Auth modal → Authentication UI: renders (evidence: `client/src/components/AuthModel.jsx`)
- Application routes → User state: dispatches user (evidence: `client/src/App.jsx`)
- Application routes → Express API: requests current user (evidence: `client/src/App.jsx`)
- Interview workflow → Session setup: renders (evidence: `client/src/pages/InterviewPage.jsx`)
- Interview workflow → Live interview: renders (evidence: `client/src/pages/InterviewPage.jsx`)
- Interview workflow → Interview report: renders (evidence: `client/src/pages/InterviewPage.jsx`)
- Live interview → Answer timer: uses (evidence: `client/src/components/Step2Interview.jsx`)
- Report page → Interview report: renders (evidence: `client/src/pages/InterviewReport.jsx`)
- Express API → Auth routes: mounts (evidence: `server/index.js`)
- Express API → User routes: mounts (evidence: `server/index.js`)
- Express API → Interview routes: mounts (evidence: `server/index.js`)
- Express API → Payment routes: mounts (evidence: `server/index.js`)
- Auth routes → Authentication: dispatches to (evidence: `server/routes/auth.route.js`)
- User routes → JWT guard: guards (evidence: `server/routes/user.route.js`)
- User routes → Profile lookup: dispatches to (evidence: `server/routes/user.route.js`)
- Interview routes → JWT guard: guards (evidence: `server/routes/interview.route.js`)
- Interview routes → Interview operations: dispatches to (evidence: `server/routes/interview.route.js`)
- Payment routes → JWT guard: guards (evidence: `server/routes/payment.route.js`)
- Payment routes → Payment operations: dispatches to (evidence: `server/routes/payment.route.js`)
- Authentication → User records: reads and writes (evidence: `server/controllers/auth.controller.js`)
- Profile lookup → User records: reads (evidence: `server/controllers/user.controller.js`)
- Interview operations → User records: reads and updates (evidence: `server/controllers/interview.controller.js`)
- Interview operations → Interview records: creates and updates (evidence: `server/controllers/interview.controller.js`)
- Interview operations → OpenRouter service: requests analysis (evidence: `server/controllers/interview.controller.js`)
- OpenRouter service → OpenRouter API: sends prompts (evidence: `server/services/openRouter.service.js`)
- Payment operations → Payment records: creates and updates (evidence: `server/controllers/payment.controller.js`)
- Payment operations → User records: adds credits (evidence: `server/controllers/payment.controller.js`)
- Payment operations → Razorpay service: creates orders (evidence: `server/controllers/payment.controller.js`)
- Razorpay service → Razorpay: submits order (evidence: `server/services/razorpay.service.js`)
- User records → MongoDB: persists
- Interview records → MongoDB: persists
- Payment records → MongoDB: persists
