# JobFoo

> JobFoo is a Match Analysis engine and Personal Career Advisor for job seekers. It provides an honest, evidence-based assessment of how a resume aligns with a specific role, then gives concrete guidance on what to do next. Unlike resume optimizers, JobFoo tells users when a role is not worth their time.

## What Makes JobFoo Distinct

- **The Gates:** Evaluation framework scoring resumes through System (ATS parsing), Recruiter (6-second scan), and Manager (proof of execution). Gate 0 (Discoverability) is planned.
- **Honest Fit Verdict:** 5-tier assessment from Unicorn Fit to Lower Priority Target. Every result leads with a strength before identifying gaps.
- **Personal Career Advisor:** Forensic on evidence, warm on delivery. Gaps are framed as visibility issues, not career failures.
- **The Four-Block Structure:** Every analysis follows Strength → Gap → Why It Matters → What To Do Next.
- **One Thing To Try:** A free, actionable task in every analysis before any paywall. Role-specific, under 5 minutes, never existential.
- **No Surprise Bills:** Every paid tier is a fixed-term pass. No auto-renewals. No cancellation flows.
- **Privacy Shield:** Zero PII transmitted to AI providers. All data tokenized via dna-scrubber before external API calls.

## Core Pages

- `/analyze`: **Match Analysis** — Paste JD and resume for a full Gates assessment with verdict, strength, gap, and next step.
- `/home`: **Dashboard** — Signed-in users see recent analyses, quick actions, tier status, and tools.
- `/alchemist`: **Resume Alchemist** — Refinement engine for rewriting specific resume bullets based on identified evidence gaps.
- `/backchannel`: **BackChannel** — Generates boolean search strings to find hiring managers and recruiters directly.
- `/vault`: **Career Vault** — Private storage for saved analyses, resume versions, and role artifacts.
- `/settings`: **Settings** — Account management, tier status, privacy controls.

## Pricing

- **Nomad ($0):** 10 Match Analyses per 24 hours. Four-block analysis, Honest Fit Verdict, Listing Integrity, Stuffing Alert. No login required.
- **Scout ($19 / 30 days):** 50 analyses per 7-day window. Resume Alchemist, Missing Evidence Ledger, User Prompts, Career Vault.
- **Candidate ($49 / 90 days):** Unlimited analyses. JobFoo Review (stress test), Stack Ranker (bulk triage), Scenario Planner, Fit Advisor.
- **Long Haul ($99 / 270 days):** Everything in Candidate plus Interview Prep, Monthly Match Calibration, Priority Compute, Market Trend Briefing.
- **Pro ($149 / 365 days):** The Career OS. Unlimited Career Vault, Google Drive Sync, Instant Artifact Compilation, Annual Career Health Brief.

## Verdict System

Verdicts are displayed to users with these labels:

| Score | Schema Key | Display Label |
|-------|-----------|---------------|
| 95-100 | unicorn_fit | Unicorn Fit |
| 90-94 | strategic_match | Strong Alignment |
| 70-89 | viable_contender | Needs Targeted Evidence |
| 40-69 | high_risk_pivot | Stretch Pivot |
| 0-39 | consider_alternatives | Lower Priority Target |

## Key Concepts

**Listing Integrity:** Classification of job descriptions as Realistic, Inflated, or Unicorn. A high score on a Unicorn listing is a red flag.

**Stuffing Alert:** Fires when Gate 1 (System) significantly outpaces Gates 2 and 3, signaling human-repellent keyword stuffing.

**Evidence Ledger:** Per-gate classification of resume claims as Proven (quantified), Claimed (unsubstantiated), or Missing (absent from resume).

**Fixability Index:** Per-gap rating of Wording (rewrite fixes it), Evidence (proof needed), or Structural (real gap that cannot be reworded away).

**Restraint:** Every analysis includes guidance on what NOT to do. Framed as protecting time and energy.

**Alternative Roles:** Required for Stretch Pivot and Lower Priority Target verdicts. Must be real, actively-hired titles on major job boards.

## Intelligence Architecture

- **The Architect (Nomad):** gemini-2.5-flash — gate analysis and scoring.
- **The Architect (Paid):** gemini-2.5-pro — upgraded model for paid tiers.
- **The Janitor:** gpt-4o-mini — post-processing wash on all user-facing output for tone, slop removal, and lexicon compliance.
- **Whisper Network (planned):** Supabase pgvector — Reddit/Blind scraping for market sentiment.

## Technical Stack

- Frontend: React (Vite) + Tailwind CSS
- Backend: Node.js (Express)
- Database: Neon PostgreSQL (Drizzle ORM)
- Auth: Google OAuth 2.0 (paid tiers), SHA-256 fingerprint (Nomad)
- Billing: Stripe fixed-term passes
- Hosting: Replit (Autoscale)
- Privacy: server/lib/dna-scrubber.ts

## Docs

- `/about`: Company mission and framework overview
- `/faq`: Frequently asked questions with structured data markup
- `/help`: Feature guides and tool documentation
- `/vs-jobscan`: Competitive comparison
- `/legal`: Terms, privacy policy, cookie policy

## Canonical Standards

- **Persona:** Personal Career Advisor (not Forensic Auditor)
- **Tone:** Forensic on evidence, warm on delivery
- **Response order:** Strength first, gap second, path forward third, next action fourth
- **No mind-reading:** "This role appears to prioritize" not "The Hiring Manager will be looking for"
- **No identity judgment:** Evaluate the resume's fit to the role, not the person's career worth
- **Tagline:** Own Your Outcome