docs/system_overview.md

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