feat: Add job search coaching tips based on user behavior"

backend/app/api/routes/coaching.py

@@ -0,0 +1,173 @@
+"""
+Smart coaching - analyzes user's job search behavior and provides actionable tips.
+"""
+from datetime import datetime, timedelta, timezone
+
+from fastapi import APIRouter
+from sqlalchemy import func, select
+
+from app.api.deps import CurrentUser, DBSession
+from app.models.application import Application
+from app.models.job import SavedJob
+from app.models.user import Profile
+
+router = APIRouter(prefix="/coaching", tags=["coaching"])
+
+
+@router.get("/tips")
+async def get_coaching_tips(db: DBSession, user: CurrentUser):
+    """
+    Analyze job search behavior and return personalized coaching tips.
+    Based on patterns in applications, saved jobs, and profile completeness.
+    """
+    now = datetime.now(timezone.utc)
+    week_ago = now - timedelta(days=7)
+    month_ago = now - timedelta(days=30)
+
+    tips = []
+
+    # Check profile completeness
+    profile_result = await db.execute(select(Profile).where(Profile.user_id == user.id))
+    profile = profile_result.scalar_one_or_none()
+
+    if not profile or not profile.headline:
+        tips.append({
+            "priority": "high",
+            "category": "profile",
+            "tip": "Complete your profile headline",
+            "detail": "Profiles with headlines get 3x better AI recommendations. Add a clear headline like 'Senior Frontend Engineer'.",
+            "action_url": "/profile",
+        })
+
+    if not profile or not profile.skills or len(profile.skills) < 5:
+        tips.append({
+            "priority": "high",
+            "category": "profile",
+            "tip": "Add more skills to your profile",
+            "detail": "The AI recommendation engine uses your skills to match jobs. Add at least 8-10 key skills.",
+            "action_url": "/profile",
+        })
+
+    if not profile or not profile.experience:
+        tips.append({
+            "priority": "high",
+            "category": "profile",
+            "tip": "Add your work experience",
+            "detail": "Experience data powers resume tailoring and interview prep. Even 1-2 roles help significantly.",
+            "action_url": "/profile",
+        })
+
+    # Application frequency
+    weekly_apps = await db.scalar(
+        select(func.count(Application.id)).where(
+            Application.user_id == user.id, Application.created_at >= week_ago
+        )
+    ) or 0
+
+    monthly_apps = await db.scalar(
+        select(func.count(Application.id)).where(
+            Application.user_id == user.id, Application.created_at >= month_ago
+        )
+    ) or 0
+
+    if weekly_apps == 0 and monthly_apps > 0:
+        tips.append({
+            "priority": "medium",
+            "category": "consistency",
+            "tip": "You haven't applied to anything this week",
+            "detail": "Consistency beats volume. Try to apply to 3-5 quality jobs per week to maintain momentum.",
+            "action_url": "/jobs",
+        })
+    elif monthly_apps == 0:
+        tips.append({
+            "priority": "high",
+            "category": "action",
+            "tip": "Start applying!",
+            "detail": "You haven't applied to any jobs yet. Browse jobs and start with roles you're most excited about.",
+            "action_url": "/jobs",
+        })
+    elif weekly_apps > 15:
+        tips.append({
+            "priority": "medium",
+            "category": "quality",
+            "tip": "Consider quality over quantity",
+            "detail": f"You applied to {weekly_apps} jobs this week. Try tailoring your resume for your top 5 picks instead of spray-and-pray.",
+            "action_url": "/resume",
+        })
+
+    # Check response rate
+    total_apps = await db.scalar(
+        select(func.count(Application.id)).where(Application.user_id == user.id)
+    ) or 0
+
+    if total_apps >= 10:
+        responded = await db.scalar(
+            select(func.count(Application.id)).where(
+                Application.user_id == user.id,
+                Application.status.in_(("screening", "interviewing", "offer", "accepted", "rejected")),
+            )
+        ) or 0
+
+        response_rate = (responded / total_apps) * 100
+        if response_rate < 15:
+            tips.append({
+                "priority": "high",
+                "category": "resume",
+                "tip": "Low response rate - review your resume",
+                "detail": f"Your response rate is {response_rate:.0f}%. Industry average is 15-25%. Try the ATS checker to optimize keywords.",
+                "action_url": "/ats-checker",
+            })
+
+    # Check saved jobs not applied
+    saved_count = await db.scalar(
+        select(func.count(SavedJob.id)).where(SavedJob.user_id == user.id)
+    ) or 0
+
+    if saved_count > 10 and weekly_apps < 3:
+        tips.append({
+            "priority": "medium",
+            "category": "action",
+            "tip": f"You have {saved_count} saved jobs — time to apply!",
+            "detail": "Saved jobs expire. Review your saved list and apply to your top choices this week.",
+            "action_url": "/saved",
+        })
+
+    # Ghosted applications
+    ghosted = await db.scalar(
+        select(func.count(Application.id)).where(
+            Application.user_id == user.id, Application.status == "ghosted"
+        )
+    ) or 0
+
+    if ghosted >= 3:
+        tips.append({
+            "priority": "low",
+            "category": "follow_up",
+            "tip": f"{ghosted} applications marked as ghosted",
+            "detail": "Getting ghosted is normal. Consider sending a brief follow-up email 7 days after applying.",
+            "action_url": "/applications",
+        })
+
+    # Networking tip
+    if total_apps >= 5 and not tips:
+        tips.append({
+            "priority": "low",
+            "category": "networking",
+            "tip": "Boost your odds with networking",
+            "detail": "Referrals have 5-10x higher success rates. Use the Networking page to draft outreach messages.",
+            "action_url": "/networking",
+        })
+
+    # Sort by priority
+    priority_order = {"high": 0, "medium": 1, "low": 2}
+    tips.sort(key=lambda t: priority_order.get(t["priority"], 99))
+
+    return {
+        "tips": tips[:5],  # Max 5 tips
+        "stats": {
+            "weekly_applications": weekly_apps,
+            "monthly_applications": monthly_apps,
+            "total_applications": total_apps,
+            "saved_jobs": saved_count,
+        },
+    }