feat(berths): split Documents tab into Spec + Deal Documents

Berth detail page now has two tabs:
  - Spec: the existing versioned berth-spec PDF surface (current panel,
    version history, parser badge).
  - Deal Documents: NEW. Lists EOIs / contracts / etc. attached to
    interests currently linked to this berth via interest_berths.

New service helper listDealDocumentsForBerth joins documents →
interests → interest_berths with a port_id guard on both sides.
GET /api/v1/berths/[id]/deal-documents wraps it, gated on berths.view.

Read-only — title, type, status badge, and an Open link to the source
interest page. Edits / sends still happen on the interest's own page.
The Spec tab paragraph now points reps to the new Deal Documents tab
instead of telling them to navigate via Interests.

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

src/components/berths/berth-deal-documents-tab.tsx

@@ -0,0 +1,90 @@
+'use client';
+
+import Link from 'next/link';
+import { useParams } from 'next/navigation';
+import { useQuery } from '@tanstack/react-query';
+import { FileText, ExternalLink } from 'lucide-react';
+
+import { apiFetch } from '@/lib/api/client';
+import { Badge } from '@/components/ui/badge';
+import { Card, CardContent, CardHeader, CardTitle } from '@/components/ui/card';
+
+interface BerthDealDoc {
+  id: string;
+  title: string;
+  documentType: string;
+  status: string;
+  createdAt: string;
+  interestId: string;
+}
+
+const STATUS_TONE: Record<string, 'default' | 'secondary' | 'outline' | 'destructive'> = {
+  draft: 'outline',
+  sent: 'secondary',
+  partially_signed: 'secondary',
+  completed: 'default',
+  expired: 'destructive',
+  cancelled: 'destructive',
+};
+
+export function BerthDealDocumentsTab({ berthId }: { berthId: string }) {
+  const params = useParams<{ portSlug: string }>();
+  const portSlug = params?.portSlug ?? '';
+
+  const { data: docs = [], isLoading } = useQuery<BerthDealDoc[]>({
+    queryKey: ['berth-deal-documents', berthId],
+    queryFn: () =>
+      apiFetch<{ data: BerthDealDoc[] }>(`/api/v1/berths/${berthId}/deal-documents`).then(
+        (r) => r.data,
+      ),
+  });
+
+  return (
+    <div className="space-y-4">
+      <p className="text-sm text-muted-foreground">
+        EOIs, contracts, and other deal documents attached to interests currently linked to this
+        berth. Read-only — to send, sign, or edit, open the document on the linked interest&apos;s
+        page.
+      </p>
+      <Card>
+        <CardHeader className="pb-3">
+          <CardTitle className="text-sm font-medium">Linked deal documents</CardTitle>
+        </CardHeader>
+        <CardContent className="pt-0">
+          {isLoading ? (
+            <p className="text-sm text-muted-foreground">Loading…</p>
+          ) : docs.length === 0 ? (
+            <p className="text-sm text-muted-foreground">
+              No deal documents yet. Documents created on a linked interest will appear here.
+            </p>
+          ) : (
+            <ul className="divide-y">
+              {docs.map((doc) => (
+                <li
+                  key={doc.id}
+                  className="flex flex-wrap items-center justify-between gap-2 py-2.5 text-sm"
+                >
+                  <div className="flex min-w-0 items-center gap-2">
+                    <FileText className="h-4 w-4 shrink-0 text-muted-foreground" />
+                    <span className="truncate font-medium">{doc.title}</span>
+                    <span className="text-xs text-muted-foreground">{doc.documentType}</span>
+                  </div>
+                  <div className="flex items-center gap-2">
+                    <Badge variant={STATUS_TONE[doc.status] ?? 'outline'}>{doc.status}</Badge>
+                    <Link
+                      // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                      href={`/${portSlug}/interests/${doc.interestId}` as any}
+                      className="inline-flex items-center gap-1 text-xs text-primary hover:underline"
+                    >
+                      Open <ExternalLink className="h-3 w-3" />
+                    </Link>
+                  </div>
+                </li>
+              ))}
+            </ul>
+          )}
+        </CardContent>
+      </Card>
+    </div>
+  );
+}

src/components/berths/berth-documents-tab.tsx

@@ -164,8 +164,8 @@ export function BerthDocumentsTab({ berthId }: { berthId: string }) {
     <div className="space-y-6">
       <p className="text-sm text-muted-foreground">
         Berth-spec PDF: the dimensional drawing or surveyor sheet for this slip. Versioned so a
-        misparse can be rolled back. For documents tied to a prospect on this berth (EOI, contract,
-        etc.), open the matching deal in the Interests tab.
+        misparse can be rolled back. Deal documents (EOI, contract, etc.) live on the &ldquo;Deal
+        Documents&rdquo; tab.
       </p>
       <Card>
         <CardHeader className="flex flex-row items-center justify-between pb-3">

src/components/berths/berth-tabs.tsx

@@ -23,6 +23,7 @@ import { BerthReservationsTab } from './berth-reservations-tab';
 import { BerthInterestsTab } from './berth-interests-tab';
 import { BerthInterestPulse } from './berth-interest-pulse';
 import { BerthDocumentsTab } from './berth-documents-tab';
+import { BerthDealDocumentsTab } from './berth-deal-documents-tab';
 
 type BerthData = {
   id: string;
@@ -413,10 +414,15 @@ export function buildBerthTabs(berth: BerthData): DetailTab[] {
       content: <BerthReservationsTab berthId={berth.id} />,
     },
     {
-      id: 'documents',
-      label: 'Documents',
+      id: 'spec',
+      label: 'Spec',
       content: <BerthDocumentsTab berthId={berth.id} />,
     },
+    {
+      id: 'deal-documents',
+      label: 'Deal Documents',
+      content: <BerthDealDocumentsTab berthId={berth.id} />,
+    },
     // Waiting List + Maintenance Log tabs were stubs ("coming soon")
     // visible to every operator. Hidden here until the
     // berth_waiting_list / berth_maintenance_log feature surfaces ship.