# sarthakkk1105/github-actions.project architecture

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

## Overview

InterviewIQ.AI is a resume-personalized interview preparation platform. Users sign in, upload a resume, configure an interview, answer generated questions, and can review reports and interview history; paid plans provide additional credits. The client is organized around routed pages and interview-flow components, while Express routes dispatch to controllers that coordinate AI services, authentication, payments, and persistence. README documentation describes capabilities beyond the sampled excerpts; those branches are included where documented, with evidence limits reflected in the graph.

Main entry points: [`server/app.js`](https://github.com/sarthakkk1105/github-actions.project/blob/main/server/app.js) (Express API), [`client/src/App.jsx`](https://github.com/sarthakkk1105/github-actions.project/blob/main/client/src/App.jsx) (App routing), [`server/controller/interview.controller.js`](https://github.com/sarthakkk1105/github-actions.project/blob/main/server/controller/interview.controller.js) (Interview workflows), [`server/models/user.model.js`](https://github.com/sarthakkk1105/github-actions.project/blob/main/server/models/user.model.js) (User records)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Client experience"]
  node_app["App routing<br/>[App.jsx]"]
  node_authpage["Sign-in page<br/>[Auth.jsx]"]
  node_setup["Resume setup<br/>[Step1setup.jsx]"]
  node_interviewpage["Interview flow<br/>[InterviewPage.jsx]"]
  node_questions["Live interview<br/>[Step2interview.jsx]"]
  node_feedback["Interview report UI<br/>[Step3repot.jsx]"]
  node_reportpage["Report page"]
  node_history["Interview history"]
  node_pricing["Pricing page<br/>[Pricing.jsx]"]
  node_userstate["User state<br/>[userSlice.js]"]
end

subgraph group_api["API and workflows"]
  node_express["Express API<br/>[app.js]"]
  node_authcontroller["Authentication<br/>[auth.controller.js]"]
  node_interviewcontroller["Interview workflows"]
  node_pdf["Resume PDF parsing"]
  node_paymentcontroller["Payment and credits"]
  node_usercontroller["User profile<br/>[user.controller.js]"]
  node_authguard["JWT guard<br/>[isAuth.js]"]
end

subgraph group_data["Persistence"]
  node_users[("User records<br/>[user.model.js]")]
  node_sessions[("Interview records<br/>[interview.model.js]")]
  node_payments[("Payment records<br/>[payment.model.js]")]
end

subgraph group_integrations["External services"]
  node_firebase["Firebase auth<br/>[firebase.js]"]
  node_ai["AI service"]
  node_razorpay["Razorpay"]
  node_mongodb[("MongoDB")]
end

node_candidate(("Candidate"))

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_pricing
node_app -->|"routes to"| node_reportpage
node_app -->|"updates"| node_userstate
node_authpage -->|"signs in with"| node_firebase
node_authpage -->|"posts sign-in"| node_express
node_authpage -->|"updates"| node_userstate
node_interviewpage -->|"renders"| node_setup
node_interviewpage -->|"renders"| node_questions
node_interviewpage -->|"renders"| node_feedback
node_candidate -->|"uploads resume"| node_setup
node_setup -->|"submits resume"| node_express
node_express -->|"dispatches interview"| node_interviewcontroller
node_express -->|"dispatches auth"| node_authcontroller
node_express -->|"dispatches payment"| node_paymentcontroller
node_express -->|"dispatches profile"| node_usercontroller
node_interviewcontroller -->|"parses resume"| node_pdf
node_interviewcontroller -->|"requests generation"| node_ai
node_interviewcontroller -->|"reads and updates"| node_users
node_interviewcontroller -->|"creates and updates"| node_sessions
node_questions -->|"sends interview answers"| node_express
node_feedback -->|"displays results"| node_reportpage
node_history -->|"requests history"| node_express
node_pricing -->|"purchases credits"| node_express
node_paymentcontroller -->|"creates orders"| node_razorpay
node_paymentcontroller -->|"records payment"| node_payments
node_paymentcontroller -->|"adds credits"| node_users
node_usercontroller -->|"uses guard"| node_authguard
node_usercontroller -->|"loads profile"| node_users
node_authcontroller -->|"finds or creates"| node_users
node_authguard -.->|"checks requests"| node_express
node_users -.->|"persists in"| node_mongodb
node_sessions -.->|"persists in"| node_mongodb
node_payments -.->|"persists in"| node_mongodb

click node_app "https://github.com/sarthakkk1105/github-actions.project/blob/main/client/src/App.jsx"
click node_authpage "https://github.com/sarthakkk1105/github-actions.project/blob/main/client/src/pages/Auth.jsx"
click node_firebase "https://github.com/sarthakkk1105/github-actions.project/blob/main/client/src/utils/firebase.js"
click node_setup "https://github.com/sarthakkk1105/github-actions.project/blob/main/client/src/components/Step1setup.jsx"
click node_interviewpage "https://github.com/sarthakkk1105/github-actions.project/blob/main/client/src/pages/InterviewPage.jsx"
click node_questions "https://github.com/sarthakkk1105/github-actions.project/blob/main/client/src/components/Step2interview.jsx"
click node_feedback "https://github.com/sarthakkk1105/github-actions.project/blob/main/client/src/components/Step3repot.jsx"
click node_reportpage "https://github.com/sarthakkk1105/github-actions.project/blob/main/client/src/pages/InterviewReport.jsx"
click node_history "https://github.com/sarthakkk1105/github-actions.project/blob/main/client/src/pages/Interviewhistory.jsx"
click node_pricing "https://github.com/sarthakkk1105/github-actions.project/blob/main/client/src/pages/Pricing.jsx"
click node_userstate "https://github.com/sarthakkk1105/github-actions.project/blob/main/client/src/redux/userSlice.js"
click node_express "https://github.com/sarthakkk1105/github-actions.project/blob/main/server/app.js"
click node_authcontroller "https://github.com/sarthakkk1105/github-actions.project/blob/main/server/controller/auth.controller.js"
click node_interviewcontroller "https://github.com/sarthakkk1105/github-actions.project/blob/main/server/controller/interview.controller.js"
click node_pdf "https://github.com/sarthakkk1105/github-actions.project/blob/main/server/controller/interview.controller.js"
click node_paymentcontroller "https://github.com/sarthakkk1105/github-actions.project/blob/main/server/controller/payment.controller.js"
click node_usercontroller "https://github.com/sarthakkk1105/github-actions.project/blob/main/server/controller/user.controller.js"
click node_authguard "https://github.com/sarthakkk1105/github-actions.project/blob/main/server/middleware/isAuth.js"
click node_ai "https://github.com/sarthakkk1105/github-actions.project/blob/main/server/services/openrouter.services.js"
click node_razorpay "https://github.com/sarthakkk1105/github-actions.project/blob/main/server/services/Razorpay.service.js"
click node_users "https://github.com/sarthakkk1105/github-actions.project/blob/main/server/models/user.model.js"
click node_sessions "https://github.com/sarthakkk1105/github-actions.project/blob/main/server/models/interview.model.js"
click node_payments "https://github.com/sarthakkk1105/github-actions.project/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_setup,node_interviewpage,node_questions,node_feedback,node_reportpage,node_history,node_pricing,node_userstate toneBlue
class node_express,node_authcontroller,node_interviewcontroller,node_pdf,node_paymentcontroller,node_usercontroller,node_authguard toneAmber
class node_users,node_sessions,node_payments toneMint
class node_firebase,node_ai,node_razorpay,node_mongodb toneRose
class node_candidate toneIndigo
```

## Components

### Client experience

- [App routing](https://github.com/sarthakkk1105/github-actions.project/blob/main/client/src/App.jsx): `client/src/App.jsx`
- [Sign-in page](https://github.com/sarthakkk1105/github-actions.project/blob/main/client/src/pages/Auth.jsx): `client/src/pages/Auth.jsx`
- [Resume setup](https://github.com/sarthakkk1105/github-actions.project/blob/main/client/src/components/Step1setup.jsx): `client/src/components/Step1setup.jsx`
- [Interview flow](https://github.com/sarthakkk1105/github-actions.project/blob/main/client/src/pages/InterviewPage.jsx): `client/src/pages/InterviewPage.jsx`
- [Live interview](https://github.com/sarthakkk1105/github-actions.project/blob/main/client/src/components/Step2interview.jsx): `client/src/components/Step2interview.jsx`
- [Interview report UI](https://github.com/sarthakkk1105/github-actions.project/blob/main/client/src/components/Step3repot.jsx): `client/src/components/Step3repot.jsx`
- [Report page](https://github.com/sarthakkk1105/github-actions.project/blob/main/client/src/pages/InterviewReport.jsx): `client/src/pages/InterviewReport.jsx`
- [Interview history](https://github.com/sarthakkk1105/github-actions.project/blob/main/client/src/pages/Interviewhistory.jsx): `client/src/pages/Interviewhistory.jsx`
- [Pricing page](https://github.com/sarthakkk1105/github-actions.project/blob/main/client/src/pages/Pricing.jsx): `client/src/pages/Pricing.jsx`
- [User state](https://github.com/sarthakkk1105/github-actions.project/blob/main/client/src/redux/userSlice.js): `client/src/redux/userSlice.js`

### API and workflows

- [Express API](https://github.com/sarthakkk1105/github-actions.project/blob/main/server/app.js): `server/app.js`
- [Authentication](https://github.com/sarthakkk1105/github-actions.project/blob/main/server/controller/auth.controller.js): `server/controller/auth.controller.js`
- [Interview workflows](https://github.com/sarthakkk1105/github-actions.project/blob/main/server/controller/interview.controller.js): `server/controller/interview.controller.js`
- [Resume PDF parsing](https://github.com/sarthakkk1105/github-actions.project/blob/main/server/controller/interview.controller.js): `server/controller/interview.controller.js`
- [Payment and credits](https://github.com/sarthakkk1105/github-actions.project/blob/main/server/controller/payment.controller.js): `server/controller/payment.controller.js`
- [User profile](https://github.com/sarthakkk1105/github-actions.project/blob/main/server/controller/user.controller.js): `server/controller/user.controller.js`
- [JWT guard](https://github.com/sarthakkk1105/github-actions.project/blob/main/server/middleware/isAuth.js): `server/middleware/isAuth.js`

### Persistence

- [User records](https://github.com/sarthakkk1105/github-actions.project/blob/main/server/models/user.model.js): `server/models/user.model.js`
- [Interview records](https://github.com/sarthakkk1105/github-actions.project/blob/main/server/models/interview.model.js): `server/models/interview.model.js`
- [Payment records](https://github.com/sarthakkk1105/github-actions.project/blob/main/server/models/payment.model.js): `server/models/payment.model.js`

### External services

- [Firebase auth](https://github.com/sarthakkk1105/github-actions.project/blob/main/client/src/utils/firebase.js): `client/src/utils/firebase.js`
- [AI service](https://github.com/sarthakkk1105/github-actions.project/blob/main/server/services/openrouter.services.js): `server/services/openrouter.services.js`
- [Razorpay](https://github.com/sarthakkk1105/github-actions.project/blob/main/server/services/Razorpay.service.js): `server/services/Razorpay.service.js`
- **MongoDB**

### Other components

- **Candidate**

## Connections

- Candidate → App routing: uses (evidence: `README.md`)
- App routing → Sign-in page: routes to (evidence: `client/src/App.jsx`)
- App routing → Interview flow: routes to (evidence: `client/src/App.jsx`)
- App routing → Interview history: routes to (evidence: `client/src/App.jsx`)
- App routing → Pricing page: routes to (evidence: `client/src/App.jsx`)
- App routing → Report page: routes to (evidence: `client/src/App.jsx`)
- App routing → User state: updates (evidence: `client/src/App.jsx`)
- Sign-in page → Firebase auth: signs in with (evidence: `client/src/pages/Auth.jsx`)
- Sign-in page → Express API: posts sign-in (evidence: `client/src/pages/Auth.jsx`)
- Sign-in page → User state: updates (evidence: `client/src/pages/Auth.jsx`)
- Interview flow → Resume setup: renders (evidence: `client/src/pages/InterviewPage.jsx`)
- Interview flow → Live interview: renders (evidence: `client/src/pages/InterviewPage.jsx`)
- Interview flow → Interview report UI: renders (evidence: `client/src/pages/InterviewPage.jsx`)
- Candidate → Resume setup: uploads resume (evidence: `README.md`)
- Resume setup → Express API: submits resume (evidence: `README.md`)
- Express API → Interview workflows: dispatches interview (evidence: `server/app.js`)
- Express API → Authentication: dispatches auth (evidence: `server/app.js`)
- Express API → Payment and credits: dispatches payment (evidence: `server/app.js`)
- Express API → User profile: dispatches profile (evidence: `server/app.js`)
- Interview workflows → Resume PDF parsing: parses resume (evidence: `server/controller/interview.controller.js`)
- Interview workflows → AI service: requests generation (evidence: `server/controller/interview.controller.js`)
- Interview workflows → User records: reads and updates (evidence: `server/controller/interview.controller.js`)
- Interview workflows → Interview records: creates and updates (evidence: `server/controller/interview.controller.js`)
- Live interview → Express API: sends interview answers (evidence: `README.md`)
- Interview report UI → Report page: displays results (evidence: `client/src/pages/InterviewReport.jsx`)
- Interview history → Express API: requests history (evidence: `README.md`)
- Pricing page → Express API: purchases credits (evidence: `README.md`)
- Payment and credits → Razorpay: creates orders (evidence: `server/controller/payment.controller.js`)
- Payment and credits → Payment records: records payment (evidence: `server/controller/payment.controller.js`)
- Payment and credits → User records: adds credits (evidence: `server/controller/payment.controller.js`)
- User profile → JWT guard: uses guard (evidence: `server/controller/user.controller.js`)
- User profile → User records: loads profile (evidence: `server/controller/user.controller.js`)
- Authentication → User records: finds or creates (evidence: `server/controller/auth.controller.js`)
- JWT guard → Express API: checks requests
- User records → MongoDB: persists in
- Interview records → MongoDB: persists in
- Payment records → MongoDB: persists in
