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/berths/berth-status-suggestion-dialog.tsx

@@ -38,7 +38,7 @@ export function BerthStatusSuggestionDialog({
     mutationFn: () =>
       apiFetch(`/api/v1/berths/${berthId}/status`, {
         method: 'PATCH',
-        body: JSON.stringify({ status: suggestedStatus, reason }),
+        body: { status: suggestedStatus, reason },
       }),
     onSuccess: () => {
       onApplied();
@@ -66,21 +66,14 @@ export function BerthStatusSuggestionDialog({
           </Badge>
         </div>
 
-        {reason && (
-          <p className="text-sm text-muted-foreground text-center px-4">{reason}</p>
-        )}
+        {reason && <p className="text-sm text-muted-foreground text-center px-4">{reason}</p>}
 
         <DialogFooter className="gap-2">
           <Button variant="outline" onClick={() => onOpenChange(false)}>
             Dismiss
           </Button>
-          <Button
-            onClick={() => applyMutation.mutate()}
-            disabled={applyMutation.isPending}
-          >
-            {applyMutation.isPending && (
-              <Loader2 className="mr-1.5 h-4 w-4 animate-spin" />
-            )}
+          <Button onClick={() => applyMutation.mutate()} disabled={applyMutation.isPending}>
+            {applyMutation.isPending && <Loader2 className="mr-1.5 h-4 w-4 animate-spin" />}
             Apply Change
           </Button>
         </DialogFooter>

src/components/berths/waiting-list-manager.tsx

@@ -10,11 +10,7 @@ import {
   useSensor,
   useSensors,
 } from '@dnd-kit/core';
-import {
-  SortableContext,
-  verticalListSortingStrategy,
-  useSortable,
-} from '@dnd-kit/sortable';
+import { SortableContext, verticalListSortingStrategy, useSortable } from '@dnd-kit/sortable';
 import { CSS } from '@dnd-kit/utilities';
 import { GripVertical, Plus, Loader2, Trash2 } from 'lucide-react';
 
@@ -81,9 +77,7 @@ function SortableEntry({
 
       <div className="flex-1 min-w-0">
         <p className="text-sm truncate">{entry.clientId}</p>
-        {entry.notes && (
-          <p className="text-xs text-muted-foreground truncate">{entry.notes}</p>
-        )}
+        {entry.notes && <p className="text-xs text-muted-foreground truncate">{entry.notes}</p>}
       </div>
 
       <Badge variant={entry.priority === 'high' ? 'destructive' : 'secondary'}>
@@ -118,7 +112,7 @@ export function WaitingListManager({ berthId }: WaitingListManagerProps) {
     mutationFn: (body: { entryId: string; newPosition: number }) =>
       apiFetch(`/api/v1/berths/${berthId}/waiting-list`, {
         method: 'PATCH',
-        body: JSON.stringify(body),
+        body,
       }),
     onSuccess: () => {
       queryClient.invalidateQueries({ queryKey: ['berth-waiting-list', berthId] });
@@ -129,7 +123,7 @@ export function WaitingListManager({ berthId }: WaitingListManagerProps) {
     mutationFn: (entries: WaitingListEntry[]) =>
       apiFetch(`/api/v1/berths/${berthId}/waiting-list`, {
         method: 'PUT',
-        body: JSON.stringify({ entries }),
+        body: { entries },
       }),
     onSuccess: () => {
       queryClient.invalidateQueries({ queryKey: ['berth-waiting-list', berthId] });
@@ -207,10 +201,7 @@ export function WaitingListManager({ berthId }: WaitingListManagerProps) {
             value={newClientId}
             onChange={(e) => setNewClientId(e.target.value)}
           />
-          <Select
-            value={newPriority}
-            onValueChange={(v) => setNewPriority(v as 'normal' | 'high')}
-          >
+          <Select value={newPriority} onValueChange={(v) => setNewPriority(v as 'normal' | 'high')}>
             <SelectTrigger>
               <SelectValue />
             </SelectTrigger>
@@ -226,9 +217,7 @@ export function WaitingListManager({ berthId }: WaitingListManagerProps) {
           />
           <div className="flex gap-2">
             <Button size="sm" onClick={handleAdd} disabled={addMutation.isPending}>
-              {addMutation.isPending && (
-                <Loader2 className="mr-1.5 h-4 w-4 animate-spin" />
-              )}
+              {addMutation.isPending && <Loader2 className="mr-1.5 h-4 w-4 animate-spin" />}
               Add to List
             </Button>
             <Button size="sm" variant="ghost" onClick={() => setShowAddForm(false)}>
@@ -243,22 +232,11 @@ export function WaitingListManager({ berthId }: WaitingListManagerProps) {
           No entries on waiting list.
         </p>
       ) : (
-        <DndContext
-          sensors={sensors}
-          collisionDetection={closestCenter}
-          onDragEnd={handleDragEnd}
-        >
-          <SortableContext
-            items={entries.map((e) => e.id)}
-            strategy={verticalListSortingStrategy}
-          >
+        <DndContext sensors={sensors} collisionDetection={closestCenter} onDragEnd={handleDragEnd}>
+          <SortableContext items={entries.map((e) => e.id)} strategy={verticalListSortingStrategy}>
             <div className="space-y-2">
               {entries.map((entry) => (
-                <SortableEntry
-                  key={entry.id}
-                  entry={entry}
-                  onRemove={handleRemove}
-                />
+                <SortableEntry key={entry.id} entry={entry} onRemove={handleRemove} />
               ))}
             </div>
           </SortableContext>