feat(v3): restructure project + add complete frontend

- Restructure: move backend from new_project/ to backend/ - Add full React/TypeScript frontend (37 pages, 17 services, 16 type defs, 11 query hooks) - Add docs/ with SRS specs, user stories, and workflow documentation - Update .gitignore for new directory layout Workflows implemented: WF1 User Signup, WF2 Placement Test, WF3 Exam Configuration, WF4 General English Exam, WF5 Course Generation, WF6 Entity Student Onboarding, AI Course Generation, Adaptive Learning Engine UI, White-Label Branding, Score Release Made-with: Cursor
2026-04-10 17:26:42 +04:00
commit 11a7265460
392 changed files with 62287 additions and 0 deletions
--- a/src/components/ai/AiInsightsPanel.tsx
+++ b/src/components/ai/AiInsightsPanel.tsx
@@ -0,0 +1,105 @@
+import { useEffect, useMemo } from "react";
+import { useMutation } from "@tanstack/react-query";
+import { Card, CardContent, CardHeader, CardTitle } from "@/components/ui/card";
+import { Sparkles, TrendingUp, AlertTriangle, Trophy, Loader2 } from "lucide-react";
+import { analyticsService } from "@/services/analytics.service";
+import type { AiInsight } from "@/types";
+import { useToast } from "@/hooks/use-toast";
+
+const EMPTY_PAYLOAD: Record<string, unknown> = {};
+
+function insightIcon(type: AiInsight["type"]) {
+  switch (type) {
+    case "positive":
+      return Trophy;
+    case "warning":
+      return AlertTriangle;
+    default:
+      return TrendingUp;
+  }
+}
+
+function insightColor(type: AiInsight["type"]) {
+  switch (type) {
+    case "positive":
+      return "text-primary";
+    case "warning":
+      return "text-warning";
+    default:
+      return "text-success";
+  }
+}
+
+interface Props {
+  data?: Record<string, unknown>;
+}
+
+export default function AiInsightsPanel({ data = EMPTY_PAYLOAD }: Props) {
+  const { toast } = useToast();
+  const payloadKey = useMemo(() => JSON.stringify(data), [data]);
+
+  const mutation = useMutation({
+    mutationFn: (payload: Record<string, unknown>) => analyticsService.getInsights(payload),
+    onError: (err: Error) => {
+      toast({
+        title: "Insights unavailable",
+        description: err.message || "Could not load AI insights.",
+        variant: "destructive",
+      });
+    },
+  });
+
+  useEffect(() => {
+    mutation.mutate(data);
+    // eslint-disable-next-line react-hooks/exhaustive-deps -- refetch when serialized payload changes
+  }, [payloadKey]);
+
+  const items = mutation.data ?? [];
+
+  return (
+    <Card className="border-0 shadow-sm">
+      <CardHeader className="pb-3">
+        <CardTitle className="text-base font-semibold flex items-center gap-2">
+          <Sparkles className="h-4 w-4 text-primary" />
+          AI Platform Insights
+        </CardTitle>
+      </CardHeader>
+      <CardContent>
+        {mutation.isPending && (
+          <div className="flex items-center gap-2 text-sm text-muted-foreground py-8 justify-center">
+            <Loader2 className="h-5 w-5 animate-spin text-primary" />
+            Loading insights…
+          </div>
+        )}
+        {mutation.isError && !mutation.isPending && (
+          <p className="text-sm text-muted-foreground py-4 text-center">Could not load insights.</p>
+        )}
+        {mutation.isSuccess && items.length === 0 && (
+          <p className="text-sm text-muted-foreground py-4 text-center">No insights available for this view.</p>
+        )}
+        {!mutation.isPending && items.length > 0 && (
+          <div className="grid grid-cols-1 md:grid-cols-3 gap-4">
+            {items.map((item) => {
+              const Icon = insightIcon(item.type);
+              const color = insightColor(item.type);
+              return (
+                <div key={item.id} className="rounded-lg border bg-muted/30 p-4">
+                  <div className="flex items-center gap-2 mb-2">
+                    <Icon className={`h-4 w-4 ${color}`} />
+                    <span className="text-sm font-semibold">{item.title}</span>
+                  </div>
+                  <p className="text-sm text-muted-foreground">{item.description}</p>
+                  {item.metric != null && item.value != null && (
+                    <p className="text-xs text-muted-foreground mt-2">
+                      {item.metric}: {item.value}
+                    </p>
+                  )}
+                </div>
+              );
+            })}
+          </div>
+        )}
+      </CardContent>
+    </Card>
+  );
+}