Complete Next.js migration with SSR and Docker deployment

- Migrate from vanilla JavaScript SPA to Next.js 16 with App Router
- Add server-side rendering for all pages (Home, Compare, Rankings)
- Create individual school pages with dynamic routing (/school/[urn])
- Implement Chart.js and Leaflet map integrations
- Add comprehensive SEO with sitemap, robots.txt, and JSON-LD
- Set up Docker multi-service architecture (PostgreSQL, FastAPI, Next.js)
- Update CI/CD pipeline to build both backend and frontend images
- Fix Dockerfile to include devDependencies for TypeScript compilation
- Add Jest testing configuration
- Implement performance optimizations (code splitting, caching)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

nextjs-app/hooks/useSchools.ts

@@ -0,0 +1,46 @@
+/**
+ * Custom hook for fetching schools with SWR
+ */
+
+'use client';
+
+import useSWR from 'swr';
+import { fetcher } from '@/lib/api';
+import type { SchoolsResponse, SchoolSearchParams } from '@/lib/types';
+
+export function useSchools(params: SchoolSearchParams = {}, shouldFetch: boolean = true) {
+  const queryParams = new URLSearchParams();
+
+  Object.entries(params).forEach(([key, value]) => {
+    if (value !== undefined && value !== null && value !== '') {
+      queryParams.set(key, String(value));
+    }
+  });
+
+  const queryString = queryParams.toString();
+  const url = `/schools${queryString ? `?${queryString}` : ''}`;
+
+  const { data, error, isLoading, mutate } = useSWR<SchoolsResponse>(
+    shouldFetch ? url : null,
+    fetcher,
+    {
+      revalidateOnFocus: false,
+      dedupingInterval: 5000, // 5 seconds
+    }
+  );
+
+  return {
+    schools: data?.schools || [],
+    pagination: data ? {
+      page: data.page,
+      page_size: data.page_size,
+      total: data.total,
+      total_pages: data.total_pages,
+    } : null,
+    searchMode: data?.search_mode,
+    locationInfo: data?.location_info,
+    isLoading,
+    error,
+    mutate,
+  };
+}