feat(sales): EOI queue route + invoice→deposit auto-advance + won/lost outcomes

Three independent strengthenings of the sales spine that the prior coherence
sweep made it possible to do cleanly.

  1. EOI queue page

     - Sidebar entry under Documents → "EOI queue".
     - Route /[port]/documents/eoi renders DocumentsHub with the existing
       eoi_queue tab pre-selected (filters in-flight EOIs only).
     - .gitignore: tightened root-only `eoi/` ignore so the documents/eoi
       route is no longer silently excluded.

  2. Invoice ↔ deposit link

     - invoices.interestId (FK, ON DELETE SET NULL) + invoices.kind
       ('general' | 'deposit'). Indexed on (port_id, interest_id).
     - createInvoiceSchema requires interestId when kind === 'deposit';
       the service validates the linked interest belongs to the same port
       before insert.
     - recordPayment auto-advances pipelineStage to deposit_10pct (via
       advanceStageIfBehind) when a paid invoice is kind=deposit and has
       an interestId. No-op if the interest is already further along.
     - "Create deposit invoice" link added to the Deposit milestone on the
       interest detail. Links to /invoices/new?interestId=…&kind=deposit;
       the form prefills the billing entity from the linked interest's
       client and shows a context banner.

  3. Won / lost terminal outcomes

     - interests.outcome ('won' | 'lost_other_marina' | 'lost_unqualified'
       | 'lost_no_response' | 'cancelled') + outcomeReason text +
       outcomeAt timestamp. Indexed on (port_id, outcome).
     - setInterestOutcome / clearInterestOutcome services + POST/DELETE
       /api/v1/interests/:id/outcome endpoints (gated by change_stage
       permission). Setting an outcome moves the interest to `completed`
       in the same write; clearing reopens to `in_communication` (or a
       caller-specified stage).
     - Mark Won / Mark Lost icon buttons on the interest detail header,
       plus an outcome badge that replaces the stage pill once a terminal
       outcome is set, plus a Reopen button.
     - Funnel + dashboard math updated to exclude lost/cancelled outcomes
       from active calculations (KPIs.activeInterests, pipelineValueUsd,
       getPipelineCounts, computePipelineFunnel, getRevenueForecast).
       The funnel now also returns a `lost` summary so callers can
       surface leakage without polluting conversion percentages.

Schema changes shipped via 0019_lazy_vampiro.sql; applied to dev DB
manually via psql because drizzle-kit push hits a pre-existing zod
parsing issue on the companies index. Dev server may need a restart
to flush prepared-statement caches.

tsc clean. vitest 832/832 pass. ESLint clean on every file touched.

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

src/lib/services/dashboard.service.ts

@@ -9,6 +9,11 @@ import { PIPELINE_STAGES, STAGE_WEIGHTS } from '@/lib/constants';
 
 const DEFAULT_PIPELINE_WEIGHTS: Record<string, number> = STAGE_WEIGHTS;
 
+// "Active" = not archived AND not closed as lost/cancelled. Won interests are
+// still counted because they represent revenue. Used everywhere KPIs say
+// "active interests" or "pipeline value".
+const isActiveInterest = sql`(${interests.outcome} IS NULL OR ${interests.outcome} = 'won')`;
+
 // ─── KPIs ─────────────────────────────────────────────────────────────────────
 
 export async function getKpis(portId: string) {
@@ -20,7 +25,7 @@ export async function getKpis(portId: string) {
   const [activeInterestsRow] = await db
     .select({ value: count() })
     .from(interests)
-    .where(and(eq(interests.portId, portId), isNull(interests.archivedAt)));
+    .where(and(eq(interests.portId, portId), isNull(interests.archivedAt), isActiveInterest));
 
   // Pipeline value: SUM berths.price via JOIN from non-archived interests with berthId
   const pipelineRows = await db
@@ -31,6 +36,7 @@ export async function getKpis(portId: string) {
       and(
         eq(interests.portId, portId),
         isNull(interests.archivedAt),
+        isActiveInterest,
         sql`${interests.berthId} IS NOT NULL`,
       ),
     );
@@ -68,7 +74,7 @@ export async function getPipelineCounts(portId: string) {
       count: sql<number>`count(*)::int`,
     })
     .from(interests)
-    .where(and(eq(interests.portId, portId), isNull(interests.archivedAt)))
+    .where(and(eq(interests.portId, portId), isNull(interests.archivedAt), isActiveInterest))
     .groupBy(interests.pipelineStage);
 
   const countsByStage = Object.fromEntries(rows.map((r) => [r.stage, r.count]));
@@ -102,7 +108,8 @@ export async function getRevenueForecast(portId: string) {
     }
   }
 
-  // Fetch all non-archived interests with a linked berth and its price
+  // Forecast excludes lost/cancelled — only currently-active or won-out
+  // interests should affect the weighted pipeline value.
   const interestRows = await db
     .select({
       id: interests.id,
@@ -115,6 +122,7 @@ export async function getRevenueForecast(portId: string) {
       and(
         eq(interests.portId, portId),
         isNull(interests.archivedAt),
+        isActiveInterest,
         sql`${interests.berthId} IS NOT NULL`,
       ),
     );