Interview-AI

An AI-powered fullstack web application that analyzes your resume, generates personalized interview reports, and creates a professional PDF resume — all in one place.

✨ Features

• 🔐 JWT Authentication — Secure register, login & logout with cookie-based tokens
• 🚫 Token Blacklisting — Invalidate tokens on logout for enhanced security
• 📄 Resume Upload — Upload your resume via Multer file handling
• 🤖 AI Interview Report — AI analyzes your resume and generates a structured interview report
• 📊 Report Management — View, store, and revisit all your past interview reports
• 📑 PDF Resume Generation — Converts AI-generated content into a downloadable PDF using Puppeteer
• 🛡️ Protected Routes — Auth-guarded pages on both frontend and backend
• ✅ Zod Validation — Strict schema validation for all AI responses

---

🏗️ Tech Stack

Backend

Technology	Purpose
Node.js + Express	REST API server
MongoDB Atlas + Mongoose	Database & ODM
JWT + Cookies	Authentication
Multer	Resume file uploads
Zod	AI response schema validation
Puppeteer	PDF generation
AI Service (Gemini/OpenAI)	Interview report generation

Frontend

Technology	Purpose
React + Vite	UI framework & build tool
React Router	Client-side routing & protected routes
SCSS	Styling
Axios	HTTP requests (service layer)
Context API	Global state management
Custom Hooks	Reusable logic (useAuth, useInterview)

---

📁 Project Structure

Interview-AI/
├── Backend/
│   ├── controllers/
│   │   ├── authController.js       # Register, Login, Logout, GetMe
│   │   └── interviewController.js  # Generate report, Get reports
│   ├── models/
│   │   ├── userModel.js            # User schema
│   │   ├── blacklistModel.js       # Token blacklist schema
│   │   └── interviewReportModel.js # AI report schema
│   ├── routes/
│   │   ├── authRoutes.js
│   │   └── interviewRoutes.js
│   ├── middleware/
│   │   └── authMiddleware.js       # JWT verification
│   ├── services/
│   │   └── aiService.js            # AI integration logic
│   └── server.js
│
└── Frontend/
    ├── src/
    │   ├── pages/
    │   │   ├── Login.jsx
    │   │   ├── Register.jsx
    │   │   └── Home.jsx
    │   ├── context/
    │   │   ├── AuthContext.jsx
    │   │   └── InterviewContext.jsx
    │   ├── hooks/
    │   │   ├── useAuth.js
    │   │   └── useInterview.js
    │   ├── services/
    │   │   └── api.js              # Axios instance + API calls
    │   └── App.jsx
    └── vite.config.js

---

🧠 Frontend Architecture (4 Layers)

┌─────────────────────────────────┐
│        UI Components            │  ← React Pages & Components
├─────────────────────────────────┤
│      Custom Hooks               │  ← useAuth, useInterview
├─────────────────────────────────┤
│   Context / State Management    │  ← AuthContext, InterviewContext
├─────────────────────────────────┤
│      Service Layer              │  ← Axios API calls
└─────────────────────────────────┘

---

🤖 AI Feature Flow

User uploads resume
        ↓
Multer saves file → Backend receives it
        ↓
AI Service processes resume
        ↓
Zod validates AI response schema
        ↓
Report saved to MongoDB
        ↓
Frontend fetches & displays report
        ↓
User downloads PDF (via Puppeteer)

---

🚀 Getting Started

Prerequisites

• Node.js v18+
• MongoDB Atlas account
• AI API key (Google Gemini or OpenAI)

---

1. Clone the Repository

git clone https://github.com/raimaAsghar/Interview-AI.git
cd Interview-AI

---

2. Backend Setup

cd Backend
npm install

Create a .env file in the Backend/ directory:

PORT=3000
MONGO_URI=your_mongodb_atlas_connection_string
JWT_SECRET=your_jwt_secret_key
AI_API_KEY=your_ai_api_key
CLIENT_URL=http://localhost:5173

Start the backend server:

npm run dev

---

3. Frontend Setup

cd Frontend
npm install
npm run dev

The app will be running at http://localhost:5173

---

📡 API Endpoints

Auth Routes — /api/auth

Method	Endpoint	Description	Auth Required
POST	/register	Register a new user	❌
POST	/login	Login & get token	❌
POST	/logout	Logout & blacklist token	✅
GET	/me	Get current user info	✅

Interview Routes — /api/interview

Method	Endpoint	Description	Auth Required
POST	/generate	Upload resume & generate AI report	✅
GET	/reports	Get all reports for current user	✅
GET	/reports/:id	Get a single report by ID	✅
POST	/resume-pdf	Generate resume PDF via Puppeteer	✅

---

🔐 Authentication Flow

Register/Login
     ↓
JWT Token → Stored in HttpOnly Cookie
     ↓
Every request → authMiddleware verifies token
     ↓
Logout → Token added to Blacklist collection
     ↓
Blacklisted tokens are rejected on all future requests

---

🛠️ Future Improvements

• Voice-based mock interview mode
• Interview question practice with AI feedback
• Dashboard with analytics across reports
• Email notifications for report completion
• Support for multiple resume formats (DOCX, LinkedIn import)

---

👩‍💻 Author

Raima Asghar

• GitHub: @raimaAsghar

---

If you found this project helpful, please ⭐ star the repo!