Deploy FastAPI backend for AI recruitment system

- Add Dockerfile for HF Spaces (port 7860)
- Add FastAPI app with jobs, applications, hr routes
- Add AI resume analysis with OpenAI gpt-4o-mini
- Add automated email notifications (selection/rejection)
- Fix env var loading to use system environment (HF Spaces secrets)

.gitignore

@@ -0,0 +1,7 @@
+__pycache__/
+*.py[cod]
+*.pyo
+.env
+*.log
+.venv/
+venv/

Dockerfile

@@ -0,0 +1,19 @@
+FROM python:3.11-slim
+
+WORKDIR /app
+
+# Install system dependencies for pdfplumber
+RUN apt-get update && apt-get install -y \
+    libpoppler-cpp-dev \
+    poppler-utils \
+    && rm -rf /var/lib/apt/lists/*
+
+COPY requirements.txt .
+RUN pip install --no-cache-dir -r requirements.txt
+
+COPY . .
+
+# Hugging Face Spaces uses port 7860
+EXPOSE 7860
+
+CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "7860"]

README.md

@@ -1,10 +1,21 @@
 ---
-title: AIproject
-emoji: ⚡
+title: SmartHire AI Backend
+emoji: 🤖
 colorFrom: purple
 colorTo: yellow
 sdk: docker
 pinned: false
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# SmartHire AI – FastAPI Backend
+
+AI-powered recruitment system backend. Handles resume screening, ATS scoring, and automated email notifications.
+
+## Endpoints
+- `GET /` — Health check
+- `POST /api/jobs/create` — Create job posting
+- `GET /api/jobs/{job_id}` — Get job details
+- `GET /api/jobs/hr/{hr_id}` — Get HR's jobs
+- `POST /api/applications/submit` — Submit application with resume PDF
+- `GET /api/applications/{job_id}` — Get applications for a job
+- `POST /api/hr/register` — Register HR user

agent/resume_agent.py

@@ -0,0 +1,101 @@
+import os
+import io
+import json
+import logging
+
+import pdfplumber
+from openai import AsyncOpenAI
+from dotenv import load_dotenv
+
+load_dotenv()
+
+logger = logging.getLogger(__name__)
+
+client = AsyncOpenAI(api_key=os.getenv("OPENAI_API_KEY"))
+
+
+def extract_text_from_pdf(pdf_bytes: bytes) -> str:
+    text = ""
+    try:
+        with pdfplumber.open(io.BytesIO(pdf_bytes)) as pdf:
+            for page in pdf.pages:
+                page_text = page.extract_text()
+                if page_text:
+                    text += page_text + "\n"
+    except Exception as exc:
+        logger.error("Failed to extract text from PDF: %s", exc)
+        raise ValueError(f"Could not extract text from PDF: {exc}") from exc
+    return text.strip()
+
+
+async def analyze_resume(
+    pdf_bytes: bytes,
+    job_title: str,
+    job_description: str,
+    required_skills: list,
+    experience_years: int,
+    company_name: str
+) -> dict:
+    resume_text = extract_text_from_pdf(pdf_bytes)
+    if not resume_text:
+        raise ValueError("Could not extract text from PDF – the file may be image-only or corrupted.")
+
+    skills_str = ", ".join(required_skills)
+
+    system_prompt = """You are an expert AI recruitment screener. Analyze the resume against the job requirements and return ONLY a valid JSON object — no markdown, no extra text.
+
+JSON structure:
+{
+  "status": "selected" or "rejected",
+  "ats_score": <integer 0-100>,
+  "candidate_name": "<full name from resume>",
+  "missing_skills": ["skill1", "skill2"],
+  "ai_feedback": "<2-3 sentence professional feedback>",
+  "skill_recommendations": [
+    {
+      "skill": "<missing skill>",
+      "why_it_matters": "<why this skill is important for the role>",
+      "resource_link": "<free learning URL from Coursera/YouTube/freeCodeCamp/official docs>",
+      "time_to_learn": "<realistic duration>"
+    }
+  ]
+}
+
+Scoring rules:
+- ATS score 0-100 based on: skill match (50%), experience (25%), education (15%), resume quality (10%)
+- Select if ats_score >= 70, reject otherwise
+- skill_recommendations only for missing skills (empty array if selected with all skills)"""
+
+    user_prompt = f"""JOB: {job_title} at {company_name}
+REQUIRED SKILLS: {skills_str}
+MIN EXPERIENCE: {experience_years} years
+DESCRIPTION: {job_description[:800]}
+
+RESUME:
+{resume_text[:3000]}
+
+Analyze and return JSON only."""
+
+    logger.info("Starting resume analysis for: %s at %s", job_title, company_name)
+
+    response = await client.chat.completions.create(
+        model="gpt-4o-mini",
+        messages=[
+            {"role": "system", "content": system_prompt},
+            {"role": "user", "content": user_prompt},
+        ],
+        temperature=0.2,
+        max_tokens=1200,
+        response_format={"type": "json_object"},
+    )
+
+    output = response.choices[0].message.content or "{}"
+
+    try:
+        parsed = json.loads(output)
+    except json.JSONDecodeError as exc:
+        logger.error("Invalid JSON from OpenAI: %s", output[:300])
+        raise ValueError(f"Invalid JSON response: {exc}") from exc
+
+    logger.info("Analysis done — status: %s, score: %s", parsed.get("status"), parsed.get("ats_score"))
+    return parsed

agent/tools.py

@@ -0,0 +1,147 @@
+import json
+import logging
+from agents import function_tool
+
+logger = logging.getLogger(__name__)
+
+
+@function_tool
+async def extract_resume_info(resume_text: str) -> str:
+    """
+    Extract structured information from raw resume text.
+    Returns a JSON string with candidate name, skills, experience years,
+    education level, and certifications.
+    """
+    result = {
+        "candidate_name": "Unknown",
+        "skills": [],
+        "experience_years": 0,
+        "education": "Unknown",
+        "certifications": []
+    }
+    logger.debug("extract_resume_info called with %d chars of resume text", len(resume_text))
+    return json.dumps(result)
+
+
+@function_tool
+async def match_skills(resume_skills: str, required_skills: str) -> str:
+    """
+    Compare resume skills against required job skills.
+
+    Args:
+        resume_skills: comma-separated list of skills found in the resume
+        required_skills: comma-separated list of skills required for the job
+
+    Returns:
+        JSON string with matched_skills, missing_skills, and match_percentage
+    """
+    resume_set = {s.strip().lower() for s in resume_skills.split(",") if s.strip()}
+    required_set = {s.strip().lower() for s in required_skills.split(",") if s.strip()}
+
+    if not required_set:
+        return json.dumps({
+            "matched_skills": [],
+            "missing_skills": [],
+            "match_percentage": 0.0
+        })
+
+    matched = sorted(resume_set & required_set)
+    missing = sorted(required_set - resume_set)
+    match_percentage = round((len(matched) / len(required_set)) * 100, 2)
+
+    result = {
+        "matched_skills": matched,
+        "missing_skills": missing,
+        "match_percentage": match_percentage
+    }
+    logger.debug("match_skills: %d/%d matched (%.1f%%)", len(matched), len(required_set), match_percentage)
+    return json.dumps(result)
+
+
+@function_tool
+async def calculate_ats_score(
+    skill_match_percentage: float,
+    experience_years_candidate: int,
+    experience_years_required: int,
+    education_level: str,
+    resume_quality: str
+) -> str:
+    """
+    Calculate ATS score (0–100) based on multiple criteria.
+    """
+    skill_match_percentage = max(0.0, min(100.0, float(skill_match_percentage)))
+    skill_score = round(50 * skill_match_percentage / 100, 2)
+
+    if experience_years_candidate >= experience_years_required:
+        experience_score = 25
+    elif experience_years_required > 0 and experience_years_candidate >= experience_years_required / 2:
+        experience_score = 12
+    else:
+        experience_score = 0
+
+    education_map = {
+        "phd": 15, "masters": 15, "master": 15,
+        "bachelors": 12, "bachelor": 12, "diploma": 8,
+    }
+    education_score = education_map.get(education_level.strip().lower(), 4)
+
+    quality_map = {"good": 10, "average": 6, "poor": 2}
+    quality_score = quality_map.get(resume_quality.strip().lower(), 6)
+
+    ats_score = round(skill_score + experience_score + education_score + quality_score, 2)
+    ats_score = max(0, min(100, ats_score))
+
+    result = {
+        "ats_score": ats_score,
+        "breakdown": {
+            "skill_score": skill_score,
+            "experience_score": experience_score,
+            "education_score": education_score,
+            "quality_score": quality_score
+        }
+    }
+    logger.debug("calculate_ats_score: total=%.2f", ats_score)
+    return json.dumps(result)
+
+
+@function_tool
+async def make_decision(
+    ats_score: int,
+    candidate_name: str,
+    missing_skills: str,
+    job_title: str
+) -> str:
+    """
+    Make a hiring decision based on ATS score.
+    """
+    missing_list = [s.strip() for s in missing_skills.split(",") if s.strip()]
+
+    if ats_score >= 70:
+        status = "selected"
+        recommendation_message = (
+            f"Congratulations, {candidate_name}! Your profile is a strong match for the "
+            f"{job_title} position. Our recruitment team will be in touch with next steps shortly."
+        )
+    else:
+        status = "rejected"
+        if missing_list:
+            skills_str = ", ".join(missing_list)
+            recommendation_message = (
+                f"Thank you for applying, {candidate_name}. Unfortunately your profile did not meet "
+                f"the minimum requirements for the {job_title} role at this time. "
+                f"We recommend strengthening the following areas: {skills_str}."
+            )
+        else:
+            recommendation_message = (
+                f"Thank you for applying, {candidate_name}. Unfortunately your profile did not meet "
+                f"the minimum requirements for the {job_title} role at this time."
+            )
+
+    result = {
+        "status": status,
+        "ats_score": ats_score,
+        "missing_skills": missing_list,
+        "recommendation_message": recommendation_message
+    }
+    logger.debug("make_decision: %s (score=%d)", status, ats_score)
+    return json.dumps(result)

email_service.py

@@ -0,0 +1,320 @@
+import smtplib
+import logging
+import os
+from email.mime.multipart import MIMEMultipart
+from email.mime.text import MIMEText
+from dotenv import load_dotenv
+
+load_dotenv()
+
+SMTP_HOST = os.getenv("SMTP_HOST", "smtp.gmail.com")
+SMTP_PORT = int(os.getenv("SMTP_PORT", "587"))
+SMTP_EMAIL = os.getenv("SMTP_EMAIL")
+SMTP_APP_PASSWORD = os.getenv("SMTP_APP_PASSWORD")
+
+logger = logging.getLogger(__name__)
+
+
+def _send_email(to_email: str, subject: str, html_body: str) -> bool:
+    """Core email sending function with one retry on failure."""
+    for attempt in range(2):
+        try:
+            msg = MIMEMultipart("alternative")
+            msg["Subject"] = subject
+            msg["From"] = SMTP_EMAIL
+            msg["To"] = to_email
+
+            part = MIMEText(html_body, "html")
+            msg.attach(part)
+
+            with smtplib.SMTP(SMTP_HOST, SMTP_PORT) as server:
+                server.ehlo()
+                server.starttls()
+                server.login(SMTP_EMAIL, SMTP_APP_PASSWORD)
+                server.sendmail(SMTP_EMAIL, to_email, msg.as_string())
+
+            logger.info(f"Email sent successfully to {to_email} | Subject: {subject}")
+            return True
+
+        except smtplib.SMTPException as e:
+            logger.error(f"SMTP error on attempt {attempt + 1} sending to {to_email}: {e}")
+            if attempt == 1:
+                return False
+        except Exception as e:
+            logger.error(f"Unexpected error on attempt {attempt + 1} sending to {to_email}: {e}")
+            if attempt == 1:
+                return False
+
+    return False
+
+
+def send_rejection_email(
+    candidate_name: str,
+    candidate_email: str,
+    job_title: str,
+    company_name: str,
+    ats_score: float,
+    missing_skills_with_recommendations: list
+) -> bool:
+    subject = f"Your Application for {job_title} at {company_name} – Update"
+
+    skills_rows_html = ""
+    if missing_skills_with_recommendations:
+        for item in missing_skills_with_recommendations:
+            skill = item.get("skill", "")
+            why = item.get("why_it_matters", "")
+            link = item.get("resource_link", "#")
+            time_to_learn = item.get("time_to_learn", "")
+            skills_rows_html += f"""
+            <tr>
+                <td style="padding:10px 12px; border-bottom:1px solid #f0f0f0; color:#333; font-weight:600;">{skill}</td>
+                <td style="padding:10px 12px; border-bottom:1px solid #f0f0f0; color:#555;">{why}</td>
+                <td style="padding:10px 12px; border-bottom:1px solid #f0f0f0;">
+                    <a href="{link}" style="color:#4F46E5; text-decoration:none; font-weight:500;">Learn Now &rarr;</a>
+                </td>
+                <td style="padding:10px 12px; border-bottom:1px solid #f0f0f0; color:#888; text-align:center;">{time_to_learn}</td>
+            </tr>"""
+
+    skills_table_html = ""
+    if skills_rows_html:
+        skills_table_html = f"""
+        <div style="margin-top:28px;">
+            <h3 style="font-size:16px; color:#1a1a2e; margin-bottom:12px; font-weight:700;">
+                Recommended Skills to Strengthen Your Profile
+            </h3>
+            <table width="100%" cellpadding="0" cellspacing="0" style="border-collapse:collapse; background:#fafafa; border-radius:8px; overflow:hidden;">
+                <thead>
+                    <tr style="background:#4F46E5;">
+                        <th style="padding:10px 12px; color:#fff; text-align:left; font-size:13px;">Skill</th>
+                        <th style="padding:10px 12px; color:#fff; text-align:left; font-size:13px;">Why It Matters</th>
+                        <th style="padding:10px 12px; color:#fff; text-align:left; font-size:13px;">Resource</th>
+                        <th style="padding:10px 12px; color:#fff; text-align:center; font-size:13px;">Time to Learn</th>
+                    </tr>
+                </thead>
+                <tbody>
+                    {skills_rows_html}
+                </tbody>
+            </table>
+        </div>"""
+
+    html_body = f"""<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>Application Update</title>
+</head>
+<body style="margin:0; padding:0; background-color:#f4f6fb; font-family:'Segoe UI', Arial, sans-serif;">
+    <table width="100%" cellpadding="0" cellspacing="0" style="background-color:#f4f6fb; padding:40px 0;">
+        <tr>
+            <td align="center">
+                <table width="620" cellpadding="0" cellspacing="0" style="background:#ffffff; border-radius:12px; overflow:hidden; box-shadow:0 4px 20px rgba(0,0,0,0.08);">
+                    <tr>
+                        <td style="background:linear-gradient(135deg, #667eea 0%, #764ba2 100%); padding:36px 40px; text-align:center;">
+                            <h1 style="margin:0; color:#ffffff; font-size:24px; font-weight:700; letter-spacing:0.5px;">{company_name}</h1>
+                            <p style="margin:8px 0 0; color:rgba(255,255,255,0.85); font-size:14px;">Recruitment Team</p>
+                        </td>
+                    </tr>
+                    <tr>
+                        <td style="padding:40px;">
+                            <p style="font-size:16px; color:#333; margin:0 0 16px;">Dear <strong>{candidate_name}</strong>,</p>
+                            <p style="font-size:15px; color:#555; line-height:1.7; margin:0 0 16px;">
+                                Thank you for taking the time to apply for the <strong>{job_title}</strong> position at <strong>{company_name}</strong>.
+                            </p>
+                            <p style="font-size:15px; color:#555; line-height:1.7; margin:0 0 24px;">
+                                After a thorough review, we regret to inform you that we will not be moving forward with your application at this time.
+                            </p>
+                            <div style="background:#fef3f2; border:1px solid #fecaca; border-radius:10px; padding:20px 24px; margin-bottom:24px; text-align:center;">
+                                <p style="margin:0 0 6px; font-size:13px; color:#888; text-transform:uppercase; letter-spacing:1px; font-weight:600;">Your ATS Match Score</p>
+                                <p style="margin:0; font-size:42px; font-weight:800; color:#e53e3e;">{int(ats_score)}<span style="font-size:20px; font-weight:500; color:#999;">/ 100</span></p>
+                                <p style="margin:6px 0 0; font-size:13px; color:#999;">A score of 70 or above is required to proceed</p>
+                            </div>
+                            {skills_table_html}
+                            <p style="font-size:15px; color:#555; line-height:1.7; margin:28px 0 32px;">
+                                We strongly encourage you to work on the skills listed above and apply again in the future.
+                            </p>
+                            <p style="font-size:15px; color:#333; margin:0;">
+                                Warm regards,<br>
+                                <strong>The Recruitment Team</strong><br>
+                                <span style="color:#888; font-size:13px;">{company_name}</span>
+                            </p>
+                        </td>
+                    </tr>
+                    <tr>
+                        <td style="background:#f8f9fc; padding:20px 40px; text-align:center; border-top:1px solid #eee;">
+                            <p style="margin:0; font-size:12px; color:#aaa;">This is an automated message. Please do not reply directly to this email.</p>
+                        </td>
+                    </tr>
+                </table>
+            </td>
+        </tr>
+    </table>
+</body>
+</html>"""
+
+    return _send_email(candidate_email, subject, html_body)
+
+
+def send_selection_email(
+    candidate_name: str,
+    candidate_email: str,
+    job_title: str,
+    company_name: str,
+    ats_score: float
+) -> bool:
+    subject = f"Congratulations! You've Been Selected – {job_title} at {company_name}"
+
+    html_body = f"""<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>Congratulations!</title>
+</head>
+<body style="margin:0; padding:0; background-color:#f4f6fb; font-family:'Segoe UI', Arial, sans-serif;">
+    <table width="100%" cellpadding="0" cellspacing="0" style="background-color:#f4f6fb; padding:40px 0;">
+        <tr>
+            <td align="center">
+                <table width="620" cellpadding="0" cellspacing="0" style="background:#ffffff; border-radius:12px; overflow:hidden; box-shadow:0 4px 20px rgba(0,0,0,0.08);">
+                    <tr>
+                        <td style="background:linear-gradient(135deg, #11998e 0%, #38ef7d 100%); padding:36px 40px; text-align:center;">
+                            <div style="font-size:48px; margin-bottom:12px;">&#127881;</div>
+                            <h1 style="margin:0; color:#ffffff; font-size:26px; font-weight:700;">Congratulations!</h1>
+                            <p style="margin:8px 0 0; color:rgba(255,255,255,0.9); font-size:15px;">You have been selected!</p>
+                        </td>
+                    </tr>
+                    <tr>
+                        <td style="padding:40px;">
+                            <p style="font-size:16px; color:#333; margin:0 0 16px;">Dear <strong>{candidate_name}</strong>,</p>
+                            <p style="font-size:15px; color:#555; line-height:1.7; margin:0 0 16px;">
+                                We are thrilled to inform you that you have been <strong style="color:#11998e;">selected</strong> for the
+                                <strong>{job_title}</strong> position at <strong>{company_name}</strong>!
+                            </p>
+                            <div style="background:#f0fdf4; border:1px solid #86efac; border-radius:10px; padding:20px 24px; margin-bottom:28px; text-align:center;">
+                                <p style="margin:0 0 6px; font-size:13px; color:#888; text-transform:uppercase; letter-spacing:1px; font-weight:600;">Your ATS Match Score</p>
+                                <p style="margin:0; font-size:42px; font-weight:800; color:#16a34a;">{int(ats_score)}<span style="font-size:20px; font-weight:500; color:#999;">/ 100</span></p>
+                            </div>
+                            <div style="background:#f8f9fc; border-left:4px solid #11998e; border-radius:0 8px 8px 0; padding:20px 24px; margin-bottom:28px;">
+                                <h3 style="margin:0 0 12px; font-size:15px; color:#1a1a2e; font-weight:700;">What Happens Next?</h3>
+                                <ul style="margin:0; padding-left:20px; color:#555; font-size:14px; line-height:2;">
+                                    <li>Our HR team will review your application in detail</li>
+                                    <li>You will be contacted within <strong>2–3 business days</strong> to schedule an interview</li>
+                                    <li>Please ensure your contact details are up to date</li>
+                                </ul>
+                            </div>
+                            <p style="font-size:15px; color:#333; margin:0;">
+                                Best regards,<br>
+                                <strong>The Recruitment Team</strong><br>
+                                <span style="color:#888; font-size:13px;">{company_name}</span>
+                            </p>
+                        </td>
+                    </tr>
+                    <tr>
+                        <td style="background:#f8f9fc; padding:20px 40px; text-align:center; border-top:1px solid #eee;">
+                            <p style="margin:0; font-size:12px; color:#aaa;">This is an automated message. Please do not reply directly to this email.</p>
+                        </td>
+                    </tr>
+                </table>
+            </td>
+        </tr>
+    </table>
+</body>
+</html>"""
+
+    return _send_email(candidate_email, subject, html_body)
+
+
+def send_hr_notification_email(
+    hr_email: str,
+    candidate_name: str,
+    candidate_email: str,
+    job_title: str,
+    company_name: str,
+    ats_score: float,
+    applied_at: str
+) -> bool:
+    subject = f"New Application Received – {job_title} | ATS Score: {int(ats_score)}"
+
+    score_color = "#16a34a" if ats_score >= 70 else "#e53e3e"
+    status_label = "SELECTED" if ats_score >= 70 else "REJECTED"
+    status_bg = "#f0fdf4" if ats_score >= 70 else "#fef3f2"
+    status_border = "#86efac" if ats_score >= 70 else "#fecaca"
+
+    html_body = f"""<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>New Application Notification</title>
+</head>
+<body style="margin:0; padding:0; background-color:#f4f6fb; font-family:'Segoe UI', Arial, sans-serif;">
+    <table width="100%" cellpadding="0" cellspacing="0" style="background-color:#f4f6fb; padding:40px 0;">
+        <tr>
+            <td align="center">
+                <table width="620" cellpadding="0" cellspacing="0" style="background:#ffffff; border-radius:12px; overflow:hidden; box-shadow:0 4px 20px rgba(0,0,0,0.08);">
+                    <tr>
+                        <td style="background:linear-gradient(135deg, #1a1a2e 0%, #16213e 100%); padding:30px 40px; text-align:center;">
+                            <h1 style="margin:0; color:#ffffff; font-size:20px; font-weight:700;">&#128203; New Application Alert</h1>
+                            <p style="margin:8px 0 0; color:rgba(255,255,255,0.7); font-size:13px;">{company_name} – HR Dashboard</p>
+                        </td>
+                    </tr>
+                    <tr>
+                        <td style="padding:36px 40px;">
+                            <div style="background:#f8f9fc; border-radius:10px; padding:24px; margin-bottom:24px;">
+                                <h3 style="margin:0 0 16px; font-size:15px; color:#1a1a2e; font-weight:700;">Candidate Details</h3>
+                                <table width="100%" cellpadding="0" cellspacing="0">
+                                    <tr>
+                                        <td style="padding:8px 0; font-size:14px; color:#888; width:160px;">Full Name</td>
+                                        <td style="padding:8px 0; font-size:14px; color:#333; font-weight:600;">{candidate_name}</td>
+                                    </tr>
+                                    <tr>
+                                        <td style="padding:8px 0; font-size:14px; color:#888;">Email Address</td>
+                                        <td style="padding:8px 0; font-size:14px;">
+                                            <a href="mailto:{candidate_email}" style="color:#4F46E5; text-decoration:none;">{candidate_email}</a>
+                                        </td>
+                                    </tr>
+                                    <tr>
+                                        <td style="padding:8px 0; font-size:14px; color:#888;">Applied For</td>
+                                        <td style="padding:8px 0; font-size:14px; color:#333; font-weight:600;">{job_title}</td>
+                                    </tr>
+                                    <tr>
+                                        <td style="padding:8px 0; font-size:14px; color:#888;">Applied At</td>
+                                        <td style="padding:8px 0; font-size:14px; color:#333;">{applied_at}</td>
+                                    </tr>
+                                </table>
+                            </div>
+                            <table width="100%" cellpadding="0" cellspacing="0" style="margin-bottom:24px;">
+                                <tr>
+                                    <td width="48%" style="vertical-align:top; padding-right:8px;">
+                                        <div style="background:#f8f9fc; border-radius:10px; padding:20px; text-align:center;">
+                                            <p style="margin:0 0 6px; font-size:12px; color:#888; text-transform:uppercase; font-weight:600;">ATS Score</p>
+                                            <p style="margin:0; font-size:38px; font-weight:800; color:{score_color};">{int(ats_score)}<span style="font-size:16px; font-weight:400; color:#999;">/100</span></p>
+                                        </div>
+                                    </td>
+                                    <td width="4%"></td>
+                                    <td width="48%" style="vertical-align:top; padding-left:8px;">
+                                        <div style="background:{status_bg}; border:1px solid {status_border}; border-radius:10px; padding:20px; text-align:center;">
+                                            <p style="margin:0 0 6px; font-size:12px; color:#888; text-transform:uppercase; font-weight:600;">Decision</p>
+                                            <p style="margin:0; font-size:22px; font-weight:800; color:{score_color};">{status_label}</p>
+                                        </div>
+                                    </td>
+                                </tr>
+                            </table>
+                            <p style="font-size:14px; color:#888; line-height:1.6; margin:0;">
+                                The candidate has been automatically notified. Log in to your HR dashboard to view the full AI analysis report.
+                            </p>
+                        </td>
+                    </tr>
+                    <tr>
+                        <td style="background:#f8f9fc; padding:20px 40px; text-align:center; border-top:1px solid #eee;">
+                            <p style="margin:0; font-size:12px; color:#aaa;">This notification was generated automatically by the {company_name} AI Recruitment System.</p>
+                        </td>
+                    </tr>
+                </table>
+            </td>
+        </tr>
+    </table>
+</body>
+</html>"""
+
+    return _send_email(hr_email, subject, html_body)

main.py

@@ -0,0 +1,65 @@
+import logging
+from fastapi import FastAPI
+from fastapi.middleware.cors import CORSMiddleware
+from routes.jobs import router as jobs_router
+from routes.applications import router as applications_router
+from routes.hr import router as hr_router
+
+# ---------------------------------------------------------------------------
+# Logging configuration
+# ---------------------------------------------------------------------------
+logging.basicConfig(
+    level=logging.INFO,
+    format="%(asctime)s | %(levelname)-8s | %(name)s | %(message)s",
+    datefmt="%Y-%m-%d %H:%M:%S",
+)
+
+logger = logging.getLogger(__name__)
+
+# ---------------------------------------------------------------------------
+# FastAPI application
+# ---------------------------------------------------------------------------
+app = FastAPI(
+    title="AI Recruitment System",
+    description="Automated resume screening and candidate evaluation powered by AI.",
+    version="1.0.0",
+)
+
+# ---------------------------------------------------------------------------
+# CORS middleware
+# ---------------------------------------------------------------------------
+import os
+ALLOWED_ORIGINS = [
+    "http://localhost:3000",
+    os.getenv("FRONTEND_URL", ""),
+]
+ALLOWED_ORIGINS = [o for o in ALLOWED_ORIGINS if o]
+
+app.add_middleware(
+    CORSMiddleware,
+    allow_origins=ALLOWED_ORIGINS,
+    allow_origin_regex=r"https://.*\.vercel\.app",
+    allow_credentials=True,
+    allow_methods=["*"],
+    allow_headers=["*"],
+)
+
+# ---------------------------------------------------------------------------
+# Routers
+# ---------------------------------------------------------------------------
+app.include_router(jobs_router, prefix="/api/jobs", tags=["jobs"])
+app.include_router(applications_router, prefix="/api/applications", tags=["applications"])
+app.include_router(hr_router, prefix="/api/hr", tags=["hr"])
+
+
+# ---------------------------------------------------------------------------
+# Health check
+# ---------------------------------------------------------------------------
+@app.get("/", tags=["health"])
+def root():
+    return {"message": "AI Recruitment System API", "status": "running", "version": "1.0.0"}
+
+
+@app.get("/health", tags=["health"])
+def health_check():
+    return {"status": "healthy"}

requirements.txt

@@ -0,0 +1,9 @@
+fastapi==0.115.0
+uvicorn==0.30.6
+python-dotenv==1.0.1
+supabase==2.9.0
+openai==1.51.0
+openai-agents==0.0.15
+pdfplumber==0.11.4
+python-multipart==0.0.12
+httpx==0.27.2

routes/applications.py

@@ -0,0 +1,249 @@
+import uuid
+import logging
+import asyncio
+from datetime import datetime, timezone
+
+from fastapi import APIRouter, HTTPException, UploadFile, File, Form
+
+import sys
+from pathlib import Path
+sys.path.insert(0, str(Path(__file__).parent.parent))
+
+from supabase_client import supabase
+from email_service import (
+    send_selection_email,
+    send_rejection_email,
+    send_hr_notification_email,
+)
+from agent.resume_agent import analyze_resume
+
+router = APIRouter()
+logger = logging.getLogger(__name__)
+
+RESUME_BUCKET = "resumes"
+MAX_FILE_SIZE = 5 * 1024 * 1024
+MIN_TEXT_LENGTH = 50
+AI_TIMEOUT_SECONDS = 60
+
+
+def _utcnow_str() -> str:
+    return datetime.now(timezone.utc).isoformat()
+
+
+@router.post("/submit")
+async def submit_application(
+    job_id: str = Form(...),
+    candidate_name: str = Form(...),
+    candidate_email: str = Form(...),
+    resume: UploadFile = File(...)
+):
+    candidate_name = candidate_name.strip()
+    candidate_email = candidate_email.strip().lower()
+
+    if not candidate_name:
+        raise HTTPException(status_code=400, detail="Candidate name is required.")
+    if not candidate_email or "@" not in candidate_email:
+        raise HTTPException(status_code=400, detail="Valid email address is required.")
+
+    content_type = resume.content_type or ""
+    filename = resume.filename or ""
+    if content_type not in ("application/pdf",) and not filename.lower().endswith(".pdf"):
+        raise HTTPException(status_code=400, detail="Only PDF files are accepted.")
+
+    try:
+        pdf_bytes = await resume.read()
+    except Exception as exc:
+        logger.error("Failed to read uploaded file: %s", exc)
+        raise HTTPException(status_code=400, detail="Could not read the uploaded file.")
+
+    if not pdf_bytes:
+        raise HTTPException(status_code=400, detail="Uploaded file is empty.")
+
+    if len(pdf_bytes) > MAX_FILE_SIZE:
+        raise HTTPException(status_code=400, detail="File size exceeds 5 MB limit.")
+
+    try:
+        job_response = supabase.table("jobs").select("*").eq("id", job_id).execute()
+        if not job_response.data:
+            raise HTTPException(status_code=404, detail="Job posting not found or link is invalid.")
+        job = job_response.data[0]
+    except HTTPException:
+        raise
+    except Exception as exc:
+        logger.error("Failed to fetch job %s: %s", job_id, exc)
+        raise HTTPException(status_code=500, detail="Could not verify job posting.")
+
+    if not job.get("is_active", True):
+        raise HTTPException(status_code=410, detail="This job posting is no longer accepting applications.")
+
+    try:
+        dup = (
+            supabase.table("applications")
+            .select("id")
+            .eq("job_id", job_id)
+            .eq("candidate_email", candidate_email)
+            .execute()
+        )
+        if dup.data:
+            raise HTTPException(
+                status_code=409,
+                detail="You have already applied for this position. Check your email for the result."
+            )
+    except HTTPException:
+        raise
+    except Exception as exc:
+        logger.warning("Duplicate check failed (continuing): %s", exc)
+
+    job_title        = job.get("title", "Unknown Position")
+    company_name     = job.get("company_name", "Our Company")
+    required_skills  = job.get("required_skills", [])
+    experience_years = job.get("experience_years", 0)
+    job_description  = job.get("description", "")
+    hr_email         = job.get("hr_email")
+
+    application_id = str(uuid.uuid4())
+    applied_at     = _utcnow_str()
+    storage_path   = f"{job_id}/{application_id}.pdf"
+    resume_url     = None
+
+    try:
+        supabase.storage.from_(RESUME_BUCKET).upload(
+            path=storage_path,
+            file=pdf_bytes,
+            file_options={"content-type": "application/pdf"}
+        )
+        resume_url = supabase.storage.from_(RESUME_BUCKET).get_public_url(storage_path)
+    except Exception as exc:
+        logger.warning("Resume storage upload failed (continuing): %s", exc)
+
+    try:
+        insert_resp = supabase.table("applications").insert({
+            "id":              application_id,
+            "job_id":          job_id,
+            "candidate_name":  candidate_name,
+            "candidate_email": candidate_email,
+            "resume_url":      resume_url,
+            "status":          "pending",
+            "ats_score":       None,
+            "missing_skills":  [],
+            "ai_feedback":     None,
+            "applied_at":      applied_at,
+        }).execute()
+        if not insert_resp.data:
+            raise RuntimeError("Insert returned no data")
+    except Exception as exc:
+        logger.error("Failed to insert application: %s", exc)
+        raise HTTPException(status_code=500, detail="Failed to save application. Please try again.")
+
+    final_status   = "pending"
+    ats_score      = 0
+    missing_skills = []
+    ai_feedback    = None
+    skill_recs     = []
+    ai_result      = None
+
+    try:
+        ai_result = await asyncio.wait_for(
+            analyze_resume(
+                pdf_bytes=pdf_bytes,
+                job_title=job_title,
+                job_description=job_description,
+                required_skills=required_skills,
+                experience_years=experience_years,
+                company_name=company_name,
+            ),
+            timeout=AI_TIMEOUT_SECONDS,
+        )
+        final_status   = ai_result.get("status", "pending")
+        ats_score      = int(ai_result.get("ats_score", 0))
+        missing_skills = ai_result.get("missing_skills", [])
+        ai_feedback    = ai_result.get("ai_feedback", "")
+        skill_recs     = ai_result.get("skill_recommendations", [])
+
+    except asyncio.TimeoutError:
+        logger.error("AI analysis timed out for application %s", application_id)
+        ai_feedback = "Analysis timed out. HR will review manually."
+    except ValueError as exc:
+        logger.error("PDF/AI error for application %s: %s", application_id, exc)
+        ai_feedback = str(exc)
+    except Exception as exc:
+        logger.error("AI analysis failed for application %s: %s", application_id, exc)
+
+    try:
+        supabase.table("applications").update({
+            "status":                final_status,
+            "ats_score":             ats_score,
+            "missing_skills":        missing_skills,
+            "ai_feedback":           ai_feedback,
+            "skill_recommendations": skill_recs,
+            "updated_at":            _utcnow_str(),
+        }).eq("id", application_id).execute()
+    except Exception as exc:
+        logger.error("Failed to update application %s: %s", application_id, exc)
+
+    if ai_result is not None and final_status in ("selected", "rejected"):
+        try:
+            if final_status == "selected":
+                send_selection_email(
+                    candidate_name=candidate_name,
+                    candidate_email=candidate_email,
+                    job_title=job_title,
+                    company_name=company_name,
+                    ats_score=ats_score,
+                )
+                if hr_email:
+                    send_hr_notification_email(
+                        hr_email=hr_email,
+                        candidate_name=candidate_name,
+                        candidate_email=candidate_email,
+                        job_title=job_title,
+                        company_name=company_name,
+                        ats_score=ats_score,
+                        applied_at=applied_at,
+                    )
+            else:
+                send_rejection_email(
+                    candidate_name=candidate_name,
+                    candidate_email=candidate_email,
+                    job_title=job_title,
+                    company_name=company_name,
+                    ats_score=ats_score,
+                    missing_skills_with_recommendations=skill_recs,
+                )
+        except Exception as exc:
+            logger.error("Email failed for application %s: %s", application_id, exc)
+
+    logger.info("Application %s processed: status=%s ats=%s", application_id, final_status, ats_score)
+
+    return {
+        "success":               True,
+        "application_id":        application_id,
+        "status":                final_status,
+        "ats_score":             ats_score,
+        "candidate_name":        candidate_name,
+        "missing_skills":        missing_skills,
+        "ai_feedback":           ai_feedback,
+        "skill_recommendations": skill_recs,
+    }
+
+
+@router.get("/{job_id}")
+async def get_applications(job_id: str):
+    try:
+        response = (
+            supabase.table("applications")
+            .select("*")
+            .eq("job_id", job_id)
+            .order("applied_at", desc=True)
+            .execute()
+        )
+    except Exception as exc:
+        logger.error("Failed to fetch applications for job %s: %s", job_id, exc)
+        raise HTTPException(status_code=500, detail="Failed to retrieve applications.")
+
+    return {
+        "success":      True,
+        "job_id":       job_id,
+        "applications": response.data or [],
+        "total":        len(response.data or []),
+    }

routes/hr.py

@@ -0,0 +1,36 @@
+import logging
+from fastapi import APIRouter, HTTPException
+from pydantic import BaseModel, EmailStr
+
+import sys
+from pathlib import Path
+sys.path.insert(0, str(Path(__file__).parent.parent))
+
+from supabase_client import supabase
+
+router = APIRouter()
+logger = logging.getLogger(__name__)
+
+
+class HRRegisterRequest(BaseModel):
+    id: str
+    name: str
+    company_name: str
+    email: EmailStr
+
+
+@router.post("/register")
+async def register_hr(payload: HRRegisterRequest):
+    try:
+        response = supabase.table("hr_users").upsert({
+            "id": payload.id,
+            "name": payload.name,
+            "company_name": payload.company_name,
+            "email": payload.email,
+        }).execute()
+    except Exception as exc:
+        logger.error("Failed to insert HR user: %s", exc)
+        raise HTTPException(status_code=500, detail="Failed to save HR profile.")
+
+    logger.info("HR user registered: id=%s email=%s", payload.id, payload.email)
+    return {"success": True, "user_id": payload.id}

routes/jobs.py

@@ -0,0 +1,111 @@
+import uuid
+import logging
+from fastapi import APIRouter, HTTPException
+from pydantic import BaseModel, EmailStr
+from typing import List
+
+import sys
+from pathlib import Path
+sys.path.insert(0, str(Path(__file__).parent.parent))
+
+from supabase_client import supabase
+
+router = APIRouter()
+logger = logging.getLogger(__name__)
+
+
+class CreateJobRequest(BaseModel):
+    title: str
+    company_name: str
+    description: str
+    required_skills: List[str]
+    experience_years: int
+    hr_id: str
+    hr_email: str
+
+
+@router.post("/create")
+async def create_job(payload: CreateJobRequest):
+    unique_link = str(uuid.uuid4())
+
+    job_data = {
+        "title": payload.title,
+        "company_name": payload.company_name,
+        "description": payload.description,
+        "required_skills": payload.required_skills,
+        "experience_years": payload.experience_years,
+        "hr_id": payload.hr_id,
+        "hr_email": payload.hr_email,
+        "unique_link": unique_link,
+        "is_active": True,
+    }
+
+    try:
+        response = supabase.table("jobs").insert(job_data).execute()
+    except Exception as exc:
+        logger.error("Failed to create job in Supabase: %s", exc)
+        raise HTTPException(status_code=500, detail="Failed to create job posting.")
+
+    if not response.data:
+        raise HTTPException(status_code=500, detail="Job creation returned no data.")
+
+    created_job = response.data[0]
+    logger.info("Job created: id=%s title=%s", created_job.get("id"), payload.title)
+    return {
+        "success": True,
+        "job": created_job,
+        "unique_link": unique_link,
+        "application_url": f"/apply/{unique_link}"
+    }
+
+
+@router.get("/{job_id}")
+async def get_job(job_id: str):
+    try:
+        response = supabase.table("jobs").select("*").eq("unique_link", job_id).execute()
+        if not response.data:
+            response = supabase.table("jobs").select("*").eq("id", job_id).execute()
+    except Exception as exc:
+        logger.error("Failed to fetch job %s: %s", job_id, exc)
+        raise HTTPException(status_code=500, detail="Failed to retrieve job details.")
+
+    if not response.data:
+        raise HTTPException(status_code=404, detail="Job not found.")
+
+    return {"success": True, "job": response.data[0]}
+
+
+@router.get("/hr/{hr_id}")
+async def get_hr_jobs(hr_id: str):
+    try:
+        jobs_response = (
+            supabase.table("jobs")
+            .select("*")
+            .eq("hr_id", hr_id)
+            .order("created_at", desc=True)
+            .execute()
+        )
+    except Exception as exc:
+        logger.error("Failed to fetch jobs for hr_id=%s: %s", hr_id, exc)
+        raise HTTPException(status_code=500, detail="Failed to retrieve jobs.")
+
+    jobs = jobs_response.data or []
+
+    enriched_jobs = []
+    for job in jobs:
+        job_id = job.get("id")
+        try:
+            count_response = (
+                supabase.table("applications")
+                .select("id", count="exact")
+                .eq("job_id", job_id)
+                .execute()
+            )
+            applicant_count = count_response.count if count_response.count is not None else 0
+        except Exception as exc:
+            logger.warning("Could not fetch applicant count for job %s: %s", job_id, exc)
+            applicant_count = 0
+
+        enriched_jobs.append({**job, "applicant_count": applicant_count})
+
+    return {"success": True, "jobs": enriched_jobs, "total": len(enriched_jobs)}

supabase_client.py

@@ -0,0 +1,13 @@
+from supabase import create_client, Client
+from dotenv import load_dotenv
+import os
+
+load_dotenv()
+
+SUPABASE_URL = os.getenv("SUPABASE_URL")
+SUPABASE_SERVICE_KEY = os.getenv("SUPABASE_SERVICE_ROLE_KEY")
+
+if not SUPABASE_URL or not SUPABASE_SERVICE_KEY:
+    raise ValueError("SUPABASE_URL and SUPABASE_SERVICE_ROLE_KEY must be set in environment variables")
+
+supabase: Client = create_client(SUPABASE_URL, SUPABASE_SERVICE_KEY)