powershell-windows

Core Functionality

• 📋 Position Management - Create and manage job positions with detailed skill requirements and AI-generated descriptions
• 👥 Candidate Tracking - Track candidates through the recruitment pipeline with status management, resume storage, and multi-position assignment (candidates can be associated with multiple positions with primary designation)
• 📝 AI-Powered Quiz Generation - Generate technical assessments tailored to specific positions using advanced LLMs
• 🎯 Interview System - Send quiz invitations to candidates via unique tokens for remote technical assessments. Features time-limited quizzes with user confirmation dialogs for completion when time expires.
• 📊 AI Evaluation - Dual evaluation system:

- Interview Evaluations - Automated quiz answer evaluation with detailed feedback and scoring

- Candidate Evaluations - Resume-based assessment against position requirements with fit scoring

• 🔄 Reusable Question Library - Create, manage, and favorite questions for reuse across multiple quizzes
• ⚙️ Generation Presets - Configurable templates for question generation with type-specific parameters

AI Capabilities

• Multi-Model Support - Flexible LLM selection (Groq-powered models including LLaMA, Gemma, DeepSeek, Kimi)
• Three Question Types:

- Multiple Choice - Auto-validated with intelligent distractors

- Open Questions - Free-form responses with sample answers

- Code Snippets - Code analysis, bug fixing, and improvement tasks

• Smart Prompting - Type-specific prompt engineering for optimal question quality
• Retry & Fallback - Robust error handling with automatic model fallbacks
• Streaming Responses - Real-time position description generation with streaming AI responses
• Voice Transcription - Audio-to-text transcription for candidate answers using Whisper models
• Consistent Evaluations - Temperature-controlled AI responses for reproducible assessment scores

Technical Features

• Server Components - Next.js 16 App Router with Cache Components ("use cache")
• Real-time Streaming - Position description generation with streaming responses
• Zod Validation - End-to-end type safety with comprehensive schemas (Zod v4)
• Better Auth - Modern authentication with session management
• Neon PostgreSQL - Serverless database with Prisma ORM
• Cloudflare R2 Storage - S3-compatible object storage for resume/file uploads
• PDF Parsing - Serverless PDF text extraction using unpdf for resume analysis
• Polymorphic Evaluations - Unified evaluation entity supporting both interview and candidate assessments

```text

dev-recruit/

├── app/ # Next.js App Router

│ ├── dashboard/ # Protected dashboard routes

│ │ ├── candidates/ # Candidate management & evaluations

│ │ ├── interviews/ # Interview tracking & evaluations

│ │ ├── positions/ # Job position management

│ │ ├── quizzes/ # Quiz creation & editing with reusable questions

│ │ ├── presets/ # Question generation presets management

│ │ └── profile/ # User profile & settings

│ ├── recruting/ # Public interview pages (candidate-facing)

│ ├── auth/ # Authentication pages (login, signup, etc.)

│ └── api/ # API routes (streaming, uploads)

├── components/ # React components

│ ├── ui/ # Base UI primitives (shadcn/ui)

│ │ ├── rhf-inputs/ # React Hook Form input components

│ ├── dashboard/ # Dashboard-specific components

│ ├── quiz/ # Quiz editing components (AI dialogs, question management)

│ ├── candidates/ # Candidate management components

│ ├── interviews/ # Interview tracking components

│ ├── presets/ # Preset management components

│ └── recruting/ # Interview taking components

├── lib/ # Core business logic

│ ├── actions/ # Server actions (quizzes, candidates, evaluations, etc.)

│ ├── data/ # Data fetching layer (cached queries)

│ ├── schemas/ # Zod validation schemas

│ ├── services/ # AI services (quiz generation, evaluation, transcription)

│ ├── utils/ # Utility functions

│ └── prisma/ # Generated Prisma client

├── hooks/ # React hooks (AI generation, forms, etc.)

├── prisma/ # Database schema & migrations

└── docs/ # Documentation

```

| Category | Technology |

| ------------------ | ----------------------------- |

| Framework | Next.js 16 (App Router) |

| Language | TypeScript 5.9 |

| Database | PostgreSQL (Neon) + Prisma 7 |

| AI/LLM | Groq API (Vercel AI SDK) |

| Styling | Tailwind CSS 4 + OKLCH colors |

| UI Components | Radix UI + shadcn/ui |

| Forms | React Hook Form + Zod v4 |

| Authentication | Better Auth |

Before you begin, ensure you have:

• Node.js 20.x or later
• pnpm 8.x or later (recommended)
• PostgreSQL database (Neon recommended)
• Groq API Key for AI features

1. Clone the repository

```bash

git clone https://github.com/your-org/dev-recruit.git

cd dev-recruit

```

2. Install dependencies

```bash

pnpm install

```

3. Configure environment variables

Create a .env file in the project root:

```env

# Database

DATABASE_URL="postgresql://user:password@host:5432/database?sslmode=require"

# Authentication (Better Auth)

BETTER_AUTH_SECRET="your-secret-key-min-32-chars"

BETTER_AUTH_URL="http://localhost:3000"

# AI (Groq)

GROQ_API_KEY="your-groq-api-key"

# Cloudflare R2 (Resume Storage)

R2_ACCOUNT_ID="your-r2-account-id"

R2_ACCESS_KEY_ID="your-r2-access-key-id"

R2_SECRET_ACCESS_KEY="your-r2-secret"

R2_BUCKET_NAME="your-r2-bucket-name"

# Optional: if using a custom/public domain for files

R2_PUBLIC_URL="https://files.yourdomain.com"

```

4. Set up the database

```bash

# Generate Prisma client

pnpm db:generate

# Push schema to database (development)

pnpm db:push

# Optional: Seed with sample data

pnpm db:seed

```

5. Start the development server

```bash

pnpm dev

```

Open [http://localhost:3000](http://localhost:3000) to access the application.

For detailed documentation on specific features:

• [AI Quiz Generation System](./docs/AI_QUIZ_GENERATION.md) - Deep dive into the AI-powered quiz generation
• [Cache Implementation](./docs/CACHE_IMPLEMENTATION.md) - Server-side caching patterns
• [Question Schema Reference](./docs/QUESTION_SCHEMAS.md) - Zod schemas for question validation

| Command | Description |

| ------------------ | ------------------------------ |

| pnpm dev | Start development server |

| pnpm build | Build for production |

| pnpm start | Start production server |

| pnpm lint | Run ESLint |

| pnpm db:generate | Generate Prisma client |

| pnpm db:push | Pus