nsbecf / docs /system_overview.md
acarey5
docs and data
4a339d7
# 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