feat(phase-b): ship analytics dashboard, alerts, scanner PWA, dedup, audit view

Phase B (Insights & Alerts) PR4-11 in one drop. Builds on the schema +
service skeletons committed in PRs 1-3.

PR4  Analytics dashboard — 4 chart types (funnel/timeline/breakdown/source),
     date-range picker (today/7d/30d/90d), CSV+PNG export per card.
PR5  Alert rail UI + /alerts page — topbar bell w/ live count, dashboard
     right-rail, three-tab page (active/dismissed/resolved), socket-driven
     invalidation. Bell lazy-loads list on popover open to keep cold pages
     fast in non-dashboard routes.
PR6  EOI queue tab on documents hub — filters to in-flight EOIs, count
     surfaces in tab label.
PR7  Interests-by-berth tab on berth detail — replaces the stub.
PR8  Expense duplicate detection — BullMQ job runs scan on create, yellow
     banner on detail w/ Merge / Not-a-duplicate, transactional merge
     consolidates receipts and archives the source.
PR9  Receipt scanner PWA + multi-provider AI — port-scoped /scan route in
     its own (scanner) group with no dashboard chrome, dynamic per-port
     manifest, OpenAI + Claude provider abstraction, admin OCR settings
     page (port-level + super-admin global default w/ opt-in fallback),
     test-connection endpoint, manual-entry fallback when no key is
     configured. Verify form always shown before save — no ghost rows.
PR10 Audit log read view — swap to tsvector full-text search on the
     existing GIN index, cursor pagination, filters for entity/action/user
     /date range, batched actor-email resolution.
PR11 Real-API tests — opt-in receipt-ocr.spec (admin save+test, optional
     real-receipt parse via REALAPI_RECEIPT_FIXTURE) and alert-engine
     socket-fanout spec gated behind RUN_ALERT_ENGINE_REALAPI. Both skip
     cleanly without their gate envs so CI stays green.

Test totals: vitest 690 -> 713, smoke 130 -> 138, realapi +2 opt-in.

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

src/lib/services/documents.service.ts

@@ -60,6 +60,13 @@ function buildHubTabFilters(
   if (!tab || tab === 'all') return filters;
 
   switch (tab) {
+    case 'eoi_queue':
+      // EOI documents currently in-flight (drafted, sent, or partially signed).
+      // Used by the dedicated tab on the documents hub to triage EOI signing
+      // pipeline volume separate from the all-doc-types view.
+      filters.push(eq(documents.documentType, 'eoi'));
+      filters.push(inArray(documents.status, ['draft', 'sent', 'partially_signed']));
+      break;
     case 'awaiting_them':
       // "awaiting them" = pending signers other than the current user.
       // Without a known caller email we cannot make that distinction, so
@@ -209,6 +216,7 @@ export async function listDocuments(
 
 export interface HubTabCounts {
   all: number;
+  eoi_queue: number;
   awaiting_them: number;
   awaiting_me: number;
   completed: number;
@@ -233,15 +241,16 @@ export async function getHubTabCounts(
     return row?.count ?? 0;
   }
 
-  const [all, awaiting_them, awaiting_me, completed, expired] = await Promise.all([
+  const [all, eoi_queue, awaiting_them, awaiting_me, completed, expired] = await Promise.all([
     tabCount('all'),
+    tabCount('eoi_queue'),
     tabCount('awaiting_them'),
     tabCount('awaiting_me'),
     tabCount('completed'),
     tabCount('expired'),
   ]);
 
-  return { all, awaiting_them, awaiting_me, completed, expired };
+  return { all, eoi_queue, awaiting_them, awaiting_me, completed, expired };
 }
 
 // ─── Get by ID ────────────────────────────────────────────────────────────────