docs/backend_overview.md

Backend Overview

Responsibilities

• Parse resumes
• Build user profile
• Load companies
• Scrape job boards
• Extract jobs
• Score matches
• Return ranked results

Core Services

Resume Parser

• Extract text from PDF
• Return raw text

AI Profile Builder

• Convert text → structured JSON
• Extract:
  • skills
  • roles
  • tools
  • experience level

Company Loader

• Load built-in CSV OR uploaded CSV
• Validate structure

Fetcher

• requests first
• Playwright fallback

ATS Detector

Detect:

• Greenhouse
• Lever
• Workday
• SmartRecruiters
• iCIMS

Job Extractor

Return:

• title
• location
• url
• department

Scorer

Compare job vs resume:

• skill overlap
• role match
• entry-level fit
• location fit

Ranker

Aggregate:

• matches

• avg score
• best role

Talking Point Generator

Generate:

• 1–2 sentences per company