64 lines
2.7 KiB
TypeScript
64 lines
2.7 KiB
TypeScript
|
/**
|
||
|
|
* Field-level override history for interests + their linked clients.
|
||
|
|
*
|
||
|
|
* Every time a field on an interest or its linked client is overridden
|
||
|
|
* via an explicit channel (today: supplemental-info form submission;
|
||
|
|
* future: form-templates, AI-assisted extraction acceptance), a row
|
||
|
|
* lands here. Distinct from `audit_logs` — that table tracks every
|
||
|
|
* CRUD event for compliance; this one tracks only deliberate overrides
|
||
|
|
* so the Interest + Client "Field history" panels can surface them
|
||
|
|
* compactly.
|
||
|
|
*/
|
||
|
|
|
||
|
|
import { pgTable, text, jsonb, timestamp, index } from 'drizzle-orm/pg-core';
|
||
|
|
import { sql } from 'drizzle-orm';
|
||
|
|
|
||
|
|
import { ports } from './ports';
|
||
|
|
import { interests } from './interests';
|
||
|
|
import { clients } from './clients';
|
||
|
|
|
||
|
|
export const interestFieldHistory = pgTable(
|
||
|
|
'interest_field_history',
|
||
|
|
{
|
||
|
|
id: text('id')
|
||
|
|
.primaryKey()
|
||
|
|
.$defaultFn(() => crypto.randomUUID()),
|
||
|
|
portId: text('port_id')
|
||
|
|
.notNull()
|
||
|
|
.references(() => ports.id),
|
||
|
|
interestId: text('interest_id').references(() => interests.id, { onDelete: 'cascade' }),
|
||
|
|
/** Denormalized for fast lookup on the Client detail "Field history"
|
||
|
|
* panel — overrides that come in via a supplemental-info form
|
||
|
|
* carry both interest + client refs. Direct-edit overrides may
|
||
|
|
* only carry one. */
|
||
|
|
clientId: text('client_id').references(() => clients.id, { onDelete: 'cascade' }),
|
||
|
|
/** Dotted path of the field that was overridden. Examples:
|
||
|
|
* 'client.fullName'
|
||
|
|
* 'interest.desiredLengthFt'
|
||
|
|
* 'client.address.streetAddress'
|
||
|
|
* The Field history panel formats this for display. */
|
||
|
|
fieldPath: text('field_path').notNull(),
|
||
|
|
oldValue: jsonb('old_value'),
|
||
|
|
newValue: jsonb('new_value').notNull(),
|
||
|
|
/** Provenance: 'supplemental_form' | 'rep_edit' | 'system_inferred' |
|
||
|
|
* 'ai_extraction' (future). Drives the "Submitted via X" copy. */
|
||
|
|
source: text('source').notNull(),
|
||
|
|
/** Optional FK to the form_submissions row that triggered the
|
||
|
|
* override. Lets the UI link back to the original submission. */
|
||
|
|
submissionId: text('submission_id'),
|
||
|
|
createdAt: timestamp('created_at', { withTimezone: true }).notNull().defaultNow(),
|
||
|
|
createdBy: text('created_by'),
|
||
|
|
},
|
||
|
|
(table) => [
|
||
|
|
index('idx_ifh_interest_created')
|
||
|
|
.on(table.portId, table.interestId, table.createdAt)
|
||
|
|
.where(sql`${table.interestId} IS NOT NULL`),
|
||
|
|
index('idx_ifh_client_created')
|
||
|
|
.on(table.portId, table.clientId, table.createdAt)
|
||
|
|
.where(sql`${table.clientId} IS NOT NULL`),
|
||
|
|
],
|
||
|
|
);
|
||
|
|
|
||
|
|
export type InterestFieldHistory = typeof interestFieldHistory.$inferSelect;
|
||
|
|
export type NewInterestFieldHistory = typeof interestFieldHistory.$inferInsert;
|