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/components/dashboard/dashboard-shell.tsx

@@ -1,22 +1,40 @@
 'use client';
 
+import { useState } from 'react';
+
 import { useRealtimeInvalidation } from '@/hooks/use-realtime-invalidation';
 import { PageHeader } from '@/components/shared/page-header';
 import { KpiCardsWithBoundary } from './kpi-cards';
-import { PipelineChart } from './pipeline-chart';
-import { RevenueForecast } from './revenue-forecast';
 import { ActivityFeed } from './activity-feed';
+import { DateRangePicker } from './date-range-picker';
+import { PipelineFunnelChart } from './pipeline-funnel-chart';
+import { OccupancyTimelineChart } from './occupancy-timeline-chart';
+import { RevenueBreakdownChart } from './revenue-breakdown-chart';
+import { LeadSourceChart } from './lead-source-chart';
+import { WidgetErrorBoundary } from './widget-error-boundary';
+import { AlertRail } from '@/components/alerts/alert-rail';
+import type { DateRange } from '@/lib/services/analytics.service';
+
+const RANGE_LABELS: Record<DateRange, string> = {
+  today: 'Today',
+  '7d': 'Last 7 days',
+  '30d': 'Last 30 days',
+  '90d': 'Last 90 days',
+};
 
 export function DashboardShell() {
+  const [range, setRange] = useState<DateRange>('30d');
+
   useRealtimeInvalidation({
     'interest:stageChanged': [
-      ['dashboard', 'pipeline'],
-      ['dashboard', 'forecast'],
+      ['analytics', 'pipeline_funnel', range],
+      ['analytics', 'lead_source_attribution', range],
+      ['dashboard', 'kpis'],
     ],
     'client:created': [['dashboard', 'kpis']],
     'berth:statusChanged': [
+      ['analytics', 'occupancy_timeline', range],
       ['dashboard', 'kpis'],
-      ['dashboard', 'forecast'],
     ],
   });
 
@@ -26,26 +44,37 @@ export function DashboardShell() {
         title="Dashboard"
         eyebrow="Overview"
         description="Live snapshot of your marina activity"
-        kpiLine={<span>Last 30 days</span>}
+        kpiLine={<span>{RANGE_LABELS[range]}</span>}
         variant="gradient"
+        actions={<DateRangePicker value={range} onChange={setRange} />}
       />
 
-      {/* Row 1: KPI cards */}
       <div className="grid gap-4 grid-cols-1 sm:grid-cols-2 lg:grid-cols-4">
         <KpiCardsWithBoundary />
       </div>
 
-      {/* Row 2: Pipeline chart + Revenue forecast */}
-      <div className="grid gap-4 grid-cols-1 lg:grid-cols-3">
-        <div className="lg:col-span-2">
-          <PipelineChart />
-        </div>
-        <div className="lg:col-span-1">
-          <RevenueForecast />
+      <div className="grid gap-4 grid-cols-1 xl:grid-cols-[minmax(0,1fr)_320px]">
+        <div className="grid gap-4 grid-cols-1 lg:grid-cols-2">
+          <WidgetErrorBoundary>
+            <PipelineFunnelChart range={range} />
+          </WidgetErrorBoundary>
+          <WidgetErrorBoundary>
+            <OccupancyTimelineChart range={range} />
+          </WidgetErrorBoundary>
+          <WidgetErrorBoundary>
+            <RevenueBreakdownChart range={range} />
+          </WidgetErrorBoundary>
+          <WidgetErrorBoundary>
+            <LeadSourceChart range={range} />
+          </WidgetErrorBoundary>
         </div>
+        <aside className="min-w-0">
+          <WidgetErrorBoundary>
+            <AlertRail />
+          </WidgetErrorBoundary>
+        </aside>
       </div>
 
-      {/* Row 3: Activity feed */}
       <ActivityFeed />
     </div>
   );