Files
pn-new-crm/src/lib/db/schema/tenancies.ts
Matt 911b51a669 feat(tenancies-p6-followup): generic create dialog + edit dialog + self-FKs
- Migration 0086: berth_tenancies.previous_tenancy_id +
  transferred_from_tenancy_id self-FKs + partial indexes. Per
  docs/tenancies-design.md these chain renewal / transfer successors
  to predecessors for fixed-term and seasonal lineage. Schema mirrored
  in tenancies.ts with AnyPgColumn typed-import.
- POST /api/v1/tenancies (generic create): accepts berthId in the
  body so client + yacht tab entry points don't have to bounce through
  /api/v1/berths/[id]/tenancies. Same createPending service helper.
- TenancyCreateDialog: <TenancyCreateDialog open clientId? yachtId?
  berthId? /> with all three pickers; pre-fills the carrier from the
  parent entity. POSTs to /api/v1/tenancies; "Create" and
  "Create and activate" CTAs both wire to the new endpoint.
- Mounted on ClientTenanciesTab + YachtTenanciesTab behind
  <PermissionGate resource="tenancies" action="manage"> so reps can
  mint tenancies directly from those tabs without bouncing through
  the berth page.
- TenancyEditDialog: edit metadata only (start/end dates, tenure type,
  notes) via the new action='update' branch on the [id] PATCH route.
  Status transitions stay on activate/end/cancel. Wired into the
  tenancy detail page header. Outer wrapper unmounts on close so the
  form re-initialises from current row data without setState-in-effect.
- updateTenancy service helper + PATCH action='update' branch added.
  Audit-logged + emits berth_tenancy:activated to invalidate detail
  query caches.

Renew + Transfer dialogs deferred — both need lineage UX decisions
(tenure-aware mutate-in-place vs new-row spawn; client/yacht swap
semantics) and the self-FK columns this commit lands are the
underpinning. Next sub-task.

Verified: tsc clean, 1493/1493 vitest, migration applied.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-25 17:10:06 +02:00

88 lines
3.6 KiB
TypeScript

import {
pgTable,
text,
timestamp,
index,
uniqueIndex,
type AnyPgColumn,
} from 'drizzle-orm/pg-core';
import { sql } from 'drizzle-orm';
import { ports } from './ports';
import { berths } from './berths';
import { clients } from './clients';
import { yachts } from './yachts';
import { interests } from './interests';
import { files } from './documents';
export const berthTenancies = pgTable(
'berth_tenancies',
{
id: text('id')
.primaryKey()
.$defaultFn(() => crypto.randomUUID()),
// H-01: tenancies are the canonical "who occupies a berth right
// now" record; RESTRICT on every parent FK keeps an ad-hoc DB-side
// hard-delete from leaving a tenancy pointing at a missing
// berth/client/yacht. Interest is nullable + SET NULL because a
// tenancy legitimately outlives the originating deal.
berthId: text('berth_id')
.notNull()
.references(() => berths.id, { onDelete: 'restrict' }),
portId: text('port_id')
.notNull()
.references(() => ports.id, { onDelete: 'restrict' }),
clientId: text('client_id')
.notNull()
.references(() => clients.id, { onDelete: 'restrict' }),
yachtId: text('yacht_id')
.notNull()
.references(() => yachts.id, { onDelete: 'restrict' }),
interestId: text('interest_id').references(() => interests.id, { onDelete: 'set null' }),
status: text('status').notNull(), // 'pending' | 'active' | 'ended' | 'cancelled'
startDate: timestamp('start_date', { withTimezone: true, mode: 'date' }).notNull(),
endDate: timestamp('end_date', { withTimezone: true, mode: 'date' }),
// M-L01: canonical tenure_type union is
// `permanent | fixed_term | fee_simple | strata_lot | seasonal`
// (kept in sync with berths.tenure_type). 'seasonal' is tenancy-
// specific (winter haul-out etc.); the others mirror the berth's
// own tenure shape. Configurable via the per-port vocabulary at
// /admin/vocabularies (key: berth_tenure_types).
tenureType: text('tenure_type').notNull().default('permanent'),
contractFileId: text('contract_file_id').references(() => files.id, { onDelete: 'set null' }),
notes: text('notes'),
// Renewal + transfer self-FKs (migration 0086). `previousTenancyId`
// chains a successor row to the row it succeeds (fixed-term + seasonal
// renewals mint a new row; permanent renewals mutate in place so the
// FK stays null). `transferredFromTenancyId` chains a new row to the
// predecessor when an active tenancy is handed over to a different
// client / yacht. SET NULL on delete keeps the lineage best-effort.
previousTenancyId: text('previous_tenancy_id').references(
(): AnyPgColumn => berthTenancies.id,
{
onDelete: 'set null',
},
),
transferredFromTenancyId: text('transferred_from_tenancy_id').references(
(): AnyPgColumn => berthTenancies.id,
{ onDelete: 'set null' },
),
createdBy: text('created_by').notNull(),
createdAt: timestamp('created_at', { withTimezone: true }).notNull().defaultNow(),
updatedAt: timestamp('updated_at', { withTimezone: true }).notNull().defaultNow(),
},
(table) => [
index('idx_bt_berth').on(table.berthId),
index('idx_bt_client').on(table.clientId),
index('idx_bt_yacht').on(table.yachtId),
index('idx_bt_port').on(table.portId),
index('idx_bt_interest').on(table.interestId),
index('idx_bt_contract_file').on(table.contractFileId),
uniqueIndex('idx_bt_active')
.on(table.berthId)
.where(sql`${table.status} = 'active'`),
],
);
export type BerthTenancy = typeof berthTenancies.$inferSelect;
export type NewBerthTenancy = typeof berthTenancies.$inferInsert;