feat(platform): residential module + admin UI + reliability fixes

Residential platform
- New schema: residentialClients, residentialInterests (separate from
  marina/yacht clients) with migration 0010
- Service layer with CRUD + audit + sockets + per-port portal toggle
- v1 + public API routes (/api/v1/residential/*, /api/public/residential-inquiries)
- List + detail pages with inline editing for clients and interests
- Per-user residentialAccess toggle on userPortRoles (migration 0011)
- Permission keys: residential_clients, residential_interests
- Sidebar nav + role form integration
- Smoke spec covering page loads, UI create flow, public endpoint

Admin & shared UI
- Admin → Forms (form templates CRUD) with validators + service
- Notification preferences page (in-app + email per type)
- Email composition + accounts list + threads view
- Branded auth shell shared across CRM + portal auth surfaces
- Inline editing extended to yacht/company/interest detail pages
- InlineTagEditor + per-entity tags endpoints (yachts, companies)
- Notes service polymorphic across clients/interests/yachts/companies
- Client list columns: yachtCount + companyCount badges
- Reservation file-download via presigned URL (replaces stale <a href>)

Route handler refactor
- Extracted yachts/companies/berths reservation handlers to sibling
  handlers.ts files (Next.js 15 route.ts only allows specific exports)

Reliability fixes
- apiFetch double-stringify bug fixed across 13 components
  (apiFetch already JSON.stringifies its body; passing a stringified
  body produced double-encoded JSON which failed zod validation)
- SocketProvider gated behind useSyncExternalStore-based mount check
  to avoid useSession() SSR crashes under React 19 + Next 15
- apiFetch falls back to URL-pathname → port-id resolution when the
  Zustand store hasn't hydrated yet (fresh contexts, e2e tests)
- CRM invite flow (schema, service, route, email, dev script)
- Dashboard route → [portSlug]/dashboard/page.tsx + redirect
- Document the dev-server restart-after-migration gotcha in CLAUDE.md

Tests
- 5-case residential smoke spec
- Integration test updates for new service signatures

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

src/components/interests/pipeline-board.tsx

@@ -74,7 +74,7 @@ export function PipelineBoard() {
     let newStage = over.id as string;
 
     // If dropped on a card (not a stage), find which stage that card belongs to
-    if (!PIPELINE_STAGES.includes(newStage as typeof PIPELINE_STAGES[number])) {
+    if (!PIPELINE_STAGES.includes(newStage as (typeof PIPELINE_STAGES)[number])) {
       const targetInterest = interests.find((i) => i.id === newStage);
       if (!targetInterest) return;
       newStage = targetInterest.pipelineStage;
@@ -85,23 +85,18 @@ export function PipelineBoard() {
     if (!currentInterest || currentInterest.pipelineStage === newStage) return;
 
     // Optimistic update
-    queryClient.setQueryData<{ data: InterestRow[] }>(
-      ['interests-board', portSlug],
-      (old) => {
-        if (!old) return old;
-        return {
-          ...old,
-          data: old.data.map((i) =>
-            i.id === interestId ? { ...i, pipelineStage: newStage } : i,
-          ),
-        };
-      },
-    );
+    queryClient.setQueryData<{ data: InterestRow[] }>(['interests-board', portSlug], (old) => {
+      if (!old) return old;
+      return {
+        ...old,
+        data: old.data.map((i) => (i.id === interestId ? { ...i, pipelineStage: newStage } : i)),
+      };
+    });
 
     try {
       await apiFetch(`/api/v1/interests/${interestId}/stage`, {
         method: 'PATCH',
-        body: JSON.stringify({ pipelineStage: newStage }),
+        body: { pipelineStage: newStage },
       });
       queryClient.invalidateQueries({ queryKey: ['interests'] });
     } catch {