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

frontend/src/components/ai/AiAlertBanner.tsx

@@ -0,0 +1,80 @@
+import { useState } from "react";
+import { useQuery } from "@tanstack/react-query";
+import { AlertTriangle, X, Sparkles, Loader2 } from "lucide-react";
+import { Button } from "@/components/ui/button";
+import { analyticsService } from "@/services/analytics.service";
+
+export default function AiAlertBanner() {
+  const [dismissedIds, setDismissedIds] = useState<Set<string>>(() => new Set());
+  const [errorDismissed, setErrorDismissed] = useState(false);
+
+  const { data: alerts, isLoading, isError, error } = useQuery({
+    queryKey: ["ai", "alerts"],
+    queryFn: () => analyticsService.getAlerts(),
+  });
+
+  const visible = alerts?.filter((a) => !dismissedIds.has(a.id)) ?? [];
+
+  if (isLoading) {
+    return (
+      <div className="rounded-lg border border-warning/30 bg-warning/10 p-4 flex items-center gap-3">
+        <Loader2 className="h-5 w-5 animate-spin text-warning shrink-0" />
+        <p className="text-sm text-muted-foreground">Loading alerts…</p>
+      </div>
+    );
+  }
+
+  if (isError && !errorDismissed) {
+    return (
+      <div className="rounded-lg border border-warning/30 bg-warning/10 p-4 flex items-start gap-3">
+        <AlertTriangle className="h-5 w-5 text-warning shrink-0 mt-0.5" />
+        <div className="flex-1">
+          <p className="text-sm font-medium flex items-center gap-1">
+            <Sparkles className="h-3 w-3 text-primary" /> Alerts unavailable
+          </p>
+          <p className="text-sm text-muted-foreground mt-1">{error instanceof Error ? error.message : "Could not load alerts."}</p>
+        </div>
+        <Button variant="ghost" size="icon" className="h-7 w-7 shrink-0" onClick={() => setErrorDismissed(true)}>
+          <X className="h-4 w-4" />
+        </Button>
+      </div>
+    );
+  }
+
+  if (isError && errorDismissed) return null;
+
+  if (!alerts?.length) {
+    return (
+      <div className="rounded-lg border border-muted bg-muted/20 p-4 flex items-start gap-3">
+        <Sparkles className="h-5 w-5 text-muted-foreground shrink-0 mt-0.5" />
+        <p className="text-sm text-muted-foreground">No AI alerts right now.</p>
+      </div>
+    );
+  }
+
+  if (!visible.length) return null;
+
+  return (
+    <div className="space-y-3">
+      {visible.map((alert) => (
+        <div key={alert.id} className="rounded-lg border border-warning/30 bg-warning/10 p-4 flex items-start gap-3">
+          <AlertTriangle className="h-5 w-5 text-warning shrink-0 mt-0.5" />
+          <div className="flex-1">
+            <p className="text-sm font-medium flex items-center gap-1">
+              <Sparkles className="h-3 w-3 text-primary" /> {alert.title}
+            </p>
+            <p className="text-sm text-muted-foreground mt-1">{alert.description}</p>
+          </div>
+          <Button
+            variant="ghost"
+            size="icon"
+            className="h-7 w-7 shrink-0"
+            onClick={() => setDismissedIds((prev) => new Set(prev).add(alert.id))}
+          >
+            <X className="h-4 w-4" />
+          </Button>
+        </div>
+      ))}
+    </div>
+  );
+}