@valentine-efagene/qshelter-common 2.0.54 → 2.0.56

package/dist/generated/client/models/index.d.ts

@@ -6,7 +6,6 @@ export * from './ContractInstallment';
 export * from './ContractPayment';
 export * from './ContractPhase';
 export * from './ContractTermination';
-export * from './ContractTransition';
 export * from './DeviceEndpoint';
 export * from './DocumentRequirementRule';
 export * from './DocumentTemplate';
@@ -23,7 +22,6 @@ export * from './PaymentMethodPhaseDocument';
 export * from './PaymentMethodPhaseStep';
 export * from './PaymentPlan';
 export * from './Permission';
-export * from './Prequalification';
 export * from './Property';
 export * from './PropertyAmenity';
 export * from './PropertyDocument';
@@ -42,7 +40,6 @@ export * from './Settings';
 export * from './Social';
 export * from './Tenant';
 export * from './Transaction';
-export * from './UnderwritingDecision';
 export * from './User';
 export * from './UserRole';
 export * from './UserSuspension';

package/dist/generated/client/models/index.js

@@ -6,7 +6,6 @@ export * from './ContractInstallment';
 export * from './ContractPayment';
 export * from './ContractPhase';
 export * from './ContractTermination';
-export * from './ContractTransition';
 export * from './DeviceEndpoint';
 export * from './DocumentRequirementRule';
 export * from './DocumentTemplate';
@@ -23,7 +22,6 @@ export * from './PaymentMethodPhaseDocument';
 export * from './PaymentMethodPhaseStep';
 export * from './PaymentPlan';
 export * from './Permission';
-export * from './Prequalification';
 export * from './Property';
 export * from './PropertyAmenity';
 export * from './PropertyDocument';
@@ -42,7 +40,6 @@ export * from './Settings';
 export * from './Social';
 export * from './Tenant';
 export * from './Transaction';
-export * from './UnderwritingDecision';
 export * from './User';
 export * from './UserRole';
 export * from './UserSuspension';

package/dist/generated/client/models.d.ts

@@ -37,13 +37,10 @@ export type * from './models/DocumentationStepApproval.js';
 export type * from './models/ContractInstallment.js';
 export type * from './models/ContractPayment.js';
 export type * from './models/ContractDocument.js';
-export type * from './models/ContractTransition.js';
 export type * from './models/ContractEvent.js';
 export type * from './models/DocumentTemplate.js';
 export type * from './models/OfferLetter.js';
 export type * from './models/ContractTermination.js';
-export type * from './models/Prequalification.js';
-export type * from './models/UnderwritingDecision.js';
 export type * from './models/PaymentMethodChangeRequest.js';
 export type * from './models/DocumentRequirementRule.js';
 export type * from './models/DomainEvent.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@valentine-efagene/qshelter-common",
-  "version": "2.0.54",
+  "version": "2.0.56",
   "description": "Shared database schemas and utilities for QShelter services",
   "main": "dist/src/index.js",
   "types": "dist/src/index.d.ts",

package/prisma/migrations/20260105080236_remove_prequalification_model/migration.sql

@@ -0,0 +1,37 @@
+/*
+  Warnings:
+
+  - The values [PREQUALIFICATION] on the enum `document_requirement_rules_context` will be removed. If these variants are still used in the database, this will fail.
+  - You are about to drop the `prequalifications` table. If the table is not empty, all the data it contains will be lost.
+  - You are about to drop the `underwriting_decisions` table. If the table is not empty, all the data it contains will be lost.
+
+*/
+-- DropForeignKey
+ALTER TABLE `prequalifications` DROP FOREIGN KEY `prequalifications_contractId_fkey`;
+
+-- DropForeignKey
+ALTER TABLE `prequalifications` DROP FOREIGN KEY `prequalifications_paymentMethodId_fkey`;
+
+-- DropForeignKey
+ALTER TABLE `prequalifications` DROP FOREIGN KEY `prequalifications_propertyId_fkey`;
+
+-- DropForeignKey
+ALTER TABLE `prequalifications` DROP FOREIGN KEY `prequalifications_tenantId_fkey`;
+
+-- DropForeignKey
+ALTER TABLE `prequalifications` DROP FOREIGN KEY `prequalifications_userId_fkey`;
+
+-- DropForeignKey
+ALTER TABLE `underwriting_decisions` DROP FOREIGN KEY `underwriting_decisions_prequalificationId_fkey`;
+
+-- DropForeignKey
+ALTER TABLE `underwriting_decisions` DROP FOREIGN KEY `underwriting_decisions_tenantId_fkey`;
+
+-- AlterTable
+ALTER TABLE `document_requirement_rules` MODIFY `context` ENUM('CONTRACT_PHASE', 'PAYMENT_METHOD_CHANGE') NOT NULL;
+
+-- DropTable
+DROP TABLE `prequalifications`;
+
+-- DropTable
+DROP TABLE `underwriting_decisions`;

package/prisma/schema.prisma

@@ -182,12 +182,6 @@ enum OfferLetterStatus {
   CANCELLED
 }
 
-enum UnderwritingDecisionKind {
-  APPROVE
-  REJECT
-  CONDITIONAL
-}
-
 // =============================================================================
 // USER & AUTH DOMAIN
 // =============================================================================
@@ -232,8 +226,7 @@ model User {
   stepApprovals DocumentationStepApproval[] @relation("DocumentationStepApprover")
   uploadedDocs  ContractDocument[]          @relation("DocumentUploader")
 
-  // Prequalification and payment method changes
-  prequalifications           Prequalification[]
+  // Payment method changes
   paymentMethodChangeRequests PaymentMethodChangeRequest[] @relation("ChangeRequestor")
   reviewedChangeRequests      PaymentMethodChangeRequest[] @relation("ChangeReviewer")
 
@@ -314,8 +307,7 @@ model Tenant {
   paymentMethods PropertyPaymentMethod[]
   contracts      Contract[]
 
-  // Prequalification and payment method changes
-  prequalifications           Prequalification[]
+  // Payment method changes
   paymentMethodChangeRequests PaymentMethodChangeRequest[]
   documentRequirementRules    DocumentRequirementRule[]
 
@@ -326,9 +318,6 @@ model Tenant {
   documentTemplates DocumentTemplate[]
   offerLetters      OfferLetter[]
 
-  // Underwriting
-  underwritingDecisions UnderwritingDecision[]
-
   @@index([subdomain])
   @@map("tenants")
 }
@@ -504,12 +493,11 @@ model Property {
   updatedAt      DateTime       @updatedAt
 
   // Relations
-  documents         PropertyDocument[]
-  media             PropertyMedia[]             @relation("PropertyMedia")
-  amenities         PropertyAmenity[] // Shared amenities (gym, pool, security)
-  paymentMethods    PropertyPaymentMethodLink[]
-  variants          PropertyVariant[]
-  prequalifications Prequalification[]
+  documents      PropertyDocument[]
+  media          PropertyMedia[]             @relation("PropertyMedia")
+  amenities      PropertyAmenity[] // Shared amenities (gym, pool, security)
+  paymentMethods PropertyPaymentMethodLink[]
+  variants       PropertyVariant[]
 
   @@index([tenantId])
   @@index([userId])
@@ -759,9 +747,6 @@ model PropertyPaymentMethod {
   // Contracts using this method
   contracts  Contract[]
 
-  // Prequalifications for this payment method
-  prequalifications Prequalification[]
-
   // Payment method change tracking
   changeRequestsFrom PaymentMethodChangeRequest[] @relation("ChangeFromMethod")
   changeRequestsTo   PaymentMethodChangeRequest[] @relation("ChangeToMethod")
@@ -942,13 +927,10 @@ model Contract {
   phases       ContractPhase[]
   documents    ContractDocument[]
   payments     ContractPayment[]
-  transitions  ContractTransition[]
   events       ContractEvent[]
   terminations ContractTermination[]
   offerLetters OfferLetter[]
 
-  // Prequalification that led to this contract (optional)
-  prequalification            Prequalification?
   // Payment method change requests for this contract
   paymentMethodChangeRequests PaymentMethodChangeRequest[]
 
@@ -1210,31 +1192,35 @@ model ContractDocument {
   @@map("contract_documents")
 }
 
-// FSM transitions for audit
-model ContractTransition {
-  id             String   @id @default(cuid())
-  contractId     String
-  contract       Contract @relation(fields: [contractId], references: [id], onDelete: Cascade)
-  fromState      String
-  toState        String
-  trigger        String
-  metadata       String?  @db.Text // JSON
-  transitionedAt DateTime @default(now())
-
-  @@index([contractId])
-  @@map("contract_transitions")
-}
-
-// Domain events for audit and integration
+// Contract domain events (FSM transitions, payments, documents, etc.)
 model ContractEvent {
   id         String   @id @default(cuid())
   contractId String
   contract   Contract @relation(fields: [contractId], references: [id], onDelete: Cascade)
-  event      String
-  data       String?  @db.Text // JSON
-  createdAt  DateTime @default(now())
+
+  // Event classification
+  eventType  String // STATE.TRANSITION, PHASE.ACTIVATED, PAYMENT.COMPLETED, etc.
+  eventGroup String? // STATE_CHANGE, PAYMENT, DOCUMENT, NOTIFICATION (for filtering)
+
+  // For state transitions (optional - only populated for STATE.TRANSITION events)
+  fromState String?
+  toState   String?
+  trigger   String?
+
+  // Event payload (all event-specific data)
+  data Json?
+
+  // Actor tracking
+  actorId   String?
+  actorType String? // USER, SYSTEM, WEBHOOK
+
+  // Timing
+  occurredAt DateTime @default(now())
 
   @@index([contractId])
+  @@index([eventType])
+  @@index([eventGroup])
+  @@index([occurredAt])
   @@map("contract_events")
 }
 
@@ -1418,120 +1404,6 @@ model ContractTermination {
   @@map("contract_terminations")
 }
 
-// =============================================================================
-// PREQUALIFICATION - Eligibility assessment before contract creation
-// =============================================================================
-// Prequalification is a separate aggregate that evaluates a user's eligibility
-// for a specific product (property + payment method). It captures their answers
-// to eligibility questions and calculates a score. Once approved, it can be
-// linked to a Contract to provide context about how the buyer qualified.
-// =============================================================================
-
-enum PrequalificationStatus {
-  DRAFT
-  SUBMITTED
-  UNDER_REVIEW
-  APPROVED
-  REJECTED
-  EXPIRED
-}
-
-model Prequalification {
-  id       String @id @default(cuid())
-  tenantId String
-  tenant   Tenant @relation(fields: [tenantId], references: [id], onDelete: Cascade)
-  userId   String
-  user     User   @relation(fields: [userId], references: [id], onDelete: Cascade)
-
-  // What they're applying for
-  propertyId      String
-  property        Property              @relation(fields: [propertyId], references: [id], onDelete: Cascade)
-  paymentMethodId String
-  paymentMethod   PropertyPaymentMethod @relation(fields: [paymentMethodId], references: [id])
-
-  // Questionnaire responses and scoring
-  answers Json // Array of {questionId, answer, weight, score}
-  score   Float? // Computed eligibility score (0-100)
-
-  // Financial assessment
-  requestedAmount     Float? // How much they want to finance
-  monthlyIncome       Float? // Self-reported monthly income
-  monthlyExpenses     Float? // Self-reported monthly expenses
-  debtToIncomeRatio   Float? // Computed DTI
-  suggestedTermMonths Int? // System-suggested term based on affordability
-
-  // Status tracking
-  status     PrequalificationStatus @default(DRAFT)
-  notes      String?                @db.Text // Admin notes
-  reviewedBy String? // Admin who reviewed
-  reviewedAt DateTime?
-  expiresAt  DateTime? // Prequalification validity period
-
-  // If approved, may be linked to eventual contract
-  contractId String?   @unique
-  contract   Contract? @relation(fields: [contractId], references: [id])
-
-  // Underwriting decisions for this prequalification
-  underwritingDecisions UnderwritingDecision[]
-
-  createdAt DateTime @default(now())
-  updatedAt DateTime @updatedAt
-
-  @@index([tenantId])
-  @@index([userId])
-  @@index([propertyId])
-  @@index([status])
-  @@map("prequalifications")
-}
-
-// =============================================================================
-// UNDERWRITING DECISION - Automated/manual credit decisions
-// =============================================================================
-// Records each underwriting decision for a prequalification. Multiple decisions
-// may exist if re-evaluation occurs (e.g., after document submission).
-// =============================================================================
-
-model UnderwritingDecision {
-  id       String @id @default(cuid())
-  tenantId String
-  tenant   Tenant @relation(fields: [tenantId], references: [id], onDelete: Cascade)
-
-  // Link to prequalification being evaluated
-  prequalificationId String
-  prequalification   Prequalification @relation(fields: [prequalificationId], references: [id], onDelete: Cascade)
-
-  // Decision outcome
-  decision UnderwritingDecisionKind
-
-  // Scoring and rationale
-  score      Float? // Computed risk score (0-100)
-  reasons    Json? // Array of reason codes/messages for decision
-  conditions Json? // Array of conditions for CONDITIONAL decisions
-
-  // Rule engine metadata
-  rulesVersion String? // Version of rules/model used
-  ruleResults  Json? // Detailed rule evaluation results
-
-  // External data references (credit bureau, verifications)
-  externalChecks Json? // { creditBureau: {...}, incomeVerification: {...} }
-
-  // Manual review (if escalated)
-  isManualReview Boolean   @default(false)
-  reviewedBy     String? // Admin who reviewed
-  reviewedAt     DateTime?
-  reviewNotes    String?   @db.Text
-
-  // Audit
-  createdAt DateTime @default(now())
-  updatedAt DateTime @updatedAt
-
-  @@index([tenantId])
-  @@index([prequalificationId])
-  @@index([decision])
-  @@index([createdAt])
-  @@map("underwriting_decisions")
-}
-
 // =============================================================================
 // PAYMENT METHOD CHANGE REQUEST - Mid-contract payment method changes
 // =============================================================================
@@ -1613,7 +1485,6 @@ model PaymentMethodChangeRequest {
 // =============================================================================
 
 enum DocumentRequirementContext {
-  PREQUALIFICATION // During prequalification
   CONTRACT_PHASE // During a contract phase
   PAYMENT_METHOD_CHANGE // When changing payment method mid-contract
 }