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