Prepare branch for merge to main

- Fix build issues with SSR and useSearchParams
- Update README.md with comprehensive project documentation
- Move debug pages to debug-disabled folder (temporary)
- Fix authentication pages with Suspense boundaries
- Add dynamic imports for map components
- Ensure all pages build successfully

This commit prepares the auth2 branch for merging into main by:
1. Resolving all build errors
2. Adding proper SSR handling for client-side components
3. Updating documentation to reflect current state
4. Moving debug/test pages out of production build

src/components/ui/ClientProjectMap.js

@@ -0,0 +1,15 @@
+"use client";
+
+import dynamic from "next/dynamic";
+
+const ProjectMap = dynamic(
+  () => import("@/components/ui/ProjectMap"),
+  {
+    ssr: false,
+    loading: () => <div className="flex items-center justify-center h-96">Loading map...</div>
+  }
+);
+
+export default function ClientProjectMap(props) {
+  return <ProjectMap {...props} />;
+}