# vippansingh27/interviewiq architecture

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

## Overview

InterviewIQ is a web platform for AI-assisted interview practice. Candidates sign in, configure an interview and optionally provide a resume, answer timed questions, and review feedback and reports; they can also revisit interview history or purchase credits. The graph separates the browser experience, API workflows, persistence, and integrations. The README documents major capabilities; sampled source confirms several routes and backend calls, but not every client-to-API request, so those links are documented at a high level.

Main entry points: [`client/src/App.jsx`](https://github.com/vippansingh27/interviewiq/blob/main/client/src/App.jsx) (Route and session shell), [`server/controllers/interview.controller.js`](https://github.com/vippansingh27/interviewiq/blob/main/server/controllers/interview.controller.js) (Interview processing), [`client/src/pages/Auth.jsx`](https://github.com/vippansingh27/interviewiq/blob/main/client/src/pages/Auth.jsx) (Sign-in view), [`server/controllers/payment.controller.js`](https://github.com/vippansingh27/interviewiq/blob/main/server/controllers/payment.controller.js) (Payment processing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web experience"]
  node_app["Route and session shell<br/>[App.jsx]"]
  node_authui["Sign-in view<br/>[Auth.jsx]"]
  node_setup["Interview setup<br/>[Step1SetUp.jsx]"]
  node_interviewui["Live interview<br/>[Step2Interview.jsx]"]
  node_timer["Response timer<br/>[Timer.jsx]"]
  node_reportui["Feedback and report<br/>[Step3Report.jsx]"]
  node_historyui["Interview history"]
  node_pricingui["Plans and credits<br/>[Pricing.jsx]"]
  node_userstate["User session state<br/>[userSlice.js]"]
end

subgraph group_api["API workflows"]
  node_authroutes["Authentication routes<br/>[auth.route.js]"]
  node_authcontroller["Account authentication<br/>[auth.controller.js]"]
  node_useroutes["User routes<br/>[user.route.js]"]
  node_usercontroller["Current user lookup<br/>[user.controller.js]"]
  node_interviewroutes["Interview routes<br/>[interview.route.js]"]
  node_interviewcontroller["Interview processing"]
  node_paymentroutes["Payment routes<br/>[payment.route.js]"]
  node_paymentcontroller["Payment processing"]
  node_authguard["JWT access guard<br/>[isAuth.js]"]
end

subgraph group_data["Account and interview data"]
  node_userstore[("User records and credits<br/>[user.model.js]")]
  node_interviewstore[("Interview records<br/>[interview.model.js]")]
  node_paymentstore[("Payment records<br/>[payment.model.js]")]
end

subgraph group_integrations["External services"]
  node_firebase["Firebase authentication<br/>[firebase.js]"]
  node_ai["OpenRouter language model"]
  node_razorpay["Razorpay payments"]
end

node_candidate(("Candidate"))

node_candidate -->|"uses"| node_app
node_app -->|"routes to"| node_authui
node_app -->|"routes to"| node_setup
node_app -->|"routes to"| node_historyui
node_app -->|"routes to"| node_pricingui
node_app -->|"routes to"| node_reportui
node_app -->|"loads session"| node_userstate
node_authui -->|"authenticates with"| node_firebase
node_authui -->|"posts sign-in"| node_authroutes
node_authui -->|"updates"| node_userstate
node_setup -->|"starts practice"| node_interviewui
node_interviewui -->|"uses"| node_timer
node_interviewui -->|"submits answers"| node_interviewroutes
node_interviewroutes -->|"guards requests"| node_authguard
node_interviewroutes -->|"dispatches to"| node_interviewcontroller
node_interviewcontroller -->|"requests AI output"| node_ai
node_interviewcontroller -->|"reads and updates"| node_userstore
node_interviewcontroller -->|"stores interview"| node_interviewstore
node_interviewcontroller -->|"returns report data"| node_reportui
node_historyui -->|"loads past sessions"| node_interviewroutes
node_pricingui -->|"starts purchase"| node_paymentroutes
node_paymentroutes -->|"guards requests"| node_authguard
node_paymentroutes -->|"dispatches to"| node_paymentcontroller
node_paymentcontroller -->|"creates order"| node_razorpay
node_paymentcontroller -->|"records payment"| node_paymentstore
node_paymentcontroller -->|"adds credits"| node_userstore
node_authroutes -->|"dispatches to"| node_authcontroller
node_authcontroller -->|"finds or creates"| node_userstore
node_useroutes -->|"guards requests"| node_authguard
node_useroutes -->|"dispatches to"| node_usercontroller
node_usercontroller -->|"reads account"| node_userstore
node_app -->|"checks current user"| node_useroutes

click node_app "https://github.com/vippansingh27/interviewiq/blob/main/client/src/App.jsx"
click node_authui "https://github.com/vippansingh27/interviewiq/blob/main/client/src/pages/Auth.jsx"
click node_firebase "https://github.com/vippansingh27/interviewiq/blob/main/client/src/utils/firebase.js"
click node_setup "https://github.com/vippansingh27/interviewiq/blob/main/client/src/components/Step1SetUp.jsx"
click node_interviewui "https://github.com/vippansingh27/interviewiq/blob/main/client/src/components/Step2Interview.jsx"
click node_timer "https://github.com/vippansingh27/interviewiq/blob/main/client/src/components/Timer.jsx"
click node_reportui "https://github.com/vippansingh27/interviewiq/blob/main/client/src/components/Step3Report.jsx"
click node_historyui "https://github.com/vippansingh27/interviewiq/blob/main/client/src/pages/InterviewHistory.jsx"
click node_pricingui "https://github.com/vippansingh27/interviewiq/blob/main/client/src/pages/Pricing.jsx"
click node_userstate "https://github.com/vippansingh27/interviewiq/blob/main/client/src/redux/userSlice.js"
click node_authroutes "https://github.com/vippansingh27/interviewiq/blob/main/server/routes/auth.route.js"
click node_authcontroller "https://github.com/vippansingh27/interviewiq/blob/main/server/controllers/auth.controller.js"
click node_useroutes "https://github.com/vippansingh27/interviewiq/blob/main/server/routes/user.route.js"
click node_usercontroller "https://github.com/vippansingh27/interviewiq/blob/main/server/controllers/user.controller.js"
click node_interviewroutes "https://github.com/vippansingh27/interviewiq/blob/main/server/routes/interview.route.js"
click node_interviewcontroller "https://github.com/vippansingh27/interviewiq/blob/main/server/controllers/interview.controller.js"
click node_paymentroutes "https://github.com/vippansingh27/interviewiq/blob/main/server/routes/payment.route.js"
click node_paymentcontroller "https://github.com/vippansingh27/interviewiq/blob/main/server/controllers/payment.controller.js"
click node_authguard "https://github.com/vippansingh27/interviewiq/blob/main/server/middlewares/isAuth.js"
click node_userstore "https://github.com/vippansingh27/interviewiq/blob/main/server/models/user.model.js"
click node_interviewstore "https://github.com/vippansingh27/interviewiq/blob/main/server/models/interview.model.js"
click node_paymentstore "https://github.com/vippansingh27/interviewiq/blob/main/server/models/payment.model.js"
click node_ai "https://github.com/vippansingh27/interviewiq/blob/main/server/services/openRouter.service.js"
click node_razorpay "https://github.com/vippansingh27/interviewiq/blob/main/server/services/razorpay.service.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_authui,node_setup,node_interviewui,node_timer,node_reportui,node_historyui,node_pricingui,node_userstate toneBlue
class node_authroutes,node_authcontroller,node_useroutes,node_usercontroller,node_interviewroutes,node_interviewcontroller,node_paymentroutes,node_paymentcontroller,node_authguard toneAmber
class node_userstore,node_interviewstore,node_paymentstore toneMint
class node_firebase,node_ai,node_razorpay toneRose
class node_candidate toneIndigo
```

## Components

### Web experience

- [Route and session shell](https://github.com/vippansingh27/interviewiq/blob/main/client/src/App.jsx): `client/src/App.jsx`
- [Sign-in view](https://github.com/vippansingh27/interviewiq/blob/main/client/src/pages/Auth.jsx): `client/src/pages/Auth.jsx`
- [Interview setup](https://github.com/vippansingh27/interviewiq/blob/main/client/src/components/Step1SetUp.jsx): `client/src/components/Step1SetUp.jsx`
- [Live interview](https://github.com/vippansingh27/interviewiq/blob/main/client/src/components/Step2Interview.jsx): `client/src/components/Step2Interview.jsx`
- [Response timer](https://github.com/vippansingh27/interviewiq/blob/main/client/src/components/Timer.jsx): `client/src/components/Timer.jsx`
- [Feedback and report](https://github.com/vippansingh27/interviewiq/blob/main/client/src/components/Step3Report.jsx): `client/src/components/Step3Report.jsx`
- [Interview history](https://github.com/vippansingh27/interviewiq/blob/main/client/src/pages/InterviewHistory.jsx): `client/src/pages/InterviewHistory.jsx`
- [Plans and credits](https://github.com/vippansingh27/interviewiq/blob/main/client/src/pages/Pricing.jsx): `client/src/pages/Pricing.jsx`
- [User session state](https://github.com/vippansingh27/interviewiq/blob/main/client/src/redux/userSlice.js): `client/src/redux/userSlice.js`

### API workflows

- [Authentication routes](https://github.com/vippansingh27/interviewiq/blob/main/server/routes/auth.route.js): `server/routes/auth.route.js`
- [Account authentication](https://github.com/vippansingh27/interviewiq/blob/main/server/controllers/auth.controller.js): `server/controllers/auth.controller.js`
- [User routes](https://github.com/vippansingh27/interviewiq/blob/main/server/routes/user.route.js): `server/routes/user.route.js`
- [Current user lookup](https://github.com/vippansingh27/interviewiq/blob/main/server/controllers/user.controller.js): `server/controllers/user.controller.js`
- [Interview routes](https://github.com/vippansingh27/interviewiq/blob/main/server/routes/interview.route.js): `server/routes/interview.route.js`
- [Interview processing](https://github.com/vippansingh27/interviewiq/blob/main/server/controllers/interview.controller.js): `server/controllers/interview.controller.js`
- [Payment routes](https://github.com/vippansingh27/interviewiq/blob/main/server/routes/payment.route.js): `server/routes/payment.route.js`
- [Payment processing](https://github.com/vippansingh27/interviewiq/blob/main/server/controllers/payment.controller.js): `server/controllers/payment.controller.js`
- [JWT access guard](https://github.com/vippansingh27/interviewiq/blob/main/server/middlewares/isAuth.js): `server/middlewares/isAuth.js`

### Account and interview data

- [User records and credits](https://github.com/vippansingh27/interviewiq/blob/main/server/models/user.model.js): `server/models/user.model.js`
- [Interview records](https://github.com/vippansingh27/interviewiq/blob/main/server/models/interview.model.js): `server/models/interview.model.js`
- [Payment records](https://github.com/vippansingh27/interviewiq/blob/main/server/models/payment.model.js): `server/models/payment.model.js`

### External services

- [Firebase authentication](https://github.com/vippansingh27/interviewiq/blob/main/client/src/utils/firebase.js): `client/src/utils/firebase.js`
- [OpenRouter language model](https://github.com/vippansingh27/interviewiq/blob/main/server/services/openRouter.service.js): `server/services/openRouter.service.js`
- [Razorpay payments](https://github.com/vippansingh27/interviewiq/blob/main/server/services/razorpay.service.js): `server/services/razorpay.service.js`

### Other components

- **Candidate**

## Connections

- Candidate → Route and session shell: uses (evidence: `README.md`)
- Route and session shell → Sign-in view: routes to (evidence: `client/src/App.jsx`)
- Route and session shell → Interview setup: routes to (evidence: `client/src/App.jsx`)
- Route and session shell → Interview history: routes to (evidence: `client/src/App.jsx`)
- Route and session shell → Plans and credits: routes to (evidence: `client/src/App.jsx`)
- Route and session shell → Feedback and report: routes to (evidence: `client/src/App.jsx`)
- Route and session shell → User session state: loads session (evidence: `client/src/App.jsx`)
- Sign-in view → Firebase authentication: authenticates with (evidence: `client/src/pages/Auth.jsx`)
- Sign-in view → Authentication routes: posts sign-in (evidence: `README.md`)
- Sign-in view → User session state: updates (evidence: `client/src/pages/Auth.jsx`)
- Interview setup → Live interview: starts practice (evidence: `client/src/pages/InterviewPage.jsx`)
- Live interview → Response timer: uses (evidence: `client/src/components/Step2Interview.jsx`)
- Live interview → Interview routes: submits answers (evidence: `README.md`)
- Interview routes → JWT access guard: guards requests (evidence: `server/routes/interview.route.js`)
- Interview routes → Interview processing: dispatches to (evidence: `server/routes/interview.route.js`)
- Interview processing → OpenRouter language model: requests AI output (evidence: `server/controllers/interview.controller.js`)
- Interview processing → User records and credits: reads and updates (evidence: `server/controllers/interview.controller.js`)
- Interview processing → Interview records: stores interview (evidence: `server/controllers/interview.controller.js`)
- Interview processing → Feedback and report: returns report data (evidence: `README.md`)
- Interview history → Interview routes: loads past sessions (evidence: `README.md`)
- Plans and credits → Payment routes: starts purchase (evidence: `README.md`)
- Payment routes → JWT access guard: guards requests (evidence: `server/routes/payment.route.js`)
- Payment routes → Payment processing: dispatches to (evidence: `server/routes/payment.route.js`)
- Payment processing → Razorpay payments: creates order (evidence: `server/controllers/payment.controller.js`)
- Payment processing → Payment records: records payment (evidence: `server/controllers/payment.controller.js`)
- Payment processing → User records and credits: adds credits (evidence: `server/controllers/payment.controller.js`)
- Authentication routes → Account authentication: dispatches to (evidence: `server/routes/auth.route.js`)
- Account authentication → User records and credits: finds or creates (evidence: `server/controllers/auth.controller.js`)
- User routes → JWT access guard: guards requests (evidence: `server/routes/user.route.js`)
- User routes → Current user lookup: dispatches to (evidence: `server/routes/user.route.js`)
- Current user lookup → User records and credits: reads account (evidence: `server/controllers/user.controller.js`)
- Route and session shell → User routes: checks current user (evidence: `README.md`)
