🧪 Manual Testing Guide - InterviewMaster AI

📋 Pre-Testing Checklist

Before you start testing, ensure all services are running:

✅ Step 1: Check Prerequisites

# Check PostgreSQL is running
# Windows: Check Services (Win + R → services.msc)
# Look for: postgresql-x64-18

# Check Redis is running
# Windows: Check if Redis process is running in Task Manager

✅ Step 2: Verify Environment Configuration

Backend (.env file is already configured):

✅ Database URL configured
✅ Redis configured
✅ HuggingFace API keys (3 keys)
✅ Email service (Gmail SMTP)
✅ CORS origins set

Frontend (.env file):

cd Ai_powered_interview_coach/frontend
# Check if .env exists, if not create it:
echo VITE_API_URL=http://localhost:8000/api/v1 > .env

🚀 Step-by-Step Testing Process

Phase 1: Start All Services (5 minutes)

1.1 Start PostgreSQL

# Windows: Should already be running as a service
# Verify: Open pgAdmin or check services

1.2 Start Redis

# Open PowerShell Terminal 1
cd Ai_powered_interview_coach
# If you have Redis installed, start it
redis-server
# Or use the Windows Redis version if available

1.3 Start Backend

# Open PowerShell Terminal 2
cd Ai_powered_interview_coach/backend
.\venv\Scripts\Activate.ps1
uvicorn app.main:app --reload --host 0.0.0.0 --port 8000

Expected Output:

INFO:     Uvicorn running on http://0.0.0.0:8000
INFO:     Application startup complete.

1.4 Start Frontend

# Open PowerShell Terminal 3
cd Ai_powered_interview_coach/frontend
npm run dev

Expected Output:

VITE v5.x.x  ready in xxx ms
➜  Local:   http://localhost:5173/

🧪 Phase 2: Test Core Features (30 minutes)

Test 1: Health Check (1 minute)

Backend Health:

Open browser: http://localhost:8000/health
✅ Should see: {"status": "healthy", "database": "connected", "cache": "connected"}

API Documentation:

Open browser: http://localhost:8000/docs
✅ Should see: Swagger UI with all endpoints

Frontend:

Open browser: http://localhost:5173
✅ Should see: Landing page with hero section

Test 2: User Registration & Authentication (5 minutes)

2.1 Register New User

Go to: http://localhost:5173
Click "Get Started" or "Sign Up"
Fill in registration form:
- Email: test@example.com
- Password: Test123!@#
- Full Name: Test User
Click "Register"
✅ Should redirect to dashboard
✅ Should see welcome message

2.2 Logout

Click user menu (top right)
Click "Logout"
✅ Should redirect to login page

2.3 Login

Enter credentials:
- Email: test@example.com
- Password: Test123!@#
Click "Login"
✅ Should redirect to dashboard
✅ Should see user name in header

2.4 Password Reset (Optional)

Logout
Click "Forgot Password?"
Enter email: test@example.com
Click "Send Reset Link"
✅ Check terminal for email log (if EMAIL_ENABLED=False)
✅ Or check email inbox (if EMAIL_ENABLED=True)

Test Result: ✅ PASS / ❌ FAIL Notes: _______________________

Test 3: Dashboard & Navigation (3 minutes)

3.1 Dashboard Quick Actions

Go to: http://localhost:5173/dashboard
✅ Should see 7 quick action buttons:
- Start Interview (primary, filled)
- Upload Resume (secondary, outlined)
- View History (primary, outlined)
- View Resumes (info, outlined)
- Analytics (success, outlined)
- Leaderboard (warning, outlined)
- Achievements (secondary, outlined)

3.2 Navigation Menu

Check sidebar/navigation menu
✅ Should see links to:
- Dashboard
- Interview
- Analytics
- Achievements
- Leaderboard
- Profile
- Settings

Test Result: ✅ PASS / ❌ FAIL Notes: _______________________

Test 4: Interview Session Flow (10 minutes)

4.1 Create Interview Session

Click "Start Interview" button
Fill in interview details:
- Role: Software Engineer
- Difficulty: Medium
- Experience Level: Mid-Level
- Number of Questions: 3
Click "Start Interview"
✅ Should redirect to interview page
✅ Should see first question

4.2 Answer Questions

Read the question
Type answer in text area (at least 50 words)
✅ Should see character count
✅ Should see timer running
Click "Submit Answer"
✅ Should see "Answer submitted successfully"
✅ Should load next question

4.3 Draft Auto-Save (Optional)

Start typing an answer
Wait 3 seconds
✅ Should see "Draft saved" indicator
Refresh page
✅ Draft should be restored

4.4 Complete Interview

Answer all 3 questions
After last question, click "Complete Interview"
✅ Should redirect to session summary page
✅ Should see:
- Overall score
- Performance breakdown
- Strengths and weaknesses
- Recommendations

Test Result: ✅ PASS / ❌ FAIL Notes: _______________________

Test 5: Resume Upload & Analysis (5 minutes)

5.1 Upload Resume

Go to dashboard
Click "Upload Resume" button
Select a resume file (PDF, DOCX, or TXT)
Click "Upload"
✅ Should see upload progress
✅ Should see success message
✅ Should see resume in list

5.2 View Resume Analysis

Click "Analyze" button on uploaded resume
Wait for AI analysis (10-30 seconds)
✅ Should see analysis results:
- Extracted skills
- Experience level
- Strengths
- Improvement suggestions
- ATS compatibility score

5.3 Delete Resume (Optional)

Click "Delete" button on resume
Confirm deletion
✅ Resume should be removed from list

Test Result: ✅ PASS / ❌ FAIL Notes: _______________________

Test 6: Analytics Dashboard (5 minutes)

6.1 View Analytics

Go to: http://localhost:5173/analytics
✅ Should see:
- Performance overview cards (total sessions, avg score, etc.)
- Score trend chart (line chart)
- Category performance chart (bar chart)
- Strengths and weaknesses cards
- Practice recommendations

6.2 Check Charts

✅ Line chart should show score trends over time
✅ Bar chart should show category performance
✅ Hover over charts to see tooltips
✅ No white page or errors

6.3 Performance Comparison

Scroll to "Performance Comparison" section
✅ Should see comparison with cohort average
✅ Should see percentile ranking

Test Result: ✅ PASS / ❌ FAIL Notes: _______________________

Test 7: Achievements System (3 minutes)

7.1 View Achievements

Go to: http://localhost:5173/achievements
✅ Should see:
- Achievement statistics (unlocked count, points, completion %)
- Progress bar
- Achievement cards grid

7.2 Check Achievement Cards

✅ Locked achievements should be grayed out
✅ Unlocked achievements should be colored
✅ Each card should show:
- Achievement name
- Description
- Points
- Category chip
- Lock/unlock icon

7.3 Unlock Achievement

Complete actions to unlock achievements:
- Complete 1 interview → "First Steps" achievement
- Complete 3 interviews → "Getting Started" achievement
✅ Achievement should unlock automatically
✅ Should see confetti animation (optional)

Test Result: ✅ PASS / ❌ FAIL Notes: _______________________

Test 8: Streak Tracking (2 minutes)

8.1 View Current Streak

Go to dashboard or streaks page
✅ Should see current streak counter
✅ Should see longest streak
✅ Should see streak calendar/history

8.2 Maintain Streak

Complete an interview today
✅ Streak should increment by 1
Come back tomorrow and complete another
✅ Streak should continue

Test Result: ✅ PASS / ❌ FAIL Notes: _______________________

Test 9: Leaderboard (3 minutes)

9.1 View Leaderboard

Go to: http://localhost:5173/leaderboard
✅ Should see:
- Weekly/All-time tabs
- Opt-in/opt-out toggle
- Leaderboard table

9.2 Opt-In to Leaderboard

Toggle "Participate in Leaderboard" to ON
✅ Should see your rank in the table
✅ Should see trophy icons for top 3

9.3 Switch Tabs

Click "Weekly" tab
✅ Should show weekly rankings
Click "All-time" tab
✅ Should show all-time rankings

Test Result: ✅ PASS / ❌ FAIL Notes: _______________________

🎓 Phase 3: Test Advanced Features (20 minutes)

Test 10: Study Plan Generator (5 minutes)

10.1 Generate Study Plan

Go to dashboard or AI features section
Click "Generate Study Plan"
Wait for AI generation (10-30 seconds)
✅ Should see personalized study plan:
- Weekly structure
- Topic recommendations
- Resource suggestions
- Based on your performance

10.2 View Study Plan Details

✅ Should see breakdown by week
✅ Should see specific topics to study
✅ Should see time estimates
✅ Should see progress tracking

Test Result: ✅ PASS / ❌ FAIL Notes: _______________________

Test 11: Company Coaching (5 minutes)

11.1 Start Coaching Session

Go to AI features or company coaching page
Enter company name: Google or Microsoft
Enter role: Software Engineer
Click "Get Coaching"
Wait for AI response (10-30 seconds)

11.2 View Coaching Results

✅ Should see:
- Company culture insights
- Interview process overview
- Common interview questions
- Role-specific guidance
- Preparation tips

Test Result: ✅ PASS / ❌ FAIL Notes: _______________________

Test 12: Session History (3 minutes)

12.1 View History

Go to dashboard
Click "View History" button
✅ Should see list of all completed interviews
✅ Each entry should show:
- Date and time
- Role
- Score
- Number of questions

12.2 View Session Details

Click on a session from history
✅ Should see full session details:
- All questions asked
- Your answers
- Evaluations
- Scores
- Feedback

Test Result: ✅ PASS / ❌ FAIL Notes: _______________________

Test 13: Profile Management (3 minutes)

13.1 View Profile

Go to: http://localhost:5173/profile
✅ Should see current profile information:
- Full name
- Email
- Join date
- Statistics

13.2 Update Profile

Click "Edit Profile"
Change full name to: Test User Updated
Click "Save"
✅ Should see success message
✅ Name should update in header

Test Result: ✅ PASS / ❌ FAIL Notes: _______________________

Test 14: Data Export (2 minutes)

14.1 Export Session Data

Go to analytics or settings page
Click "Export Data" or "Download CSV"
✅ Should download CSV file
Open CSV file
✅ Should contain session data with columns:
- Session ID
- Date
- Role
- Score
- Questions
- Answers

Test Result: ✅ PASS / ❌ FAIL Notes: _______________________

Test 15: Cache Performance (2 minutes)

15.1 Check Cache Metrics

Go to: http://localhost:8000/cache/metrics
✅ Should see JSON response with:
- Total requests
- Cache hits
- Cache misses
- Hit rate percentage

15.2 Test Caching

Create an interview session
Get first question (should cache)
Refresh page
Get same question again (should hit cache)
✅ Response should be faster second time

Test Result: ✅ PASS / ❌ FAIL Notes: _______________________

🔍 Phase 4: Error Handling & Edge Cases (10 minutes)

Test 16: Form Validation

16.1 Registration Validation

Try to register with:
- Invalid email: notanemail
- ✅ Should show error: "Invalid email format"
- Short password: 123
- ✅ Should show error: "Password too short"
- Empty fields
- ✅ Should show error: "Required field"

16.2 Interview Form Validation

Try to create interview with:
- Empty role field
- ✅ Should show error
- Invalid number of questions (0 or 100)
- ✅ Should show error or limit

Test Result: ✅ PASS / ❌ FAIL Notes: _______________________

Test 17: Network Error Handling

17.1 Backend Down

Stop backend server (Ctrl+C in backend terminal)
Try to login or create interview
✅ Should show error message: "Unable to connect to server"
✅ Should not crash the app
Restart backend
✅ App should recover automatically

Test Result: ✅ PASS / ❌ FAIL Notes: _______________________

Test 18: Authentication Errors

18.1 Invalid Login

Try to login with wrong password
✅ Should show error: "Invalid credentials"

18.2 Duplicate Registration

Try to register with existing email
✅ Should show error: "Email already registered"

18.3 Token Expiration

Login and wait 15+ minutes (or modify token expiry)
Try to make an API call
✅ Should auto-refresh token or redirect to login

Test Result: ✅ PASS / ❌ FAIL Notes: _______________________

📱 Phase 5: Responsive Design (5 minutes)

Test 19: Mobile View

19.1 Resize Browser

Open browser DevTools (F12)
Toggle device toolbar (Ctrl+Shift+M)
Select mobile device (iPhone, Android)
✅ Navigation should collapse to hamburger menu
✅ Cards should stack vertically
✅ Charts should be responsive
✅ Forms should be usable

19.2 Test Key Pages on Mobile

Dashboard: ✅ PASS / ❌ FAIL
Interview: ✅ PASS / ❌ FAIL
Analytics: ✅ PASS / ❌ FAIL
Achievements: ✅ PASS / ❌ FAIL

Test Result: ✅ PASS / ❌ FAIL Notes: _______________________

🎯 Phase 6: Performance Testing (5 minutes)

Test 20: Load Time

20.1 Page Load Times

Open browser DevTools → Network tab
Hard refresh (Ctrl+Shift+R)
Check load times:
- Landing page: ✅ < 2 seconds
- Dashboard: ✅ < 3 seconds
- Analytics: ✅ < 3 seconds

20.2 API Response Times

Check Network tab for API calls
✅ Most endpoints should respond < 500ms
✅ AI endpoints (evaluation, analysis) may take 5-30 seconds

Test Result: ✅ PASS / ❌ FAIL Notes: _______________________

📊 Testing Summary Checklist

Core Features (Must Pass)

Analytics & Gamification (Must Pass)

Advanced Features (Should Pass)

Technical (Should Pass)

🐛 Bug Reporting Template

If you find any issues, document them using this template:

**Bug Title**: [Short description]

**Severity**: Critical / High / Medium / Low

**Steps to Reproduce**:
1. Go to...
2. Click on...
3. Enter...
4. See error

**Expected Behavior**:
[What should happen]

**Actual Behavior**:
[What actually happens]

**Screenshots**:
[Attach if applicable]

**Browser Console Errors**:
[Copy any errors from F12 console]

**Environment**:
- Browser: Chrome/Firefox/Edge
- OS: Windows 11
- Backend: Running/Not Running
- Frontend: Running/Not Running

🔧 Troubleshooting Common Issues

Issue 1: Backend Won't Start

Symptoms: Error when running uvicorn app.main:app --reload

Solutions:

# Check if virtual environment is activated
.\venv\Scripts\Activate.ps1

# Reinstall dependencies
pip install -r requirements.txt

# Check database connection
# Verify PostgreSQL is running
# Check DATABASE_URL in .env

# Check Redis connection
# Verify Redis is running

Issue 2: Frontend Won't Start

Symptoms: Error when running npm run dev

Solutions:

# Reinstall dependencies
rm -rf node_modules
npm install

# Clear cache
npm cache clean --force

# Check Node version
node --version  # Should be 18+

Issue 3: Database Connection Error

Symptoms: "Database health check failed"

Solutions:

Check PostgreSQL service is running
Verify DATABASE_URL in .env
Check password encoding (@ symbol should be %40)
Run: python create_database.py
Run: alembic upgrade head

Issue 4: Redis Connection Error

Symptoms: "Cache unavailable"

Solutions:

Start Redis server: redis-server
Check REDIS_HOST and REDIS_PORT in .env
Test connection: redis-cli ping (should return PONG)

Issue 5: AI API Errors

Symptoms: "AI provider error" or evaluation fails

Solutions:

Check HuggingFace API keys in .env
Verify keys are valid (not expired)
Check API quota/rate limits
Circuit breaker will auto-retry with backup keys

Issue 6: White Page / Blank Screen

Symptoms: Page loads but shows nothing

Solutions:

Hard refresh: Ctrl + Shift + R
Clear browser cache
Check browser console (F12) for errors
Check if backend is running
Verify VITE_API_URL in frontend/.env

Issue 7: Charts Not Rendering

Symptoms: Analytics page shows no charts

Solutions:

Complete at least 1 interview session (need data)
Hard refresh page
Check browser console for errors
Verify Recharts is installed: npm list recharts

📝 Quick Start Commands Reference

Start Everything (3 Terminals)

Terminal 1 - Redis:

redis-server

Terminal 2 - Backend:

cd Ai_powered_interview_coach/backend
.\venv\Scripts\Activate.ps1
uvicorn app.main:app --reload --host 0.0.0.0 --port 8000

Terminal 3 - Frontend:

cd Ai_powered_interview_coach/frontend
npm run dev

Access URLs

Frontend: http://localhost:5173
Backend API: http://localhost:8000
API Docs: http://localhost:8000/docs
Health Check: http://localhost:8000/health
Cache Metrics: http://localhost:8000/cache/metrics

Stop Everything

Press Ctrl + C in each terminal
Or close terminal windows

✅ Final Testing Checklist

Before marking testing complete, ensure:

Functionality

Performance

Pages load quickly (< 3 seconds)
No memory leaks
Smooth animations
Charts render properly

User Experience

Technical

🎉 Testing Complete!

Once all tests pass, you have verified:

✅ 18 major features are working correctly ✅ 50+ API endpoints are functional ✅ 20 database models are properly configured ✅ Frontend and backend are communicating ✅ AI integration is working with failover ✅ Caching system is operational ✅ Authentication is secure ✅ Analytics are calculating correctly ✅ Gamification features are engaging

Your InterviewMaster AI platform is production-ready! 🚀

Testing Duration: ~1-2 hours for complete manual testing Last Updated: March 12, 2026 Version: 1.0

FilesExpand file tree

MANUAL_TESTING_GUIDE.md

Latest commit

History

MANUAL_TESTING_GUIDE.md

File metadata and controls

🧪 Manual Testing Guide - InterviewMaster AI

📋 Pre-Testing Checklist

✅ Step 1: Check Prerequisites

✅ Step 2: Verify Environment Configuration

🚀 Step-by-Step Testing Process

Phase 1: Start All Services (5 minutes)

1.1 Start PostgreSQL

1.2 Start Redis

1.3 Start Backend

1.4 Start Frontend

🧪 Phase 2: Test Core Features (30 minutes)

Test 1: Health Check (1 minute)

Test 2: User Registration & Authentication (5 minutes)

2.1 Register New User

2.2 Logout

2.3 Login

2.4 Password Reset (Optional)

Test 3: Dashboard & Navigation (3 minutes)

3.1 Dashboard Quick Actions

3.2 Navigation Menu

Test 4: Interview Session Flow (10 minutes)

4.1 Create Interview Session

4.2 Answer Questions

4.3 Draft Auto-Save (Optional)

4.4 Complete Interview

Test 5: Resume Upload & Analysis (5 minutes)

5.1 Upload Resume

5.2 View Resume Analysis

5.3 Delete Resume (Optional)

Test 6: Analytics Dashboard (5 minutes)

6.1 View Analytics

6.2 Check Charts

6.3 Performance Comparison

Test 7: Achievements System (3 minutes)

7.1 View Achievements

7.2 Check Achievement Cards

7.3 Unlock Achievement

Test 8: Streak Tracking (2 minutes)

8.1 View Current Streak

8.2 Maintain Streak

Test 9: Leaderboard (3 minutes)

9.1 View Leaderboard

9.2 Opt-In to Leaderboard

9.3 Switch Tabs

🎓 Phase 3: Test Advanced Features (20 minutes)

Test 10: Study Plan Generator (5 minutes)

10.1 Generate Study Plan

10.2 View Study Plan Details

Test 11: Company Coaching (5 minutes)

11.1 Start Coaching Session

11.2 View Coaching Results

Test 12: Session History (3 minutes)

12.1 View History

12.2 View Session Details

Test 13: Profile Management (3 minutes)

13.1 View Profile

13.2 Update Profile

Test 14: Data Export (2 minutes)

14.1 Export Session Data

Test 15: Cache Performance (2 minutes)

15.1 Check Cache Metrics

15.2 Test Caching

🔍 Phase 4: Error Handling & Edge Cases (10 minutes)

Test 16: Form Validation

16.1 Registration Validation

16.2 Interview Form Validation

Test 17: Network Error Handling

17.1 Backend Down

Test 18: Authentication Errors

18.1 Invalid Login

18.2 Duplicate Registration

18.3 Token Expiration

📱 Phase 5: Responsive Design (5 minutes)

Test 19: Mobile View