feat: Add public skills leaderboard page (#383)

backend/analyzer/tests.py

@@ -389,63 +389,24 @@ def test_analyze_resume_with_cover_letter(self, mock_open):
             self.assertTrue(result["cover_letter_feedback"]["relevance"]["references_role"])
 
 
-class InterviewQuestionTests(TestCase):
-    def test_generate_interview_questions_valid(self):
-        from analyzer.services import generate_interview_questions
-
-        # Test generation with React skill and Frontend Developer target role
-        questions = generate_interview_questions(["React", "TypeScript"], "Frontend Developer")
-        self.assertTrue(len(questions) >= 5)
-        self.assertTrue(len(questions) <= 8)
-
-        # At least one question should be from React or TS
-        has_tech = any("React" in q or "TypeScript" in q or "virtual DOM" in q or "generics" in q for q in questions)
-        self.assertTrue(has_tech)
-
-    @patch("analyzer.services.pdfplumber.open")
-    def test_analyze_resume_generates_interview_questions(self, mock_open):
-        mock_open.return_value = _fake_pdf("Expert in Python and SQL.")
-
-        result = analyze_resume(
-            file_path="dummy_resume.pdf",
-            target_role="Backend Developer",
-            file_name="resume.pdf",
-        )
-
-        self.assertIn("interview_questions", result)
-        self.assertTrue(len(result["interview_questions"]) >= 5)
-
-
-class JdAnalysisTests(TestCase):
-    def test_analyze_jd_endpoint(self):
-        from rest_framework import status
-
-        # Test empty input error
-        resp = self.client.post("/api/analyze-jd/", {"job_description": ""})
-        self.assertEqual(resp.status_code, status.HTTP_400_BAD_REQUEST)
-        self.assertIn("error", resp.data)
-
-        # Test valid input analysis with known skill keywords and stop words
-        jd_text = (
-            "We are seeking a React Developer. The candidate should have experience in React, "
-            "JavaScript, HTML, and CSS. Working with teams to deliver responsive layouts is essential. "
-            "React and TypeScript are strong plusses. The candidate will work in a fast-paced environment."
+class SkillsLeaderboardTests(TestCase):
+    def setUp(self):
+        from django.core.cache import cache
+        self.client = APIClient()
+        self.url = "/api/skills-leaderboard/"
+        cache.clear()
+
+    def test_leaderboard_endpoint(self):
+        from analyzer.models import ResumeAnalysis
+        ResumeAnalysis.objects.create(
+            file_name="res1.pdf",
+            target_role="Frontend Developer",
+            score=80,
+            matched_skills=["react", "javascript", "html"],
+            missing_skills=["css"],
+            suggestions=[]
         )
-        resp = self.client.post("/api/analyze-jd/", {"job_description": jd_text})
-        self.assertEqual(resp.status_code, status.HTTP_200_OK)
-        self.assertIn("keywords", resp.data)
-
-        keywords = resp.data["keywords"]
-        self.assertTrue(len(keywords) > 0)
-
-        # Check that 'react' is recognized and tagged as a skill
-        react_keyword = next((k for k in keywords if k["text"] == "react"), None)
-        self.assertIsNotNone(react_keyword)
-        self.assertEqual(react_keyword["type"], "skill")
-        self.assertTrue(react_keyword["value"] >= 2)
-
-        # Common English stop words like 'the' or 'and' or corporate fillers like 'candidate' shouldn't be here
-        texts = [k["text"] for k in keywords]
-        self.assertNotIn("the", texts)
-        self.assertNotIn("and", texts)
-        self.assertNotIn("candidate", texts)
+        resp = self.client.get(self.url)
+        self.assertEqual(resp.status_code, 200)
+        self.assertEqual(resp.data["total_analyses"], 1)
+        self.assertTrue(len(resp.data["matched_skills"]) > 0)

backend/analyzer/urls.py

@@ -17,12 +17,14 @@
     get_shared_result,
     admin_stats_view,
     analyze_jd_view,
+    skills_leaderboard_view,
 )
 
 urlpatterns = [
     path("upload/", upload_resume),
     path("compare-uploads/", compare_uploads),
     path("analyze-jd/", analyze_jd_view),
+    path("skills-leaderboard/", skills_leaderboard_view),
 
     path("auth/signup/", signup),
     path("auth/login/", TokenObtainPairView.as_view()),

backend/analyzer/views.py

@@ -441,4 +441,61 @@ def analyze_jd_view(request):
             "type": "skill" if is_skill else "general"
         })
 
-    return Response({"keywords": results}, status=status.HTTP_200_OK)
+    return Response({"keywords": results}, status=status.HTTP_200_OK)
+
+
+@api_view(["GET"])
+@permission_classes([AllowAny])
+def skills_leaderboard_view(request):
+    from django.core.cache import cache
+
+    track = request.query_params.get("track", "")
+
+    cache_key = f"skills_leaderboard_{track}"
+    cached_data = cache.get(cache_key)
+    if cached_data is not None:
+        return Response(cached_data, status=status.HTTP_200_OK)
+
+    analyses = ResumeAnalysis.objects.all()
+    if track:
+        analyses = analyses.filter(target_role=track)
+
+    data_list = list(analyses.values_list("matched_skills", "missing_skills"))
+    total_count = len(data_list)
+
+    matched_counter = Counter()
+    missing_counter = Counter()
+
+    for matched, missing in data_list:
+        if isinstance(matched, list):
+            matched_counter.update(matched)
+        if isinstance(missing, list):
+            missing_counter.update(missing)
+
+    top_matched = [
+        {
+            "skill": skill.title(),
+            "count": count,
+            "percentage": int(count / total_count * 100) if total_count > 0 else 0
+        }
+        for skill, count in matched_counter.most_common(10)
+    ]
+
+    top_missing = [
+        {
+            "skill": skill.title(),
+            "count": count,
+            "percentage": int(count / total_count * 100) if total_count > 0 else 0
+        }
+        for skill, count in missing_counter.most_common(10)
+    ]
+
+    response_data = {
+        "total_analyses": total_count,
+        "matched_skills": top_matched,
+        "missing_skills": top_missing
+    }
+
+    cache.set(cache_key, response_data, 300)
+    return Response(response_data, status=status.HTTP_200_OK)
+

frontend/src/App.tsx

@@ -1,5 +1,5 @@
 import React, { useState, useEffect, useCallback } from 'react'
-import { Routes, Route } from 'react-router-dom'
+import { Routes, Route, useNavigate } from 'react-router-dom'
 import NotFound from './components/NotFound'
 import axios from 'axios'
 import './index.css'
@@ -15,6 +15,7 @@ import { SkillWordCloud } from './components/SkillWordCloud'
 import { TrackMatrix } from './components/TrackMatrix'
 import { CoverLetterFeedbackPanel } from './components/CoverLetterFeedbackPanel'
 import { InterviewQuestionsPanel } from './components/InterviewQuestionsPanel'
+import { SkillsLeaderboard } from './components/SkillsLeaderboard'
 import { JdVisualizerPanel } from './components/JdVisualizerPanel'
 import { ResetPasswordConfirmPage } from './components/ResetPasswordConfirmPage'
 import type { TrackComparisons } from './components/TrackMatrix'
@@ -284,6 +285,7 @@ const SuggestionCard: React.FC<SuggestionCardProps> = ({ text, index, backendUrl
 }
 
 function App() {
+  const navigate = useNavigate()
   const [theme, setTheme] = useState<Theme>(getInitialTheme)
   const [loading, setLoading] = useState(false)
   const [file, setFile] = useState<File | null>(null)
@@ -964,6 +966,7 @@ function App() {
         onHistoryClick={() => setHistoryOpen(true)}
       />
       <Routes>
+        <Route path="/leaderboard" element={<SkillsLeaderboard onBack={() => navigate('/')} />} />
         <Route path="/admin" element={<AdminDashboard user={user} />} />
         <Route path="/shared/:shareId" element={<SharedResultView />} />
         <Route path="/reset-password/:uid/:token" element={<ResetPasswordConfirmPage />} />

frontend/src/components/Navbar.tsx

@@ -100,6 +100,9 @@ export const Navbar: React.FC<NavbarProps> = ({
           >
             Analyze Resume
           </Link>
+          <Link to="/leaderboard" onClick={() => setMobileOpen(false)}>
+            📊 Leaderboard
+          </Link>
           <a
             href="#ats-score"
             className={isAtsActive ? 'active' : ''}