# vaishnavi15-cell/ai_interview_simulator architecture

> Architecture diagram of the GitHub repository vaishnavi15-cell/ai_interview_simulator, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/vaishnavi15-cell/ai_interview_simulator
- Repository: https://github.com/vaishnavi15-cell/ai_interview_simulator

## Overview

This is an AI interview simulator: users can authenticate, optionally provide a resume, generate tailored interview questions, answer by voice or text, and receive AI evaluation. The React app coordinates the experience and calls an Express backend; the backend handles authentication, resume analysis, question generation, answer evaluation, and video upload. Authentication records are stored in a JSON file. The excerpts establish several client-to-server calls and backend storage ownership; other backend integrations are shown only at a high level, so uncertain links are omitted or marked unverified.

Main entry points: [`frontend/src/App.jsx`](https://github.com/vaishnavi15-cell/ai_interview_simulator/blob/main/frontend/src/App.jsx) (Interview experience), [`backend/server.js`](https://github.com/vaishnavi15-cell/ai_interview_simulator/blob/main/backend/server.js) (Express routes and middleware), [`frontend/src/components/AuthModal.jsx`](https://github.com/vaishnavi15-cell/ai_interview_simulator/blob/main/frontend/src/components/AuthModal.jsx) (Sign-in and signup), [`backend/userStore.js`](https://github.com/vaishnavi15-cell/ai_interview_simulator/blob/main/backend/userStore.js) (User store)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Interview client"]
  node_app["Interview experience<br/>[App.jsx]"]
  node_navbar["Account navigation<br/>[Navbar.jsx]"]
  node_authmodal["Sign-in and signup<br/>[AuthModal.jsx]"]
end

subgraph group_api["Backend API"]
  node_server["Express routes and middleware<br/>[server.js]"]
  node_resume["Resume analysis<br/>[server.js]"]
  node_questions["Question generation<br/>[server.js]"]
  node_evaluation["Answer evaluation<br/>[server.js]"]
  node_video["Video upload<br/>[server.js]"]
end

subgraph group_identity["Identity and storage"]
  node_auth_routes["Authentication endpoints<br/>[server.js]"]
  node_user_store["User store<br/>[userStore.js]"]
  node_user_file[("Users JSON file<br/>[users.json]")]
end

subgraph group_integrations["External integrations"]
  node_ai["AI provider services"]
end

node_candidate(("Candidate"))
node_browser_speech["Browser speech APIs"]

node_candidate -->|"uses"| node_app
node_app -->|"renders"| node_navbar
node_app -->|"renders"| node_authmodal
node_candidate -->|"submits credentials"| node_authmodal
node_authmodal -->|"posts login or signup"| node_auth_routes
node_server -->|"registers"| node_auth_routes
node_auth_routes -->|"creates or verifies users"| node_user_store
node_user_store -->|"reads and writes"| node_user_file
node_app -->|"fetches current user"| node_server
node_app -->|"requests questions"| node_questions
node_app -->|"requests analysis"| node_resume
node_server -->|"registers endpoint"| node_resume
node_server -->|"registers endpoint"| node_questions
node_server -->|"registers endpoint"| node_evaluation
node_server -->|"registers endpoint"| node_video
node_app -->|"uses recognition and speech"| node_browser_speech
node_resume -.->|"generates analysis"| node_ai
node_questions -.->|"generates questions"| node_ai
node_evaluation -.->|"evaluates answers"| node_ai

click node_app "https://github.com/vaishnavi15-cell/ai_interview_simulator/blob/main/frontend/src/App.jsx"
click node_navbar "https://github.com/vaishnavi15-cell/ai_interview_simulator/blob/main/frontend/src/components/Navbar.jsx"
click node_authmodal "https://github.com/vaishnavi15-cell/ai_interview_simulator/blob/main/frontend/src/components/AuthModal.jsx"
click node_server "https://github.com/vaishnavi15-cell/ai_interview_simulator/blob/main/backend/server.js"
click node_resume "https://github.com/vaishnavi15-cell/ai_interview_simulator/blob/main/backend/server.js"
click node_questions "https://github.com/vaishnavi15-cell/ai_interview_simulator/blob/main/backend/server.js"
click node_evaluation "https://github.com/vaishnavi15-cell/ai_interview_simulator/blob/main/backend/server.js"
click node_video "https://github.com/vaishnavi15-cell/ai_interview_simulator/blob/main/backend/server.js"
click node_auth_routes "https://github.com/vaishnavi15-cell/ai_interview_simulator/blob/main/backend/server.js"
click node_user_store "https://github.com/vaishnavi15-cell/ai_interview_simulator/blob/main/backend/userStore.js"
click node_user_file "https://github.com/vaishnavi15-cell/ai_interview_simulator/blob/main/backend/data/users.json"

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_navbar,node_authmodal,node_browser_speech toneBlue
class node_server,node_resume,node_questions,node_evaluation,node_video toneAmber
class node_auth_routes,node_user_store,node_user_file toneMint
class node_ai toneRose
class node_candidate toneIndigo
```

## Components

### Interview client

- [Interview experience](https://github.com/vaishnavi15-cell/ai_interview_simulator/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Account navigation](https://github.com/vaishnavi15-cell/ai_interview_simulator/blob/main/frontend/src/components/Navbar.jsx): `frontend/src/components/Navbar.jsx`
- [Sign-in and signup](https://github.com/vaishnavi15-cell/ai_interview_simulator/blob/main/frontend/src/components/AuthModal.jsx): `frontend/src/components/AuthModal.jsx`

### Backend API

- [Express routes and middleware](https://github.com/vaishnavi15-cell/ai_interview_simulator/blob/main/backend/server.js): `backend/server.js`
- [Resume analysis](https://github.com/vaishnavi15-cell/ai_interview_simulator/blob/main/backend/server.js): `backend/server.js`
- [Question generation](https://github.com/vaishnavi15-cell/ai_interview_simulator/blob/main/backend/server.js): `backend/server.js`
- [Answer evaluation](https://github.com/vaishnavi15-cell/ai_interview_simulator/blob/main/backend/server.js): `backend/server.js`
- [Video upload](https://github.com/vaishnavi15-cell/ai_interview_simulator/blob/main/backend/server.js): `backend/server.js`

### Identity and storage

- [Authentication endpoints](https://github.com/vaishnavi15-cell/ai_interview_simulator/blob/main/backend/server.js): `backend/server.js`
- [User store](https://github.com/vaishnavi15-cell/ai_interview_simulator/blob/main/backend/userStore.js): `backend/userStore.js`
- [Users JSON file](https://github.com/vaishnavi15-cell/ai_interview_simulator/blob/main/backend/data/users.json): `backend/data/users.json`

### External integrations

- **AI provider services**

### Other components

- **Candidate**
- **Browser speech APIs**

## Connections

- Candidate → Interview experience: uses (evidence: `frontend/src/App.jsx`)
- Interview experience → Account navigation: renders (evidence: `frontend/src/App.jsx`)
- Interview experience → Sign-in and signup: renders (evidence: `frontend/src/App.jsx`)
- Candidate → Sign-in and signup: submits credentials (evidence: `frontend/src/components/AuthModal.jsx`)
- Sign-in and signup → Authentication endpoints: posts login or signup (evidence: `frontend/src/components/AuthModal.jsx`)
- Express routes and middleware → Authentication endpoints: registers (evidence: `backend/server.js`)
- Authentication endpoints → User store: creates or verifies users (evidence: `backend/server.js`)
- User store → Users JSON file: reads and writes (evidence: `backend/userStore.js`)
- Interview experience → Express routes and middleware: fetches current user (evidence: `frontend/src/App.jsx`)
- Interview experience → Question generation: requests questions (evidence: `frontend/src/App.jsx`)
- Interview experience → Resume analysis: requests analysis (evidence: `frontend/src/App.jsx`)
- Express routes and middleware → Resume analysis: registers endpoint (evidence: `backend/server.js`)
- Express routes and middleware → Question generation: registers endpoint (evidence: `backend/server.js`)
- Express routes and middleware → Answer evaluation: registers endpoint (evidence: `backend/server.js`)
- Express routes and middleware → Video upload: registers endpoint (evidence: `backend/server.js`)
- Interview experience → Browser speech APIs: uses recognition and speech (evidence: `frontend/src/App.jsx`)
- Resume analysis → AI provider services: generates analysis
- Question generation → AI provider services: generates questions
- Answer evaluation → AI provider services: evaluates answers
