# venkatasaieeshreddy005/rankup-ai architecture

> Architecture diagram of the GitHub repository venkatasaieeshreddy005/rankup-ai, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/venkatasaieeshreddy005/rankup-ai
- Repository: https://github.com/venkatasaieeshreddy005/rankup-ai

## Overview

RankUp AI is a mock-interview practice product. Users sign in, prepare an interview (including optional resume analysis), answer timed questions, and review feedback and reports; pricing and credit-backed interview generation are additional product capabilities. The graph includes the documented frontend routes and backend interview, account, and payment subsystems. Some client-to-API wiring and payment behavior are unsampled, so those links are omitted rather than inferred.

Main entry points: [`client/src/App.jsx`](https://github.com/venkatasaieeshreddy005/rankup-ai/blob/main/client/src/App.jsx) (Route shell), [`server/controllers/interview.js`](https://github.com/venkatasaieeshreddy005/rankup-ai/blob/main/server/controllers/interview.js) (Interview workflow), [`client/src/pages/Auth.jsx`](https://github.com/venkatasaieeshreddy005/rankup-ai/blob/main/client/src/pages/Auth.jsx) (Google sign-in), [`server/index.js`](https://github.com/venkatasaieeshreddy005/rankup-ai/blob/main/server/index.js) (API server)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web application"]
  node_app["Route shell<br/>[App.jsx]"]
  node_authui["Google sign-in<br/>[Auth.jsx]"]
  node_authmodal["Sign-in modal<br/>[AuthModel.jsx]"]
  node_home["Home experience<br/>[Home.jsx]"]
end

subgraph group_identity["Identity and accounts"]
  node_firebase["Firebase auth<br/>[firebase.js]"]
  node_userstate["User state<br/>[userSlice.js]"]
  node_server["API server<br/>[index.js]"]
  node_authroutes["Auth routes<br/>[authroute.js]"]
  node_authcontroller["Authentication<br/>[authcontroller.js]"]
  node_authmiddleware["Session validation<br/>[isAuth.js]"]
  node_usercontroller["Current user<br/>[usercontroller.js]"]
  node_userdb[("User records<br/>[user.js]")]
end

subgraph group_interviews["Interview lifecycle"]
  node_history["Interview history"]
  node_interviewpage["Interview workspace<br/>[InterviewPage.jsx]"]
  node_setup["Interview setup<br/>[Setup.jsx]"]
  node_interviewui["Timed interview<br/>[Interview.jsx]"]
  node_timer["Question timer<br/>[Timer.jsx]"]
  node_reportpage["Report page"]
  node_reportui["Performance report<br/>[Report.jsx]"]
  node_interviewroutes["Interview routes<br/>[interview.js]"]
  node_interviewcontroller["Interview workflow<br/>[interview.js]"]
  node_messageprompt["Question prompts"]
  node_evalprompt["Evaluation prompts"]
  node_ai["AI gateway"]
  node_interviewdb[("Interview records<br/>[interview.js]")]
end

subgraph group_commerce["Credits and payments"]
  node_pricing["Pricing page<br/>[Pricing.jsx]"]
  node_paymentroutes["Payment routes<br/>[payment.js]"]
  node_paymentcontroller["Payment workflow<br/>[payment.js]"]
  node_razorpay["Razorpay service<br/>[razorpay.js]"]
  node_paymentdb[("Payment records<br/>[payment.js]")]
end

node_user(("User"))
node_openrouter{{"OpenRouter"}}

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_pricing
node_app -->|"routes to"| node_history
node_app -->|"routes to"| node_reportpage
node_app -->|"updates"| node_userstate
node_authui -->|"authenticates with"| node_firebase
node_authui -->|"posts sign-in"| node_authroutes
node_authui -->|"updates"| node_userstate
node_authmodal -->|"renders"| node_authui
node_interviewpage -->|"renders"| node_setup
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_interviewroutes
node_server -->|"mounts"| node_paymentroutes
node_authroutes -->|"dispatches to"| node_authcontroller
node_authcontroller -->|"reads and writes"| node_userdb
node_authcontroller -->|"gets token for"| node_user
node_server -->|"mounts user API"| node_usercontroller
node_usercontroller -->|"reads"| node_userdb
node_interviewroutes -->|"guards routes"| node_authmiddleware
node_interviewroutes -->|"dispatches to"| node_interviewcontroller
node_interviewcontroller -->|"builds prompts"| node_messageprompt
node_interviewcontroller -->|"builds prompts"| node_evalprompt
node_interviewcontroller -->|"requests analysis"| node_ai
node_ai -->|"sends completions"| node_openrouter
node_interviewcontroller -->|"reads and writes"| node_interviewdb
node_interviewcontroller -->|"deducts credits"| node_userdb
node_paymentroutes -->|"guards routes"| node_authmiddleware
node_paymentroutes -->|"dispatches to"| node_paymentcontroller
node_paymentcontroller -->|"uses"| node_razorpay
node_paymentcontroller -->|"reads and writes"| node_paymentdb
node_paymentcontroller -->|"updates credits"| node_userdb

click node_app "https://github.com/venkatasaieeshreddy005/rankup-ai/blob/main/client/src/App.jsx"
click node_authui "https://github.com/venkatasaieeshreddy005/rankup-ai/blob/main/client/src/pages/Auth.jsx"
click node_authmodal "https://github.com/venkatasaieeshreddy005/rankup-ai/blob/main/client/src/components/AuthModel.jsx"
click node_firebase "https://github.com/venkatasaieeshreddy005/rankup-ai/blob/main/client/src/utils/firebase.js"
click node_userstate "https://github.com/venkatasaieeshreddy005/rankup-ai/blob/main/client/src/redux/userSlice.js"
click node_home "https://github.com/venkatasaieeshreddy005/rankup-ai/blob/main/client/src/pages/Home.jsx"
click node_pricing "https://github.com/venkatasaieeshreddy005/rankup-ai/blob/main/client/src/pages/Pricing.jsx"
click node_history "https://github.com/venkatasaieeshreddy005/rankup-ai/blob/main/client/src/pages/interviewHistory.jsx"
click node_interviewpage "https://github.com/venkatasaieeshreddy005/rankup-ai/blob/main/client/src/pages/InterviewPage.jsx"
click node_setup "https://github.com/venkatasaieeshreddy005/rankup-ai/blob/main/client/src/components/Setup.jsx"
click node_interviewui "https://github.com/venkatasaieeshreddy005/rankup-ai/blob/main/client/src/components/Interview.jsx"
click node_timer "https://github.com/venkatasaieeshreddy005/rankup-ai/blob/main/client/src/components/Timer.jsx"
click node_reportpage "https://github.com/venkatasaieeshreddy005/rankup-ai/blob/main/client/src/pages/interviewReport.jsx"
click node_reportui "https://github.com/venkatasaieeshreddy005/rankup-ai/blob/main/client/src/components/Report.jsx"
click node_server "https://github.com/venkatasaieeshreddy005/rankup-ai/blob/main/server/index.js"
click node_authroutes "https://github.com/venkatasaieeshreddy005/rankup-ai/blob/main/server/routes/authroute.js"
click node_authcontroller "https://github.com/venkatasaieeshreddy005/rankup-ai/blob/main/server/controllers/authcontroller.js"
click node_authmiddleware "https://github.com/venkatasaieeshreddy005/rankup-ai/blob/main/server/middleware/isAuth.js"
click node_usercontroller "https://github.com/venkatasaieeshreddy005/rankup-ai/blob/main/server/controllers/usercontroller.js"
click node_userdb "https://github.com/venkatasaieeshreddy005/rankup-ai/blob/main/server/models/user.js"
click node_interviewroutes "https://github.com/venkatasaieeshreddy005/rankup-ai/blob/main/server/routes/interview.js"
click node_interviewcontroller "https://github.com/venkatasaieeshreddy005/rankup-ai/blob/main/server/controllers/interview.js"
click node_messageprompt "https://github.com/venkatasaieeshreddy005/rankup-ai/blob/main/server/services/interviewMessage.js"
click node_evalprompt "https://github.com/venkatasaieeshreddy005/rankup-ai/blob/main/server/services/evaluationPrompt.js"
click node_ai "https://github.com/venkatasaieeshreddy005/rankup-ai/blob/main/server/services/openRouterService.js"
click node_interviewdb "https://github.com/venkatasaieeshreddy005/rankup-ai/blob/main/server/models/interview.js"
click node_paymentroutes "https://github.com/venkatasaieeshreddy005/rankup-ai/blob/main/server/routes/payment.js"
click node_paymentcontroller "https://github.com/venkatasaieeshreddy005/rankup-ai/blob/main/server/controllers/payment.js"
click node_razorpay "https://github.com/venkatasaieeshreddy005/rankup-ai/blob/main/server/services/razorpay.js"
click node_paymentdb "https://github.com/venkatasaieeshreddy005/rankup-ai/blob/main/server/models/payment.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_authmodal,node_home,node_user toneBlue
class node_firebase,node_userstate,node_server,node_authroutes,node_authcontroller,node_authmiddleware,node_usercontroller,node_userdb toneAmber
class node_history,node_interviewpage,node_setup,node_interviewui,node_timer,node_reportpage,node_reportui,node_interviewroutes,node_interviewcontroller,node_messageprompt,node_evalprompt,node_ai,node_interviewdb,node_openrouter toneMint
class node_pricing,node_paymentroutes,node_paymentcontroller,node_razorpay,node_paymentdb toneRose
```

## Components

### Web application

- [Route shell](https://github.com/venkatasaieeshreddy005/rankup-ai/blob/main/client/src/App.jsx): `client/src/App.jsx`
- [Google sign-in](https://github.com/venkatasaieeshreddy005/rankup-ai/blob/main/client/src/pages/Auth.jsx): `client/src/pages/Auth.jsx`
- [Sign-in modal](https://github.com/venkatasaieeshreddy005/rankup-ai/blob/main/client/src/components/AuthModel.jsx): `client/src/components/AuthModel.jsx`
- [Home experience](https://github.com/venkatasaieeshreddy005/rankup-ai/blob/main/client/src/pages/Home.jsx): `client/src/pages/Home.jsx`

### Identity and accounts

- [Firebase auth](https://github.com/venkatasaieeshreddy005/rankup-ai/blob/main/client/src/utils/firebase.js): `client/src/utils/firebase.js`
- [User state](https://github.com/venkatasaieeshreddy005/rankup-ai/blob/main/client/src/redux/userSlice.js): `client/src/redux/userSlice.js`
- [API server](https://github.com/venkatasaieeshreddy005/rankup-ai/blob/main/server/index.js): `server/index.js`
- [Auth routes](https://github.com/venkatasaieeshreddy005/rankup-ai/blob/main/server/routes/authroute.js): `server/routes/authroute.js`
- [Authentication](https://github.com/venkatasaieeshreddy005/rankup-ai/blob/main/server/controllers/authcontroller.js): `server/controllers/authcontroller.js`
- [Session validation](https://github.com/venkatasaieeshreddy005/rankup-ai/blob/main/server/middleware/isAuth.js): `server/middleware/isAuth.js`
- [Current user](https://github.com/venkatasaieeshreddy005/rankup-ai/blob/main/server/controllers/usercontroller.js): `server/controllers/usercontroller.js`
- [User records](https://github.com/venkatasaieeshreddy005/rankup-ai/blob/main/server/models/user.js): `server/models/user.js`

### Interview lifecycle

- [Interview history](https://github.com/venkatasaieeshreddy005/rankup-ai/blob/main/client/src/pages/interviewHistory.jsx): `client/src/pages/interviewHistory.jsx`
- [Interview workspace](https://github.com/venkatasaieeshreddy005/rankup-ai/blob/main/client/src/pages/InterviewPage.jsx): `client/src/pages/InterviewPage.jsx`
- [Interview setup](https://github.com/venkatasaieeshreddy005/rankup-ai/blob/main/client/src/components/Setup.jsx): `client/src/components/Setup.jsx`
- [Timed interview](https://github.com/venkatasaieeshreddy005/rankup-ai/blob/main/client/src/components/Interview.jsx): `client/src/components/Interview.jsx`
- [Question timer](https://github.com/venkatasaieeshreddy005/rankup-ai/blob/main/client/src/components/Timer.jsx): `client/src/components/Timer.jsx`
- [Report page](https://github.com/venkatasaieeshreddy005/rankup-ai/blob/main/client/src/pages/interviewReport.jsx): `client/src/pages/interviewReport.jsx`
- [Performance report](https://github.com/venkatasaieeshreddy005/rankup-ai/blob/main/client/src/components/Report.jsx): `client/src/components/Report.jsx`
- [Interview routes](https://github.com/venkatasaieeshreddy005/rankup-ai/blob/main/server/routes/interview.js): `server/routes/interview.js`
- [Interview workflow](https://github.com/venkatasaieeshreddy005/rankup-ai/blob/main/server/controllers/interview.js): `server/controllers/interview.js`
- [Question prompts](https://github.com/venkatasaieeshreddy005/rankup-ai/blob/main/server/services/interviewMessage.js): `server/services/interviewMessage.js`
- [Evaluation prompts](https://github.com/venkatasaieeshreddy005/rankup-ai/blob/main/server/services/evaluationPrompt.js): `server/services/evaluationPrompt.js`
- [AI gateway](https://github.com/venkatasaieeshreddy005/rankup-ai/blob/main/server/services/openRouterService.js): `server/services/openRouterService.js`
- [Interview records](https://github.com/venkatasaieeshreddy005/rankup-ai/blob/main/server/models/interview.js): `server/models/interview.js`

### Credits and payments

- [Pricing page](https://github.com/venkatasaieeshreddy005/rankup-ai/blob/main/client/src/pages/Pricing.jsx): `client/src/pages/Pricing.jsx`
- [Payment routes](https://github.com/venkatasaieeshreddy005/rankup-ai/blob/main/server/routes/payment.js): `server/routes/payment.js`
- [Payment workflow](https://github.com/venkatasaieeshreddy005/rankup-ai/blob/main/server/controllers/payment.js): `server/controllers/payment.js`
- [Razorpay service](https://github.com/venkatasaieeshreddy005/rankup-ai/blob/main/server/services/razorpay.js): `server/services/razorpay.js`
- [Payment records](https://github.com/venkatasaieeshreddy005/rankup-ai/blob/main/server/models/payment.js): `server/models/payment.js`

### Other components

- **User**
- **OpenRouter**

## Connections

- User → Route shell: uses (evidence: `client/src/App.jsx`)
- Route shell → Home experience: routes to (evidence: `client/src/App.jsx`)
- Route shell → Google sign-in: routes to (evidence: `client/src/App.jsx`)
- Route shell → Interview workspace: routes to (evidence: `client/src/App.jsx`)
- Route shell → Pricing page: routes to (evidence: `client/src/App.jsx`)
- Route shell → Interview history: routes to (evidence: `client/src/App.jsx`)
- Route shell → Report page: routes to (evidence: `client/src/App.jsx`)
- Route shell → User state: updates (evidence: `client/src/App.jsx`)
- Google sign-in → Firebase auth: authenticates with (evidence: `client/src/pages/Auth.jsx`)
- Google sign-in → Auth routes: posts sign-in (evidence: `client/src/pages/Auth.jsx`)
- Google sign-in → User state: updates (evidence: `client/src/pages/Auth.jsx`)
- Sign-in modal → Google sign-in: renders (evidence: `client/src/components/AuthModel.jsx`)
- Interview workspace → Interview setup: renders (evidence: `client/src/pages/InterviewPage.jsx`)
- Interview workspace → Timed interview: renders (evidence: `client/src/pages/InterviewPage.jsx`)
- Interview workspace → Performance report: renders (evidence: `client/src/pages/InterviewPage.jsx`)
- Timed interview → Question timer: uses (evidence: `client/src/components/Interview.jsx`)
- Report page → Performance report: renders (evidence: `client/src/pages/interviewReport.jsx`)
- API server → Auth routes: mounts (evidence: `server/index.js`)
- API server → Interview routes: mounts (evidence: `server/index.js`)
- API server → Payment routes: mounts (evidence: `server/index.js`)
- Auth routes → Authentication: dispatches to (evidence: `server/routes/authroute.js`)
- Authentication → User records: reads and writes (evidence: `server/controllers/authcontroller.js`)
- Authentication → User: gets token for (evidence: `server/controllers/authcontroller.js`)
- API server → Current user: mounts user API (evidence: `server/index.js`)
- Current user → User records: reads (evidence: `server/controllers/usercontroller.js`)
- Interview routes → Session validation: guards routes (evidence: `server/routes/interview.js`)
- Interview routes → Interview workflow: dispatches to (evidence: `server/routes/interview.js`)
- Interview workflow → Question prompts: builds prompts (evidence: `server/controllers/interview.js`)
- Interview workflow → Evaluation prompts: builds prompts (evidence: `server/controllers/interview.js`)
- Interview workflow → AI gateway: requests analysis (evidence: `server/controllers/interview.js`)
- AI gateway → OpenRouter: sends completions (evidence: `server/services/openRouterService.js`)
- Interview workflow → Interview records: reads and writes (evidence: `server/controllers/interview.js`)
- Interview workflow → User records: deducts credits (evidence: `server/controllers/interview.js`)
- Payment routes → Session validation: guards routes (evidence: `server/routes/payment.js`)
- Payment routes → Payment workflow: dispatches to (evidence: `server/routes/payment.js`)
- Payment workflow → Razorpay service: uses (evidence: `server/controllers/payment.js`)
- Payment workflow → Payment records: reads and writes (evidence: `server/controllers/payment.js`)
- Payment workflow → User records: updates credits (evidence: `server/controllers/payment.js`)
