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/lib/services/clients.service.ts

@@ -1,4 +1,4 @@
-import { and, eq, ilike, inArray, isNull } from 'drizzle-orm';
+import { and, count, eq, ilike, inArray, isNull } from 'drizzle-orm';
 
 import { db } from '@/lib/db';
 import { clients, clientContacts, clientRelationships, clientTags } from '@/lib/db/schema/clients';
@@ -8,6 +8,7 @@ import { berthReservations } from '@/lib/db/schema/reservations';
 import { tags } from '@/lib/db/schema/system';
 import { createAuditLog } from '@/lib/audit';
 import { NotFoundError } from '@/lib/errors';
+import { isPortalEnabledForPort } from '@/lib/services/portal-auth.service';
 import { emitToRoom } from '@/lib/socket/server';
 import { buildListQuery } from '@/lib/db/query-builder';
 import { diffEntity } from '@/lib/entity-diff';
@@ -59,7 +60,7 @@ export async function listClients(portId: string, query: ListClientsInput) {
   if (sort === 'fullName') sortColumn = clients.fullName;
   else if (sort === 'createdAt') sortColumn = clients.createdAt;
 
-  const result = await buildListQuery({
+  const result = await buildListQuery<typeof clients.$inferSelect>({
     table: clients,
     portIdColumn: clients.portId,
     portId,
@@ -75,7 +76,41 @@ export async function listClients(portId: string, query: ListClientsInput) {
     archivedAtColumn: clients.archivedAt,
   });
 
-  return result;
+  if (result.data.length === 0) return result;
+
+  const ids = result.data.map((r) => r.id);
+
+  const [yachtCounts, companyCounts] = await Promise.all([
+    db
+      .select({ ownerId: yachts.currentOwnerId, count: count() })
+      .from(yachts)
+      .where(
+        and(
+          eq(yachts.portId, portId),
+          eq(yachts.currentOwnerType, 'client'),
+          inArray(yachts.currentOwnerId, ids),
+          isNull(yachts.archivedAt),
+        ),
+      )
+      .groupBy(yachts.currentOwnerId),
+    db
+      .select({ clientId: companyMemberships.clientId, count: count() })
+      .from(companyMemberships)
+      .where(and(inArray(companyMemberships.clientId, ids), isNull(companyMemberships.endDate)))
+      .groupBy(companyMemberships.clientId),
+  ]);
+
+  const yachtCountMap = new Map(yachtCounts.map((r) => [r.ownerId, r.count]));
+  const companyCountMap = new Map(companyCounts.map((r) => [r.clientId, r.count]));
+
+  return {
+    ...result,
+    data: result.data.map((row) => ({
+      ...row,
+      yachtCount: yachtCountMap.get(row.id) ?? 0,
+      companyCount: companyCountMap.get(row.id) ?? 0,
+    })),
+  };
 }
 
 // ─── Get by ID ────────────────────────────────────────────────────────────────
@@ -157,6 +192,8 @@ export async function getClientById(id: string, portId: string) {
     },
   });
 
+  const portalEnabled = await isPortalEnabledForPort(portId);
+
   return {
     ...client,
     contacts,
@@ -164,6 +201,7 @@ export async function getClientById(id: string, portId: string) {
     yachts: yachtRows,
     companies: membershipRows,
     activeReservations,
+    clientPortalEnabled: portalEnabled,
   };
 }