Initial commit: Port Nimara CRM (Layers 0-4)

Full CRM rebuild with Next.js 15, TypeScript, Tailwind, Drizzle ORM,
PostgreSQL, Redis, BullMQ, MinIO, and Socket.io. Includes 461 source
files covering clients, berths, interests/pipeline, documents/EOI,
expenses/invoices, email, notifications, dashboard, admin, and
client portal. CI/CD via Gitea Actions with Docker builds.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

src/providers/socket-provider.tsx

@@ -0,0 +1,44 @@
+'use client';
+
+import { createContext, useContext, useEffect, useState, type ReactNode } from 'react';
+import { io, type Socket } from 'socket.io-client';
+
+import { useSession } from '@/lib/auth/client';
+import { usePortStore } from '@/stores/ui-store';
+
+const SocketContext = createContext<Socket | null>(null);
+
+export function SocketProvider({ children }: { children: ReactNode }) {
+  const { data: session } = useSession();
+  const currentPortId = usePortStore((s) => s.currentPortId);
+  const [socket, setSocket] = useState<Socket | null>(null);
+
+  useEffect(() => {
+    if (!session?.user || !currentPortId) return;
+
+    const s = io(process.env.NEXT_PUBLIC_APP_URL!, {
+      path: '/socket.io/',
+      withCredentials: true,
+      auth: { portId: currentPortId },
+      transports: ['websocket', 'polling'],
+    });
+
+    s.on('connect', () => setSocket(s));
+    s.on('disconnect', () => setSocket(null));
+
+    return () => {
+      s.disconnect();
+      setSocket(null);
+    };
+  }, [session?.user, currentPortId]);
+
+  return (
+    <SocketContext.Provider value={socket}>
+      {children}
+    </SocketContext.Provider>
+  );
+}
+
+export function useSocket() {
+  return useContext(SocketContext);
+}