npm - @valentine-efagene/qshelter-common - Versions diffs - 2.0.44 → 2.0.46 - Mend

@valentine-efagene/qshelter-common 2.0.44 → 2.0.46

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (7) hide show

package/dist/generated/client/internal/class.js CHANGED Viewed

@@ -15,7 +15,7 @@ const config = {
     "clientVersion": "7.2.0",
     "engineVersion": "0c8ef2ce45c83248ab3df073180d5eda9e8be7a3",
     "activeProvider": "mysql",
-    "inlineSchema": "// =============================================================================\n// QSHELTER UNIFIED DATABASE SCHEMA\n// =============================================================================\n// This schema contains all database models for the QShelter platform\n// Organized by domain for better readability\n// =============================================================================\n\ngenerator client {\n  provider   = \"prisma-client\"\n  output     = \"../generated/client\"\n  engineType = \"client\"\n}\n\ndatasource db {\n  provider = \"mysql\"\n}\n\n// =============================================================================\n// ENUMS - Database-enforced value constraints\n// =============================================================================\n\nenum PhaseCategory {\n  DOCUMENTATION\n  PAYMENT\n}\n\nenum PhaseType {\n  KYC\n  VERIFICATION\n  DOWNPAYMENT\n  MORTGAGE\n  BALLOON\n  CUSTOM\n}\n\nenum PaymentFrequency {\n  MONTHLY\n  BIWEEKLY\n  WEEKLY\n  ONE_TIME\n  CUSTOM\n}\n\nenum ContractStatus {\n  DRAFT\n  PENDING\n  ACTIVE\n  COMPLETED\n  CANCELLED\n  TERMINATED\n}\n\nenum PhaseStatus {\n  PENDING\n  IN_PROGRESS\n  AWAITING_APPROVAL\n  ACTIVE\n  COMPLETED\n  SKIPPED\n  FAILED\n}\n\nenum StepType {\n  UPLOAD\n  REVIEW\n  SIGNATURE\n  APPROVAL\n  EXTERNAL_CHECK\n  WAIT\n  GENERATE_DOCUMENT // Triggers document generation (offer letters, contracts, etc.)\n}\n\nenum StepStatus {\n  PENDING\n  IN_PROGRESS\n  COMPLETED\n  FAILED\n  SKIPPED\n}\n\nenum InstallmentStatus {\n  PENDING\n  PAID\n  OVERDUE\n  PARTIALLY_PAID\n  WAIVED\n}\n\nenum PaymentStatus {\n  INITIATED\n  PENDING\n  COMPLETED\n  FAILED\n  REFUNDED\n}\n\nenum ApprovalDecision {\n  APPROVED\n  REJECTED\n  REQUEST_CHANGES\n}\n\n// =============================================================================\n// CONTRACT TERMINATION / CANCELLATION ENUMS\n// =============================================================================\n\nenum TerminationType {\n  BUYER_WITHDRAWAL // Buyer wants to cancel (voluntary)\n  SELLER_WITHDRAWAL // Seller/developer cancels\n  MUTUAL_AGREEMENT // Both parties agree to terminate\n  PAYMENT_DEFAULT // Buyer failed payment obligations\n  DOCUMENT_FAILURE // Buyer failed to provide required documents\n  FRAUD // Fraudulent activity detected\n  FORCE_MAJEURE // External circumstances (disaster, etc.)\n  PROPERTY_UNAVAILABLE // Property no longer available\n  REGULATORY // Regulatory/legal requirement\n  OTHER // Other reasons (with notes)\n}\n\nenum TerminationStatus {\n  REQUESTED // Initial request submitted\n  PENDING_REVIEW // Awaiting admin review\n  PENDING_REFUND // Approved, awaiting refund processing\n  REFUND_IN_PROGRESS // Refund being processed\n  REFUND_COMPLETED // Refund completed\n  COMPLETED // Termination fully executed (no refund or refund done)\n  REJECTED // Termination request rejected\n  CANCELLED // Termination request was cancelled\n}\n\nenum RefundStatus {\n  NOT_APPLICABLE // No refund needed (no payments made)\n  PENDING // Refund not yet initiated\n  INITIATED // Refund request sent to payment gateway\n  PROCESSING // Gateway processing refund\n  PARTIAL_COMPLETED // Some refund completed (penalties deducted)\n  COMPLETED // Full refund completed\n  FAILED // Refund failed (needs manual intervention)\n}\n\nenum TerminationInitiator {\n  BUYER\n  SELLER\n  ADMIN\n  SYSTEM\n}\n\nenum CompletionCriterion {\n  DOCUMENT_APPROVALS\n  PAYMENT_AMOUNT\n  STEPS_COMPLETED\n}\n\nenum DocumentStatus {\n  DRAFT\n  PENDING\n  PENDING_SIGNATURE\n  SENT\n  VIEWED\n  SIGNED\n  APPROVED\n  REJECTED\n  EXPIRED\n  CANCELLED\n}\n\nenum OfferLetterType {\n  PROVISIONAL\n  FINAL\n}\n\nenum OfferLetterStatus {\n  DRAFT\n  GENERATED\n  SENT\n  VIEWED\n  SIGNED\n  EXPIRED\n  CANCELLED\n}\n\nenum UnderwritingDecisionKind {\n  APPROVE\n  REJECT\n  CONDITIONAL\n}\n\n// =============================================================================\n// USER & AUTH DOMAIN\n// =============================================================================\n\nmodel User {\n  id                     String            @id @default(cuid())\n  email                  String            @unique\n  password               String?\n  phone                  String?           @unique\n  firstName              String?\n  lastName               String?\n  isActive               Boolean           @default(true)\n  isEmailVerified        Boolean           @default(false)\n  googleId               String?\n  avatar                 String?\n  tenantId               String?\n  tenant                 Tenant?           @relation(fields: [tenantId], references: [id], onDelete: SetNull)\n  // Support multiple roles via explicit join table `UserRole`\n  userRoles              UserRole[]\n  walletId               String?           @unique\n  wallet                 Wallet?           @relation(fields: [walletId], references: [id])\n  createdAt              DateTime          @default(now())\n  updatedAt              DateTime          @updatedAt\n  emailVerifiedAt        DateTime?\n  emailVerificationToken String?\n  lastLoginAt            DateTime?\n  refreshTokens          RefreshToken[]\n  passwordResets         PasswordReset[]\n  suspensions            UserSuspension[]\n  emailPreferences       EmailPreference[]\n  deviceEndpoints        DeviceEndpoint[]\n  socials                Social[]\n\n  // Relations to other domains\n  properties       Property[]\n  contracts        Contract[]        @relation(\"ContractBuyer\")\n  soldContracts    Contract[]        @relation(\"ContractSeller\")\n  contractPayments ContractPayment[] @relation(\"ContractPayer\")\n\n  // Phase step assignments and approvals\n  assignedSteps ContractPhaseStep[]         @relation(\"PhaseStepAssignee\")\n  stepApprovals ContractPhaseStepApproval[] @relation(\"PhaseStepApprover\")\n  uploadedDocs  ContractDocument[]          @relation(\"DocumentUploader\")\n\n  // Prequalification and payment method changes\n  prequalifications           Prequalification[]\n  paymentMethodChangeRequests PaymentMethodChangeRequest[] @relation(\"ChangeRequestor\")\n  reviewedChangeRequests      PaymentMethodChangeRequest[] @relation(\"ChangeReviewer\")\n\n  // Contract terminations\n  initiatedTerminations ContractTermination[] @relation(\"TerminationInitiator\")\n  reviewedTerminations  ContractTermination[] @relation(\"TerminationReviewer\")\n\n  // Offer letters\n  offerLettersGenerated OfferLetter[] @relation(\"OfferLetterGenerator\")\n  offerLettersSent      OfferLetter[] @relation(\"OfferLetterSender\")\n\n  @@index([email])\n  @@index([tenantId])\n  @@map(\"users\")\n}\n\nmodel Role {\n  id          String           @id @default(cuid())\n  name        String           @unique\n  description String?\n  userRoles   UserRole[]\n  permissions RolePermission[]\n  createdAt   DateTime         @default(now())\n  updatedAt   DateTime         @updatedAt\n\n  @@map(\"roles\")\n}\n\nmodel Permission {\n  id          String           @id @default(cuid())\n  name        String           @unique\n  description String?\n  resource    String\n  action      String\n  roles       RolePermission[]\n  createdAt   DateTime         @default(now())\n  updatedAt   DateTime         @updatedAt\n\n  @@unique([resource, action])\n  @@index([resource])\n  @@map(\"permissions\")\n}\n\nmodel RolePermission {\n  roleId       String\n  permissionId String\n  role         Role       @relation(fields: [roleId], references: [id], onDelete: Cascade)\n  permission   Permission @relation(fields: [permissionId], references: [id], onDelete: Cascade)\n  createdAt    DateTime   @default(now())\n\n  @@id([roleId, permissionId])\n  @@map(\"role_permissions\")\n}\n\nmodel UserRole {\n  userId    String\n  roleId    String\n  user      User     @relation(fields: [userId], references: [id], onDelete: Cascade)\n  role      Role     @relation(fields: [roleId], references: [id], onDelete: Cascade)\n  createdAt DateTime @default(now())\n\n  @@id([userId, roleId])\n  @@map(\"user_roles\")\n}\n\nmodel Tenant {\n  id        String   @id @default(cuid())\n  name      String\n  subdomain String   @unique\n  isActive  Boolean  @default(true)\n  createdAt DateTime @default(now())\n  updatedAt DateTime @updatedAt\n\n  // Back-relations for multitenancy\n  users          User[]\n  properties     Property[]\n  paymentPlans   PaymentPlan[]\n  paymentMethods PropertyPaymentMethod[]\n  contracts      Contract[]\n\n  // Prequalification and payment method changes\n  prequalifications           Prequalification[]\n  paymentMethodChangeRequests PaymentMethodChangeRequest[]\n  documentRequirementRules    DocumentRequirementRule[]\n\n  // Contract terminations\n  contractTerminations ContractTermination[]\n\n  // Offer letters and templates\n  documentTemplates DocumentTemplate[]\n  offerLetters      OfferLetter[]\n\n  // Underwriting\n  underwritingDecisions UnderwritingDecision[]\n\n  @@index([subdomain])\n  @@map(\"tenants\")\n}\n\nmodel RefreshToken {\n  id        String   @id @default(cuid())\n  // Use the JWT `jti` for indexed lookups and keep the raw JWT (optional)\n  jti       String?  @unique @db.VarChar(255)\n  token     String?  @db.LongText\n  userId    String\n  user      User     @relation(fields: [userId], references: [id], onDelete: Cascade)\n  expiresAt DateTime\n  createdAt DateTime @default(now())\n\n  @@index([userId])\n  @@index([expiresAt])\n  @@map(\"refresh_tokens\")\n}\n\nmodel PasswordReset {\n  id        String    @id @default(cuid())\n  token     String    @unique\n  userId    String\n  user      User      @relation(fields: [userId], references: [id], onDelete: Cascade)\n  expiresAt DateTime\n  usedAt    DateTime?\n  createdAt DateTime  @default(now())\n\n  @@index([userId])\n  @@index([expiresAt])\n  @@map(\"password_resets\")\n}\n\nmodel UserSuspension {\n  id          String    @id @default(cuid())\n  userId      String\n  user        User      @relation(fields: [userId], references: [id], onDelete: Cascade)\n  reason      String\n  suspendedAt DateTime  @default(now())\n  expiresAt   DateTime?\n  liftedAt    DateTime?\n\n  @@index([userId])\n  @@map(\"user_suspensions\")\n}\n\nmodel EmailPreference {\n  id                  String   @id @default(cuid())\n  userId              String\n  user                User     @relation(fields: [userId], references: [id], onDelete: Cascade)\n  marketingEmails     Boolean  @default(true)\n  transactionalEmails Boolean  @default(true)\n  propertyAlerts      Boolean  @default(true)\n  paymentReminders    Boolean  @default(true)\n  createdAt           DateTime @default(now())\n  updatedAt           DateTime @updatedAt\n\n  @@index([userId])\n  @@map(\"email_preferences\")\n}\n\nmodel DeviceEndpoint {\n  id        String   @id @default(cuid())\n  userId    String\n  user      User     @relation(fields: [userId], references: [id], onDelete: Cascade)\n  endpoint  String // Push notification endpoint\n  platform  String // ios, android, web\n  isActive  Boolean  @default(true)\n  createdAt DateTime @default(now())\n  updatedAt DateTime @updatedAt\n\n  @@index([userId])\n  @@map(\"device_endpoints\")\n}\n\nmodel Social {\n  id        String   @id @default(cuid())\n  userId    String\n  user      User     @relation(fields: [userId], references: [id], onDelete: Cascade)\n  provider  String // google, facebook, twitter, etc\n  socialId  String // ID from the social provider\n  createdAt DateTime @default(now())\n  updatedAt DateTime @updatedAt\n\n  @@unique([provider, socialId])\n  @@index([userId])\n  @@map(\"socials\")\n}\n\nmodel OAuthState {\n  id        String   @id @default(cuid())\n  state     String   @unique\n  expiresAt DateTime\n  createdAt DateTime @default(now())\n\n  @@index([state])\n  @@index([expiresAt])\n  @@map(\"oauth_states\")\n}\n\nmodel Wallet {\n  id           String        @id @default(cuid())\n  balance      Float         @default(0)\n  currency     String        @default(\"USD\")\n  user         User?\n  transactions Transaction[]\n  createdAt    DateTime      @default(now())\n  updatedAt    DateTime      @updatedAt\n\n  @@map(\"wallets\")\n}\n\nmodel Transaction {\n  id          String   @id @default(cuid())\n  walletId    String\n  wallet      Wallet   @relation(fields: [walletId], references: [id], onDelete: Cascade)\n  amount      Float\n  type        String // CREDIT, DEBIT\n  status      String // PENDING, COMPLETED, FAILED\n  reference   String?\n  description String?\n  createdAt   DateTime @default(now())\n  updatedAt   DateTime @updatedAt\n\n  @@index([walletId])\n  @@map(\"transactions\")\n}\n\nmodel Settings {\n  id        String   @id @default(cuid())\n  key       String   @unique\n  value     String   @db.Text\n  category  String?\n  createdAt DateTime @default(now())\n  updatedAt DateTime @updatedAt\n\n  @@index([category])\n  @@map(\"settings\")\n}\n\n// =============================================================================\n// PROPERTY DOMAIN\n// =============================================================================\n// Property = listing/project (e.g., \"Sunrise Estate\")\n// PropertyVariant = configuration with specs & price (e.g., \"3-Bed Corner - Finished\")\n// PropertyUnit = individual sellable unit (e.g., \"Unit A1\")\n// =============================================================================\n\nmodel Property {\n  id             String         @id @default(cuid())\n  tenantId       String\n  tenant         Tenant         @relation(fields: [tenantId], references: [id], onDelete: Cascade)\n  userId         String\n  user           User           @relation(fields: [userId], references: [id], onDelete: Cascade)\n  title          String\n  category       String // SALE, RENT, LEASE\n  propertyType   String // APARTMENT, HOUSE, LAND, COMMERCIAL, ESTATE, TOWNHOUSE\n  country        String\n  currency       String // USD, NGN, etc\n  city           String\n  district       String?\n  zipCode        String?\n  streetAddress  String?\n  longitude      Float?\n  latitude       Float?\n  status         String         @default(\"DRAFT\") // DRAFT, PUBLISHED, SOLD_OUT, ARCHIVED\n  description    String?        @db.Text\n  displayImageId String?\n  displayImage   PropertyMedia? @relation(\"DisplayImage\", fields: [displayImageId], references: [id], onDelete: SetNull)\n  isPublished    Boolean        @default(false)\n  publishedAt    DateTime?\n  createdAt      DateTime       @default(now())\n  updatedAt      DateTime       @updatedAt\n\n  // Relations\n  documents         PropertyDocument[]\n  media             PropertyMedia[]             @relation(\"PropertyMedia\")\n  amenities         PropertyAmenity[] // Shared amenities (gym, pool, security)\n  paymentMethods    PropertyPaymentMethodLink[]\n  variants          PropertyVariant[]\n  prequalifications Prequalification[]\n\n  @@index([tenantId])\n  @@index([userId])\n  @@index([category])\n  @@index([propertyType])\n  @@index([city])\n  @@index([status])\n  @@map(\"properties\")\n}\n\nmodel PropertyMedia {\n  id         String   @id @default(cuid())\n  propertyId String\n  property   Property @relation(\"PropertyMedia\", fields: [propertyId], references: [id], onDelete: Cascade)\n  url        String\n  type       String // IMAGE, VIDEO\n  caption    String?\n  order      Int      @default(0)\n  createdAt  DateTime @default(now())\n  updatedAt  DateTime @updatedAt\n\n  displayForProperties Property[] @relation(\"DisplayImage\")\n\n  @@index([propertyId])\n  @@map(\"property_media\")\n}\n\nmodel PropertyDocument {\n  id         String   @id @default(cuid())\n  propertyId String\n  property   Property @relation(fields: [propertyId], references: [id], onDelete: Cascade)\n  name       String\n  url        String\n  type       String // TITLE_DEED, SURVEY_PLAN, etc\n  createdAt  DateTime @default(now())\n  updatedAt  DateTime @updatedAt\n\n  @@index([propertyId])\n  @@map(\"property_documents\")\n}\n\nmodel Amenity {\n  id         String                   @id @default(cuid())\n  name       String                   @unique\n  category   String? // PROPERTY, VARIANT, BOTH - helps filter which amenities to show\n  icon       String? // Icon name/URL for UI\n  createdAt  DateTime                 @default(now())\n  updatedAt  DateTime                 @updatedAt\n  properties PropertyAmenity[]\n  variants   PropertyVariantAmenity[]\n\n  @@index([category])\n  @@map(\"amenities\")\n}\n\n// =============================================================================\n// PROPERTY VARIANT & UNIT MODELS\n// =============================================================================\n\n// PropertyVariant = specific configuration with its own price and amenities\n// e.g., \"3-Bedroom Corner Piece - Fully Finished\", \"2-Bedroom Standard - Carcass\"\nmodel PropertyVariant {\n  id         String   @id @default(cuid())\n  propertyId String\n  property   Property @relation(fields: [propertyId], references: [id], onDelete: Cascade)\n\n  name        String // \"Corner Piece - Finished\", \"Standard - Carcass\"\n  description String? @db.Text\n\n  // Specifications\n  nBedrooms     Int?\n  nBathrooms    Int?\n  nParkingSpots Int?\n  area          Float? // Square meters/feet\n\n  // Pricing\n  price       Float\n  pricePerSqm Float? // Computed or set manually\n\n  // Inventory counters (denormalized for performance, updated via triggers/service)\n  totalUnits     Int @default(1)\n  availableUnits Int @default(1)\n  reservedUnits  Int @default(0)\n  soldUnits      Int @default(0)\n\n  // Status\n  status    String   @default(\"AVAILABLE\") // AVAILABLE, LOW_STOCK, SOLD_OUT, ARCHIVED\n  isActive  Boolean  @default(true)\n  createdAt DateTime @default(now())\n  updatedAt DateTime @updatedAt\n\n  // Relations\n  amenities PropertyVariantAmenity[]\n  units     PropertyUnit[]\n  media     PropertyVariantMedia[]\n\n  @@index([propertyId])\n  @@index([status])\n  @@index([price])\n  @@map(\"property_variants\")\n}\n\n// PropertyVariantAmenity = amenities specific to a variant\n// e.g., \"Finished Kitchen\", \"Smart Home System\", \"Private Garden\"\nmodel PropertyVariantAmenity {\n  variantId String\n  amenityId String\n  variant   PropertyVariant @relation(fields: [variantId], references: [id], onDelete: Cascade)\n  amenity   Amenity         @relation(fields: [amenityId], references: [id], onDelete: Cascade)\n  createdAt DateTime        @default(now())\n\n  @@id([variantId, amenityId])\n  @@map(\"property_variant_amenities\")\n}\n\n// PropertyVariantMedia = images/videos specific to a variant\nmodel PropertyVariantMedia {\n  id        String          @id @default(cuid())\n  variantId String\n  variant   PropertyVariant @relation(fields: [variantId], references: [id], onDelete: Cascade)\n  url       String\n  type      String // IMAGE, VIDEO, FLOOR_PLAN, 3D_TOUR\n  caption   String?\n  order     Int             @default(0)\n  createdAt DateTime        @default(now())\n  updatedAt DateTime        @updatedAt\n\n  @@index([variantId])\n  @@map(\"property_variant_media\")\n}\n\n// PropertyUnit = individual sellable/rentable unit within a variant\n// e.g., \"Unit A1\", \"Block B - Flat 3\", \"Plot 15\"\nmodel PropertyUnit {\n  id        String          @id @default(cuid())\n  variantId String\n  variant   PropertyVariant @relation(fields: [variantId], references: [id], onDelete: Cascade)\n\n  unitNumber  String // \"A1\", \"B-3\", \"Plot 15\"\n  floorNumber Int? // For apartments\n  blockName   String? // \"Block A\", \"Tower 1\"\n\n  // Unit-specific overrides (if different from variant)\n  priceOverride Float? // If this specific unit has a different price\n  areaOverride  Float? // If this specific unit has a different area\n  notes         String? @db.Text // Internal notes about this unit\n\n  // Status tracking\n  status String @default(\"AVAILABLE\") // AVAILABLE, RESERVED, SOLD, RENTED, UNAVAILABLE\n\n  // Reservation/hold\n  reservedAt    DateTime?\n  reservedUntil DateTime?\n  reservedById  String?\n\n  // Ownership tracking (once sold)\n  ownerId String?\n\n  createdAt DateTime @default(now())\n  updatedAt DateTime @updatedAt\n\n  // Relations\n  contracts Contract[]\n\n  @@unique([variantId, unitNumber])\n  @@index([variantId])\n  @@index([status])\n  @@map(\"property_units\")\n}\n\nmodel PropertyAmenity {\n  propertyId String\n  amenityId  String\n  property   Property @relation(fields: [propertyId], references: [id], onDelete: Cascade)\n  amenity    Amenity  @relation(fields: [amenityId], references: [id], onDelete: Cascade)\n  createdAt  DateTime @default(now())\n\n  @@id([propertyId, amenityId])\n  @@map(\"property_amenities\")\n}\n\n// =============================================================================\n// PAYMENT PLAN DOMAIN - Reusable installment structure templates\n// =============================================================================\n\n// PaymentPlan = reusable structure for how payments are scheduled\n// Examples: \"Monthly360\" (360 monthly payments), \"Weekly52\", \"OneTime\"\nmodel PaymentPlan {\n  id          String  @id @default(cuid())\n  tenantId    String? // NULL = global template available to all tenants\n  tenant      Tenant? @relation(fields: [tenantId], references: [id], onDelete: Cascade)\n  name        String\n  description String? @db.Text\n  isActive    Boolean @default(true)\n\n  // Structure configuration\n  paymentFrequency       PaymentFrequency\n  customFrequencyDays    Int?\n  numberOfInstallments   Int // 1 for one-time, 360 for 30yr monthly, etc\n  calculateInterestDaily Boolean          @default(false)\n  gracePeriodDays        Int              @default(0)\n\n  // Fund collection behavior\n  // true = we collect funds via wallet/gateway (e.g., downpayment)\n  // false = external payment, we only track/reconcile (e.g., bank mortgage)\n  collectFunds Boolean @default(true)\n\n  createdAt DateTime @default(now())\n  updatedAt DateTime @updatedAt\n\n  // Used by property payment method phases (templates)\n  methodPhases   PropertyPaymentMethodPhase[]\n  // Used by instantiated contract phases\n  contractPhases ContractPhase[]\n\n  @@unique([tenantId, name]) // Unique per tenant, or globally if tenantId is null\n  @@index([tenantId])\n  @@map(\"payment_plans\")\n}\n\n// =============================================================================\n// PROPERTY PAYMENT METHOD DOMAIN - Product offerings per property\n// =============================================================================\n\n// PropertyPaymentMethod = how a property can be purchased (e.g., \"Standard Mortgage\", \"Cash\", \"Rent-to-Own\")\nmodel PropertyPaymentMethod {\n  id          String  @id @default(cuid())\n  tenantId    String\n  tenant      Tenant  @relation(fields: [tenantId], references: [id], onDelete: Cascade)\n  name        String // \"Standard Mortgage\", \"Flexible Payment\", \"Cash Purchase\"\n  description String? @db.Text\n  isActive    Boolean @default(true)\n\n  // Global method configuration\n  allowEarlyPayoff       Boolean @default(true)\n  earlyPayoffPenaltyRate Float?\n  autoActivatePhases     Boolean @default(true)\n  requiresManualApproval Boolean @default(false)\n\n  createdAt DateTime @default(now())\n  updatedAt DateTime @updatedAt\n\n  // Many-to-many with properties\n  properties PropertyPaymentMethodLink[]\n  // Phases that make up this method (templates)\n  phases     PropertyPaymentMethodPhase[]\n  // Contracts using this method\n  contracts  Contract[]\n\n  // Prequalifications for this payment method\n  prequalifications Prequalification[]\n\n  // Payment method change tracking\n  changeRequestsFrom PaymentMethodChangeRequest[] @relation(\"ChangeFromMethod\")\n  changeRequestsTo   PaymentMethodChangeRequest[] @relation(\"ChangeToMethod\")\n\n  // Document requirement rules\n  documentRules   DocumentRequirementRule[] @relation(\"RulePaymentMethod\")\n  changeRulesFrom DocumentRequirementRule[] @relation(\"RuleFromMethod\")\n  changeRulesTo   DocumentRequirementRule[] @relation(\"RuleToMethod\")\n\n  @@unique([tenantId, name]) // Unique per tenant\n  @@index([tenantId])\n  @@map(\"property_payment_methods\")\n}\n\n// Many-to-many link between Property and PaymentMethod\nmodel PropertyPaymentMethodLink {\n  propertyId      String\n  property        Property              @relation(fields: [propertyId], references: [id], onDelete: Cascade)\n  paymentMethodId String\n  paymentMethod   PropertyPaymentMethod @relation(fields: [paymentMethodId], references: [id], onDelete: Cascade)\n\n  // Method-specific overrides for this property\n  isDefault Boolean  @default(false)\n  isActive  Boolean  @default(true)\n  createdAt DateTime @default(now())\n\n  @@id([propertyId, paymentMethodId])\n  @@map(\"property_payment_method_links\")\n}\n\n// Phase template within a PropertyPaymentMethod (e.g., documentation, downpayment, mortgage)\n// phaseCategory determines the FSM type: DOCUMENTATION or PAYMENT\nmodel PropertyPaymentMethodPhase {\n  id              String                @id @default(cuid())\n  paymentMethodId String\n  paymentMethod   PropertyPaymentMethod @relation(fields: [paymentMethodId], references: [id], onDelete: Cascade)\n  paymentPlanId   String? // Only for PAYMENT phases\n  paymentPlan     PaymentPlan?          @relation(fields: [paymentPlanId], references: [id])\n\n  name        String\n  description String? @db.Text\n\n  // Phase classification (DB-enforced enums)\n  phaseCategory PhaseCategory\n  phaseType     PhaseType\n  order         Int\n\n  // Financial configuration (for PAYMENT phases)\n  interestRate   Float?\n  percentOfPrice Float? // e.g., 10.0 for 10% downpayment\n\n  // Fund collection behavior (inherited from PaymentPlan if not set)\n  // true = we collect funds via wallet/gateway (e.g., downpayment)\n  // false = external payment, we only track/reconcile (e.g., bank mortgage)\n  collectFunds Boolean? // null = inherit from PaymentPlan\n\n  // Activation rules\n  requiresPreviousPhaseCompletion Boolean              @default(true)\n  minimumCompletionPercentage     Float?\n  completionCriterion             CompletionCriterion?\n\n  // Snapshots for audit (original config at creation time)\n  stepDefinitionsSnapshot  Json?\n  requiredDocumentSnapshot Json?\n\n  createdAt DateTime @default(now())\n  updatedAt DateTime @updatedAt\n\n  // Normalized child tables (for DOCUMENTATION phases)\n  steps             PaymentMethodPhaseStep[]\n  requiredDocuments PaymentMethodPhaseDocument[]\n\n  @@index([paymentMethodId])\n  @@index([paymentPlanId])\n  @@index([phaseCategory])\n  @@map(\"property_payment_method_phases\")\n}\n\n// Step template within a DOCUMENTATION phase\nmodel PaymentMethodPhaseStep {\n  id      String                     @id @default(cuid())\n  phaseId String\n  phase   PropertyPaymentMethodPhase @relation(fields: [phaseId], references: [id], onDelete: Cascade)\n\n  name     String\n  stepType StepType\n  order    Int\n\n  metadata  Json?\n  createdAt DateTime @default(now())\n  updatedAt DateTime @updatedAt\n\n  @@index([phaseId])\n  @@map(\"payment_method_phase_steps\")\n}\n\n// Required document within a DOCUMENTATION phase\nmodel PaymentMethodPhaseDocument {\n  id      String                     @id @default(cuid())\n  phaseId String\n  phase   PropertyPaymentMethodPhase @relation(fields: [phaseId], references: [id], onDelete: Cascade)\n\n  documentType     String\n  isRequired       Boolean @default(true)\n  description      String? @db.Text\n  allowedMimeTypes String? // CSV: application/pdf,image/jpeg\n  maxSizeBytes     Int?\n\n  metadata  Json?\n  createdAt DateTime @default(now())\n\n  @@index([phaseId, documentType])\n  @@map(\"payment_method_phase_documents\")\n}\n\n// =============================================================================\n// CONTRACT DOMAIN - Unified agreement model (replaces Mortgage, PurchasePlan, etc.)\n// =============================================================================\n// Contract is the canonical agreement. \"Mortgage\" is just a product configuration\n// that creates a Contract with specific phases (documentation, downpayment, long-term payment).\n// Phases can be DOCUMENTATION (FSM for approvals) or PAYMENT (PaymentPlan-driven installments).\n// =============================================================================\n\nmodel Contract {\n  id              String                 @id @default(cuid())\n  tenantId        String\n  tenant          Tenant                 @relation(fields: [tenantId], references: [id], onDelete: Cascade)\n  // Link to specific unit being purchased/rented\n  propertyUnitId  String\n  propertyUnit    PropertyUnit           @relation(fields: [propertyUnitId], references: [id], onDelete: Cascade)\n  buyerId         String\n  buyer           User                   @relation(\"ContractBuyer\", fields: [buyerId], references: [id], onDelete: Cascade)\n  sellerId        String?\n  seller          User?                  @relation(\"ContractSeller\", fields: [sellerId], references: [id])\n  paymentMethodId String? // PropertyPaymentMethod used to create this contract\n  paymentMethod   PropertyPaymentMethod? @relation(fields: [paymentMethodId], references: [id])\n\n  // Contract identification\n  contractNumber String  @unique\n  title          String\n  description    String? @db.Text\n  contractType   String // Admin-defined: MORTGAGE, INSTALLMENT, RENT_TO_OWN, CASH, LEASE, etc.\n\n  // Financial summary (computed from phases)\n  totalAmount       Float // Total contract value (from unit price or negotiated)\n  downPayment       Float  @default(0)\n  downPaymentPaid   Float  @default(0)\n  principal         Float? // Financed amount (if applicable)\n  interestRate      Float? // Overall interest rate (if applicable)\n  termMonths        Int? // Total term (if applicable)\n  periodicPayment   Float? // Computed periodic payment (if applicable)\n  totalPaidToDate   Float  @default(0)\n  totalInterestPaid Float  @default(0)\n\n  // FSM state (DB-enforced enums)\n  status         ContractStatus @default(DRAFT)\n  state          ContractStatus @default(DRAFT) // FSM state for workflow\n  currentPhaseId String?\n\n  // Timing\n  nextPaymentDueDate DateTime?\n  lastReminderSentAt DateTime?\n  startDate          DateTime?\n  endDate            DateTime?\n  signedAt           DateTime?\n  terminatedAt       DateTime?\n  createdAt          DateTime  @default(now())\n  updatedAt          DateTime  @updatedAt\n\n  // Relations\n  phases       ContractPhase[]\n  documents    ContractDocument[]\n  payments     ContractPayment[]\n  transitions  ContractTransition[]\n  events       ContractEvent[]\n  terminations ContractTermination[]\n  offerLetters OfferLetter[]\n\n  // Prequalification that led to this contract (optional)\n  prequalification            Prequalification?\n  // Payment method change requests for this contract\n  paymentMethodChangeRequests PaymentMethodChangeRequest[]\n\n  @@index([tenantId])\n  @@index([propertyUnitId])\n  @@index([buyerId])\n  @@index([sellerId])\n  @@index([paymentMethodId])\n  @@index([status])\n  @@index([state])\n  @@map(\"contracts\")\n}\n\n// Phase within a contract - can be DOCUMENTATION or PAYMENT type\n// Admin names phases freely (e.g., \"KYC Documents\", \"Downpayment\", \"Monthly Mortgage\")\nmodel ContractPhase {\n  id            String       @id @default(cuid())\n  contractId    String\n  contract      Contract     @relation(fields: [contractId], references: [id], onDelete: Cascade)\n  paymentPlanId String? // Only for PAYMENT phases\n  paymentPlan   PaymentPlan? @relation(fields: [paymentPlanId], references: [id])\n\n  // Admin-defined naming\n  name        String\n  description String? @db.Text\n\n  // Phase classification (DB-enforced enums)\n  phaseCategory PhaseCategory\n  phaseType     PhaseType\n  order         Int\n\n  // FSM state for this phase (DB-enforced enum)\n  status PhaseStatus @default(PENDING)\n\n  // Financial details (for PAYMENT phases)\n  totalAmount     Float?\n  paidAmount      Float  @default(0)\n  remainingAmount Float?\n  interestRate    Float?\n\n  // Fund collection behavior (snapshotted from template at contract creation)\n  // true = we collect funds via wallet/gateway (e.g., downpayment)\n  // false = external payment, we only track/reconcile (e.g., bank mortgage)\n  collectFunds Boolean @default(true)\n\n  // Progress counters (for efficient activation checks)\n  approvedDocumentsCount Int @default(0)\n  requiredDocumentsCount Int @default(0)\n  completedStepsCount    Int @default(0)\n  totalStepsCount        Int @default(0)\n\n  // Timing\n  dueDate     DateTime?\n  startDate   DateTime?\n  endDate     DateTime?\n  activatedAt DateTime?\n  completedAt DateTime?\n\n  // Activation rules\n  requiresPreviousPhaseCompletion Boolean              @default(true)\n  minimumCompletionPercentage     Float?\n  completionCriterion             CompletionCriterion?\n\n  // Snapshots for audit (effective config at contract creation)\n  paymentPlanSnapshot      Json?\n  stepDefinitionsSnapshot  Json?\n  requiredDocumentSnapshot Json?\n\n  createdAt DateTime @default(now())\n  updatedAt DateTime @updatedAt\n\n  // Relations\n  installments ContractInstallment[]\n  payments     ContractPayment[]\n  steps        ContractPhaseStep[] // For DOCUMENTATION phases (FSM steps)\n\n  @@index([contractId])\n  @@index([paymentPlanId])\n  @@index([phaseCategory])\n  @@index([status])\n  @@index([order])\n  @@map(\"contract_phases\")\n}\n\n// Steps within a DOCUMENTATION phase (FSM for document collection/approval)\nmodel ContractPhaseStep {\n  id      String        @id @default(cuid())\n  phaseId String\n  phase   ContractPhase @relation(fields: [phaseId], references: [id], onDelete: Cascade)\n\n  name        String\n  description String?  @db.Text\n  stepType    StepType\n  order       Int\n\n  status StepStatus @default(PENDING)\n\n  // Configuration metadata (for GENERATE_DOCUMENT steps, etc.)\n  metadata Json?\n\n  // Assignment\n  assigneeId String?\n  assignee   User?   @relation(\"PhaseStepAssignee\", fields: [assigneeId], references: [id])\n\n  // Required document types for UPLOAD steps (normalized)\n  requiredDocuments ContractPhaseStepDocument[]\n\n  // Timing\n  dueDate     DateTime?\n  completedAt DateTime?\n\n  createdAt DateTime @default(now())\n  updatedAt DateTime @updatedAt\n\n  approvals ContractPhaseStepApproval[]\n\n  @@index([phaseId])\n  @@index([status])\n  @@index([order])\n  @@map(\"contract_phase_steps\")\n}\n\n// Required documents for a step (normalized from CSV)\nmodel ContractPhaseStepDocument {\n  id     String            @id @default(cuid())\n  stepId String\n  step   ContractPhaseStep @relation(fields: [stepId], references: [id], onDelete: Cascade)\n\n  documentType String\n  isRequired   Boolean @default(true)\n\n  createdAt DateTime @default(now())\n\n  @@index([stepId, documentType])\n  @@map(\"contract_phase_step_documents\")\n}\n\n// Approvals for documentation steps\nmodel ContractPhaseStepApproval {\n  id         String            @id @default(cuid())\n  stepId     String\n  step       ContractPhaseStep @relation(fields: [stepId], references: [id], onDelete: Cascade)\n  approverId String?\n  approver   User?             @relation(\"PhaseStepApprover\", fields: [approverId], references: [id])\n\n  decision  ApprovalDecision\n  comment   String?          @db.Text\n  decidedAt DateTime         @default(now())\n\n  createdAt DateTime @default(now())\n\n  @@index([stepId])\n  @@map(\"contract_phase_step_approvals\")\n}\n\n// Installments within a PAYMENT phase\nmodel ContractInstallment {\n  id      String        @id @default(cuid())\n  phaseId String\n  phase   ContractPhase @relation(fields: [phaseId], references: [id], onDelete: Cascade)\n\n  installmentNumber Int\n\n  amount          Float\n  principalAmount Float @default(0)\n  interestAmount  Float @default(0)\n\n  dueDate DateTime\n  status  InstallmentStatus @default(PENDING)\n\n  paidAmount Float     @default(0)\n  paidDate   DateTime?\n\n  lateFee            Float     @default(0)\n  lateFeeWaived      Boolean   @default(false)\n  gracePeriodDays    Int       @default(0)\n  gracePeriodEndDate DateTime?\n\n  createdAt DateTime @default(now())\n  updatedAt DateTime @updatedAt\n\n  payments ContractPayment[]\n\n  @@index([phaseId])\n  @@index([dueDate])\n  @@index([status])\n  @@map(\"contract_installments\")\n}\n\n// Unified payment record for contracts\nmodel ContractPayment {\n  id            String               @id @default(cuid())\n  contractId    String\n  contract      Contract             @relation(fields: [contractId], references: [id], onDelete: Cascade)\n  phaseId       String?\n  phase         ContractPhase?       @relation(fields: [phaseId], references: [id])\n  installmentId String?\n  installment   ContractInstallment? @relation(fields: [installmentId], references: [id])\n  payerId       String?\n  payer         User?                @relation(\"ContractPayer\", fields: [payerId], references: [id])\n\n  amount          Float\n  principalAmount Float @default(0)\n  interestAmount  Float @default(0)\n  lateFeeAmount   Float @default(0)\n\n  paymentMethod String // BANK_TRANSFER, CREDIT_CARD, WALLET, CASH, CHECK\n  status        PaymentStatus @default(INITIATED)\n\n  reference       String? @unique\n  gatewayResponse String? @db.Text // JSON\n\n  processedAt DateTime?\n  createdAt   DateTime  @default(now())\n  updatedAt   DateTime  @updatedAt\n\n  @@index([contractId])\n  @@index([phaseId])\n  @@index([installmentId])\n  @@index([payerId])\n  @@index([status])\n  @@index([reference])\n  @@map(\"contract_payments\")\n}\n\n// Contract documents (owned by contract, linked to phases/steps as needed)\nmodel ContractDocument {\n  id         String   @id @default(cuid())\n  contractId String\n  contract   Contract @relation(fields: [contractId], references: [id], onDelete: Cascade)\n  phaseId    String? // Optional link to specific phase\n  stepId     String? // Optional link to specific step\n\n  name         String\n  url          String\n  type         String // ID, BANK_STATEMENT, INCOME_PROOF, TITLE_DEED, SIGNATURE, etc.\n  uploadedById String?\n  uploadedBy   User?   @relation(\"DocumentUploader\", fields: [uploadedById], references: [id])\n\n  status DocumentStatus @default(PENDING)\n\n  createdAt DateTime @default(now())\n  updatedAt DateTime @updatedAt\n\n  @@index([contractId])\n  @@index([phaseId])\n  @@index([stepId])\n  @@index([type])\n  @@index([status])\n  @@map(\"contract_documents\")\n}\n\n// FSM transitions for audit\nmodel ContractTransition {\n  id             String   @id @default(cuid())\n  contractId     String\n  contract       Contract @relation(fields: [contractId], references: [id], onDelete: Cascade)\n  fromState      String\n  toState        String\n  trigger        String\n  metadata       String?  @db.Text // JSON\n  transitionedAt DateTime @default(now())\n\n  @@index([contractId])\n  @@map(\"contract_transitions\")\n}\n\n// Domain events for audit and integration\nmodel ContractEvent {\n  id         String   @id @default(cuid())\n  contractId String\n  contract   Contract @relation(fields: [contractId], references: [id], onDelete: Cascade)\n  event      String\n  data       String?  @db.Text // JSON\n  createdAt  DateTime @default(now())\n\n  @@index([contractId])\n  @@map(\"contract_events\")\n}\n\n// =============================================================================\n// OFFER LETTERS - Provisional and Final offer documents\n// =============================================================================\n\nmodel DocumentTemplate {\n  id       String @id @default(cuid())\n  tenantId String\n  tenant   Tenant @relation(fields: [tenantId], references: [id], onDelete: Cascade)\n\n  name        String // \"Provisional Offer Letter\", \"Final Offer Letter\"\n  code        String // PROVISIONAL_OFFER, FINAL_OFFER\n  description String?\n  version     Int     @default(1)\n\n  // Template content (Handlebars)\n  htmlTemplate String  @db.Text\n  cssStyles    String? @db.Text\n\n  // Merge field definitions for UI\n  mergeFields Json? // [{name, type, required, description}]\n\n  isActive  Boolean @default(true)\n  isDefault Boolean @default(false)\n\n  createdAt DateTime @default(now())\n  updatedAt DateTime @updatedAt\n\n  offerLetters OfferLetter[]\n\n  @@unique([tenantId, code, version])\n  @@index([tenantId])\n  @@index([code])\n  @@map(\"document_templates\")\n}\n\nmodel OfferLetter {\n  id         String   @id @default(cuid())\n  tenantId   String\n  tenant     Tenant   @relation(fields: [tenantId], references: [id], onDelete: Cascade)\n  contractId String\n  contract   Contract @relation(fields: [contractId], references: [id], onDelete: Cascade)\n\n  // Template used\n  templateId String\n  template   DocumentTemplate @relation(fields: [templateId], references: [id])\n\n  // Letter details\n  letterNumber String            @unique // OL-XXXXXX\n  type         OfferLetterType\n  status       OfferLetterStatus @default(DRAFT)\n\n  // Generated document\n  htmlContent String? @db.Text // Rendered HTML\n  pdfUrl      String? // S3 URL of generated PDF\n  pdfKey      String? // S3 key for deletion/access\n\n  // Merge data used (snapshot for audit)\n  mergeData Json? // All data merged into template\n\n  // Signing workflow\n  sentAt        DateTime?\n  viewedAt      DateTime?\n  signedAt      DateTime?\n  signatureIp   String?\n  signatureData Json? // {method, timestamp, metadata}\n\n  // Validity\n  expiresAt    DateTime?\n  expiredAt    DateTime?\n  cancelledAt  DateTime?\n  cancelReason String?\n\n  // Audit\n  generatedById String?\n  generatedBy   User?   @relation(\"OfferLetterGenerator\", fields: [generatedById], references: [id])\n  sentById      String?\n  sentBy        User?   @relation(\"OfferLetterSender\", fields: [sentById], references: [id])\n\n  createdAt DateTime @default(now())\n  updatedAt DateTime @updatedAt\n\n  @@index([tenantId])\n  @@index([contractId])\n  @@index([type])\n  @@index([status])\n  @@map(\"offer_letters\")\n}\n\n// =============================================================================\n// CONTRACT TERMINATION - Full lifecycle for cancellation/termination\n// =============================================================================\n// Tracks termination requests from initiation through refund completion.\n// Industry-standard flow:\n// 1. Request created (by buyer/seller/admin/system)\n// 2. Admin reviews (if required by policy)\n// 3. Financial settlement calculated (refunds, penalties, forfeitures)\n// 4. Refund processed (if applicable)\n// 5. Contract marked terminated, unit released\n// =============================================================================\n\nmodel ContractTermination {\n  id         String   @id @default(cuid())\n  contractId String\n  contract   Contract @relation(fields: [contractId], references: [id], onDelete: Cascade)\n  tenantId   String\n  tenant     Tenant   @relation(fields: [tenantId], references: [id], onDelete: Cascade)\n\n  // Request identification\n  requestNumber String @unique // TRM-XXXXXX\n\n  // Who initiated and why\n  initiatedBy    TerminationInitiator\n  initiatorId    String? // userId if BUYER/SELLER/ADMIN\n  initiator      User?                @relation(\"TerminationInitiator\", fields: [initiatorId], references: [id])\n  type           TerminationType\n  reason         String?              @db.Text\n  supportingDocs Json? // [{type, url, uploadedAt}]\n\n  // Workflow status\n  status              TerminationStatus @default(REQUESTED)\n  requiresApproval    Boolean           @default(true)\n  autoApproveEligible Boolean           @default(false) // Pre-signature, no payments\n\n  // Admin review\n  reviewedBy      String?\n  reviewer        User?     @relation(\"TerminationReviewer\", fields: [reviewedBy], references: [id])\n  reviewedAt      DateTime?\n  reviewNotes     String?   @db.Text\n  rejectionReason String?   @db.Text\n\n  // Financial snapshot at time of request\n  contractSnapshot    Json // Full contract state snapshot\n  totalContractAmount Float\n  totalPaidToDate     Float\n  outstandingBalance  Float\n\n  // Settlement calculation\n  refundableAmount Float   @default(0) // Amount eligible for refund\n  penaltyAmount    Float   @default(0) // Penalties/fees to deduct\n  forfeitedAmount  Float   @default(0) // Amount forfeited (non-refundable deposits)\n  adminFeeAmount   Float   @default(0) // Processing fees\n  netRefundAmount  Float   @default(0) // refundableAmount - penaltyAmount - adminFeeAmount\n  settlementNotes  String? @db.Text\n\n  // Refund processing\n  refundStatus         RefundStatus @default(NOT_APPLICABLE)\n  refundReference      String? // Payment gateway reference\n  refundMethod         String? // ORIGINAL_METHOD, BANK_TRANSFER, CHECK, WALLET\n  refundAccountDetails Json? // Encrypted bank details if needed\n  refundInitiatedAt    DateTime?\n  refundCompletedAt    DateTime?\n  refundFailureReason  String?      @db.Text\n\n  // Property unit handling\n  unitReleasedAt    DateTime?\n  unitReservedForId String? // If unit being held for another buyer\n\n  // Timing\n  requestedAt DateTime  @default(now())\n  approvedAt  DateTime?\n  executedAt  DateTime?\n  completedAt DateTime?\n  cancelledAt DateTime?\n\n  // Idempotency and audit\n  idempotencyKey String? @unique\n  metadata       Json?\n\n  createdAt DateTime @default(now())\n  updatedAt DateTime @updatedAt\n\n  @@index([contractId])\n  @@index([tenantId])\n  @@index([status])\n  @@index([type])\n  @@index([initiatorId])\n  @@index([requestedAt])\n  @@map(\"contract_terminations\")\n}\n\n// =============================================================================\n// PREQUALIFICATION - Eligibility assessment before contract creation\n// =============================================================================\n// Prequalification is a separate aggregate that evaluates a user's eligibility\n// for a specific product (property + payment method). It captures their answers\n// to eligibility questions and calculates a score. Once approved, it can be\n// linked to a Contract to provide context about how the buyer qualified.\n// =============================================================================\n\nenum PrequalificationStatus {\n  DRAFT\n  SUBMITTED\n  UNDER_REVIEW\n  APPROVED\n  REJECTED\n  EXPIRED\n}\n\nmodel Prequalification {\n  id       String @id @default(cuid())\n  tenantId String\n  tenant   Tenant @relation(fields: [tenantId], references: [id], onDelete: Cascade)\n  userId   String\n  user     User   @relation(fields: [userId], references: [id], onDelete: Cascade)\n\n  // What they're applying for\n  propertyId      String\n  property        Property              @relation(fields: [propertyId], references: [id], onDelete: Cascade)\n  paymentMethodId String\n  paymentMethod   PropertyPaymentMethod @relation(fields: [paymentMethodId], references: [id])\n\n  // Questionnaire responses and scoring\n  answers Json // Array of {questionId, answer, weight, score}\n  score   Float? // Computed eligibility score (0-100)\n\n  // Financial assessment\n  requestedAmount     Float? // How much they want to finance\n  monthlyIncome       Float? // Self-reported monthly income\n  monthlyExpenses     Float? // Self-reported monthly expenses\n  debtToIncomeRatio   Float? // Computed DTI\n  suggestedTermMonths Int? // System-suggested term based on affordability\n\n  // Status tracking\n  status     PrequalificationStatus @default(DRAFT)\n  notes      String?                @db.Text // Admin notes\n  reviewedBy String? // Admin who reviewed\n  reviewedAt DateTime?\n  expiresAt  DateTime? // Prequalification validity period\n\n  // If approved, may be linked to eventual contract\n  contractId String?   @unique\n  contract   Contract? @relation(fields: [contractId], references: [id])\n\n  // Underwriting decisions for this prequalification\n  underwritingDecisions UnderwritingDecision[]\n\n  createdAt DateTime @default(now())\n  updatedAt DateTime @updatedAt\n\n  @@index([tenantId])\n  @@index([userId])\n  @@index([propertyId])\n  @@index([status])\n  @@map(\"prequalifications\")\n}\n\n// =============================================================================\n// UNDERWRITING DECISION - Automated/manual credit decisions\n// =============================================================================\n// Records each underwriting decision for a prequalification. Multiple decisions\n// may exist if re-evaluation occurs (e.g., after document submission).\n// =============================================================================\n\nmodel UnderwritingDecision {\n  id       String @id @default(cuid())\n  tenantId String\n  tenant   Tenant @relation(fields: [tenantId], references: [id], onDelete: Cascade)\n\n  // Link to prequalification being evaluated\n  prequalificationId String\n  prequalification   Prequalification @relation(fields: [prequalificationId], references: [id], onDelete: Cascade)\n\n  // Decision outcome\n  decision UnderwritingDecisionKind\n\n  // Scoring and rationale\n  score      Float? // Computed risk score (0-100)\n  reasons    Json? // Array of reason codes/messages for decision\n  conditions Json? // Array of conditions for CONDITIONAL decisions\n\n  // Rule engine metadata\n  rulesVersion String? // Version of rules/model used\n  ruleResults  Json? // Detailed rule evaluation results\n\n  // External data references (credit bureau, verifications)\n  externalChecks Json? // { creditBureau: {...}, incomeVerification: {...} }\n\n  // Manual review (if escalated)\n  isManualReview Boolean   @default(false)\n  reviewedBy     String? // Admin who reviewed\n  reviewedAt     DateTime?\n  reviewNotes    String?   @db.Text\n\n  // Audit\n  createdAt DateTime @default(now())\n  updatedAt DateTime @updatedAt\n\n  @@index([tenantId])\n  @@index([prequalificationId])\n  @@index([decision])\n  @@index([createdAt])\n  @@map(\"underwriting_decisions\")\n}\n\n// =============================================================================\n// PAYMENT METHOD CHANGE REQUEST - Mid-contract payment method changes\n// =============================================================================\n// When a user wants to change their payment method after contract creation,\n// this aggregate tracks the request, required documentation, approvals, and\n// final execution. Different from-to combinations may require different docs.\n// =============================================================================\n\nenum PaymentMethodChangeStatus {\n  PENDING_DOCUMENTS\n  DOCUMENTS_SUBMITTED\n  UNDER_REVIEW\n  APPROVED\n  REJECTED\n  EXECUTED\n  CANCELLED\n}\n\nmodel PaymentMethodChangeRequest {\n  id         String   @id @default(cuid())\n  tenantId   String\n  tenant     Tenant   @relation(fields: [tenantId], references: [id], onDelete: Cascade)\n  contractId String\n  contract   Contract @relation(fields: [contractId], references: [id], onDelete: Cascade)\n\n  // The change being requested\n  fromPaymentMethodId String\n  fromPaymentMethod   PropertyPaymentMethod @relation(\"ChangeFromMethod\", fields: [fromPaymentMethodId], references: [id])\n  toPaymentMethodId   String\n  toPaymentMethod     PropertyPaymentMethod @relation(\"ChangeToMethod\", fields: [toPaymentMethodId], references: [id])\n\n  // Who requested and why\n  requestorId String\n  requestor   User    @relation(\"ChangeRequestor\", fields: [requestorId], references: [id])\n  reason      String? @db.Text\n\n  // Documentation requirements (determined by DocumentRequirementRule)\n  requiredDocumentTypes String? // CSV: BANK_STATEMENT,INCOME_PROOF,NEW_EMPLOYER_LETTER\n  submittedDocuments    Json? // [{type, s3Key, uploadedAt, status}]\n\n  // Financial impact assessment\n  currentOutstanding   Float? // Outstanding balance at time of request\n  newTermMonths        Int? // New term if applicable\n  newInterestRate      Float? // New rate if applicable\n  newMonthlyPayment    Float? // Projected new payment\n  penaltyAmount        Float? // Early change penalty if applicable\n  financialImpactNotes String? @db.Text\n\n  // Status and workflow\n  status      PaymentMethodChangeStatus @default(PENDING_DOCUMENTS)\n  reviewerId  String?\n  reviewer    User?                     @relation(\"ChangeReviewer\", fields: [reviewerId], references: [id])\n  reviewNotes String?                   @db.Text\n  reviewedAt  DateTime?\n\n  // Execution details\n  executedAt        DateTime?\n  previousPhaseData Json? // Snapshot of phases before change\n  newPhaseData      Json? // New phases created after change\n\n  createdAt DateTime @default(now())\n  updatedAt DateTime @updatedAt\n\n  @@index([tenantId])\n  @@index([contractId])\n  @@index([status])\n  @@index([requestorId])\n  @@map(\"payment_method_change_requests\")\n}\n\n// =============================================================================\n// DOCUMENT REQUIREMENT RULES - Configurable document requirements\n// =============================================================================\n// Admins can configure which documents are required for specific scenarios:\n// - Prequalification for a payment method type\n// - Contract phases\n// - Payment method changes (from-to combinations)\n// This allows tenants to customize documentation workflows per product.\n// =============================================================================\n\nenum DocumentRequirementContext {\n  PREQUALIFICATION // During prequalification\n  CONTRACT_PHASE // During a contract phase\n  PAYMENT_METHOD_CHANGE // When changing payment method mid-contract\n}\n\nmodel DocumentRequirementRule {\n  id       String @id @default(cuid())\n  tenantId String\n  tenant   Tenant @relation(fields: [tenantId], references: [id], onDelete: Cascade)\n\n  // Rule context\n  context DocumentRequirementContext\n\n  // Scoping (which situations this rule applies to)\n  // For PREQUALIFICATION: paymentMethodId\n  // For CONTRACT_PHASE: phaseType\n  // For PAYMENT_METHOD_CHANGE: fromMethodId + toMethodId\n  paymentMethodId     String?\n  paymentMethod       PropertyPaymentMethod? @relation(\"RulePaymentMethod\", fields: [paymentMethodId], references: [id])\n  phaseType           String? // KYC, VERIFICATION, DOWNPAYMENT, etc.\n  fromPaymentMethodId String?\n  fromPaymentMethod   PropertyPaymentMethod? @relation(\"RuleFromMethod\", fields: [fromPaymentMethodId], references: [id])\n  toPaymentMethodId   String?\n  toPaymentMethod     PropertyPaymentMethod? @relation(\"RuleToMethod\", fields: [toPaymentMethodId], references: [id])\n\n  // Document requirements\n  documentType     String // ID_CARD, PASSPORT, BANK_STATEMENT, INCOME_PROOF, etc.\n  isRequired       Boolean @default(true)\n  description      String? // Instructions for the user\n  maxSizeBytes     Int? // Max file size allowed\n  allowedMimeTypes String? // CSV: application/pdf,image/jpeg,image/png\n\n  // Validation rules\n  expiryDays           Int? // Document must not be older than X days\n  requiresManualReview Boolean @default(false)\n\n  isActive  Boolean  @default(true)\n  createdAt DateTime @default(now())\n  updatedAt DateTime @updatedAt\n\n  @@index([tenantId])\n  @@index([context])\n  @@index([paymentMethodId])\n  @@index([phaseType])\n  @@index([fromPaymentMethodId, toPaymentMethodId])\n  @@map(\"document_requirement_rules\")\n}\n\n// =============================================================================\n// EVENT OUTBOX - For guaranteed event delivery to SQS queues\n// =============================================================================\n\nmodel DomainEvent {\n  id String @id @default(cuid())\n\n  // Event identification\n  eventType     String // MORTGAGE.CREATED, PHASE.ACTIVATED, PAYMENT.COMPLETED, etc\n  aggregateType String // Mortgage, MortgagePhase, MortgagePayment, Property, etc\n  aggregateId   String\n\n  // Routing - which queue(s) should receive this\n  queueName String // notifications, payments, mortgage-steps, accounting, etc\n\n  // Event payload (all data needed by consumers)\n  payload String @db.Text // JSON\n\n  // Metadata\n  occurredAt DateTime @default(now())\n  actorId    String? // User who triggered the event\n  actorRole  String? // Role of the actor\n\n  // Processing status\n  status       String    @default(\"PENDING\") // PENDING, PROCESSING, SENT, FAILED\n  processedAt  DateTime?\n  sentAt       DateTime?\n  failureCount Int       @default(0)\n  lastError    String?   @db.Text\n  nextRetryAt  DateTime?\n\n  createdAt DateTime @default(now())\n  updatedAt DateTime @updatedAt\n\n  @@index([status, nextRetryAt])\n  @@index([eventType])\n  @@index([aggregateType, aggregateId])\n  @@index([queueName])\n  @@index([occurredAt])\n  @@map(\"domain_events\")\n}\n",
+    "inlineSchema": "// =============================================================================\n// QSHELTER UNIFIED DATABASE SCHEMA\n// =============================================================================\n// This schema contains all database models for the QShelter platform\n// Organized by domain for better readability\n// =============================================================================\n\ngenerator client {\n  provider   = \"prisma-client\"\n  output     = \"../generated/client\"\n  engineType = \"client\"\n}\n\ndatasource db {\n  provider = \"mysql\"\n}\n\n// =============================================================================\n// ENUMS - Database-enforced value constraints\n// =============================================================================\n\nenum PhaseCategory {\n  DOCUMENTATION\n  PAYMENT\n}\n\nenum PhaseType {\n  KYC\n  VERIFICATION\n  DOWNPAYMENT\n  MORTGAGE\n  BALLOON\n  CUSTOM\n}\n\nenum PaymentFrequency {\n  MONTHLY\n  BIWEEKLY\n  WEEKLY\n  ONE_TIME\n  CUSTOM\n}\n\nenum ContractStatus {\n  DRAFT\n  PENDING\n  ACTIVE\n  COMPLETED\n  CANCELLED\n  TERMINATED\n}\n\nenum PhaseStatus {\n  PENDING\n  IN_PROGRESS\n  AWAITING_APPROVAL\n  ACTIVE\n  COMPLETED\n  SKIPPED\n  FAILED\n}\n\nenum StepType {\n  UPLOAD\n  REVIEW\n  SIGNATURE\n  APPROVAL\n  EXTERNAL_CHECK\n  WAIT\n  GENERATE_DOCUMENT // Triggers document generation (offer letters, contracts, etc.)\n}\n\nenum StepStatus {\n  PENDING\n  IN_PROGRESS\n  COMPLETED\n  FAILED\n  SKIPPED\n}\n\nenum InstallmentStatus {\n  PENDING\n  PAID\n  OVERDUE\n  PARTIALLY_PAID\n  WAIVED\n}\n\nenum PaymentStatus {\n  INITIATED\n  PENDING\n  COMPLETED\n  FAILED\n  REFUNDED\n}\n\nenum ApprovalDecision {\n  APPROVED\n  REJECTED\n  REQUEST_CHANGES\n}\n\n// =============================================================================\n// CONTRACT TERMINATION / CANCELLATION ENUMS\n// =============================================================================\n\nenum TerminationType {\n  BUYER_WITHDRAWAL // Buyer wants to cancel (voluntary)\n  SELLER_WITHDRAWAL // Seller/developer cancels\n  MUTUAL_AGREEMENT // Both parties agree to terminate\n  PAYMENT_DEFAULT // Buyer failed payment obligations\n  DOCUMENT_FAILURE // Buyer failed to provide required documents\n  FRAUD // Fraudulent activity detected\n  FORCE_MAJEURE // External circumstances (disaster, etc.)\n  PROPERTY_UNAVAILABLE // Property no longer available\n  REGULATORY // Regulatory/legal requirement\n  OTHER // Other reasons (with notes)\n}\n\nenum TerminationStatus {\n  REQUESTED // Initial request submitted\n  PENDING_REVIEW // Awaiting admin review\n  PENDING_REFUND // Approved, awaiting refund processing\n  REFUND_IN_PROGRESS // Refund being processed\n  REFUND_COMPLETED // Refund completed\n  COMPLETED // Termination fully executed (no refund or refund done)\n  REJECTED // Termination request rejected\n  CANCELLED // Termination request was cancelled\n}\n\nenum RefundStatus {\n  NOT_APPLICABLE // No refund needed (no payments made)\n  PENDING // Refund not yet initiated\n  INITIATED // Refund request sent to payment gateway\n  PROCESSING // Gateway processing refund\n  PARTIAL_COMPLETED // Some refund completed (penalties deducted)\n  COMPLETED // Full refund completed\n  FAILED // Refund failed (needs manual intervention)\n}\n\nenum TerminationInitiator {\n  BUYER\n  SELLER\n  ADMIN\n  SYSTEM\n}\n\nenum CompletionCriterion {\n  DOCUMENT_APPROVALS\n  PAYMENT_AMOUNT\n  STEPS_COMPLETED\n}\n\nenum DocumentStatus {\n  DRAFT\n  PENDING\n  PENDING_SIGNATURE\n  SENT\n  VIEWED\n  SIGNED\n  APPROVED\n  REJECTED\n  EXPIRED\n  CANCELLED\n}\n\nenum OfferLetterType {\n  PROVISIONAL\n  FINAL\n}\n\nenum OfferLetterStatus {\n  DRAFT\n  GENERATED\n  SENT\n  VIEWED\n  SIGNED\n  EXPIRED\n  CANCELLED\n}\n\nenum UnderwritingDecisionKind {\n  APPROVE\n  REJECT\n  CONDITIONAL\n}\n\n// =============================================================================\n// USER & AUTH DOMAIN\n// =============================================================================\n\nmodel User {\n  id                     String            @id @default(cuid())\n  email                  String            @unique\n  password               String?\n  phone                  String?           @unique\n  firstName              String?\n  lastName               String?\n  isActive               Boolean           @default(true)\n  isEmailVerified        Boolean           @default(false)\n  googleId               String?\n  avatar                 String?\n  tenantId               String?\n  tenant                 Tenant?           @relation(fields: [tenantId], references: [id], onDelete: SetNull)\n  // Support multiple roles via explicit join table `UserRole`\n  userRoles              UserRole[]\n  walletId               String?           @unique\n  wallet                 Wallet?           @relation(fields: [walletId], references: [id])\n  createdAt              DateTime          @default(now())\n  updatedAt              DateTime          @updatedAt\n  emailVerifiedAt        DateTime?\n  emailVerificationToken String?\n  lastLoginAt            DateTime?\n  refreshTokens          RefreshToken[]\n  passwordResets         PasswordReset[]\n  suspensions            UserSuspension[]\n  emailPreferences       EmailPreference[]\n  deviceEndpoints        DeviceEndpoint[]\n  socials                Social[]\n\n  // Relations to other domains\n  properties       Property[]\n  contracts        Contract[]        @relation(\"ContractBuyer\")\n  soldContracts    Contract[]        @relation(\"ContractSeller\")\n  contractPayments ContractPayment[] @relation(\"ContractPayer\")\n\n  // Phase step assignments and approvals\n  assignedSteps ContractPhaseStep[]         @relation(\"PhaseStepAssignee\")\n  stepApprovals ContractPhaseStepApproval[] @relation(\"PhaseStepApprover\")\n  uploadedDocs  ContractDocument[]          @relation(\"DocumentUploader\")\n\n  // Prequalification and payment method changes\n  prequalifications           Prequalification[]\n  paymentMethodChangeRequests PaymentMethodChangeRequest[] @relation(\"ChangeRequestor\")\n  reviewedChangeRequests      PaymentMethodChangeRequest[] @relation(\"ChangeReviewer\")\n\n  // Contract terminations\n  initiatedTerminations ContractTermination[] @relation(\"TerminationInitiator\")\n  reviewedTerminations  ContractTermination[] @relation(\"TerminationReviewer\")\n\n  // Offer letters\n  offerLettersGenerated OfferLetter[] @relation(\"OfferLetterGenerator\")\n  offerLettersSent      OfferLetter[] @relation(\"OfferLetterSender\")\n\n  @@index([email])\n  @@index([tenantId])\n  @@map(\"users\")\n}\n\nmodel Role {\n  id          String           @id @default(cuid())\n  name        String           @unique\n  description String?\n  userRoles   UserRole[]\n  permissions RolePermission[]\n  createdAt   DateTime         @default(now())\n  updatedAt   DateTime         @updatedAt\n\n  @@map(\"roles\")\n}\n\nmodel Permission {\n  id          String           @id @default(cuid())\n  name        String           @unique\n  description String?\n  resource    String\n  action      String\n  roles       RolePermission[]\n  createdAt   DateTime         @default(now())\n  updatedAt   DateTime         @updatedAt\n\n  @@unique([resource, action])\n  @@index([resource])\n  @@map(\"permissions\")\n}\n\nmodel RolePermission {\n  roleId       String\n  permissionId String\n  role         Role       @relation(fields: [roleId], references: [id], onDelete: Cascade)\n  permission   Permission @relation(fields: [permissionId], references: [id], onDelete: Cascade)\n  createdAt    DateTime   @default(now())\n\n  @@id([roleId, permissionId])\n  @@map(\"role_permissions\")\n}\n\nmodel UserRole {\n  userId    String\n  roleId    String\n  user      User     @relation(fields: [userId], references: [id], onDelete: Cascade)\n  role      Role     @relation(fields: [roleId], references: [id], onDelete: Cascade)\n  createdAt DateTime @default(now())\n\n  @@id([userId, roleId])\n  @@map(\"user_roles\")\n}\n\nmodel Tenant {\n  id        String   @id @default(cuid())\n  name      String\n  subdomain String   @unique\n  isActive  Boolean  @default(true)\n  createdAt DateTime @default(now())\n  updatedAt DateTime @updatedAt\n\n  // Back-relations for multitenancy\n  users          User[]\n  properties     Property[]\n  paymentPlans   PaymentPlan[]\n  paymentMethods PropertyPaymentMethod[]\n  contracts      Contract[]\n\n  // Prequalification and payment method changes\n  prequalifications           Prequalification[]\n  paymentMethodChangeRequests PaymentMethodChangeRequest[]\n  documentRequirementRules    DocumentRequirementRule[]\n\n  // Contract terminations\n  contractTerminations ContractTermination[]\n\n  // Offer letters and templates\n  documentTemplates DocumentTemplate[]\n  offerLetters      OfferLetter[]\n\n  // Underwriting\n  underwritingDecisions UnderwritingDecision[]\n\n  @@index([subdomain])\n  @@map(\"tenants\")\n}\n\nmodel RefreshToken {\n  id        String   @id @default(cuid())\n  // Use the JWT `jti` for indexed lookups and keep the raw JWT (optional)\n  jti       String?  @unique @db.VarChar(255)\n  token     String?  @db.LongText\n  userId    String\n  user      User     @relation(fields: [userId], references: [id], onDelete: Cascade)\n  expiresAt DateTime\n  createdAt DateTime @default(now())\n\n  @@index([userId])\n  @@index([expiresAt])\n  @@map(\"refresh_tokens\")\n}\n\nmodel PasswordReset {\n  id        String    @id @default(cuid())\n  token     String    @unique\n  userId    String\n  user      User      @relation(fields: [userId], references: [id], onDelete: Cascade)\n  expiresAt DateTime\n  usedAt    DateTime?\n  createdAt DateTime  @default(now())\n\n  @@index([userId])\n  @@index([expiresAt])\n  @@map(\"password_resets\")\n}\n\nmodel UserSuspension {\n  id          String    @id @default(cuid())\n  userId      String\n  user        User      @relation(fields: [userId], references: [id], onDelete: Cascade)\n  reason      String\n  suspendedAt DateTime  @default(now())\n  expiresAt   DateTime?\n  liftedAt    DateTime?\n\n  @@index([userId])\n  @@map(\"user_suspensions\")\n}\n\nmodel EmailPreference {\n  id                  String   @id @default(cuid())\n  userId              String\n  user                User     @relation(fields: [userId], references: [id], onDelete: Cascade)\n  marketingEmails     Boolean  @default(true)\n  transactionalEmails Boolean  @default(true)\n  propertyAlerts      Boolean  @default(true)\n  paymentReminders    Boolean  @default(true)\n  createdAt           DateTime @default(now())\n  updatedAt           DateTime @updatedAt\n\n  @@index([userId])\n  @@map(\"email_preferences\")\n}\n\nmodel DeviceEndpoint {\n  id        String   @id @default(cuid())\n  userId    String\n  user      User     @relation(fields: [userId], references: [id], onDelete: Cascade)\n  endpoint  String // Push notification endpoint\n  platform  String // ios, android, web\n  isActive  Boolean  @default(true)\n  createdAt DateTime @default(now())\n  updatedAt DateTime @updatedAt\n\n  @@index([userId])\n  @@map(\"device_endpoints\")\n}\n\nmodel Social {\n  id        String   @id @default(cuid())\n  userId    String\n  user      User     @relation(fields: [userId], references: [id], onDelete: Cascade)\n  provider  String // google, facebook, twitter, etc\n  socialId  String // ID from the social provider\n  createdAt DateTime @default(now())\n  updatedAt DateTime @updatedAt\n\n  @@unique([provider, socialId])\n  @@index([userId])\n  @@map(\"socials\")\n}\n\nmodel OAuthState {\n  id        String   @id @default(cuid())\n  state     String   @unique\n  expiresAt DateTime\n  createdAt DateTime @default(now())\n\n  @@index([state])\n  @@index([expiresAt])\n  @@map(\"oauth_states\")\n}\n\nmodel Wallet {\n  id           String        @id @default(cuid())\n  balance      Float         @default(0)\n  currency     String        @default(\"USD\")\n  user         User?\n  transactions Transaction[]\n  createdAt    DateTime      @default(now())\n  updatedAt    DateTime      @updatedAt\n\n  @@map(\"wallets\")\n}\n\nmodel Transaction {\n  id          String   @id @default(cuid())\n  walletId    String\n  wallet      Wallet   @relation(fields: [walletId], references: [id], onDelete: Cascade)\n  amount      Float\n  type        String // CREDIT, DEBIT\n  status      String // PENDING, COMPLETED, FAILED\n  reference   String?\n  description String?\n  createdAt   DateTime @default(now())\n  updatedAt   DateTime @updatedAt\n\n  @@index([walletId])\n  @@map(\"transactions\")\n}\n\nmodel Settings {\n  id        String   @id @default(cuid())\n  key       String   @unique\n  value     String   @db.Text\n  category  String?\n  createdAt DateTime @default(now())\n  updatedAt DateTime @updatedAt\n\n  @@index([category])\n  @@map(\"settings\")\n}\n\n// =============================================================================\n// PROPERTY DOMAIN\n// =============================================================================\n// Property = listing/project (e.g., \"Sunrise Estate\")\n// PropertyVariant = configuration with specs & price (e.g., \"3-Bed Corner - Finished\")\n// PropertyUnit = individual sellable unit (e.g., \"Unit A1\")\n// =============================================================================\n\nmodel Property {\n  id             String         @id @default(cuid())\n  tenantId       String\n  tenant         Tenant         @relation(fields: [tenantId], references: [id], onDelete: Cascade)\n  userId         String\n  user           User           @relation(fields: [userId], references: [id], onDelete: Cascade)\n  title          String\n  category       String // SALE, RENT, LEASE\n  propertyType   String // APARTMENT, HOUSE, LAND, COMMERCIAL, ESTATE, TOWNHOUSE\n  country        String\n  currency       String // USD, NGN, etc\n  city           String\n  district       String?\n  zipCode        String?\n  streetAddress  String?\n  longitude      Float?\n  latitude       Float?\n  status         String         @default(\"DRAFT\") // DRAFT, PUBLISHED, SOLD_OUT, ARCHIVED\n  description    String?        @db.Text\n  displayImageId String?\n  displayImage   PropertyMedia? @relation(\"DisplayImage\", fields: [displayImageId], references: [id], onDelete: SetNull)\n  isPublished    Boolean        @default(false)\n  publishedAt    DateTime?\n  createdAt      DateTime       @default(now())\n  updatedAt      DateTime       @updatedAt\n\n  // Relations\n  documents         PropertyDocument[]\n  media             PropertyMedia[]             @relation(\"PropertyMedia\")\n  amenities         PropertyAmenity[] // Shared amenities (gym, pool, security)\n  paymentMethods    PropertyPaymentMethodLink[]\n  variants          PropertyVariant[]\n  prequalifications Prequalification[]\n\n  @@index([tenantId])\n  @@index([userId])\n  @@index([category])\n  @@index([propertyType])\n  @@index([city])\n  @@index([status])\n  @@map(\"properties\")\n}\n\nmodel PropertyMedia {\n  id         String   @id @default(cuid())\n  propertyId String\n  property   Property @relation(\"PropertyMedia\", fields: [propertyId], references: [id], onDelete: Cascade)\n  url        String\n  type       String // IMAGE, VIDEO\n  caption    String?\n  order      Int      @default(0)\n  createdAt  DateTime @default(now())\n  updatedAt  DateTime @updatedAt\n\n  displayForProperties Property[] @relation(\"DisplayImage\")\n\n  @@index([propertyId])\n  @@map(\"property_media\")\n}\n\nmodel PropertyDocument {\n  id         String   @id @default(cuid())\n  propertyId String\n  property   Property @relation(fields: [propertyId], references: [id], onDelete: Cascade)\n  name       String\n  url        String\n  type       String // TITLE_DEED, SURVEY_PLAN, etc\n  createdAt  DateTime @default(now())\n  updatedAt  DateTime @updatedAt\n\n  @@index([propertyId])\n  @@map(\"property_documents\")\n}\n\nmodel Amenity {\n  id         String                   @id @default(cuid())\n  name       String                   @unique\n  category   String? // PROPERTY, VARIANT, BOTH - helps filter which amenities to show\n  icon       String? // Icon name/URL for UI\n  createdAt  DateTime                 @default(now())\n  updatedAt  DateTime                 @updatedAt\n  properties PropertyAmenity[]\n  variants   PropertyVariantAmenity[]\n\n  @@index([category])\n  @@map(\"amenities\")\n}\n\n// =============================================================================\n// PROPERTY VARIANT & UNIT MODELS\n// =============================================================================\n\n// PropertyVariant = specific configuration with its own price and amenities\n// e.g., \"3-Bedroom Corner Piece - Fully Finished\", \"2-Bedroom Standard - Carcass\"\nmodel PropertyVariant {\n  id         String   @id @default(cuid())\n  propertyId String\n  property   Property @relation(fields: [propertyId], references: [id], onDelete: Cascade)\n\n  name        String // \"Corner Piece - Finished\", \"Standard - Carcass\"\n  description String? @db.Text\n\n  // Specifications\n  nBedrooms     Int?\n  nBathrooms    Int?\n  nParkingSpots Int?\n  area          Float? // Square meters/feet\n\n  // Pricing\n  price       Float\n  pricePerSqm Float? // Computed or set manually\n\n  // Inventory counters (denormalized for performance, updated via triggers/service)\n  totalUnits     Int @default(1)\n  availableUnits Int @default(1)\n  reservedUnits  Int @default(0)\n  soldUnits      Int @default(0)\n\n  // Status\n  status    String   @default(\"AVAILABLE\") // AVAILABLE, LOW_STOCK, SOLD_OUT, ARCHIVED\n  isActive  Boolean  @default(true)\n  createdAt DateTime @default(now())\n  updatedAt DateTime @updatedAt\n\n  // Relations\n  amenities PropertyVariantAmenity[]\n  units     PropertyUnit[]\n  media     PropertyVariantMedia[]\n\n  @@index([propertyId])\n  @@index([status])\n  @@index([price])\n  @@map(\"property_variants\")\n}\n\n// PropertyVariantAmenity = amenities specific to a variant\n// e.g., \"Finished Kitchen\", \"Smart Home System\", \"Private Garden\"\nmodel PropertyVariantAmenity {\n  variantId String\n  amenityId String\n  variant   PropertyVariant @relation(fields: [variantId], references: [id], onDelete: Cascade)\n  amenity   Amenity         @relation(fields: [amenityId], references: [id], onDelete: Cascade)\n  createdAt DateTime        @default(now())\n\n  @@id([variantId, amenityId])\n  @@map(\"property_variant_amenities\")\n}\n\n// PropertyVariantMedia = images/videos specific to a variant\nmodel PropertyVariantMedia {\n  id        String          @id @default(cuid())\n  variantId String\n  variant   PropertyVariant @relation(fields: [variantId], references: [id], onDelete: Cascade)\n  url       String\n  type      String // IMAGE, VIDEO, FLOOR_PLAN, 3D_TOUR\n  caption   String?\n  order     Int             @default(0)\n  createdAt DateTime        @default(now())\n  updatedAt DateTime        @updatedAt\n\n  @@index([variantId])\n  @@map(\"property_variant_media\")\n}\n\n// PropertyUnit = individual sellable/rentable unit within a variant\n// e.g., \"Unit A1\", \"Block B - Flat 3\", \"Plot 15\"\nmodel PropertyUnit {\n  id        String          @id @default(cuid())\n  variantId String\n  variant   PropertyVariant @relation(fields: [variantId], references: [id], onDelete: Cascade)\n\n  unitNumber  String // \"A1\", \"B-3\", \"Plot 15\"\n  floorNumber Int? // For apartments\n  blockName   String? // \"Block A\", \"Tower 1\"\n\n  // Unit-specific overrides (if different from variant)\n  priceOverride Float? // If this specific unit has a different price\n  areaOverride  Float? // If this specific unit has a different area\n  notes         String? @db.Text // Internal notes about this unit\n\n  // Status tracking\n  status String @default(\"AVAILABLE\") // AVAILABLE, RESERVED, SOLD, RENTED, UNAVAILABLE\n\n  // Reservation/hold\n  reservedAt    DateTime?\n  reservedUntil DateTime?\n  reservedById  String?\n\n  // Ownership tracking (once sold)\n  ownerId String?\n\n  createdAt DateTime @default(now())\n  updatedAt DateTime @updatedAt\n\n  // Relations\n  contracts Contract[]\n\n  @@unique([variantId, unitNumber])\n  @@index([variantId])\n  @@index([status])\n  @@map(\"property_units\")\n}\n\nmodel PropertyAmenity {\n  propertyId String\n  amenityId  String\n  property   Property @relation(fields: [propertyId], references: [id], onDelete: Cascade)\n  amenity    Amenity  @relation(fields: [amenityId], references: [id], onDelete: Cascade)\n  createdAt  DateTime @default(now())\n\n  @@id([propertyId, amenityId])\n  @@map(\"property_amenities\")\n}\n\n// =============================================================================\n// PAYMENT PLAN DOMAIN - Reusable installment structure templates\n// =============================================================================\n\n// PaymentPlan = reusable structure for how payments are scheduled\n// Examples: \"Monthly360\" (360 monthly payments), \"Weekly52\", \"OneTime\"\nmodel PaymentPlan {\n  id          String  @id @default(cuid())\n  tenantId    String? // NULL = global template available to all tenants\n  tenant      Tenant? @relation(fields: [tenantId], references: [id], onDelete: Cascade)\n  name        String\n  description String? @db.Text\n  isActive    Boolean @default(true)\n\n  // Structure configuration\n  paymentFrequency       PaymentFrequency\n  customFrequencyDays    Int?\n  numberOfInstallments   Int // 1 for one-time, 360 for 30yr monthly, etc\n  calculateInterestDaily Boolean          @default(false)\n  gracePeriodDays        Int              @default(0)\n\n  // Fund collection behavior\n  // true = we collect funds via wallet/gateway (e.g., downpayment)\n  // false = external payment, we only track/reconcile (e.g., bank mortgage)\n  collectFunds Boolean @default(true)\n\n  createdAt DateTime @default(now())\n  updatedAt DateTime @updatedAt\n\n  // Used by property payment method phases (templates)\n  methodPhases   PropertyPaymentMethodPhase[]\n  // Used by instantiated contract phases\n  contractPhases ContractPhase[]\n\n  @@unique([tenantId, name]) // Unique per tenant, or globally if tenantId is null\n  @@index([tenantId])\n  @@map(\"payment_plans\")\n}\n\n// =============================================================================\n// PROPERTY PAYMENT METHOD DOMAIN - Product offerings per property\n// =============================================================================\n\n// PropertyPaymentMethod = how a property can be purchased (e.g., \"Standard Mortgage\", \"Cash\", \"Rent-to-Own\")\nmodel PropertyPaymentMethod {\n  id          String  @id @default(cuid())\n  tenantId    String\n  tenant      Tenant  @relation(fields: [tenantId], references: [id], onDelete: Cascade)\n  name        String // \"Standard Mortgage\", \"Flexible Payment\", \"Cash Purchase\"\n  description String? @db.Text\n  isActive    Boolean @default(true)\n\n  // Global method configuration\n  allowEarlyPayoff       Boolean @default(true)\n  earlyPayoffPenaltyRate Float?\n  autoActivatePhases     Boolean @default(true)\n  requiresManualApproval Boolean @default(false)\n\n  createdAt DateTime @default(now())\n  updatedAt DateTime @updatedAt\n\n  // Many-to-many with properties\n  properties PropertyPaymentMethodLink[]\n  // Phases that make up this method (templates)\n  phases     PropertyPaymentMethodPhase[]\n  // Contracts using this method\n  contracts  Contract[]\n\n  // Prequalifications for this payment method\n  prequalifications Prequalification[]\n\n  // Payment method change tracking\n  changeRequestsFrom PaymentMethodChangeRequest[] @relation(\"ChangeFromMethod\")\n  changeRequestsTo   PaymentMethodChangeRequest[] @relation(\"ChangeToMethod\")\n\n  // Document requirement rules\n  documentRules   DocumentRequirementRule[] @relation(\"RulePaymentMethod\")\n  changeRulesFrom DocumentRequirementRule[] @relation(\"RuleFromMethod\")\n  changeRulesTo   DocumentRequirementRule[] @relation(\"RuleToMethod\")\n\n  @@unique([tenantId, name]) // Unique per tenant\n  @@index([tenantId])\n  @@map(\"property_payment_methods\")\n}\n\n// Many-to-many link between Property and PaymentMethod\nmodel PropertyPaymentMethodLink {\n  propertyId      String\n  property        Property              @relation(fields: [propertyId], references: [id], onDelete: Cascade)\n  paymentMethodId String\n  paymentMethod   PropertyPaymentMethod @relation(fields: [paymentMethodId], references: [id], onDelete: Cascade)\n\n  // Method-specific overrides for this property\n  isDefault Boolean  @default(false)\n  isActive  Boolean  @default(true)\n  createdAt DateTime @default(now())\n\n  @@id([propertyId, paymentMethodId])\n  @@map(\"property_payment_method_links\")\n}\n\n// Phase template within a PropertyPaymentMethod (e.g., documentation, downpayment, mortgage)\n// phaseCategory determines the FSM type: DOCUMENTATION or PAYMENT\nmodel PropertyPaymentMethodPhase {\n  id              String                @id @default(cuid())\n  paymentMethodId String\n  paymentMethod   PropertyPaymentMethod @relation(fields: [paymentMethodId], references: [id], onDelete: Cascade)\n  paymentPlanId   String? // Only for PAYMENT phases\n  paymentPlan     PaymentPlan?          @relation(fields: [paymentPlanId], references: [id])\n\n  name        String\n  description String? @db.Text\n\n  // Phase classification (DB-enforced enums)\n  phaseCategory PhaseCategory\n  phaseType     PhaseType\n  order         Int\n\n  // Financial configuration (for PAYMENT phases)\n  interestRate   Float?\n  percentOfPrice Float? // e.g., 10.0 for 10% downpayment\n\n  // Fund collection behavior (inherited from PaymentPlan if not set)\n  // true = we collect funds via wallet/gateway (e.g., downpayment)\n  // false = external payment, we only track/reconcile (e.g., bank mortgage)\n  collectFunds Boolean? // null = inherit from PaymentPlan\n\n  // Activation rules\n  requiresPreviousPhaseCompletion Boolean              @default(true)\n  minimumCompletionPercentage     Float?\n  completionCriterion             CompletionCriterion?\n\n  // Snapshots for audit (original config at creation time)\n  stepDefinitionsSnapshot  Json?\n  requiredDocumentSnapshot Json?\n\n  createdAt DateTime @default(now())\n  updatedAt DateTime @updatedAt\n\n  // Normalized child tables (for DOCUMENTATION phases)\n  steps             PaymentMethodPhaseStep[]\n  requiredDocuments PaymentMethodPhaseDocument[]\n\n  @@index([paymentMethodId])\n  @@index([paymentPlanId])\n  @@index([phaseCategory])\n  @@map(\"property_payment_method_phases\")\n}\n\n// Step template within a DOCUMENTATION phase\nmodel PaymentMethodPhaseStep {\n  id      String                     @id @default(cuid())\n  phaseId String\n  phase   PropertyPaymentMethodPhase @relation(fields: [phaseId], references: [id], onDelete: Cascade)\n\n  name     String\n  stepType StepType\n  order    Int\n\n  metadata  Json?\n  createdAt DateTime @default(now())\n  updatedAt DateTime @updatedAt\n\n  @@index([phaseId])\n  @@map(\"payment_method_phase_steps\")\n}\n\n// Required document within a DOCUMENTATION phase\nmodel PaymentMethodPhaseDocument {\n  id      String                     @id @default(cuid())\n  phaseId String\n  phase   PropertyPaymentMethodPhase @relation(fields: [phaseId], references: [id], onDelete: Cascade)\n\n  documentType     String\n  isRequired       Boolean @default(true)\n  description      String? @db.Text\n  allowedMimeTypes String? // CSV: application/pdf,image/jpeg\n  maxSizeBytes     Int?\n\n  metadata  Json?\n  createdAt DateTime @default(now())\n\n  @@index([phaseId, documentType])\n  @@map(\"payment_method_phase_documents\")\n}\n\n// =============================================================================\n// CONTRACT DOMAIN - Unified agreement model (replaces Mortgage, PurchasePlan, etc.)\n// =============================================================================\n// Contract is the canonical agreement. \"Mortgage\" is just a product configuration\n// that creates a Contract with specific phases (documentation, downpayment, long-term payment).\n// Phases can be DOCUMENTATION (FSM for approvals) or PAYMENT (PaymentPlan-driven installments).\n// =============================================================================\n\nmodel Contract {\n  id              String                 @id @default(cuid())\n  tenantId        String\n  tenant          Tenant                 @relation(fields: [tenantId], references: [id], onDelete: Cascade)\n  // Link to specific unit being purchased/rented\n  propertyUnitId  String\n  propertyUnit    PropertyUnit           @relation(fields: [propertyUnitId], references: [id], onDelete: Cascade)\n  buyerId         String\n  buyer           User                   @relation(\"ContractBuyer\", fields: [buyerId], references: [id], onDelete: Cascade)\n  sellerId        String?\n  seller          User?                  @relation(\"ContractSeller\", fields: [sellerId], references: [id])\n  paymentMethodId String? // PropertyPaymentMethod used to create this contract\n  paymentMethod   PropertyPaymentMethod? @relation(fields: [paymentMethodId], references: [id])\n\n  // Contract identification\n  contractNumber String  @unique\n  title          String\n  description    String? @db.Text\n  contractType   String // Admin-defined: MORTGAGE, INSTALLMENT, RENT_TO_OWN, CASH, LEASE, etc.\n\n  // Financial summary (computed from phases)\n  totalAmount       Float // Total contract value (from unit price or negotiated)\n  downPayment       Float  @default(0)\n  downPaymentPaid   Float  @default(0)\n  principal         Float? // Financed amount (if applicable)\n  interestRate      Float? // Overall interest rate (if applicable)\n  termMonths        Int? // Total term (if applicable)\n  periodicPayment   Float? // Computed periodic payment (if applicable)\n  totalPaidToDate   Float  @default(0)\n  totalInterestPaid Float  @default(0)\n\n  // FSM state (DB-enforced enums)\n  status         ContractStatus @default(DRAFT)\n  state          ContractStatus @default(DRAFT) // FSM state for workflow\n  currentPhaseId String?\n\n  // Timing\n  nextPaymentDueDate DateTime?\n  lastReminderSentAt DateTime?\n  startDate          DateTime?\n  endDate            DateTime?\n  signedAt           DateTime?\n  terminatedAt       DateTime?\n  createdAt          DateTime  @default(now())\n  updatedAt          DateTime  @updatedAt\n\n  // Relations\n  phases       ContractPhase[]\n  documents    ContractDocument[]\n  payments     ContractPayment[]\n  transitions  ContractTransition[]\n  events       ContractEvent[]\n  terminations ContractTermination[]\n  offerLetters OfferLetter[]\n\n  // Prequalification that led to this contract (optional)\n  prequalification            Prequalification?\n  // Payment method change requests for this contract\n  paymentMethodChangeRequests PaymentMethodChangeRequest[]\n\n  @@index([tenantId])\n  @@index([propertyUnitId])\n  @@index([buyerId])\n  @@index([sellerId])\n  @@index([paymentMethodId])\n  @@index([status])\n  @@index([state])\n  @@map(\"contracts\")\n}\n\n// Phase within a contract - can be DOCUMENTATION or PAYMENT type\n// Admin names phases freely (e.g., \"KYC Documents\", \"Downpayment\", \"Monthly Mortgage\")\nmodel ContractPhase {\n  id            String       @id @default(cuid())\n  contractId    String\n  contract      Contract     @relation(fields: [contractId], references: [id], onDelete: Cascade)\n  paymentPlanId String? // Only for PAYMENT phases\n  paymentPlan   PaymentPlan? @relation(fields: [paymentPlanId], references: [id])\n\n  // Admin-defined naming\n  name        String\n  description String? @db.Text\n\n  // Phase classification (DB-enforced enums)\n  phaseCategory PhaseCategory\n  phaseType     PhaseType\n  order         Int\n\n  // FSM state for this phase (DB-enforced enum)\n  status PhaseStatus @default(PENDING)\n\n  // Financial details (for PAYMENT phases)\n  totalAmount     Float?\n  paidAmount      Float  @default(0)\n  remainingAmount Float?\n  interestRate    Float?\n\n  // Fund collection behavior (snapshotted from template at contract creation)\n  // true = we collect funds via wallet/gateway (e.g., downpayment)\n  // false = external payment, we only track/reconcile (e.g., bank mortgage)\n  collectFunds Boolean @default(true)\n\n  // Progress counters (for efficient activation checks)\n  approvedDocumentsCount Int @default(0)\n  requiredDocumentsCount Int @default(0)\n  completedStepsCount    Int @default(0)\n  totalStepsCount        Int @default(0)\n\n  // Timing\n  dueDate     DateTime?\n  startDate   DateTime?\n  endDate     DateTime?\n  activatedAt DateTime?\n  completedAt DateTime?\n\n  // Activation rules\n  requiresPreviousPhaseCompletion Boolean              @default(true)\n  minimumCompletionPercentage     Float?\n  completionCriterion             CompletionCriterion?\n\n  // Snapshots for audit (effective config at contract creation)\n  paymentPlanSnapshot      Json?\n  stepDefinitionsSnapshot  Json?\n  requiredDocumentSnapshot Json?\n\n  createdAt DateTime @default(now())\n  updatedAt DateTime @updatedAt\n\n  // Relations\n  installments ContractInstallment[]\n  payments     ContractPayment[]\n  steps        ContractPhaseStep[] // For DOCUMENTATION phases (FSM steps)\n\n  @@index([contractId])\n  @@index([paymentPlanId])\n  @@index([phaseCategory])\n  @@index([status])\n  @@index([order])\n  @@map(\"contract_phases\")\n}\n\n// Steps within a DOCUMENTATION phase (FSM for document collection/approval)\nmodel ContractPhaseStep {\n  id      String        @id @default(cuid())\n  phaseId String\n  phase   ContractPhase @relation(fields: [phaseId], references: [id], onDelete: Cascade)\n\n  name        String\n  description String?  @db.Text\n  stepType    StepType\n  order       Int\n\n  status StepStatus @default(PENDING)\n\n  // Configuration metadata (for GENERATE_DOCUMENT steps, etc.)\n  metadata Json?\n\n  // Assignment\n  assigneeId String?\n  assignee   User?   @relation(\"PhaseStepAssignee\", fields: [assigneeId], references: [id])\n\n  // Required document types for UPLOAD steps (normalized)\n  requiredDocuments ContractPhaseStepDocument[]\n\n  // Timing\n  dueDate     DateTime?\n  completedAt DateTime?\n\n  createdAt DateTime @default(now())\n  updatedAt DateTime @updatedAt\n\n  approvals ContractPhaseStepApproval[]\n\n  @@index([phaseId])\n  @@index([status])\n  @@index([order])\n  @@map(\"contract_phase_steps\")\n}\n\n// Required documents for a step (normalized from CSV)\nmodel ContractPhaseStepDocument {\n  id     String            @id @default(cuid())\n  stepId String\n  step   ContractPhaseStep @relation(fields: [stepId], references: [id], onDelete: Cascade)\n\n  documentType String\n  isRequired   Boolean @default(true)\n\n  createdAt DateTime @default(now())\n\n  @@index([stepId, documentType])\n  @@map(\"contract_phase_step_documents\")\n}\n\n// Approvals for documentation steps\nmodel ContractPhaseStepApproval {\n  id         String            @id @default(cuid())\n  stepId     String\n  step       ContractPhaseStep @relation(fields: [stepId], references: [id], onDelete: Cascade)\n  approverId String?\n  approver   User?             @relation(\"PhaseStepApprover\", fields: [approverId], references: [id])\n\n  decision  ApprovalDecision\n  comment   String?          @db.Text\n  decidedAt DateTime         @default(now())\n\n  createdAt DateTime @default(now())\n\n  @@index([stepId])\n  @@map(\"contract_phase_step_approvals\")\n}\n\n// Installments within a PAYMENT phase\nmodel ContractInstallment {\n  id      String        @id @default(cuid())\n  phaseId String\n  phase   ContractPhase @relation(fields: [phaseId], references: [id], onDelete: Cascade)\n\n  installmentNumber Int\n\n  amount          Float\n  principalAmount Float @default(0)\n  interestAmount  Float @default(0)\n\n  dueDate DateTime\n  status  InstallmentStatus @default(PENDING)\n\n  paidAmount Float     @default(0)\n  paidDate   DateTime?\n\n  lateFee            Float     @default(0)\n  lateFeeWaived      Boolean   @default(false)\n  gracePeriodDays    Int       @default(0)\n  gracePeriodEndDate DateTime?\n\n  createdAt DateTime @default(now())\n  updatedAt DateTime @updatedAt\n\n  payments ContractPayment[]\n\n  @@index([phaseId])\n  @@index([dueDate])\n  @@index([status])\n  @@map(\"contract_installments\")\n}\n\n// Unified payment record for contracts\nmodel ContractPayment {\n  id            String               @id @default(cuid())\n  contractId    String\n  contract      Contract             @relation(fields: [contractId], references: [id], onDelete: Cascade)\n  phaseId       String?\n  phase         ContractPhase?       @relation(fields: [phaseId], references: [id])\n  installmentId String?\n  installment   ContractInstallment? @relation(fields: [installmentId], references: [id])\n  payerId       String?\n  payer         User?                @relation(\"ContractPayer\", fields: [payerId], references: [id])\n\n  amount          Float\n  principalAmount Float @default(0)\n  interestAmount  Float @default(0)\n  lateFeeAmount   Float @default(0)\n\n  paymentMethod String // BANK_TRANSFER, CREDIT_CARD, WALLET, CASH, CHECK\n  status        PaymentStatus @default(INITIATED)\n\n  reference       String? @unique\n  gatewayResponse String? @db.Text // JSON\n\n  processedAt DateTime?\n  createdAt   DateTime  @default(now())\n  updatedAt   DateTime  @updatedAt\n\n  @@index([contractId])\n  @@index([phaseId])\n  @@index([installmentId])\n  @@index([payerId])\n  @@index([status])\n  @@index([reference])\n  @@map(\"contract_payments\")\n}\n\n// Contract documents (owned by contract, linked to phases/steps as needed)\nmodel ContractDocument {\n  id         String   @id @default(cuid())\n  contractId String\n  contract   Contract @relation(fields: [contractId], references: [id], onDelete: Cascade)\n  phaseId    String? // Optional link to specific phase\n  stepId     String? // Optional link to specific step\n\n  name         String\n  url          String\n  type         String // ID, BANK_STATEMENT, INCOME_PROOF, TITLE_DEED, SIGNATURE, etc.\n  uploadedById String?\n  uploadedBy   User?   @relation(\"DocumentUploader\", fields: [uploadedById], references: [id])\n\n  status DocumentStatus @default(PENDING)\n\n  createdAt DateTime @default(now())\n  updatedAt DateTime @updatedAt\n\n  @@index([contractId])\n  @@index([phaseId])\n  @@index([stepId])\n  @@index([type])\n  @@index([status])\n  @@map(\"contract_documents\")\n}\n\n// FSM transitions for audit\nmodel ContractTransition {\n  id             String   @id @default(cuid())\n  contractId     String\n  contract       Contract @relation(fields: [contractId], references: [id], onDelete: Cascade)\n  fromState      String\n  toState        String\n  trigger        String\n  metadata       String?  @db.Text // JSON\n  transitionedAt DateTime @default(now())\n\n  @@index([contractId])\n  @@map(\"contract_transitions\")\n}\n\n// Domain events for audit and integration\nmodel ContractEvent {\n  id         String   @id @default(cuid())\n  contractId String\n  contract   Contract @relation(fields: [contractId], references: [id], onDelete: Cascade)\n  event      String\n  data       String?  @db.Text // JSON\n  createdAt  DateTime @default(now())\n\n  @@index([contractId])\n  @@map(\"contract_events\")\n}\n\n// =============================================================================\n// OFFER LETTERS - Provisional and Final offer documents\n// =============================================================================\n\nmodel DocumentTemplate {\n  id       String @id @default(cuid())\n  tenantId String\n  tenant   Tenant @relation(fields: [tenantId], references: [id], onDelete: Cascade)\n\n  name        String // \"Provisional Offer Letter\", \"Final Offer Letter\"\n  code        String // PROVISIONAL_OFFER, FINAL_OFFER\n  description String?\n  version     Int     @default(1)\n\n  // Template content (Handlebars)\n  htmlTemplate String  @db.Text\n  cssStyles    String? @db.Text\n\n  // Merge field definitions for UI\n  mergeFields Json? // [{name, type, required, description}]\n\n  isActive  Boolean @default(true)\n  isDefault Boolean @default(false)\n\n  createdAt DateTime @default(now())\n  updatedAt DateTime @updatedAt\n\n  offerLetters OfferLetter[]\n\n  @@unique([tenantId, code, version])\n  @@index([tenantId])\n  @@index([code])\n  @@map(\"document_templates\")\n}\n\nmodel OfferLetter {\n  id         String   @id @default(cuid())\n  tenantId   String\n  tenant     Tenant   @relation(fields: [tenantId], references: [id], onDelete: Cascade)\n  contractId String\n  contract   Contract @relation(fields: [contractId], references: [id], onDelete: Cascade)\n\n  // Template used (optional - documents-service may handle default selection)\n  templateId String?\n  template   DocumentTemplate? @relation(fields: [templateId], references: [id])\n\n  // Letter details\n  letterNumber String            @unique // OL-XXXXXX\n  type         OfferLetterType\n  status       OfferLetterStatus @default(DRAFT)\n\n  // Generated document\n  htmlContent String? @db.Text // Rendered HTML\n  pdfUrl      String? // S3 URL of generated PDF\n  pdfKey      String? // S3 key for deletion/access\n\n  // Merge data used (snapshot for audit)\n  mergeData Json? // All data merged into template\n\n  // Signing workflow\n  sentAt        DateTime?\n  viewedAt      DateTime?\n  signedAt      DateTime?\n  signatureIp   String?\n  signatureData Json? // {method, timestamp, metadata}\n\n  // Validity\n  expiresAt    DateTime?\n  expiredAt    DateTime?\n  cancelledAt  DateTime?\n  cancelReason String?\n\n  // Audit\n  generatedById String?\n  generatedBy   User?   @relation(\"OfferLetterGenerator\", fields: [generatedById], references: [id])\n  sentById      String?\n  sentBy        User?   @relation(\"OfferLetterSender\", fields: [sentById], references: [id])\n\n  createdAt DateTime @default(now())\n  updatedAt DateTime @updatedAt\n\n  @@index([tenantId])\n  @@index([contractId])\n  @@index([type])\n  @@index([status])\n  @@map(\"offer_letters\")\n}\n\n// =============================================================================\n// CONTRACT TERMINATION - Full lifecycle for cancellation/termination\n// =============================================================================\n// Tracks termination requests from initiation through refund completion.\n// Industry-standard flow:\n// 1. Request created (by buyer/seller/admin/system)\n// 2. Admin reviews (if required by policy)\n// 3. Financial settlement calculated (refunds, penalties, forfeitures)\n// 4. Refund processed (if applicable)\n// 5. Contract marked terminated, unit released\n// =============================================================================\n\nmodel ContractTermination {\n  id         String   @id @default(cuid())\n  contractId String\n  contract   Contract @relation(fields: [contractId], references: [id], onDelete: Cascade)\n  tenantId   String\n  tenant     Tenant   @relation(fields: [tenantId], references: [id], onDelete: Cascade)\n\n  // Request identification\n  requestNumber String @unique // TRM-XXXXXX\n\n  // Who initiated and why\n  initiatedBy    TerminationInitiator\n  initiatorId    String? // userId if BUYER/SELLER/ADMIN\n  initiator      User?                @relation(\"TerminationInitiator\", fields: [initiatorId], references: [id])\n  type           TerminationType\n  reason         String?              @db.Text\n  supportingDocs Json? // [{type, url, uploadedAt}]\n\n  // Workflow status\n  status              TerminationStatus @default(REQUESTED)\n  requiresApproval    Boolean           @default(true)\n  autoApproveEligible Boolean           @default(false) // Pre-signature, no payments\n\n  // Admin review\n  reviewedBy      String?\n  reviewer        User?     @relation(\"TerminationReviewer\", fields: [reviewedBy], references: [id])\n  reviewedAt      DateTime?\n  reviewNotes     String?   @db.Text\n  rejectionReason String?   @db.Text\n\n  // Financial snapshot at time of request\n  contractSnapshot    Json // Full contract state snapshot\n  totalContractAmount Float\n  totalPaidToDate     Float\n  outstandingBalance  Float\n\n  // Settlement calculation\n  refundableAmount Float   @default(0) // Amount eligible for refund\n  penaltyAmount    Float   @default(0) // Penalties/fees to deduct\n  forfeitedAmount  Float   @default(0) // Amount forfeited (non-refundable deposits)\n  adminFeeAmount   Float   @default(0) // Processing fees\n  netRefundAmount  Float   @default(0) // refundableAmount - penaltyAmount - adminFeeAmount\n  settlementNotes  String? @db.Text\n\n  // Refund processing\n  refundStatus         RefundStatus @default(NOT_APPLICABLE)\n  refundReference      String? // Payment gateway reference\n  refundMethod         String? // ORIGINAL_METHOD, BANK_TRANSFER, CHECK, WALLET\n  refundAccountDetails Json? // Encrypted bank details if needed\n  refundInitiatedAt    DateTime?\n  refundCompletedAt    DateTime?\n  refundFailureReason  String?      @db.Text\n\n  // Property unit handling\n  unitReleasedAt    DateTime?\n  unitReservedForId String? // If unit being held for another buyer\n\n  // Timing\n  requestedAt DateTime  @default(now())\n  approvedAt  DateTime?\n  executedAt  DateTime?\n  completedAt DateTime?\n  cancelledAt DateTime?\n\n  // Idempotency and audit\n  idempotencyKey String? @unique\n  metadata       Json?\n\n  createdAt DateTime @default(now())\n  updatedAt DateTime @updatedAt\n\n  @@index([contractId])\n  @@index([tenantId])\n  @@index([status])\n  @@index([type])\n  @@index([initiatorId])\n  @@index([requestedAt])\n  @@map(\"contract_terminations\")\n}\n\n// =============================================================================\n// PREQUALIFICATION - Eligibility assessment before contract creation\n// =============================================================================\n// Prequalification is a separate aggregate that evaluates a user's eligibility\n// for a specific product (property + payment method). It captures their answers\n// to eligibility questions and calculates a score. Once approved, it can be\n// linked to a Contract to provide context about how the buyer qualified.\n// =============================================================================\n\nenum PrequalificationStatus {\n  DRAFT\n  SUBMITTED\n  UNDER_REVIEW\n  APPROVED\n  REJECTED\n  EXPIRED\n}\n\nmodel Prequalification {\n  id       String @id @default(cuid())\n  tenantId String\n  tenant   Tenant @relation(fields: [tenantId], references: [id], onDelete: Cascade)\n  userId   String\n  user     User   @relation(fields: [userId], references: [id], onDelete: Cascade)\n\n  // What they're applying for\n  propertyId      String\n  property        Property              @relation(fields: [propertyId], references: [id], onDelete: Cascade)\n  paymentMethodId String\n  paymentMethod   PropertyPaymentMethod @relation(fields: [paymentMethodId], references: [id])\n\n  // Questionnaire responses and scoring\n  answers Json // Array of {questionId, answer, weight, score}\n  score   Float? // Computed eligibility score (0-100)\n\n  // Financial assessment\n  requestedAmount     Float? // How much they want to finance\n  monthlyIncome       Float? // Self-reported monthly income\n  monthlyExpenses     Float? // Self-reported monthly expenses\n  debtToIncomeRatio   Float? // Computed DTI\n  suggestedTermMonths Int? // System-suggested term based on affordability\n\n  // Status tracking\n  status     PrequalificationStatus @default(DRAFT)\n  notes      String?                @db.Text // Admin notes\n  reviewedBy String? // Admin who reviewed\n  reviewedAt DateTime?\n  expiresAt  DateTime? // Prequalification validity period\n\n  // If approved, may be linked to eventual contract\n  contractId String?   @unique\n  contract   Contract? @relation(fields: [contractId], references: [id])\n\n  // Underwriting decisions for this prequalification\n  underwritingDecisions UnderwritingDecision[]\n\n  createdAt DateTime @default(now())\n  updatedAt DateTime @updatedAt\n\n  @@index([tenantId])\n  @@index([userId])\n  @@index([propertyId])\n  @@index([status])\n  @@map(\"prequalifications\")\n}\n\n// =============================================================================\n// UNDERWRITING DECISION - Automated/manual credit decisions\n// =============================================================================\n// Records each underwriting decision for a prequalification. Multiple decisions\n// may exist if re-evaluation occurs (e.g., after document submission).\n// =============================================================================\n\nmodel UnderwritingDecision {\n  id       String @id @default(cuid())\n  tenantId String\n  tenant   Tenant @relation(fields: [tenantId], references: [id], onDelete: Cascade)\n\n  // Link to prequalification being evaluated\n  prequalificationId String\n  prequalification   Prequalification @relation(fields: [prequalificationId], references: [id], onDelete: Cascade)\n\n  // Decision outcome\n  decision UnderwritingDecisionKind\n\n  // Scoring and rationale\n  score      Float? // Computed risk score (0-100)\n  reasons    Json? // Array of reason codes/messages for decision\n  conditions Json? // Array of conditions for CONDITIONAL decisions\n\n  // Rule engine metadata\n  rulesVersion String? // Version of rules/model used\n  ruleResults  Json? // Detailed rule evaluation results\n\n  // External data references (credit bureau, verifications)\n  externalChecks Json? // { creditBureau: {...}, incomeVerification: {...} }\n\n  // Manual review (if escalated)\n  isManualReview Boolean   @default(false)\n  reviewedBy     String? // Admin who reviewed\n  reviewedAt     DateTime?\n  reviewNotes    String?   @db.Text\n\n  // Audit\n  createdAt DateTime @default(now())\n  updatedAt DateTime @updatedAt\n\n  @@index([tenantId])\n  @@index([prequalificationId])\n  @@index([decision])\n  @@index([createdAt])\n  @@map(\"underwriting_decisions\")\n}\n\n// =============================================================================\n// PAYMENT METHOD CHANGE REQUEST - Mid-contract payment method changes\n// =============================================================================\n// When a user wants to change their payment method after contract creation,\n// this aggregate tracks the request, required documentation, approvals, and\n// final execution. Different from-to combinations may require different docs.\n// =============================================================================\n\nenum PaymentMethodChangeStatus {\n  PENDING_DOCUMENTS\n  DOCUMENTS_SUBMITTED\n  UNDER_REVIEW\n  APPROVED\n  REJECTED\n  EXECUTED\n  CANCELLED\n}\n\nmodel PaymentMethodChangeRequest {\n  id         String   @id @default(cuid())\n  tenantId   String\n  tenant     Tenant   @relation(fields: [tenantId], references: [id], onDelete: Cascade)\n  contractId String\n  contract   Contract @relation(fields: [contractId], references: [id], onDelete: Cascade)\n\n  // The change being requested\n  fromPaymentMethodId String\n  fromPaymentMethod   PropertyPaymentMethod @relation(\"ChangeFromMethod\", fields: [fromPaymentMethodId], references: [id])\n  toPaymentMethodId   String\n  toPaymentMethod     PropertyPaymentMethod @relation(\"ChangeToMethod\", fields: [toPaymentMethodId], references: [id])\n\n  // Who requested and why\n  requestorId String\n  requestor   User    @relation(\"ChangeRequestor\", fields: [requestorId], references: [id])\n  reason      String? @db.Text\n\n  // Documentation requirements (determined by DocumentRequirementRule)\n  requiredDocumentTypes String? // CSV: BANK_STATEMENT,INCOME_PROOF,NEW_EMPLOYER_LETTER\n  submittedDocuments    Json? // [{type, s3Key, uploadedAt, status}]\n\n  // Financial impact assessment\n  currentOutstanding   Float? // Outstanding balance at time of request\n  newTermMonths        Int? // New term if applicable\n  newInterestRate      Float? // New rate if applicable\n  newMonthlyPayment    Float? // Projected new payment\n  penaltyAmount        Float? // Early change penalty if applicable\n  financialImpactNotes String? @db.Text\n\n  // Status and workflow\n  status      PaymentMethodChangeStatus @default(PENDING_DOCUMENTS)\n  reviewerId  String?\n  reviewer    User?                     @relation(\"ChangeReviewer\", fields: [reviewerId], references: [id])\n  reviewNotes String?                   @db.Text\n  reviewedAt  DateTime?\n\n  // Execution details\n  executedAt        DateTime?\n  previousPhaseData Json? // Snapshot of phases before change\n  newPhaseData      Json? // New phases created after change\n\n  createdAt DateTime @default(now())\n  updatedAt DateTime @updatedAt\n\n  @@index([tenantId])\n  @@index([contractId])\n  @@index([status])\n  @@index([requestorId])\n  @@map(\"payment_method_change_requests\")\n}\n\n// =============================================================================\n// DOCUMENT REQUIREMENT RULES - Configurable document requirements\n// =============================================================================\n// Admins can configure which documents are required for specific scenarios:\n// - Prequalification for a payment method type\n// - Contract phases\n// - Payment method changes (from-to combinations)\n// This allows tenants to customize documentation workflows per product.\n// =============================================================================\n\nenum DocumentRequirementContext {\n  PREQUALIFICATION // During prequalification\n  CONTRACT_PHASE // During a contract phase\n  PAYMENT_METHOD_CHANGE // When changing payment method mid-contract\n}\n\nmodel DocumentRequirementRule {\n  id       String @id @default(cuid())\n  tenantId String\n  tenant   Tenant @relation(fields: [tenantId], references: [id], onDelete: Cascade)\n\n  // Rule context\n  context DocumentRequirementContext\n\n  // Scoping (which situations this rule applies to)\n  // For PREQUALIFICATION: paymentMethodId\n  // For CONTRACT_PHASE: phaseType\n  // For PAYMENT_METHOD_CHANGE: fromMethodId + toMethodId\n  paymentMethodId     String?\n  paymentMethod       PropertyPaymentMethod? @relation(\"RulePaymentMethod\", fields: [paymentMethodId], references: [id])\n  phaseType           String? // KYC, VERIFICATION, DOWNPAYMENT, etc.\n  fromPaymentMethodId String?\n  fromPaymentMethod   PropertyPaymentMethod? @relation(\"RuleFromMethod\", fields: [fromPaymentMethodId], references: [id])\n  toPaymentMethodId   String?\n  toPaymentMethod     PropertyPaymentMethod? @relation(\"RuleToMethod\", fields: [toPaymentMethodId], references: [id])\n\n  // Document requirements\n  documentType     String // ID_CARD, PASSPORT, BANK_STATEMENT, INCOME_PROOF, etc.\n  isRequired       Boolean @default(true)\n  description      String? // Instructions for the user\n  maxSizeBytes     Int? // Max file size allowed\n  allowedMimeTypes String? // CSV: application/pdf,image/jpeg,image/png\n\n  // Validation rules\n  expiryDays           Int? // Document must not be older than X days\n  requiresManualReview Boolean @default(false)\n\n  isActive  Boolean  @default(true)\n  createdAt DateTime @default(now())\n  updatedAt DateTime @updatedAt\n\n  @@index([tenantId])\n  @@index([context])\n  @@index([paymentMethodId])\n  @@index([phaseType])\n  @@index([fromPaymentMethodId, toPaymentMethodId])\n  @@map(\"document_requirement_rules\")\n}\n\n// =============================================================================\n// EVENT OUTBOX - For guaranteed event delivery to SQS queues\n// =============================================================================\n\nmodel DomainEvent {\n  id String @id @default(cuid())\n\n  // Event identification\n  eventType     String // MORTGAGE.CREATED, PHASE.ACTIVATED, PAYMENT.COMPLETED, etc\n  aggregateType String // Mortgage, MortgagePhase, MortgagePayment, Property, etc\n  aggregateId   String\n\n  // Routing - which queue(s) should receive this\n  queueName String // notifications, payments, mortgage-steps, accounting, etc\n\n  // Event payload (all data needed by consumers)\n  payload String @db.Text // JSON\n\n  // Metadata\n  occurredAt DateTime @default(now())\n  actorId    String? // User who triggered the event\n  actorRole  String? // Role of the actor\n\n  // Processing status\n  status       String    @default(\"PENDING\") // PENDING, PROCESSING, SENT, FAILED\n  processedAt  DateTime?\n  sentAt       DateTime?\n  failureCount Int       @default(0)\n  lastError    String?   @db.Text\n  nextRetryAt  DateTime?\n\n  createdAt DateTime @default(now())\n  updatedAt DateTime @updatedAt\n\n  @@index([status, nextRetryAt])\n  @@index([eventType])\n  @@index([aggregateType, aggregateId])\n  @@index([queueName])\n  @@index([occurredAt])\n  @@map(\"domain_events\")\n}\n",
     "runtimeDataModel": {
         "models": {},
         "enums": {},

package/dist/generated/client/models/DocumentTemplate.d.ts CHANGED Viewed

@@ -483,9 +483,9 @@ export type DocumentTemplateMinOrderByAggregateInput = {
 export type DocumentTemplateSumOrderByAggregateInput = {
     version?: Prisma.SortOrder;
 };
-export type DocumentTemplateScalarRelationFilter = {
-    is?: Prisma.DocumentTemplateWhereInput;
-    isNot?: Prisma.DocumentTemplateWhereInput;
+export type DocumentTemplateNullableScalarRelationFilter = {
+    is?: Prisma.DocumentTemplateWhereInput | null;
+    isNot?: Prisma.DocumentTemplateWhereInput | null;
 };
 export type DocumentTemplateCreateNestedManyWithoutTenantInput = {
     create?: Prisma.XOR<Prisma.DocumentTemplateCreateWithoutTenantInput, Prisma.DocumentTemplateUncheckedCreateWithoutTenantInput> | Prisma.DocumentTemplateCreateWithoutTenantInput[] | Prisma.DocumentTemplateUncheckedCreateWithoutTenantInput[];
@@ -530,10 +530,12 @@ export type DocumentTemplateCreateNestedOneWithoutOfferLettersInput = {
     connectOrCreate?: Prisma.DocumentTemplateCreateOrConnectWithoutOfferLettersInput;
     connect?: Prisma.DocumentTemplateWhereUniqueInput;
 };
-export type DocumentTemplateUpdateOneRequiredWithoutOfferLettersNestedInput = {
+export type DocumentTemplateUpdateOneWithoutOfferLettersNestedInput = {
     create?: Prisma.XOR<Prisma.DocumentTemplateCreateWithoutOfferLettersInput, Prisma.DocumentTemplateUncheckedCreateWithoutOfferLettersInput>;
     connectOrCreate?: Prisma.DocumentTemplateCreateOrConnectWithoutOfferLettersInput;
     upsert?: Prisma.DocumentTemplateUpsertWithoutOfferLettersInput;
+    disconnect?: Prisma.DocumentTemplateWhereInput | boolean;
+    delete?: Prisma.DocumentTemplateWhereInput | boolean;
     connect?: Prisma.DocumentTemplateWhereUniqueInput;
     update?: Prisma.XOR<Prisma.XOR<Prisma.DocumentTemplateUpdateToOneWithWhereWithoutOfferLettersInput, Prisma.DocumentTemplateUpdateWithoutOfferLettersInput>, Prisma.DocumentTemplateUncheckedUpdateWithoutOfferLettersInput>;
 };

package/dist/generated/client/models/OfferLetter.d.ts CHANGED Viewed

@@ -227,7 +227,7 @@ export type OfferLetterGroupByOutputType = {
     id: string;
     tenantId: string;
     contractId: string;
-    templateId: string;
+    templateId: string | null;
     letterNumber: string;
     type: $Enums.OfferLetterType;
     status: $Enums.OfferLetterStatus;
@@ -262,7 +262,7 @@ export type OfferLetterWhereInput = {
     id?: Prisma.StringFilter<"OfferLetter"> | string;
     tenantId?: Prisma.StringFilter<"OfferLetter"> | string;
     contractId?: Prisma.StringFilter<"OfferLetter"> | string;
-    templateId?: Prisma.StringFilter<"OfferLetter"> | string;
+    templateId?: Prisma.StringNullableFilter<"OfferLetter"> | string | null;
     letterNumber?: Prisma.StringFilter<"OfferLetter"> | string;
     type?: Prisma.EnumOfferLetterTypeFilter<"OfferLetter"> | $Enums.OfferLetterType;
     status?: Prisma.EnumOfferLetterStatusFilter<"OfferLetter"> | $Enums.OfferLetterStatus;
@@ -285,7 +285,7 @@ export type OfferLetterWhereInput = {
     updatedAt?: Prisma.DateTimeFilter<"OfferLetter"> | Date | string;
     tenant?: Prisma.XOR<Prisma.TenantScalarRelationFilter, Prisma.TenantWhereInput>;
     contract?: Prisma.XOR<Prisma.ContractScalarRelationFilter, Prisma.ContractWhereInput>;
-    template?: Prisma.XOR<Prisma.DocumentTemplateScalarRelationFilter, Prisma.DocumentTemplateWhereInput>;
+    template?: Prisma.XOR<Prisma.DocumentTemplateNullableScalarRelationFilter, Prisma.DocumentTemplateWhereInput> | null;
     generatedBy?: Prisma.XOR<Prisma.UserNullableScalarRelationFilter, Prisma.UserWhereInput> | null;
     sentBy?: Prisma.XOR<Prisma.UserNullableScalarRelationFilter, Prisma.UserWhereInput> | null;
 };
@@ -293,7 +293,7 @@ export type OfferLetterOrderByWithRelationInput = {
     id?: Prisma.SortOrder;
     tenantId?: Prisma.SortOrder;
     contractId?: Prisma.SortOrder;
-    templateId?: Prisma.SortOrder;
+    templateId?: Prisma.SortOrderInput | Prisma.SortOrder;
     letterNumber?: Prisma.SortOrder;
     type?: Prisma.SortOrder;
     status?: Prisma.SortOrder;
@@ -329,7 +329,7 @@ export type OfferLetterWhereUniqueInput = Prisma.AtLeast<{
     NOT?: Prisma.OfferLetterWhereInput | Prisma.OfferLetterWhereInput[];
     tenantId?: Prisma.StringFilter<"OfferLetter"> | string;
     contractId?: Prisma.StringFilter<"OfferLetter"> | string;
-    templateId?: Prisma.StringFilter<"OfferLetter"> | string;
+    templateId?: Prisma.StringNullableFilter<"OfferLetter"> | string | null;
     type?: Prisma.EnumOfferLetterTypeFilter<"OfferLetter"> | $Enums.OfferLetterType;
     status?: Prisma.EnumOfferLetterStatusFilter<"OfferLetter"> | $Enums.OfferLetterStatus;
     htmlContent?: Prisma.StringNullableFilter<"OfferLetter"> | string | null;
@@ -351,7 +351,7 @@ export type OfferLetterWhereUniqueInput = Prisma.AtLeast<{
     updatedAt?: Prisma.DateTimeFilter<"OfferLetter"> | Date | string;
     tenant?: Prisma.XOR<Prisma.TenantScalarRelationFilter, Prisma.TenantWhereInput>;
     contract?: Prisma.XOR<Prisma.ContractScalarRelationFilter, Prisma.ContractWhereInput>;
-    template?: Prisma.XOR<Prisma.DocumentTemplateScalarRelationFilter, Prisma.DocumentTemplateWhereInput>;
+    template?: Prisma.XOR<Prisma.DocumentTemplateNullableScalarRelationFilter, Prisma.DocumentTemplateWhereInput> | null;
     generatedBy?: Prisma.XOR<Prisma.UserNullableScalarRelationFilter, Prisma.UserWhereInput> | null;
     sentBy?: Prisma.XOR<Prisma.UserNullableScalarRelationFilter, Prisma.UserWhereInput> | null;
 }, "id" | "letterNumber">;
@@ -359,7 +359,7 @@ export type OfferLetterOrderByWithAggregationInput = {
     id?: Prisma.SortOrder;
     tenantId?: Prisma.SortOrder;
     contractId?: Prisma.SortOrder;
-    templateId?: Prisma.SortOrder;
+    templateId?: Prisma.SortOrderInput | Prisma.SortOrder;
     letterNumber?: Prisma.SortOrder;
     type?: Prisma.SortOrder;
     status?: Prisma.SortOrder;
@@ -391,7 +391,7 @@ export type OfferLetterScalarWhereWithAggregatesInput = {
     id?: Prisma.StringWithAggregatesFilter<"OfferLetter"> | string;
     tenantId?: Prisma.StringWithAggregatesFilter<"OfferLetter"> | string;
     contractId?: Prisma.StringWithAggregatesFilter<"OfferLetter"> | string;
-    templateId?: Prisma.StringWithAggregatesFilter<"OfferLetter"> | string;
+    templateId?: Prisma.StringNullableWithAggregatesFilter<"OfferLetter"> | string | null;
     letterNumber?: Prisma.StringWithAggregatesFilter<"OfferLetter"> | string;
     type?: Prisma.EnumOfferLetterTypeWithAggregatesFilter<"OfferLetter"> | $Enums.OfferLetterType;
     status?: Prisma.EnumOfferLetterStatusWithAggregatesFilter<"OfferLetter"> | $Enums.OfferLetterStatus;
@@ -435,7 +435,7 @@ export type OfferLetterCreateInput = {
     updatedAt?: Date | string;
     tenant: Prisma.TenantCreateNestedOneWithoutOfferLettersInput;
     contract: Prisma.ContractCreateNestedOneWithoutOfferLettersInput;
-    template: Prisma.DocumentTemplateCreateNestedOneWithoutOfferLettersInput;
+    template?: Prisma.DocumentTemplateCreateNestedOneWithoutOfferLettersInput;
     generatedBy?: Prisma.UserCreateNestedOneWithoutOfferLettersGeneratedInput;
     sentBy?: Prisma.UserCreateNestedOneWithoutOfferLettersSentInput;
 };
@@ -443,7 +443,7 @@ export type OfferLetterUncheckedCreateInput = {
     id?: string;
     tenantId: string;
     contractId: string;
-    templateId: string;
+    templateId?: string | null;
     letterNumber: string;
     type: $Enums.OfferLetterType;
     status?: $Enums.OfferLetterStatus;
@@ -487,7 +487,7 @@ export type OfferLetterUpdateInput = {
     updatedAt?: Prisma.DateTimeFieldUpdateOperationsInput | Date | string;
     tenant?: Prisma.TenantUpdateOneRequiredWithoutOfferLettersNestedInput;
     contract?: Prisma.ContractUpdateOneRequiredWithoutOfferLettersNestedInput;
-    template?: Prisma.DocumentTemplateUpdateOneRequiredWithoutOfferLettersNestedInput;
+    template?: Prisma.DocumentTemplateUpdateOneWithoutOfferLettersNestedInput;
     generatedBy?: Prisma.UserUpdateOneWithoutOfferLettersGeneratedNestedInput;
     sentBy?: Prisma.UserUpdateOneWithoutOfferLettersSentNestedInput;
 };
@@ -495,7 +495,7 @@ export type OfferLetterUncheckedUpdateInput = {
     id?: Prisma.StringFieldUpdateOperationsInput | string;
     tenantId?: Prisma.StringFieldUpdateOperationsInput | string;
     contractId?: Prisma.StringFieldUpdateOperationsInput | string;
-    templateId?: Prisma.StringFieldUpdateOperationsInput | string;
+    templateId?: Prisma.NullableStringFieldUpdateOperationsInput | string | null;
     letterNumber?: Prisma.StringFieldUpdateOperationsInput | string;
     type?: Prisma.EnumOfferLetterTypeFieldUpdateOperationsInput | $Enums.OfferLetterType;
     status?: Prisma.EnumOfferLetterStatusFieldUpdateOperationsInput | $Enums.OfferLetterStatus;
@@ -521,7 +521,7 @@ export type OfferLetterCreateManyInput = {
     id?: string;
     tenantId: string;
     contractId: string;
-    templateId: string;
+    templateId?: string | null;
     letterNumber: string;
     type: $Enums.OfferLetterType;
     status?: $Enums.OfferLetterStatus;
@@ -568,7 +568,7 @@ export type OfferLetterUncheckedUpdateManyInput = {
     id?: Prisma.StringFieldUpdateOperationsInput | string;
     tenantId?: Prisma.StringFieldUpdateOperationsInput | string;
     contractId?: Prisma.StringFieldUpdateOperationsInput | string;
-    templateId?: Prisma.StringFieldUpdateOperationsInput | string;
+    templateId?: Prisma.NullableStringFieldUpdateOperationsInput | string | null;
     letterNumber?: Prisma.StringFieldUpdateOperationsInput | string;
     type?: Prisma.EnumOfferLetterTypeFieldUpdateOperationsInput | $Enums.OfferLetterType;
     status?: Prisma.EnumOfferLetterStatusFieldUpdateOperationsInput | $Enums.OfferLetterStatus;
@@ -895,14 +895,14 @@ export type OfferLetterCreateWithoutGeneratedByInput = {
     updatedAt?: Date | string;
     tenant: Prisma.TenantCreateNestedOneWithoutOfferLettersInput;
     contract: Prisma.ContractCreateNestedOneWithoutOfferLettersInput;
-    template: Prisma.DocumentTemplateCreateNestedOneWithoutOfferLettersInput;
+    template?: Prisma.DocumentTemplateCreateNestedOneWithoutOfferLettersInput;
     sentBy?: Prisma.UserCreateNestedOneWithoutOfferLettersSentInput;
 };
 export type OfferLetterUncheckedCreateWithoutGeneratedByInput = {
     id?: string;
     tenantId: string;
     contractId: string;
-    templateId: string;
+    templateId?: string | null;
     letterNumber: string;
     type: $Enums.OfferLetterType;
     status?: $Enums.OfferLetterStatus;
@@ -953,14 +953,14 @@ export type OfferLetterCreateWithoutSentByInput = {
     updatedAt?: Date | string;
     tenant: Prisma.TenantCreateNestedOneWithoutOfferLettersInput;
     contract: Prisma.ContractCreateNestedOneWithoutOfferLettersInput;
-    template: Prisma.DocumentTemplateCreateNestedOneWithoutOfferLettersInput;
+    template?: Prisma.DocumentTemplateCreateNestedOneWithoutOfferLettersInput;
     generatedBy?: Prisma.UserCreateNestedOneWithoutOfferLettersGeneratedInput;
 };
 export type OfferLetterUncheckedCreateWithoutSentByInput = {
     id?: string;
     tenantId: string;
     contractId: string;
-    templateId: string;
+    templateId?: string | null;
     letterNumber: string;
     type: $Enums.OfferLetterType;
     status?: $Enums.OfferLetterStatus;
@@ -1009,7 +1009,7 @@ export type OfferLetterScalarWhereInput = {
     id?: Prisma.StringFilter<"OfferLetter"> | string;
     tenantId?: Prisma.StringFilter<"OfferLetter"> | string;
     contractId?: Prisma.StringFilter<"OfferLetter"> | string;
-    templateId?: Prisma.StringFilter<"OfferLetter"> | string;
+    templateId?: Prisma.StringNullableFilter<"OfferLetter"> | string | null;
     letterNumber?: Prisma.StringFilter<"OfferLetter"> | string;
     type?: Prisma.EnumOfferLetterTypeFilter<"OfferLetter"> | $Enums.OfferLetterType;
     status?: Prisma.EnumOfferLetterStatusFilter<"OfferLetter"> | $Enums.OfferLetterStatus;
@@ -1065,14 +1065,14 @@ export type OfferLetterCreateWithoutTenantInput = {
     createdAt?: Date | string;
     updatedAt?: Date | string;
     contract: Prisma.ContractCreateNestedOneWithoutOfferLettersInput;
-    template: Prisma.DocumentTemplateCreateNestedOneWithoutOfferLettersInput;
+    template?: Prisma.DocumentTemplateCreateNestedOneWithoutOfferLettersInput;
     generatedBy?: Prisma.UserCreateNestedOneWithoutOfferLettersGeneratedInput;
     sentBy?: Prisma.UserCreateNestedOneWithoutOfferLettersSentInput;
 };
 export type OfferLetterUncheckedCreateWithoutTenantInput = {
     id?: string;
     contractId: string;
-    templateId: string;
+    templateId?: string | null;
     letterNumber: string;
     type: $Enums.OfferLetterType;
     status?: $Enums.OfferLetterStatus;
@@ -1136,14 +1136,14 @@ export type OfferLetterCreateWithoutContractInput = {
     createdAt?: Date | string;
     updatedAt?: Date | string;
     tenant: Prisma.TenantCreateNestedOneWithoutOfferLettersInput;
-    template: Prisma.DocumentTemplateCreateNestedOneWithoutOfferLettersInput;
+    template?: Prisma.DocumentTemplateCreateNestedOneWithoutOfferLettersInput;
     generatedBy?: Prisma.UserCreateNestedOneWithoutOfferLettersGeneratedInput;
     sentBy?: Prisma.UserCreateNestedOneWithoutOfferLettersSentInput;
 };
 export type OfferLetterUncheckedCreateWithoutContractInput = {
     id?: string;
     tenantId: string;
-    templateId: string;
+    templateId?: string | null;
     letterNumber: string;
     type: $Enums.OfferLetterType;
     status?: $Enums.OfferLetterStatus;
@@ -1261,7 +1261,7 @@ export type OfferLetterCreateManyGeneratedByInput = {
     id?: string;
     tenantId: string;
     contractId: string;
-    templateId: string;
+    templateId?: string | null;
     letterNumber: string;
     type: $Enums.OfferLetterType;
     status?: $Enums.OfferLetterStatus;
@@ -1286,7 +1286,7 @@ export type OfferLetterCreateManySentByInput = {
     id?: string;
     tenantId: string;
     contractId: string;
-    templateId: string;
+    templateId?: string | null;
     letterNumber: string;
     type: $Enums.OfferLetterType;
     status?: $Enums.OfferLetterStatus;
@@ -1329,14 +1329,14 @@ export type OfferLetterUpdateWithoutGeneratedByInput = {
     updatedAt?: Prisma.DateTimeFieldUpdateOperationsInput | Date | string;
     tenant?: Prisma.TenantUpdateOneRequiredWithoutOfferLettersNestedInput;
     contract?: Prisma.ContractUpdateOneRequiredWithoutOfferLettersNestedInput;
-    template?: Prisma.DocumentTemplateUpdateOneRequiredWithoutOfferLettersNestedInput;
+    template?: Prisma.DocumentTemplateUpdateOneWithoutOfferLettersNestedInput;
     sentBy?: Prisma.UserUpdateOneWithoutOfferLettersSentNestedInput;
 };
 export type OfferLetterUncheckedUpdateWithoutGeneratedByInput = {
     id?: Prisma.StringFieldUpdateOperationsInput | string;
     tenantId?: Prisma.StringFieldUpdateOperationsInput | string;
     contractId?: Prisma.StringFieldUpdateOperationsInput | string;
-    templateId?: Prisma.StringFieldUpdateOperationsInput | string;
+    templateId?: Prisma.NullableStringFieldUpdateOperationsInput | string | null;
     letterNumber?: Prisma.StringFieldUpdateOperationsInput | string;
     type?: Prisma.EnumOfferLetterTypeFieldUpdateOperationsInput | $Enums.OfferLetterType;
     status?: Prisma.EnumOfferLetterStatusFieldUpdateOperationsInput | $Enums.OfferLetterStatus;
@@ -1361,7 +1361,7 @@ export type OfferLetterUncheckedUpdateManyWithoutGeneratedByInput = {
     id?: Prisma.StringFieldUpdateOperationsInput | string;
     tenantId?: Prisma.StringFieldUpdateOperationsInput | string;
     contractId?: Prisma.StringFieldUpdateOperationsInput | string;
-    templateId?: Prisma.StringFieldUpdateOperationsInput | string;
+    templateId?: Prisma.NullableStringFieldUpdateOperationsInput | string | null;
     letterNumber?: Prisma.StringFieldUpdateOperationsInput | string;
     type?: Prisma.EnumOfferLetterTypeFieldUpdateOperationsInput | $Enums.OfferLetterType;
     status?: Prisma.EnumOfferLetterStatusFieldUpdateOperationsInput | $Enums.OfferLetterStatus;
@@ -1404,14 +1404,14 @@ export type OfferLetterUpdateWithoutSentByInput = {
     updatedAt?: Prisma.DateTimeFieldUpdateOperationsInput | Date | string;
     tenant?: Prisma.TenantUpdateOneRequiredWithoutOfferLettersNestedInput;
     contract?: Prisma.ContractUpdateOneRequiredWithoutOfferLettersNestedInput;
-    template?: Prisma.DocumentTemplateUpdateOneRequiredWithoutOfferLettersNestedInput;
+    template?: Prisma.DocumentTemplateUpdateOneWithoutOfferLettersNestedInput;
     generatedBy?: Prisma.UserUpdateOneWithoutOfferLettersGeneratedNestedInput;
 };
 export type OfferLetterUncheckedUpdateWithoutSentByInput = {
     id?: Prisma.StringFieldUpdateOperationsInput | string;
     tenantId?: Prisma.StringFieldUpdateOperationsInput | string;
     contractId?: Prisma.StringFieldUpdateOperationsInput | string;
-    templateId?: Prisma.StringFieldUpdateOperationsInput | string;
+    templateId?: Prisma.NullableStringFieldUpdateOperationsInput | string | null;
     letterNumber?: Prisma.StringFieldUpdateOperationsInput | string;
     type?: Prisma.EnumOfferLetterTypeFieldUpdateOperationsInput | $Enums.OfferLetterType;
     status?: Prisma.EnumOfferLetterStatusFieldUpdateOperationsInput | $Enums.OfferLetterStatus;
@@ -1436,7 +1436,7 @@ export type OfferLetterUncheckedUpdateManyWithoutSentByInput = {
     id?: Prisma.StringFieldUpdateOperationsInput | string;
     tenantId?: Prisma.StringFieldUpdateOperationsInput | string;
     contractId?: Prisma.StringFieldUpdateOperationsInput | string;
-    templateId?: Prisma.StringFieldUpdateOperationsInput | string;
+    templateId?: Prisma.NullableStringFieldUpdateOperationsInput | string | null;
     letterNumber?: Prisma.StringFieldUpdateOperationsInput | string;
     type?: Prisma.EnumOfferLetterTypeFieldUpdateOperationsInput | $Enums.OfferLetterType;
     status?: Prisma.EnumOfferLetterStatusFieldUpdateOperationsInput | $Enums.OfferLetterStatus;
@@ -1460,7 +1460,7 @@ export type OfferLetterUncheckedUpdateManyWithoutSentByInput = {
 export type OfferLetterCreateManyTenantInput = {
     id?: string;
     contractId: string;
-    templateId: string;
+    templateId?: string | null;
     letterNumber: string;
     type: $Enums.OfferLetterType;
     status?: $Enums.OfferLetterStatus;
@@ -1503,14 +1503,14 @@ export type OfferLetterUpdateWithoutTenantInput = {
     createdAt?: Prisma.DateTimeFieldUpdateOperationsInput | Date | string;
     updatedAt?: Prisma.DateTimeFieldUpdateOperationsInput | Date | string;
     contract?: Prisma.ContractUpdateOneRequiredWithoutOfferLettersNestedInput;
-    template?: Prisma.DocumentTemplateUpdateOneRequiredWithoutOfferLettersNestedInput;
+    template?: Prisma.DocumentTemplateUpdateOneWithoutOfferLettersNestedInput;
     generatedBy?: Prisma.UserUpdateOneWithoutOfferLettersGeneratedNestedInput;
     sentBy?: Prisma.UserUpdateOneWithoutOfferLettersSentNestedInput;
 };
 export type OfferLetterUncheckedUpdateWithoutTenantInput = {
     id?: Prisma.StringFieldUpdateOperationsInput | string;
     contractId?: Prisma.StringFieldUpdateOperationsInput | string;
-    templateId?: Prisma.StringFieldUpdateOperationsInput | string;
+    templateId?: Prisma.NullableStringFieldUpdateOperationsInput | string | null;
     letterNumber?: Prisma.StringFieldUpdateOperationsInput | string;
     type?: Prisma.EnumOfferLetterTypeFieldUpdateOperationsInput | $Enums.OfferLetterType;
     status?: Prisma.EnumOfferLetterStatusFieldUpdateOperationsInput | $Enums.OfferLetterStatus;
@@ -1535,7 +1535,7 @@ export type OfferLetterUncheckedUpdateWithoutTenantInput = {
 export type OfferLetterUncheckedUpdateManyWithoutTenantInput = {
     id?: Prisma.StringFieldUpdateOperationsInput | string;
     contractId?: Prisma.StringFieldUpdateOperationsInput | string;
-    templateId?: Prisma.StringFieldUpdateOperationsInput | string;
+    templateId?: Prisma.NullableStringFieldUpdateOperationsInput | string | null;
     letterNumber?: Prisma.StringFieldUpdateOperationsInput | string;
     type?: Prisma.EnumOfferLetterTypeFieldUpdateOperationsInput | $Enums.OfferLetterType;
     status?: Prisma.EnumOfferLetterStatusFieldUpdateOperationsInput | $Enums.OfferLetterStatus;
@@ -1560,7 +1560,7 @@ export type OfferLetterUncheckedUpdateManyWithoutTenantInput = {
 export type OfferLetterCreateManyContractInput = {
     id?: string;
     tenantId: string;
-    templateId: string;
+    templateId?: string | null;
     letterNumber: string;
     type: $Enums.OfferLetterType;
     status?: $Enums.OfferLetterStatus;
@@ -1603,14 +1603,14 @@ export type OfferLetterUpdateWithoutContractInput = {
     createdAt?: Prisma.DateTimeFieldUpdateOperationsInput | Date | string;
     updatedAt?: Prisma.DateTimeFieldUpdateOperationsInput | Date | string;
     tenant?: Prisma.TenantUpdateOneRequiredWithoutOfferLettersNestedInput;
-    template?: Prisma.DocumentTemplateUpdateOneRequiredWithoutOfferLettersNestedInput;
+    template?: Prisma.DocumentTemplateUpdateOneWithoutOfferLettersNestedInput;
     generatedBy?: Prisma.UserUpdateOneWithoutOfferLettersGeneratedNestedInput;
     sentBy?: Prisma.UserUpdateOneWithoutOfferLettersSentNestedInput;
 };
 export type OfferLetterUncheckedUpdateWithoutContractInput = {
     id?: Prisma.StringFieldUpdateOperationsInput | string;
     tenantId?: Prisma.StringFieldUpdateOperationsInput | string;
-    templateId?: Prisma.StringFieldUpdateOperationsInput | string;
+    templateId?: Prisma.NullableStringFieldUpdateOperationsInput | string | null;
     letterNumber?: Prisma.StringFieldUpdateOperationsInput | string;
     type?: Prisma.EnumOfferLetterTypeFieldUpdateOperationsInput | $Enums.OfferLetterType;
     status?: Prisma.EnumOfferLetterStatusFieldUpdateOperationsInput | $Enums.OfferLetterStatus;
@@ -1635,7 +1635,7 @@ export type OfferLetterUncheckedUpdateWithoutContractInput = {
 export type OfferLetterUncheckedUpdateManyWithoutContractInput = {
     id?: Prisma.StringFieldUpdateOperationsInput | string;
     tenantId?: Prisma.StringFieldUpdateOperationsInput | string;
-    templateId?: Prisma.StringFieldUpdateOperationsInput | string;
+    templateId?: Prisma.NullableStringFieldUpdateOperationsInput | string | null;
     letterNumber?: Prisma.StringFieldUpdateOperationsInput | string;
     type?: Prisma.EnumOfferLetterTypeFieldUpdateOperationsInput | $Enums.OfferLetterType;
     status?: Prisma.EnumOfferLetterStatusFieldUpdateOperationsInput | $Enums.OfferLetterStatus;
@@ -1784,7 +1784,7 @@ export type OfferLetterSelect<ExtArgs extends runtime.Types.Extensions.InternalA
     updatedAt?: boolean;
     tenant?: boolean | Prisma.TenantDefaultArgs<ExtArgs>;
     contract?: boolean | Prisma.ContractDefaultArgs<ExtArgs>;
-    template?: boolean | Prisma.DocumentTemplateDefaultArgs<ExtArgs>;
+    template?: boolean | Prisma.OfferLetter$templateArgs<ExtArgs>;
     generatedBy?: boolean | Prisma.OfferLetter$generatedByArgs<ExtArgs>;
     sentBy?: boolean | Prisma.OfferLetter$sentByArgs<ExtArgs>;
 }, ExtArgs["result"]["offerLetter"]>;
@@ -1818,7 +1818,7 @@ export type OfferLetterOmit<ExtArgs extends runtime.Types.Extensions.InternalArg
 export type OfferLetterInclude<ExtArgs extends runtime.Types.Extensions.InternalArgs = runtime.Types.Extensions.DefaultArgs> = {
     tenant?: boolean | Prisma.TenantDefaultArgs<ExtArgs>;
     contract?: boolean | Prisma.ContractDefaultArgs<ExtArgs>;
-    template?: boolean | Prisma.DocumentTemplateDefaultArgs<ExtArgs>;
+    template?: boolean | Prisma.OfferLetter$templateArgs<ExtArgs>;
     generatedBy?: boolean | Prisma.OfferLetter$generatedByArgs<ExtArgs>;
     sentBy?: boolean | Prisma.OfferLetter$sentByArgs<ExtArgs>;
 };
@@ -1827,7 +1827,7 @@ export type $OfferLetterPayload<ExtArgs extends runtime.Types.Extensions.Interna
     objects: {
         tenant: Prisma.$TenantPayload<ExtArgs>;
         contract: Prisma.$ContractPayload<ExtArgs>;
-        template: Prisma.$DocumentTemplatePayload<ExtArgs>;
+        template: Prisma.$DocumentTemplatePayload<ExtArgs> | null;
         generatedBy: Prisma.$UserPayload<ExtArgs> | null;
         sentBy: Prisma.$UserPayload<ExtArgs> | null;
     };
@@ -1835,7 +1835,7 @@ export type $OfferLetterPayload<ExtArgs extends runtime.Types.Extensions.Interna
         id: string;
         tenantId: string;
         contractId: string;
-        templateId: string;
+        templateId: string | null;
         letterNumber: string;
         type: $Enums.OfferLetterType;
         status: $Enums.OfferLetterStatus;
@@ -2135,7 +2135,7 @@ export interface Prisma__OfferLetterClient<T, Null = never, ExtArgs extends runt
     readonly [Symbol.toStringTag]: "PrismaPromise";
     tenant<T extends Prisma.TenantDefaultArgs<ExtArgs> = {}>(args?: Prisma.Subset<T, Prisma.TenantDefaultArgs<ExtArgs>>): Prisma.Prisma__TenantClient<runtime.Types.Result.GetResult<Prisma.$TenantPayload<ExtArgs>, T, "findUniqueOrThrow", GlobalOmitOptions> | Null, Null, ExtArgs, GlobalOmitOptions>;
     contract<T extends Prisma.ContractDefaultArgs<ExtArgs> = {}>(args?: Prisma.Subset<T, Prisma.ContractDefaultArgs<ExtArgs>>): Prisma.Prisma__ContractClient<runtime.Types.Result.GetResult<Prisma.$ContractPayload<ExtArgs>, T, "findUniqueOrThrow", GlobalOmitOptions> | Null, Null, ExtArgs, GlobalOmitOptions>;
-    template<T extends Prisma.DocumentTemplateDefaultArgs<ExtArgs> = {}>(args?: Prisma.Subset<T, Prisma.DocumentTemplateDefaultArgs<ExtArgs>>): Prisma.Prisma__DocumentTemplateClient<runtime.Types.Result.GetResult<Prisma.$DocumentTemplatePayload<ExtArgs>, T, "findUniqueOrThrow", GlobalOmitOptions> | Null, Null, ExtArgs, GlobalOmitOptions>;
+    template<T extends Prisma.OfferLetter$templateArgs<ExtArgs> = {}>(args?: Prisma.Subset<T, Prisma.OfferLetter$templateArgs<ExtArgs>>): Prisma.Prisma__DocumentTemplateClient<runtime.Types.Result.GetResult<Prisma.$DocumentTemplatePayload<ExtArgs>, T, "findUniqueOrThrow", GlobalOmitOptions> | null, null, ExtArgs, GlobalOmitOptions>;
     generatedBy<T extends Prisma.OfferLetter$generatedByArgs<ExtArgs> = {}>(args?: Prisma.Subset<T, Prisma.OfferLetter$generatedByArgs<ExtArgs>>): Prisma.Prisma__UserClient<runtime.Types.Result.GetResult<Prisma.$UserPayload<ExtArgs>, T, "findUniqueOrThrow", GlobalOmitOptions> | null, null, ExtArgs, GlobalOmitOptions>;
     sentBy<T extends Prisma.OfferLetter$sentByArgs<ExtArgs> = {}>(args?: Prisma.Subset<T, Prisma.OfferLetter$sentByArgs<ExtArgs>>): Prisma.Prisma__UserClient<runtime.Types.Result.GetResult<Prisma.$UserPayload<ExtArgs>, T, "findUniqueOrThrow", GlobalOmitOptions> | null, null, ExtArgs, GlobalOmitOptions>;
     /**
@@ -2514,6 +2514,24 @@ export type OfferLetterDeleteManyArgs<ExtArgs extends runtime.Types.Extensions.I
      */
     limit?: number;
 };
+/**
+ * OfferLetter.template
+ */
+export type OfferLetter$templateArgs<ExtArgs extends runtime.Types.Extensions.InternalArgs = runtime.Types.Extensions.DefaultArgs> = {
+    /**
+     * Select specific fields to fetch from the DocumentTemplate
+     */
+    select?: Prisma.DocumentTemplateSelect<ExtArgs> | null;
+    /**
+     * Omit specific fields from the DocumentTemplate
+     */
+    omit?: Prisma.DocumentTemplateOmit<ExtArgs> | null;
+    /**
+     * Choose, which related nodes to fetch as well
+     */
+    include?: Prisma.DocumentTemplateInclude<ExtArgs> | null;
+    where?: Prisma.DocumentTemplateWhereInput;
+};
 /**
  * OfferLetter.generatedBy
  */

package/dist/src/prisma/tenant.js CHANGED Viewed

@@ -1,11 +1,30 @@
 /**
- * Models that require tenant scoping
+ * Models that require tenant scoping.
+ *
+ * IMPORTANT: When adding a new model with tenantId to the schema,
+ * add it to this list so queries are automatically filtered by tenant.
+ *
+ * Models with nullable tenantId (for global templates) should also be
+ * added to OPTIONAL_TENANT_MODELS below.
  */
 const TENANT_SCOPED_MODELS = [
+    // Property domain
     "property",
-    "paymentPlan",
     "propertyPaymentMethod",
+    // Payment plan domain
+    "paymentPlan",
+    // Contract domain
     "contract",
+    "contractTermination",
+    // Document domain
+    "documentTemplate",
+    "offerLetter",
+    "documentRequirementRule",
+    // Prequalification & underwriting domain
+    "prequalification",
+    "underwritingDecision",
+    // Payment method changes
+    "paymentMethodChangeRequest",
 ];
 /**
  * Models that can optionally have tenant scoping (nullable tenantId)

package/package.json CHANGED Viewed

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

package/prisma/migrations/20260104174626_make_offer_letter_template_optional/migration.sql ADDED Viewed

@@ -0,0 +1,11 @@
+-- DropForeignKey
+ALTER TABLE `offer_letters` DROP FOREIGN KEY `offer_letters_templateId_fkey`;
+-- DropIndex
+DROP INDEX `offer_letters_templateId_fkey` ON `offer_letters`;
+-- AlterTable
+ALTER TABLE `offer_letters` MODIFY `templateId` VARCHAR(191) NULL;
+-- AddForeignKey
+ALTER TABLE `offer_letters` ADD CONSTRAINT `offer_letters_templateId_fkey` FOREIGN KEY (`templateId`) REFERENCES `document_templates`(`id`) ON DELETE SET NULL ON UPDATE CASCADE;

package/prisma/schema.prisma CHANGED Viewed

@@ -1261,9 +1261,9 @@ model OfferLetter {
   contractId String
   contract   Contract @relation(fields: [contractId], references: [id], onDelete: Cascade)
-  // Template used
-  templateId String
-  template   DocumentTemplate @relation(fields: [templateId], references: [id])
+  // Template used (optional - documents-service may handle default selection)
+  templateId String?
+  template   DocumentTemplate? @relation(fields: [templateId], references: [id])
   // Letter details
   letterNumber String            @unique // OL-XXXXXX