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/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),
   ],
 );