# AI Career Fair Matcher - System Overview

## Purpose
AI Career Fair Matcher helps students identify which companies to prioritize at career fairs using AI + job board analysis.

Users upload a resume and the system:
- extracts skills and experience
- analyzes company job boards
- ranks companies based on fit
- suggests what to say to recruiters

## Core Idea
Turn:
Resume + Company List → Actionable Career Strategy

## Key Features
- Resume upload (PDF)
- AI-powered resume parsing
- Built-in company lists (no setup needed)
- Optional custom CSV upload
- Job board scraping (requests + Playwright fallback)
- Company ranking
- Match explanations
- Recruiter talking points

## Inputs
- Resume (PDF)
- Company source:
  - built-in CSV (default)
  - uploaded CSV (optional)
- Preferences (optional):
  - entry-level only
  - remote preference
  - location

## Outputs
- Ranked companies
- Matching job roles
- Resume profile (JSON)
- Match explanations
- Talking points

## Architecture
1. Resume Processing
2. AI Profile Extraction
3. Company Loader
4. Job Scraper
5. ATS Detection
6. Job Extraction
7. Matching Engine
8. Ranking Engine
9. UI Display

## Deployment Target
Hugging Face Spaces (Gradio app)

## Design Principles
- Zero setup (works out of the box)
- Explainable results
- Modular backend
- Resume-driven personalization
- Resilient to broken job sites