From d62ae97c98d8272df4f792c2e4d1ee25fdc884c8 Mon Sep 17 00:00:00 2001
From: Nanfe Yarnap <120315173+Nanfe01@users.noreply.github.com>
Date: Sat, 25 Apr 2026 17:35:15 +0000
Subject: [PATCH 1/4] feat(frontend): implement follow system UI with hooks and
 components

---
 src/components/follow/follow.api.ts | 91 +++++++++++++++++++++++++++++
 1 file changed, 91 insertions(+)
 create mode 100644 src/components/follow/follow.api.ts

diff --git a/src/components/follow/follow.api.ts b/src/components/follow/follow.api.ts
new file mode 100644
index 0000000..72d768c
--- /dev/null
+++ b/src/components/follow/follow.api.ts
@@ -0,0 +1,91 @@
+import React, { useEffect, useState } from 'react';
+
+interface Props {
+  userId: string; // target user
+}
+
+const FollowCard: React.FC<Props> = ({ userId }) => {
+  const [isFollowing, setIsFollowing] = useState(false);
+  const [followers, setFollowers] = useState(0);
+  const [loading, setLoading] = useState(false);
+
+  // 🔹 Fetch initial data
+  useEffect(() => {
+    const fetchData = async () => {
+      try {
+        const [statusRes, countRes] = await Promise.all([
+          fetch(`/api/follow/status/${userId}`),
+          fetch(`/api/follow/count/${userId}`),
+        ]);
+
+        const status = await statusRes.json();
+        const counts = await countRes.json();
+
+        setIsFollowing(status);
+        setFollowers(counts.followers);
+      } catch (err) {
+        console.error(err);
+      }
+    };
+
+    fetchData();
+  }, [userId]);
+
+  // 🔹 Handle follow/unfollow
+  const handleSubmit = async (e: React.FormEvent) => {
+    e.preventDefault();
+    setLoading(true);
+
+    try {
+      if (isFollowing) {
+        await fetch(`/api/follow/${userId}`, {
+          method: 'DELETE',
+        });
+
+        setIsFollowing(false);
+        setFollowers((prev) => prev - 1); // optimistic
+      } else {
+        await fetch(`/api/follow`, {
+          method: 'POST',
+          headers: { 'Content-Type': 'application/json' },
+          body: JSON.stringify({ userId }),
+        });
+
+        setIsFollowing(true);
+        setFollowers((prev) => prev + 1); // optimistic
+      }
+    } catch (err) {
+      console.error(err);
+    } finally {
+      setLoading(false);
+    }
+  };
+
+  return (
+    <div className="bg-gray-900 text-white p-4 rounded-xl w-fit">
+      <p className="text-sm mb-2">
+        <strong>{followers}</strong> Followers
+      </p>
+
+      <form onSubmit={handleSubmit}>
+        <button
+          type="submit"
+          disabled={loading}
+          className={`px-4 py-2 rounded-lg text-sm font-medium transition ${
+            isFollowing
+              ? 'bg-gray-700'
+              : 'bg-green-600 hover:bg-green-500'
+          }`}
+        >
+          {loading
+            ? 'Processing...'
+            : isFollowing
+            ? 'Unfollow'
+            : 'Follow'}
+        </button>
+      </form>
+    </div>
+  );
+};
+
+export default FollowCard;
\ No newline at end of file

From 85275966900cccf0cee43dcb24a56b3e981d26d0 Mon Sep 17 00:00:00 2001
From: Nanfe Yarnap <120315173+Nanfe01@users.noreply.github.com>
Date: Sat, 25 Apr 2026 17:47:51 +0000
Subject: [PATCH 2/4] feat(frontend): implement quiz result feedback UI

---
 src/components/QuizResult.tsx | 100 ++++++++++++++++++++++++++++++++++
 1 file changed, 100 insertions(+)
 create mode 100644 src/components/QuizResult.tsx

diff --git a/src/components/QuizResult.tsx b/src/components/QuizResult.tsx
new file mode 100644
index 0000000..eb645cb
--- /dev/null
+++ b/src/components/QuizResult.tsx
@@ -0,0 +1,100 @@
+import React from 'react';
+
+type QuestionResult = {
+  question: string;
+  options: string[];
+  correctAnswer: string;
+  selectedAnswer: string;
+  explanation: string;
+};
+
+interface Props {
+  results: QuestionResult[];
+}
+
+const QuizResult: React.FC<Props> = ({ results }) => {
+  const total = results.length;
+  const correctCount = results.filter(
+    (q) => q.selectedAnswer === q.correctAnswer
+  ).length;
+
+  const scorePercent = Math.round((correctCount / total) * 100);
+
+  return (
+    <div className="bg-gray-900 text-white p-6 rounded-xl max-w-3xl mx-auto">
+      {/* 🔹 Score Summary */}
+      <div className="mb-6 border-b border-gray-700 pb-4">
+        <h2 className="text-xl font-semibold">Quiz Results</h2>
+        <p className="text-sm text-gray-400 mt-1">
+          You got <strong>{correctCount}</strong> out of{' '}
+          <strong>{total}</strong> correct
+        </p>
+
+        <div className="mt-3">
+          <div className="w-full bg-gray-700 rounded-full h-3">
+            <div
+              className="bg-green-500 h-3 rounded-full"
+              style={{ width: `${scorePercent}%` }}
+            />
+          </div>
+          <p className="text-sm mt-1">{scorePercent}% Score</p>
+        </div>
+      </div>
+
+      {/* 🔹 Questions Review */}
+      <div className="space-y-6">
+        {results.map((q, index) => {
+          const isCorrect = q.selectedAnswer === q.correctAnswer;
+
+          return (
+            <div
+              key={index}
+              className="p-4 rounded-lg border border-gray-700"
+            >
+              <p className="font-medium mb-3">
+                {index + 1}. {q.question}
+              </p>
+
+              <div className="space-y-2">
+                {q.options.map((option, i) => {
+                  const isSelected = option === q.selectedAnswer;
+                  const isCorrectOption = option === q.correctAnswer;
+
+                  let className = 'block px-3 py-2 rounded-md text-sm';
+
+                  if (isCorrectOption) {
+                    className += ' bg-green-600/30 border border-green-500';
+                  } else if (isSelected && !isCorrect) {
+                    className += ' bg-red-600/30 border border-red-500';
+                  } else {
+                    className += ' bg-gray-800';
+                  }
+
+                  return (
+                    <div key={i} className={className}>
+                      {option}
+                    </div>
+                  );
+                })}
+              </div>
+
+              {/* 🔹 Explanation */}
+              <div className="mt-3 text-sm text-gray-300">
+                <p>
+                  <strong>
+                    {isCorrect ? 'Correct ✅' : 'Incorrect ❌'}
+                  </strong>
+                </p>
+                <p className="mt-1 text-gray-400">
+                  {q.explanation}
+                </p>
+              </div>
+            </div>
+          );
+        })}
+      </div>
+    </div>
+  );
+};
+
+export default QuizResult;
\ No newline at end of file

From 73a8fc036ae66bbbbb783662f1de859f70437b58 Mon Sep 17 00:00:00 2001
From: Nanfe Yarnap <120315173+Nanfe01@users.noreply.github.com>
Date: Sat, 25 Apr 2026 18:07:04 +0000
Subject: [PATCH 3/4] feat(quiz): implement hint reveal system with usage
 tracking

---
 src/components/HintBox.tsx | 37 +++++++++++++++++++++++++++++++++++++
 1 file changed, 37 insertions(+)
 create mode 100644 src/components/HintBox.tsx

diff --git a/src/components/HintBox.tsx b/src/components/HintBox.tsx
new file mode 100644
index 0000000..5a5931c
--- /dev/null
+++ b/src/components/HintBox.tsx
@@ -0,0 +1,37 @@
+// HintBox.tsx
+import React from 'react';
+
+interface Props {
+  hint?: string;
+  revealed: boolean;
+  onReveal: () => void;
+  penalty?: number;
+}
+
+const HintBox: React.FC<Props> = ({
+  hint,
+  revealed,
+  onReveal,
+  penalty = 0,
+}) => {
+  if (!hint) return null;
+
+  return (
+    <div className="mt-3">
+      {!revealed ? (
+        <button
+          onClick={onReveal}
+          className="text-sm text-yellow-400 hover:underline"
+        >
+          💡 Show Hint {penalty > 0 && `( -${penalty} pts )`}
+        </button>
+      ) : (
+        <div className="bg-yellow-500/10 border border-yellow-500 p-3 rounded-md text-sm text-yellow-200">
+          {hint}
+        </div>
+      )}
+    </div>
+  );
+};
+
+export default HintBox;
\ No newline at end of file

From 17253fd8f5d3b6d31c449808d7b968d1eecd9977 Mon Sep 17 00:00:00 2001
From: Nanfe Yarnap <120315173+Nanfe01@users.noreply.github.com>
Date: Sat, 25 Apr 2026 18:12:07 +0000
Subject: [PATCH 4/4] feat(analytics): implement quiz performance analytics
 dashboard

---
 src/components/AnalyticsDashboard.tsx | 32 +++++++++++++++++++++++++++
 1 file changed, 32 insertions(+)
 create mode 100644 src/components/AnalyticsDashboard.tsx

diff --git a/src/components/AnalyticsDashboard.tsx b/src/components/AnalyticsDashboard.tsx
new file mode 100644
index 0000000..d592f69
--- /dev/null
+++ b/src/components/AnalyticsDashboard.tsx
@@ -0,0 +1,32 @@
+// AnalyticsDashboard.tsx
+import QuestionBreakdown from './QuestionBreakdown';
+import TopicPerformance from './TopicPerformance';
+import ScoreChart from './ScoreChart';
+import ExportButton from './ExportButton';
+import { groupByTopic } from '../utils/analytics.helpers';
+
+const AnalyticsDashboard = ({ questions }) => {
+  const topics = groupByTopic(questions);
+
+  return (
+    <div className="bg-gray-900 text-white p-6 rounded-xl space-y-6">
+      <div className="flex justify-between items-center">
+        <h2 className="text-xl font-semibold">
+          Test Analytics
+        </h2>
+        <ExportButton data={questions} />
+      </div>
+
+      {/* 🔹 Chart */}
+      <ScoreChart data={topics} />
+
+      {/* 🔹 Topic Performance */}
+      <TopicPerformance topics={topics} />
+
+      {/* 🔹 Question Breakdown */}
+      <QuestionBreakdown questions={questions} />
+    </div>
+  );
+};
+
+export default AnalyticsDashboard;
\ No newline at end of file