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/context/ComparisonContext.tsx

@@ -0,0 +1,32 @@
+/**
+ * ComparisonContext
+ * Global state for school comparison basket
+ */
+
+'use client';
+
+import { createContext, useContext } from 'react';
+import type { School } from '@/lib/types';
+
+interface ComparisonContextType {
+  selectedSchools: School[];
+  comparisonData: any;
+  isLoading: boolean;
+  error: any;
+  addSchool: (school: School) => void;
+  removeSchool: (urn: number) => void;
+  clearAll: () => void;
+  isSelected: (urn: number) => boolean;
+  canAddMore: boolean;
+  mutate: () => void;
+}
+
+export const ComparisonContext = createContext<ComparisonContextType | undefined>(undefined);
+
+export function useComparisonContext() {
+  const context = useContext(ComparisonContext);
+  if (!context) {
+    throw new Error('useComparisonContext must be used within ComparisonProvider');
+  }
+  return context;
+}

nextjs-app/context/ComparisonProvider.tsx

@@ -0,0 +1,19 @@
+/**
+ * ComparisonProvider
+ * Provides comparison state to all components
+ */
+
+'use client';
+
+import { useComparison } from '@/hooks/useComparison';
+import { ComparisonContext } from './ComparisonContext';
+
+export function ComparisonProvider({ children }: { children: React.ReactNode }) {
+  const comparisonState = useComparison();
+
+  return (
+    <ComparisonContext.Provider value={comparisonState}>
+      {children}
+    </ComparisonContext.Provider>
+  );
+}