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/hooks/use-feature-flag.ts

@@ -0,0 +1,18 @@
+'use client';
+
+import { useQuery } from '@tanstack/react-query';
+
+import { apiFetch } from '@/lib/api/client';
+
+/**
+ * Returns true when the given feature flag is enabled for the current port.
+ * Result is cached for 5 minutes.
+ */
+export function useFeatureFlag(key: string): boolean {
+  const { data } = useQuery<{ enabled: boolean }>({
+    queryKey: ['feature-flag', key],
+    queryFn: () => apiFetch(`/api/v1/settings/feature-flag?key=${encodeURIComponent(key)}`),
+    staleTime: 300_000, // 5 min
+  });
+  return data?.enabled ?? false;
+}