feat(pipeline): 9→7 stage refactor + v1.1 hardening wave

Replaces the legacy 9-stage pipeline with 7 canonical stages
(enquiry → qualified → eoi → reservation → deposit_paid → contract →
nurturing) plus three doc sub-status columns (eoi_doc_status,
reservation_doc_status, contract_doc_status) that track sent/signed
within a single stage instead of branching it.

Schema (migration 0062):
- interests gains assigned_to, deposit_expected_amount/currency,
  three doc-status columns, two documenso-id columns, and
  date_reservation_signed.
- New tables: qualification_criteria (per-port admin-configurable),
  interest_qualifications (per-interest state), payments (deposit /
  balance / refund records keyed to interest + client).
- Default qualification criteria seeded for every existing port.
- Dummy-data UPDATEs collapse Sent/Signed pairs and 'completed' into
  the new stage + doc-status + outcome shape.

Migration 0063 adds interest_contact_log.voice_transcript and
template_used columns for v1.1-A/B (quick-template buttons + voice
transcription via Web Speech API).

v1.1 phase work bundled here:
- A/B: Quick-template buttons (Call / Visit / Email) + mic toggle on
       the contact-log compose dialog (useVoiceTranscription hook).
- C:   berth-rules-engine wraps state writes in pg_advisory_xact_lock
       with an idempotent re-read; emits rule_evaluated audit traces.
- D:   Documenso webhook: reservation/contract sub-status stamping
       moved out of the PDF-download try-block so a download failure
       no longer swallows the stamp. New integration test coverage.
- E:   /admin/qualification-criteria CRUD page + admin component.
- F:   default_new_interest_owner exposed in System Settings.
- G:   recentActivityCount + active_engagement deal-pulse signal
       surfaced as a chip on interests + hot-deals card.
- H:   interest_assigned notification on assignedTo change (skips
       self-assign, uses a dedupe key).

Plus the supporting components: AssignedToChip, DealPulseChip,
PaymentsSection, QualificationChecklist, MultiEoiChip,
SkipAheadBanner, WonStatusPanel, InterestBerthStatusBanner,
SupplementalInfoRequestButton, UserPicker.

Tests: 1370/1370 vitest pass (added deal-health unit suite +
expanded constants/validators/pipeline-transitions coverage). tsc
clean, eslint clean.

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

src/lib/db/schema/index.ts

@@ -68,5 +68,8 @@ export * from './website-submissions';
 // Pre-EOI supplemental form tokens
 export * from './supplemental-forms';
 
+// Pipeline refactor — qualification criteria, payment records
+export * from './pipeline';
+
 // Relations (must come last - references all tables)
 export * from './relations';

src/lib/db/schema/interests.ts

@@ -15,7 +15,8 @@ import { clients } from './clients';
 import { berths } from './berths';
 import { yachts } from './yachts';
 
-// Pipeline stages: open, details_sent, in_communication, eoi_sent, eoi_signed, deposit_10pct, contract_sent, contract_signed, completed
+// Pipeline stages: enquiry, qualified, nurturing, eoi, reservation, deposit_paid, contract
+// (doc sub-status carried on eoi_doc_status / reservation_doc_status / contract_doc_status)
 
 export const interests = pgTable(
   'interests',
@@ -30,7 +31,19 @@ export const interests = pgTable(
       .notNull()
       .references(() => clients.id),
     yachtId: text('yacht_id').references(() => yachts.id, { onDelete: 'set null' }),
-    pipelineStage: text('pipeline_stage').notNull().default('open'),
+    /** Who owns this deal. Auto-assigned on create from system_settings
+     *  `default_new_interest_owner`; reassignable via the interest header. */
+    assignedTo: text('assigned_to'),
+    pipelineStage: text('pipeline_stage').notNull().default('enquiry'),
+    /** Sub-status for the doc-signing stages. NULL while the deal hasn't
+     *  reached the stage yet; 'pending' | 'sent' | 'signed' | 'declined' | 'voided'. */
+    eoiDocStatus: text('eoi_doc_status'),
+    reservationDocStatus: text('reservation_doc_status'),
+    contractDocStatus: text('contract_doc_status'),
+    /** Documenso IDs per document type. EOI uses the existing `documensoId`
+     *  for backward compat with the template-generate path. */
+    reservationDocumensoId: text('reservation_documenso_id'),
+    contractDocumensoId: text('contract_documenso_id'),
     leadCategory: text('lead_category'), // general_interest, specific_qualified, hot_lead
     source: text('source'), // website, manual, referral, broker
     eoiStatus: text('eoi_status'), // null, waiting_for_signatures, signed, expired
@@ -38,10 +51,16 @@ export const interests = pgTable(
     contractStatus: text('contract_status'),
     depositStatus: text('deposit_status'),
     reservationStatus: text('reservation_status'),
+    /** Agreed deposit amount captured at reservation-agreement time. Lets
+     *  the payments running-total decide when the deposit is "fully paid"
+     *  and the stage advances automatically. */
+    depositExpectedAmount: numeric('deposit_expected_amount'),
+    depositExpectedCurrency: text('deposit_expected_currency').default('EUR'),
     dateFirstContact: timestamp('date_first_contact', { withTimezone: true }),
     dateLastContact: timestamp('date_last_contact', { withTimezone: true }),
     dateEoiSent: timestamp('date_eoi_sent', { withTimezone: true }),
     dateEoiSigned: timestamp('date_eoi_signed', { withTimezone: true }),
+    dateReservationSigned: timestamp('date_reservation_signed', { withTimezone: true }),
     dateContractSent: timestamp('date_contract_sent', { withTimezone: true }),
     dateContractSigned: timestamp('date_contract_signed', { withTimezone: true }),
     dateDepositReceived: timestamp('date_deposit_received', { withTimezone: true }),
@@ -86,6 +105,7 @@ export const interests = pgTable(
       .on(table.portId)
       .where(sql`${table.archivedAt} IS NULL`),
     index('idx_interests_outcome').on(table.portId, table.outcome),
+    index('idx_interests_assigned_to').on(table.assignedTo),
   ],
 );
 

src/lib/db/schema/operations.ts

@@ -231,6 +231,13 @@ export const interestContactLog = pgTable(
     direction: text('direction').notNull().default('outbound'),
     /** Short free text — "Discussed yacht size, asked about tax structure". */
     summary: text('summary').notNull(),
+    /** Raw Web Speech API transcript captured at log time, kept separate
+     *  from the rep-polished `summary` so the original utterance survives
+     *  edits to the summary text. NULL when the rep typed manually. */
+    voiceTranscript: text('voice_transcript'),
+    /** Which of the 3 quick-template buttons was tapped on the log modal
+     *  ('call' | 'visit' | 'email'). NULL when the rep filled in freeform. */
+    templateUsed: text('template_used'),
     /** Optional. When set, a reminder is auto-created pointing back to
      *  the interest for follow-up. Stored as the original choice so the
      *  UI can re-render it; the actual reminder lives in `reminders`. */

src/lib/db/schema/pipeline.ts

@@ -0,0 +1,125 @@
+/**
+ * Pipeline-refactor tables — per-port qualification criteria, per-interest
+ * qualification state, and payment records (no invoice generation).
+ *
+ * See migrations/0062_pipeline_refactor.sql.
+ */
+
+import {
+  pgTable,
+  text,
+  boolean,
+  integer,
+  numeric,
+  timestamp,
+  index,
+  primaryKey,
+} from 'drizzle-orm/pg-core';
+
+import { ports } from './ports';
+import { interests } from './interests';
+import { clients } from './clients';
+import { files } from './documents';
+
+/**
+ * Per-port qualification criteria. Admin-configurable: enable/disable,
+ * rename labels, reorder. The default seed is 2 enabled (dimensions +
+ * intent) and 2 disabled (signatory + timeline) per port.
+ */
+export const qualificationCriteria = pgTable(
+  'qualification_criteria',
+  {
+    id: text('id')
+      .primaryKey()
+      .$defaultFn(() => crypto.randomUUID()),
+    portId: text('port_id')
+      .notNull()
+      .references(() => ports.id, { onDelete: 'cascade' }),
+    /** Stable key for code references. e.g. 'dimensions', 'intent'. */
+    key: text('key').notNull(),
+    /** Display label shown on the qualification checklist UI. */
+    label: text('label').notNull(),
+    /** Optional short description shown as helper text under the checkbox. */
+    description: text('description'),
+    enabled: boolean('enabled').notNull().default(true),
+    displayOrder: integer('display_order').notNull().default(0),
+    createdAt: timestamp('created_at', { withTimezone: true }).notNull().defaultNow(),
+    updatedAt: timestamp('updated_at', { withTimezone: true }).notNull().defaultNow(),
+  },
+  (table) => [index('idx_qualification_criteria_port').on(table.portId)],
+);
+
+/**
+ * Per-interest qualification state. Composite PK (interest_id, criterion_key)
+ * lets the same key exist across ports without conflicts and gives O(1)
+ * lookup for the "all enabled criteria confirmed" check.
+ */
+export const interestQualifications = pgTable(
+  'interest_qualifications',
+  {
+    interestId: text('interest_id')
+      .notNull()
+      .references(() => interests.id, { onDelete: 'cascade' }),
+    criterionKey: text('criterion_key').notNull(),
+    confirmed: boolean('confirmed').notNull().default(false),
+    confirmedAt: timestamp('confirmed_at', { withTimezone: true }),
+    confirmedBy: text('confirmed_by'),
+    notes: text('notes'),
+  },
+  (table) => [
+    primaryKey({ columns: [table.interestId, table.criterionKey] }),
+    index('idx_interest_qualifications_interest').on(table.interestId),
+  ],
+);
+
+/**
+ * Payment records. The CRM does NOT generate invoices — clients pay banks
+ * directly. We record that money was received (or refunded) with an
+ * optional uploaded receipt for audit purposes.
+ *
+ * The "deposit_paid" stage auto-advances when SUM(payments where type=deposit)
+ * for an interest reaches the `interests.depositExpectedAmount`.
+ */
+export const payments = pgTable(
+  'payments',
+  {
+    id: text('id')
+      .primaryKey()
+      .$defaultFn(() => crypto.randomUUID()),
+    portId: text('port_id')
+      .notNull()
+      .references(() => ports.id, { onDelete: 'cascade' }),
+    interestId: text('interest_id')
+      .notNull()
+      .references(() => interests.id, { onDelete: 'cascade' }),
+    clientId: text('client_id')
+      .notNull()
+      .references(() => clients.id, { onDelete: 'cascade' }),
+    /** 'deposit' | 'balance' | 'refund' | 'other' — `refund` rows carry
+     *  negative amounts so the running total nets out correctly. */
+    paymentType: text('payment_type').notNull(),
+    amount: numeric('amount').notNull(),
+    currency: text('currency').notNull().default('EUR'),
+    receivedAt: timestamp('received_at', { withTimezone: true }).notNull(),
+    /** Optional uploaded receipt PDF. The UI warns reps that recording
+     *  without a receipt may make later verification harder, but doesn't
+     *  block the save. */
+    receiptFileId: text('receipt_file_id').references(() => files.id),
+    notes: text('notes'),
+    recordedBy: text('recorded_by').notNull(),
+    createdAt: timestamp('created_at', { withTimezone: true }).notNull().defaultNow(),
+  },
+  (table) => [
+    index('idx_payments_interest').on(table.interestId),
+    index('idx_payments_client').on(table.clientId),
+    index('idx_payments_port').on(table.portId),
+    index('idx_payments_type').on(table.portId, table.paymentType),
+  ],
+);
+
+export type QualificationCriterion = typeof qualificationCriteria.$inferSelect;
+export type NewQualificationCriterion = typeof qualificationCriteria.$inferInsert;
+export type InterestQualification = typeof interestQualifications.$inferSelect;
+export type NewInterestQualification = typeof interestQualifications.$inferInsert;
+export type Payment = typeof payments.$inferSelect;
+export type NewPayment = typeof payments.$inferInsert;