# rajeev-gif/ai-interview-prep architecture

> Architecture diagram of the GitHub repository rajeev-gif/ai-interview-prep, 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/rajeev-gif/ai-interview-prep
- Repository: https://github.com/rajeev-gif/ai-interview-prep

## Overview

AI Interview Prep lets users register, create mock-interview sessions, review generated questions and answers, request concept explanations, and manage questions and sessions. The React app routes users through authentication and a dashboard into a session; its API requests reach an Express backend that applies authentication, invokes controllers, and stores users, sessions, and questions in MongoDB. AI generation and profile-image upload are documented capabilities; the sampled server and routes show their entry points, but the external AI and upload-storage details are not fully evidenced.

Main entry points: [`backend/server.js`](https://github.com/rajeev-gif/ai-interview-prep/blob/main/backend/server.js) (Express API), [`frontend/interview-prep-ai/src/utils/axiosInstance.js`](https://github.com/rajeev-gif/ai-interview-prep/blob/main/frontend/interview-prep-ai/src/utils/axiosInstance.js) (API client paths), [`frontend/interview-prep-ai/src/App.jsx`](https://github.com/rajeev-gif/ai-interview-prep/blob/main/frontend/interview-prep-ai/src/App.jsx) (App routing), [`frontend/interview-prep-ai/src/pages/InterviewPrep/InterviewPrep.jsx`](https://github.com/rajeev-gif/ai-interview-prep/blob/main/frontend/interview-prep-ai/src/pages/InterviewPrep/InterviewPrep.jsx) (Interview practice)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Frontend experience"]
  node_app["App routing<br/>[App.jsx]"]
  node_authui["Account flows"]
  node_context["User context<br/>[userContext.jsx]"]
  node_landing["Landing page<br/>[LandingPage.jsx]"]
  node_dashboard["Session dashboard<br/>[Dashboard.jsx]"]
  node_sessionform["Session creation"]
  node_prep["Interview practice<br/>[InterviewPrep.jsx]"]
  node_response["Explanation display"]
  node_api["API client paths<br/>[axiosInstance.js]"]
end

subgraph group_backend["Backend API"]
  node_server["Express API<br/>[server.js]"]
  node_authroutes["Auth routes<br/>[authRoutes.js]"]
  node_sessionroutes["Session routes<br/>[sessionRoutes.js]"]
  node_questionroutes["Question routes<br/>[questionRoutes.js]"]
  node_authcontroller["Account controller<br/>[authController.js]"]
  node_sessioncontroller["Session controller"]
  node_questioncontroller["Question controller"]
  node_aicontroller["AI controller<br/>[aiController.js]"]
  node_authmw["JWT protection<br/>[authMiddleware.js]"]
  node_imageupload["Image upload"]
end

subgraph group_data["Application data"]
  node_userdb[("User records<br/>[User.js]")]
  node_sessiondb[("Session records<br/>[Session.js]")]
  node_questiondb[("Question records<br/>[Question.js]")]
end

subgraph group_integrations["External services"]
  node_mongodb[("MongoDB")]
  node_gemini["Google Generative AI"]
end

node_user(("Interviewee"))

node_user -->|"uses"| node_app
node_app -->|"routes to"| node_landing
node_app -->|"routes to"| node_dashboard
node_app -->|"routes to"| node_prep
node_app -->|"provides"| node_context
node_landing -->|"opens"| node_authui
node_authui -->|"updates"| node_context
node_context -->|"requests profile"| node_api
node_dashboard -->|"opens"| node_sessionform
node_dashboard -->|"loads sessions"| node_api
node_sessionform -->|"creates session"| node_api
node_prep -->|"loads session"| node_api
node_prep -->|"requests explanation"| node_api
node_prep -->|"renders explanation"| node_response
node_api -.->|"calls API"| node_server
node_server -->|"mounts"| node_authroutes
node_server -->|"mounts"| node_sessionroutes
node_server -->|"mounts"| node_questionroutes
node_server -->|"routes AI requests"| node_aicontroller
node_authroutes -->|"dispatches"| node_authcontroller
node_authroutes -->|"protects profile"| node_authmw
node_authroutes -->|"handles uploads"| node_imageupload
node_sessionroutes -->|"dispatches"| node_sessioncontroller
node_sessionroutes -->|"protects routes"| node_authmw
node_questionroutes -->|"dispatches"| node_questioncontroller
node_authmw -->|"loads user"| node_userdb
node_authcontroller -->|"reads and writes"| node_userdb
node_sessioncontroller -->|"reads and writes"| node_sessiondb
node_sessioncontroller -->|"creates and deletes"| node_questiondb
node_questioncontroller -->|"manages questions"| node_questiondb
node_questioncontroller -->|"updates session"| node_sessiondb
node_aicontroller -.->|"generates content"| node_gemini
node_server -->|"connects"| node_mongodb
node_imageupload -->|"receives image"| node_user

click node_app "https://github.com/rajeev-gif/ai-interview-prep/blob/main/frontend/interview-prep-ai/src/App.jsx"
click node_authui "https://github.com/rajeev-gif/ai-interview-prep/tree/main/frontend/interview-prep-ai/src/pages/Auth"
click node_context "https://github.com/rajeev-gif/ai-interview-prep/blob/main/frontend/interview-prep-ai/src/context/userContext.jsx"
click node_landing "https://github.com/rajeev-gif/ai-interview-prep/blob/main/frontend/interview-prep-ai/src/pages/LandingPage.jsx"
click node_dashboard "https://github.com/rajeev-gif/ai-interview-prep/blob/main/frontend/interview-prep-ai/src/pages/Home/Dashboard.jsx"
click node_sessionform "https://github.com/rajeev-gif/ai-interview-prep/blob/main/frontend/interview-prep-ai/src/pages/Home/CreateSessionForm.jsx"
click node_prep "https://github.com/rajeev-gif/ai-interview-prep/blob/main/frontend/interview-prep-ai/src/pages/InterviewPrep/InterviewPrep.jsx"
click node_response "https://github.com/rajeev-gif/ai-interview-prep/blob/main/frontend/interview-prep-ai/src/pages/InterviewPrep/components/AiResponsePreview.jsx"
click node_api "https://github.com/rajeev-gif/ai-interview-prep/blob/main/frontend/interview-prep-ai/src/utils/axiosInstance.js"
click node_server "https://github.com/rajeev-gif/ai-interview-prep/blob/main/backend/server.js"
click node_authroutes "https://github.com/rajeev-gif/ai-interview-prep/blob/main/backend/routes/authRoutes.js"
click node_sessionroutes "https://github.com/rajeev-gif/ai-interview-prep/blob/main/backend/routes/sessionRoutes.js"
click node_questionroutes "https://github.com/rajeev-gif/ai-interview-prep/blob/main/backend/routes/questionRoutes.js"
click node_authcontroller "https://github.com/rajeev-gif/ai-interview-prep/blob/main/backend/controllers/authController.js"
click node_sessioncontroller "https://github.com/rajeev-gif/ai-interview-prep/blob/main/backend/controllers/sessionController.js"
click node_questioncontroller "https://github.com/rajeev-gif/ai-interview-prep/blob/main/backend/controllers/questionController.js"
click node_aicontroller "https://github.com/rajeev-gif/ai-interview-prep/blob/main/backend/controllers/aiController.js"
click node_authmw "https://github.com/rajeev-gif/ai-interview-prep/blob/main/backend/middldewares/authMiddleware.js"
click node_userdb "https://github.com/rajeev-gif/ai-interview-prep/blob/main/backend/models/User.js"
click node_sessiondb "https://github.com/rajeev-gif/ai-interview-prep/blob/main/backend/models/Session.js"
click node_questiondb "https://github.com/rajeev-gif/ai-interview-prep/blob/main/backend/models/Question.js"
click node_imageupload "https://github.com/rajeev-gif/ai-interview-prep/blob/main/backend/middldewares/uploadMiddleware.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_context,node_landing,node_dashboard,node_sessionform,node_prep,node_response,node_api,node_user toneBlue
class node_server,node_authroutes,node_sessionroutes,node_questionroutes,node_authcontroller,node_sessioncontroller,node_questioncontroller,node_aicontroller,node_authmw,node_imageupload toneAmber
class node_userdb,node_sessiondb,node_questiondb toneMint
class node_mongodb,node_gemini toneRose
```

## Components

### Frontend experience

- [App routing](https://github.com/rajeev-gif/ai-interview-prep/blob/main/frontend/interview-prep-ai/src/App.jsx): `frontend/interview-prep-ai/src/App.jsx`
- [Account flows](https://github.com/rajeev-gif/ai-interview-prep/tree/main/frontend/interview-prep-ai/src/pages/Auth): `frontend/interview-prep-ai/src/pages/Auth`
- [User context](https://github.com/rajeev-gif/ai-interview-prep/blob/main/frontend/interview-prep-ai/src/context/userContext.jsx): `frontend/interview-prep-ai/src/context/userContext.jsx`
- [Landing page](https://github.com/rajeev-gif/ai-interview-prep/blob/main/frontend/interview-prep-ai/src/pages/LandingPage.jsx): `frontend/interview-prep-ai/src/pages/LandingPage.jsx`
- [Session dashboard](https://github.com/rajeev-gif/ai-interview-prep/blob/main/frontend/interview-prep-ai/src/pages/Home/Dashboard.jsx): `frontend/interview-prep-ai/src/pages/Home/Dashboard.jsx`
- [Session creation](https://github.com/rajeev-gif/ai-interview-prep/blob/main/frontend/interview-prep-ai/src/pages/Home/CreateSessionForm.jsx): `frontend/interview-prep-ai/src/pages/Home/CreateSessionForm.jsx`
- [Interview practice](https://github.com/rajeev-gif/ai-interview-prep/blob/main/frontend/interview-prep-ai/src/pages/InterviewPrep/InterviewPrep.jsx): `frontend/interview-prep-ai/src/pages/InterviewPrep/InterviewPrep.jsx`
- [Explanation display](https://github.com/rajeev-gif/ai-interview-prep/blob/main/frontend/interview-prep-ai/src/pages/InterviewPrep/components/AiResponsePreview.jsx): `frontend/interview-prep-ai/src/pages/InterviewPrep/components/AiResponsePreview.jsx`
- [API client paths](https://github.com/rajeev-gif/ai-interview-prep/blob/main/frontend/interview-prep-ai/src/utils/axiosInstance.js): `frontend/interview-prep-ai/src/utils/axiosInstance.js`

### Backend API

- [Express API](https://github.com/rajeev-gif/ai-interview-prep/blob/main/backend/server.js): `backend/server.js`
- [Auth routes](https://github.com/rajeev-gif/ai-interview-prep/blob/main/backend/routes/authRoutes.js): `backend/routes/authRoutes.js`
- [Session routes](https://github.com/rajeev-gif/ai-interview-prep/blob/main/backend/routes/sessionRoutes.js): `backend/routes/sessionRoutes.js`
- [Question routes](https://github.com/rajeev-gif/ai-interview-prep/blob/main/backend/routes/questionRoutes.js): `backend/routes/questionRoutes.js`
- [Account controller](https://github.com/rajeev-gif/ai-interview-prep/blob/main/backend/controllers/authController.js): `backend/controllers/authController.js`
- [Session controller](https://github.com/rajeev-gif/ai-interview-prep/blob/main/backend/controllers/sessionController.js): `backend/controllers/sessionController.js`
- [Question controller](https://github.com/rajeev-gif/ai-interview-prep/blob/main/backend/controllers/questionController.js): `backend/controllers/questionController.js`
- [AI controller](https://github.com/rajeev-gif/ai-interview-prep/blob/main/backend/controllers/aiController.js): `backend/controllers/aiController.js`
- [JWT protection](https://github.com/rajeev-gif/ai-interview-prep/blob/main/backend/middldewares/authMiddleware.js): `backend/middldewares/authMiddleware.js`
- [Image upload](https://github.com/rajeev-gif/ai-interview-prep/blob/main/backend/middldewares/uploadMiddleware.js): `backend/middldewares/uploadMiddleware.js`

### Application data

- [User records](https://github.com/rajeev-gif/ai-interview-prep/blob/main/backend/models/User.js): `backend/models/User.js`
- [Session records](https://github.com/rajeev-gif/ai-interview-prep/blob/main/backend/models/Session.js): `backend/models/Session.js`
- [Question records](https://github.com/rajeev-gif/ai-interview-prep/blob/main/backend/models/Question.js): `backend/models/Question.js`

### External services

- **MongoDB**
- **Google Generative AI**

### Other components

- **Interviewee**

## Connections

- Interviewee → App routing: uses (evidence: `frontend/interview-prep-ai/src/App.jsx`)
- App routing → Landing page: routes to (evidence: `frontend/interview-prep-ai/src/App.jsx`)
- App routing → Session dashboard: routes to (evidence: `frontend/interview-prep-ai/src/App.jsx`)
- App routing → Interview practice: routes to (evidence: `frontend/interview-prep-ai/src/App.jsx`)
- App routing → User context: provides (evidence: `frontend/interview-prep-ai/src/App.jsx`)
- Landing page → Account flows: opens (evidence: `frontend/interview-prep-ai/src/pages/LandingPage.jsx`)
- Account flows → User context: updates (evidence: `frontend/interview-prep-ai/src/pages/Auth/SignUp.jsx`)
- User context → API client paths: requests profile (evidence: `frontend/interview-prep-ai/src/context/userContext.jsx`)
- Session dashboard → Session creation: opens (evidence: `frontend/interview-prep-ai/src/pages/Home/Dashboard.jsx`)
- Session dashboard → API client paths: loads sessions (evidence: `frontend/interview-prep-ai/src/pages/Home/Dashboard.jsx`)
- Session creation → API client paths: creates session (evidence: `frontend/interview-prep-ai/src/pages/Home/CreateSessionForm.jsx`)
- Interview practice → API client paths: loads session (evidence: `frontend/interview-prep-ai/src/pages/InterviewPrep/InterviewPrep.jsx`)
- Interview practice → API client paths: requests explanation (evidence: `frontend/interview-prep-ai/src/pages/InterviewPrep/InterviewPrep.jsx`)
- Interview practice → Explanation display: renders explanation (evidence: `frontend/interview-prep-ai/src/pages/InterviewPrep/InterviewPrep.jsx`)
- API client paths → Express API: calls API
- Express API → Auth routes: mounts (evidence: `backend/server.js`)
- Express API → Session routes: mounts (evidence: `backend/server.js`)
- Express API → Question routes: mounts (evidence: `backend/server.js`)
- Express API → AI controller: routes AI requests (evidence: `backend/server.js`)
- Auth routes → Account controller: dispatches (evidence: `backend/routes/authRoutes.js`)
- Auth routes → JWT protection: protects profile (evidence: `backend/routes/authRoutes.js`)
- Auth routes → Image upload: handles uploads (evidence: `backend/routes/authRoutes.js`)
- Session routes → Session controller: dispatches (evidence: `backend/routes/sessionRoutes.js`)
- Session routes → JWT protection: protects routes (evidence: `backend/routes/sessionRoutes.js`)
- Question routes → Question controller: dispatches (evidence: `backend/routes/questionRoutes.js`)
- JWT protection → User records: loads user (evidence: `backend/middldewares/authMiddleware.js`)
- Account controller → User records: reads and writes (evidence: `backend/controllers/authController.js`)
- Session controller → Session records: reads and writes (evidence: `backend/controllers/sessionController.js`)
- Session controller → Question records: creates and deletes (evidence: `backend/controllers/sessionController.js`)
- Question controller → Question records: manages questions (evidence: `backend/controllers/questionController.js`)
- Question controller → Session records: updates session (evidence: `backend/controllers/questionController.js`)
- AI controller → Google Generative AI: generates content
- Express API → MongoDB: connects (evidence: `backend/server.js`)
- Image upload → Interviewee: receives image
