Skip to content

README.md

Latest commit

 

History

History
200 lines (155 loc) · 7.68 KB

README.md

File metadata and controls

200 lines (155 loc) · 7.68 KB
Raw

🎙️ Interview Lab

Amazon VA Interview Preparation Platform

AI-powered mock interviews, resume coaching, cover letter generation, and practice tests for aspiring Amazon Virtual Assistants.

Deploy with Vercel

Live Demo · Report Bug · Request Feature

✨ Features

Feature Description
AI Mock Interviews Role-specific interview sessions with real-time AI feedback and scoring
Question Bank 264+ questions across 6 VA roles and 3 difficulty levels
Resume Lab Upload resume, get AI review with truth flags and improvement suggestions
Cover Letter Studio Generate role-targeted cover letters with multiple tones
Practice Tests Timed assessments with AI-scored results
Learning Paths Beginner → Intermediate → Advanced guides per role
Download Center Templates, checklists, worksheets
Admin Panel Analytics dashboard and question management

💰 Pricing

Free, always. Interview Lab is a free companion to Project Amazon PH Academy. All features are available to all users — no paid tiers.

🛠 Tech Stack

Layer Technology
Framework Next.js 16.1.1 (App Router, standalone)
Runtime Bun (CI uses npm)
Database Prisma v6 + PostgreSQL (PostgreSQL only)
Auth Custom JWT sessions (jose) + HttpOnly cookies
UI Tailwind CSS v4 + "Field Manual" light design system
Icons Phosphor Icons (light weight)
Fonts Space Grotesk (headings) + Plus Jakarta Sans (body)
AI Z AI Web Dev SDK for coaching, scoring, content generation
Export docx, PDF (manual builder / pdfkit), Excel (exceljs)

🚀 Getting Started

Prerequisites

  • Bun installed
  • Git

Setup

# Clone the repo
git clone https://github.com/projectamazonph/Interview-lab.git
cd Interview-lab

# Install dependencies
bun install

# Set up the database
bun run db:push

# Start the dev server
bun run dev

The app will be available at http://localhost:3000.

Quick Start (alternative)

bash .zscripts/dev.sh

📁 Project Structure

src/
├── app/                        # Next.js App Router
│   ├── api/                    # API routes
│   │   ├── auth/               # Register, login, logout, email verify
│   │   ├── interview/          # Mock interview sessions
│   │   ├── questions/          # Question bank + count
│   │   ├── assessments/        # Practice test assessments
│   │   ├── profile/            # User profile (GET/PUT)
│   │   ├── dashboard/          # Dashboard aggregation
│   │   ├── subscription/       # Removed (product is free)
│   │   ├── resume/             # Resume upload + AI review
│   │   ├── cover-letter/       # Cover letter generation
│   │   ├── ai/                 # AI endpoints (coach, scoring, resume, cover)
│   │   ├── admin/              # Admin analytics + question management
│   │   ├── guides/             # Learning path guides
│   │   ├── downloads/          # Download center
│   │   └── export/             # DOCX/PDF/Excel export
│   └── [pages]/                # Page routes
├── components/
│   ├── interview-lab/          # Page components (Field Manual design system)
│   └── ui/                     # Shared primitives (field-card, field-button, etc.)
├── lib/
│   ├── auth-helpers.ts         # Server-side JWT + header auth
│   ├── pricing.ts              # Tier configs (currently unused — product is free)
│   ├── subscription-guard.ts   # Feature access checks (returns allowed: true)
│   ├── types.ts                # TypeScript interfaces
│   └── utils.ts                # cn() utility
└── hooks/                      # Custom React hooks

prisma/                         # Prisma schema (PostgreSQL)
__tests__/                      # Test suites
├── api/                        # API route unit tests (218 tests)
│   ├── interview-session.test.ts
│   ├── questions.test.ts
│   ├── auth-register.test.ts
│   ├── auth-login.test.ts
│   ├── assessments.test.ts
│   ├── profile-dashboard.test.ts
│   ├── subscription.test.ts
│   └── resume-coverletter.test.ts
└── components/                 # Component tests
docs/                           # PRD, architecture, feature specs
.zscripts/                      # Dev/build/startup scripts

🧪 Testing

# Run all tests
bun test

# Run specific test file
bun test __tests__/api/resume-coverletter.test.ts

# Run API tests only
bun test __tests__/api/

Test Coverage

Test File Tests What It Covers
interview-session.test.ts 21 Session creation, answer submission, auth/authz
questions.test.ts 38 Question bank filtering, role/difficulty, structure
auth-register.test.ts 34 Registration validation, email/password, bot protection
auth-login.test.ts 26 Login flow, rate limiting, session, email sanitization
assessments.test.ts 20 Assessment list/get/submit, answer key stripping
profile-dashboard.test.ts 23 Profile whitelisting, sanitization, dashboard stats
resume-coverletter.test.ts 25 Resume CRUD, cover-letter tones, truth flags
Total 187 All API routes, all green

Tests use in-memory stubs — no database or server required.

📋 Available Scripts

Command Description
bun run dev Dev server with logging
bun run build Production build (standalone)
bun run db:push Push Prisma schema to PostgreSQL
bun run db:generate Generate Prisma client
bun run test Run test suite
bun run lint ESLint check

🎨 Design System — "Field Manual" (light theme)

The earlier "Ethereal Glass" dark design was reverted. The live app uses a clean light "Field Manual" system.

  • Palette: Warm off-white (#FAFAF7) with subtle grain/border texture, primary orange (#FF6B35) accents
  • Colors: Ink scale for text, emerald success, amber warnings, rose danger
  • Motion: Framer Motion scroll reveals, stagger, hover physics (no custom cubic-beziers)
  • Components: FieldCard (solid surface, thin border, soft shadow), FieldButton (default/outline/ghost), FieldBadge, Alert
  • Icons: Phosphor Icons in weight="light" — no thick-stroked icons
  • Typography: Space Grotesk for headings, Plus Jakarta Sans for body

🔐 Environment Variables

Variable Description
DATABASE_URL PostgreSQL connection URL
JWT_SECRET Secret for signing JWT session tokens
NEXT_PUBLIC_APP_URL App base URL

📚 Documentation

  • docs/PRD.md — Product requirements
  • docs/BUILD_SPEC.md — Technical build specification
  • docs/TESTING.md — Testing strategy
  • docs/SECURITY.md — Security considerations
  • docs/DEPLOYMENT.md — Deployment guide
  • docs/ENGINEERING_DIARY.md — Development journal
  • AGENTS.md — AI agent context and coding standards
  • REDESIGN-PLAN.md — Full UI/UX redesign plan

📄 License

Private — © 2026 Ryan Roland Dabao. All rights reserved.