Skip to content

validation_guide.md

Latest commit

 

History

History
54 lines (43 loc) · 2.29 KB

validation_guide.md

File metadata and controls

54 lines (43 loc) · 2.29 KB

Internal Validation & Demo Guide

1. Demo Script (60 Seconds Flow)

Setup (Before Call)

  1. Reset Environment:
    • Click "Reset Demo" on the Dashboard (top right).
    • Confirm. Wait for reload (~3s).
    • Result: You are on the "New Ranking" page. The database is clean/ready.

The Narrative

"I'll show you how HireRank turns a JD and a pile of resumes into a decision in under a minute."

Step 1: The Context (0:00 - 0:15)

  • Dashboard: "We start with the Job Description. No complex setup."
  • Action: Paste a standard JD (e.g., Senior Python Engineer).
  • Action: Click "Analyze & Rank".
  • "Our AI instantly extracts the hard skills and experience requirements." (Show extracted tags).

Step 2: The Data (0:15 - 0:30)

  • Job Detail Page: "Now we need candidates."
  • Action: Click "Upload Resumes".
  • Action: Select 3-5 sample PDFs.
  • "You can drag and drop a whole folder. Processing happens locally."

Step 3: The Decision (0:30 - 0:50)

  • Ranking Table: "Here is your shortlist. Ranked 1, 2, 3."
  • Fit Badges: "Jane is a Strong Fit (85%). The others are ranked relative to this specific JD."
  • Explainability: Click Jane (Rank #1).
    • "We don't just give you a score. We tell you why."
    • Point to Strengths: "Matched 'FastAPI' and 'System Design' from the text."

Step 4: The Output (0:50 - 1:00)

  • Back to Ranking.
  • Click "Export CSV".
  • "Open this in Excel/Sheets. It's your discussion document for the hiring meeting."

2. Validation Checklist (Are we ready?)

  • JD extraction works: Pasting text results in a Job created with "Skills" tags.
  • Upload flow: "Upload Resumes" button appears prominently.
  • Ranking matches: High-quality resume gets #1 rank.
  • History: Created job appears in "History" tab.
  • Export: CSV downloads correctly.

3. MVP Limitations (Do Not Demo)

  • Large Files: >10MB PDFs might timeout.
  • Concurrency: Single user local DB.
  • History Edit: We don't support editing the JD after analysis (yet). Create a new one.

4. Common Questions (FAQ)

  • "Do I have to create a job first?" -> No, just paste the text. That's it.
  • "Where is the data stored?" -> Locally on your encrypted instance (for this demo).