@valentine-efagene/qshelter-common 2.0.98 → 2.0.100

package/prisma/schema.prisma

@@ -345,7 +345,7 @@ model User {
   socials                Social[]
 
   // Relations to other domains
-  properties       Property[]
+  properties          Property[]
   applications        Application[]        @relation("ApplicationBuyer")
   soldApplications    Application[]        @relation("ApplicationSeller")
   applicationPayments ApplicationPayment[] @relation("ApplicationPayer")
@@ -353,7 +353,7 @@ model User {
   // Documentation step assignments and approvals
   assignedSteps DocumentationStep[]         @relation("DocumentationStepAssignee")
   stepApprovals DocumentationStepApproval[] @relation("DocumentationStepApprover")
-  uploadedDocs  ApplicationDocument[]          @relation("DocumentUploader")
+  uploadedDocs  ApplicationDocument[]       @relation("DocumentUploader")
 
   // Payment method changes
   paymentMethodChangeRequests PaymentMethodChangeRequest[] @relation("ChangeRequestor")
@@ -496,7 +496,7 @@ model Tenant {
   properties     Property[]
   paymentPlans   PaymentPlan[]
   paymentMethods PropertyPaymentMethod[]
-  applications      Application[]
+  applications   Application[]
 
   // RBAC: Tenant-scoped roles and permissions
   roles       Role[]
@@ -531,7 +531,35 @@ model Tenant {
   approvalRequests ApprovalRequest[]
 
   // Contract refunds
-  contractRefunds ApplicationRefund[]
+  contractRefunds             ApplicationRefund[]
+  propertyPaymentMethodLinks  PropertyPaymentMethodLink[]
+  propertyPaymentMethodPhases PropertyPaymentMethodPhase[]
+  phaseEventAttachments       PhaseEventAttachment[]
+  paymentMethodPhaseSteps     PaymentMethodPhaseStep[]
+  stepEventAttachments        StepEventAttachment[]
+  paymentMethodPhaseDocuments PaymentMethodPhaseDocument[]
+  paymentMethodPhaseFields    PaymentMethodPhaseField[]
+  applicationPhases           ApplicationPhase[]
+  questionnairePhases         QuestionnairePhase[]
+  documentationPhases         DocumentationPhase[]
+  paymentPhases               PaymentPhase[]
+  questionnaireFields         QuestionnaireField[]
+  applicationEvents           ApplicationEvent[]
+  documentationSteps          DocumentationStep[]
+  documentationStepDocuments  DocumentationStepDocument[]
+  documentationStepApprovals  DocumentationStepApproval[]
+  paymentInstallments         PaymentInstallment[]
+  applicationPayments         ApplicationPayment[]
+  applicationDocuments        ApplicationDocument[]
+  propertyMedia               PropertyMedia[]
+  propertyDocuments           PropertyDocument[]
+  propertyVariants            PropertyVariant[]
+  propertyVariantAmenities    PropertyVariantAmenity[]
+  propertyVariantMedia        PropertyVariantMedia[]
+  propertyUnits               PropertyUnit[]
+  propertyAmenities           PropertyAmenity[]
+  eventHandlerExecutions      EventHandlerExecution[]
+  amenities                   Amenity[]
 
   @@index([subdomain])
   @@map("tenants")
@@ -779,6 +807,8 @@ model Property {
 
 model PropertyMedia {
   id         String   @id @default(cuid())
+  tenantId   String
+  tenant     Tenant   @relation(fields: [tenantId], references: [id], onDelete: Cascade)
   propertyId String
   property   Property @relation("PropertyMedia", fields: [propertyId], references: [id], onDelete: Cascade)
   url        String
@@ -790,12 +820,15 @@ model PropertyMedia {
 
   displayForProperties Property[] @relation("DisplayImage")
 
+  @@index([tenantId])
   @@index([propertyId])
   @@map("property_media")
 }
 
 model PropertyDocument {
   id         String   @id @default(cuid())
+  tenantId   String
+  tenant     Tenant   @relation(fields: [tenantId], references: [id], onDelete: Cascade)
   propertyId String
   property   Property @relation(fields: [propertyId], references: [id], onDelete: Cascade)
   name       String
@@ -804,13 +837,16 @@ model PropertyDocument {
   createdAt  DateTime @default(now())
   updatedAt  DateTime @updatedAt
 
+  @@index([tenantId])
   @@index([propertyId])
   @@map("property_documents")
 }
 
 model Amenity {
   id         String                   @id @default(cuid())
-  name       String                   @unique
+  tenantId   String
+  tenant     Tenant                   @relation(fields: [tenantId], references: [id], onDelete: Cascade)
+  name       String
   category   String? // PROPERTY, VARIANT, BOTH - helps filter which amenities to show
   icon       String? // Icon name/URL for UI
   createdAt  DateTime                 @default(now())
@@ -818,6 +854,8 @@ model Amenity {
   properties PropertyAmenity[]
   variants   PropertyVariantAmenity[]
 
+  @@unique([tenantId, name]) // Unique per tenant
+  @@index([tenantId])
   @@index([category])
   @@map("amenities")
 }
@@ -830,6 +868,8 @@ model Amenity {
 // e.g., "3-Bedroom Corner Piece - Fully Finished", "2-Bedroom Standard - Carcass"
 model PropertyVariant {
   id         String   @id @default(cuid())
+  tenantId   String
+  tenant     Tenant   @relation(fields: [tenantId], references: [id], onDelete: Cascade)
   propertyId String
   property   Property @relation(fields: [propertyId], references: [id], onDelete: Cascade)
 
@@ -863,6 +903,7 @@ model PropertyVariant {
   units     PropertyUnit[]
   media     PropertyVariantMedia[]
 
+  @@index([tenantId])
   @@index([propertyId])
   @@index([status])
   @@index([price])
@@ -872,6 +913,8 @@ model PropertyVariant {
 // PropertyVariantAmenity = amenities specific to a variant
 // e.g., "Finished Kitchen", "Smart Home System", "Private Garden"
 model PropertyVariantAmenity {
+  tenantId  String
+  tenant    Tenant          @relation(fields: [tenantId], references: [id], onDelete: Cascade)
   variantId String
   amenityId String
   variant   PropertyVariant @relation(fields: [variantId], references: [id], onDelete: Cascade)
@@ -879,12 +922,15 @@ model PropertyVariantAmenity {
   createdAt DateTime        @default(now())
 
   @@id([variantId, amenityId])
+  @@index([tenantId])
   @@map("property_variant_amenities")
 }
 
 // PropertyVariantMedia = images/videos specific to a variant
 model PropertyVariantMedia {
   id        String          @id @default(cuid())
+  tenantId  String
+  tenant    Tenant          @relation(fields: [tenantId], references: [id], onDelete: Cascade)
   variantId String
   variant   PropertyVariant @relation(fields: [variantId], references: [id], onDelete: Cascade)
   url       String
@@ -894,6 +940,7 @@ model PropertyVariantMedia {
   createdAt DateTime        @default(now())
   updatedAt DateTime        @updatedAt
 
+  @@index([tenantId])
   @@index([variantId])
   @@map("property_variant_media")
 }
@@ -902,6 +949,8 @@ model PropertyVariantMedia {
 // e.g., "Unit A1", "Block B - Flat 3", "Plot 15"
 model PropertyUnit {
   id        String          @id @default(cuid())
+  tenantId  String
+  tenant    Tenant          @relation(fields: [tenantId], references: [id], onDelete: Cascade)
   variantId String
   variant   PropertyVariant @relation(fields: [variantId], references: [id], onDelete: Cascade)
 
@@ -935,12 +984,15 @@ model PropertyUnit {
   transferRequests PropertyTransferRequest[]
 
   @@unique([variantId, unitNumber])
+  @@index([tenantId])
   @@index([variantId])
   @@index([status])
   @@map("property_units")
 }
 
 model PropertyAmenity {
+  tenantId   String
+  tenant     Tenant   @relation(fields: [tenantId], references: [id], onDelete: Cascade)
   propertyId String
   amenityId  String
   property   Property @relation(fields: [propertyId], references: [id], onDelete: Cascade)
@@ -948,6 +1000,7 @@ model PropertyAmenity {
   createdAt  DateTime @default(now())
 
   @@id([propertyId, amenityId])
+  @@index([tenantId])
   @@map("property_amenities")
 }
 
@@ -1023,11 +1076,11 @@ model PropertyPaymentMethod {
   updatedAt DateTime @updatedAt
 
   // Many-to-many with properties
-  properties PropertyPaymentMethodLink[]
+  properties   PropertyPaymentMethodLink[]
   // Phases that make up this method (templates)
-  phases     PropertyPaymentMethodPhase[]
+  phases       PropertyPaymentMethodPhase[]
   // Contracts using this method
-  applications  Application[]
+  applications Application[]
 
   // Payment method change tracking
   changeRequestsFrom PaymentMethodChangeRequest[] @relation("ChangeFromMethod")
@@ -1045,6 +1098,8 @@ model PropertyPaymentMethod {
 
 // Many-to-many link between Property and PaymentMethod
 model PropertyPaymentMethodLink {
+  tenantId        String
+  tenant          Tenant                @relation(fields: [tenantId], references: [id], onDelete: Cascade)
   propertyId      String
   property        Property              @relation(fields: [propertyId], references: [id], onDelete: Cascade)
   paymentMethodId String
@@ -1056,6 +1111,7 @@ model PropertyPaymentMethodLink {
   createdAt DateTime @default(now())
 
   @@id([propertyId, paymentMethodId])
+  @@index([tenantId])
   @@map("property_payment_method_links")
 }
 
@@ -1063,6 +1119,8 @@ model PropertyPaymentMethodLink {
 // phaseCategory determines the FSM type: DOCUMENTATION or PAYMENT
 model PropertyPaymentMethodPhase {
   id              String                @id @default(cuid())
+  tenantId        String
+  tenant          Tenant                @relation(fields: [tenantId], references: [id], onDelete: Cascade)
   paymentMethodId String
   paymentMethod   PropertyPaymentMethod @relation(fields: [paymentMethodId], references: [id], onDelete: Cascade)
   paymentPlanId   String? // Only for PAYMENT phases
@@ -1105,6 +1163,7 @@ model PropertyPaymentMethodPhase {
   // Event attachments - handlers that fire on phase transitions
   eventAttachments    PhaseEventAttachment[]
 
+  @@index([tenantId])
   @@index([paymentMethodId])
   @@index([paymentPlanId])
   @@index([phaseCategory])
@@ -1114,9 +1173,11 @@ model PropertyPaymentMethodPhase {
 /// Phase Event Attachment - Links event handlers to phase template triggers
 /// When a phase transitions (complete, payment received, etc.), attached handlers fire
 model PhaseEventAttachment {
-  id      String                     @id @default(cuid())
-  phaseId String
-  phase   PropertyPaymentMethodPhase @relation(fields: [phaseId], references: [id], onDelete: Cascade)
+  id       String                     @id @default(cuid())
+  tenantId String
+  tenant   Tenant                     @relation(fields: [tenantId], references: [id], onDelete: Cascade)
+  phaseId  String
+  phase    PropertyPaymentMethodPhase @relation(fields: [phaseId], references: [id], onDelete: Cascade)
 
   /// When this handler should fire
   trigger PhaseTrigger
@@ -1135,6 +1196,7 @@ model PhaseEventAttachment {
   updatedAt DateTime @updatedAt
 
   @@unique([phaseId, handlerId, trigger])
+  @@index([tenantId])
   @@index([phaseId])
   @@index([handlerId])
   @@map("phase_event_attachments")
@@ -1142,9 +1204,11 @@ model PhaseEventAttachment {
 
 // Step template within a DOCUMENTATION phase
 model PaymentMethodPhaseStep {
-  id      String                     @id @default(cuid())
-  phaseId String
-  phase   PropertyPaymentMethodPhase @relation(fields: [phaseId], references: [id], onDelete: Cascade)
+  id       String                     @id @default(cuid())
+  tenantId String
+  tenant   Tenant                     @relation(fields: [tenantId], references: [id], onDelete: Cascade)
+  phaseId  String
+  phase    PropertyPaymentMethodPhase @relation(fields: [phaseId], references: [id], onDelete: Cascade)
 
   name     String
   stepType StepType
@@ -1157,6 +1221,7 @@ model PaymentMethodPhaseStep {
   // Event attachments - handlers that fire on step transitions
   eventAttachments StepEventAttachment[]
 
+  @@index([tenantId])
   @@index([phaseId])
   @@map("payment_method_phase_steps")
 }
@@ -1164,9 +1229,11 @@ model PaymentMethodPhaseStep {
 /// Step Event Attachment - Links event handlers to step template triggers
 /// When a step transitions (complete, reject, etc.), attached handlers fire
 model StepEventAttachment {
-  id     String                 @id @default(cuid())
-  stepId String
-  step   PaymentMethodPhaseStep @relation(fields: [stepId], references: [id], onDelete: Cascade)
+  id       String                 @id @default(cuid())
+  tenantId String
+  tenant   Tenant                 @relation(fields: [tenantId], references: [id], onDelete: Cascade)
+  stepId   String
+  step     PaymentMethodPhaseStep @relation(fields: [stepId], references: [id], onDelete: Cascade)
 
   /// When this handler should fire
   trigger StepTrigger
@@ -1185,6 +1252,7 @@ model StepEventAttachment {
   updatedAt DateTime @updatedAt
 
   @@unique([stepId, handlerId, trigger])
+  @@index([tenantId])
   @@index([stepId])
   @@index([handlerId])
   @@map("step_event_attachments")
@@ -1192,9 +1260,11 @@ model StepEventAttachment {
 
 // Required document within a DOCUMENTATION phase
 model PaymentMethodPhaseDocument {
-  id      String                     @id @default(cuid())
-  phaseId String
-  phase   PropertyPaymentMethodPhase @relation(fields: [phaseId], references: [id], onDelete: Cascade)
+  id       String                     @id @default(cuid())
+  tenantId String
+  tenant   Tenant                     @relation(fields: [tenantId], references: [id], onDelete: Cascade)
+  phaseId  String
+  phase    PropertyPaymentMethodPhase @relation(fields: [phaseId], references: [id], onDelete: Cascade)
 
   documentType     String
   isRequired       Boolean @default(true)
@@ -1205,6 +1275,7 @@ model PaymentMethodPhaseDocument {
   metadata  Json?
   createdAt DateTime @default(now())
 
+  @@index([tenantId])
   @@index([phaseId, documentType])
   @@map("payment_method_phase_documents")
 }
@@ -1230,9 +1301,11 @@ enum FieldType {
 
 // Questionnaire field template within a QUESTIONNAIRE phase
 model PaymentMethodPhaseField {
-  id      String                     @id @default(cuid())
-  phaseId String
-  phase   PropertyPaymentMethodPhase @relation(fields: [phaseId], references: [id], onDelete: Cascade)
+  id       String                     @id @default(cuid())
+  tenantId String
+  tenant   Tenant                     @relation(fields: [tenantId], references: [id], onDelete: Cascade)
+  phaseId  String
+  phase    PropertyPaymentMethodPhase @relation(fields: [phaseId], references: [id], onDelete: Cascade)
 
   // Field identification
   name        String // Internal field name (e.g., "monthly_income")
@@ -1264,6 +1337,7 @@ model PaymentMethodPhaseField {
   updatedAt DateTime @updatedAt
 
   @@unique([phaseId, name])
+  @@index([tenantId])
   @@index([phaseId])
   @@map("payment_method_phase_fields")
 }
@@ -1292,8 +1366,8 @@ model Application {
 
   // Contract identification
   applicationNumber String  @unique
-  title          String
-  description    String? @db.Text
+  title             String
+  description       String? @db.Text
   applicationType   String // Admin-defined: MORTGAGE, INSTALLMENT, RENT_TO_OWN, CASH, LEASE, etc.
 
   // Contract value (negotiated from unit price)
@@ -1325,7 +1399,7 @@ model Application {
   paymentMethodChangeRequests PaymentMethodChangeRequest[]
 
   // Transfer tracking - when a contract is transferred to a different property
-  transferredFromId String?   @unique // Source contract if this was created via transfer
+  transferredFromId String?      @unique // Source contract if this was created via transfer
   transferredFrom   Application? @relation("ApplicationTransfer", fields: [transferredFromId], references: [id])
   transferredTo     Application? @relation("ApplicationTransfer")
 
@@ -1419,7 +1493,9 @@ model ApplicationRefund {
 // =============================================================================
 
 model ApplicationPhase {
-  id         String   @id @default(cuid())
+  id            String      @id @default(cuid())
+  tenantId      String
+  tenant        Tenant      @relation(fields: [tenantId], references: [id], onDelete: Cascade)
   applicationId String
   application   Application @relation(fields: [applicationId], references: [id], onDelete: Cascade)
 
@@ -1459,6 +1535,7 @@ model ApplicationPhase {
   // Back-relation for applications where this is the current phase
   currentForApplications Application[] @relation("CurrentPhase")
 
+  @@index([tenantId])
   @@index([applicationId])
   @@index([phaseCategory])
   @@index([status])
@@ -1473,9 +1550,11 @@ model ApplicationPhase {
 // =============================================================================
 
 model QuestionnairePhase {
-  id      String        @id @default(cuid())
-  phaseId String        @unique
-  phase   ApplicationPhase @relation(fields: [phaseId], references: [id], onDelete: Cascade)
+  id       String           @id @default(cuid())
+  tenantId String
+  tenant   Tenant           @relation(fields: [tenantId], references: [id], onDelete: Cascade)
+  phaseId  String           @unique
+  phase    ApplicationPhase @relation(fields: [phaseId], references: [id], onDelete: Cascade)
 
   // Progress tracking
   completedFieldsCount Int @default(0)
@@ -1496,6 +1575,7 @@ model QuestionnairePhase {
   // Child records
   fields QuestionnaireField[]
 
+  @@index([tenantId])
   @@index([phaseId])
   @@map("questionnaire_phases")
 }
@@ -1507,9 +1587,11 @@ model QuestionnairePhase {
 // =============================================================================
 
 model DocumentationPhase {
-  id      String        @id @default(cuid())
-  phaseId String        @unique
-  phase   ApplicationPhase @relation(fields: [phaseId], references: [id], onDelete: Cascade)
+  id       String           @id @default(cuid())
+  tenantId String
+  tenant   Tenant           @relation(fields: [tenantId], references: [id], onDelete: Cascade)
+  phaseId  String           @unique
+  phase    ApplicationPhase @relation(fields: [phaseId], references: [id], onDelete: Cascade)
 
   // Current step pointer for UX and orchestration
   currentStepId String?
@@ -1535,6 +1617,7 @@ model DocumentationPhase {
   // Child records
   steps DocumentationStep[]
 
+  @@index([tenantId])
   @@index([phaseId])
   @@index([currentStepId])
   @@map("documentation_phases")
@@ -1547,9 +1630,11 @@ model DocumentationPhase {
 // =============================================================================
 
 model PaymentPhase {
-  id      String        @id @default(cuid())
-  phaseId String        @unique
-  phase   ApplicationPhase @relation(fields: [phaseId], references: [id], onDelete: Cascade)
+  id       String           @id @default(cuid())
+  tenantId String
+  tenant   Tenant           @relation(fields: [tenantId], references: [id], onDelete: Cascade)
+  phaseId  String           @unique
+  phase    ApplicationPhase @relation(fields: [phaseId], references: [id], onDelete: Cascade)
 
   // Payment plan reference
   paymentPlanId String?
@@ -1582,6 +1667,7 @@ model PaymentPhase {
   // Child records
   installments PaymentInstallment[]
 
+  @@index([tenantId])
   @@index([phaseId])
   @@index([paymentPlanId])
   @@map("payment_phases")
@@ -1596,6 +1682,8 @@ model PaymentPhase {
 
 model QuestionnaireField {
   id                   String             @id @default(cuid())
+  tenantId             String
+  tenant               Tenant             @relation(fields: [tenantId], references: [id], onDelete: Cascade)
   questionnairePhaseId String
   questionnairePhase   QuestionnairePhase @relation(fields: [questionnairePhaseId], references: [id], onDelete: Cascade)
 
@@ -1634,6 +1722,7 @@ model QuestionnaireField {
   updatedAt   DateTime  @updatedAt
 
   @@unique([questionnairePhaseId, name])
+  @@index([tenantId])
   @@index([questionnairePhaseId])
   @@map("questionnaire_fields")
 }
@@ -1646,7 +1735,9 @@ model QuestionnaireField {
 // ApplicationEvent is purely for historical tracking and state machine transitions.
 // =============================================================================
 model ApplicationEvent {
-  id         String   @id @default(cuid())
+  id            String      @id @default(cuid())
+  tenantId      String
+  tenant        Tenant      @relation(fields: [tenantId], references: [id], onDelete: Cascade)
   applicationId String
   application   Application @relation(fields: [applicationId], references: [id], onDelete: Cascade)
 
@@ -1669,6 +1760,7 @@ model ApplicationEvent {
   // Timing
   occurredAt DateTime @default(now())
 
+  @@index([tenantId])
   @@index([applicationId])
   @@index([eventType])
   @@index([eventGroup])
@@ -1679,6 +1771,8 @@ model ApplicationEvent {
 // Steps within a DOCUMENTATION phase (FSM for document collection/approval)
 model DocumentationStep {
   id                   String             @id @default(cuid())
+  tenantId             String
+  tenant               Tenant             @relation(fields: [tenantId], references: [id], onDelete: Cascade)
   documentationPhaseId String
   documentationPhase   DocumentationPhase @relation(fields: [documentationPhaseId], references: [id], onDelete: Cascade)
 
@@ -1722,6 +1816,7 @@ model DocumentationStep {
   approvals       DocumentationStepApproval[]
   currentForPhase DocumentationPhase[]        @relation("CurrentStep")
 
+  @@index([tenantId])
   @@index([documentationPhaseId])
   @@index([status])
   @@index([order])
@@ -1730,15 +1825,18 @@ model DocumentationStep {
 
 // Required documents for a step (normalized from CSV)
 model DocumentationStepDocument {
-  id     String            @id @default(cuid())
-  stepId String
-  step   DocumentationStep @relation(fields: [stepId], references: [id], onDelete: Cascade)
+  id       String            @id @default(cuid())
+  tenantId String
+  tenant   Tenant            @relation(fields: [tenantId], references: [id], onDelete: Cascade)
+  stepId   String
+  step     DocumentationStep @relation(fields: [stepId], references: [id], onDelete: Cascade)
 
   documentType String
   isRequired   Boolean @default(true)
 
   createdAt DateTime @default(now())
 
+  @@index([tenantId])
   @@index([stepId, documentType])
   @@map("documentation_step_documents")
 }
@@ -1746,6 +1844,8 @@ model DocumentationStepDocument {
 // Approvals for documentation steps
 model DocumentationStepApproval {
   id         String            @id @default(cuid())
+  tenantId   String
+  tenant     Tenant            @relation(fields: [tenantId], references: [id], onDelete: Cascade)
   stepId     String
   step       DocumentationStep @relation(fields: [stepId], references: [id], onDelete: Cascade)
   approverId String?
@@ -1757,6 +1857,7 @@ model DocumentationStepApproval {
 
   createdAt DateTime @default(now())
 
+  @@index([tenantId])
   @@index([stepId])
   @@map("documentation_step_approvals")
 }
@@ -1764,6 +1865,8 @@ model DocumentationStepApproval {
 // Installments within a PAYMENT phase
 model PaymentInstallment {
   id             String       @id @default(cuid())
+  tenantId       String
+  tenant         Tenant       @relation(fields: [tenantId], references: [id], onDelete: Cascade)
   paymentPhaseId String
   paymentPhase   PaymentPhase @relation(fields: [paymentPhaseId], references: [id], onDelete: Cascade)
 
@@ -1789,6 +1892,7 @@ model PaymentInstallment {
 
   payments ApplicationPayment[]
 
+  @@index([tenantId])
   @@index([paymentPhaseId])
   @@index([dueDate])
   @@index([status])
@@ -1797,15 +1901,17 @@ model PaymentInstallment {
 
 // Unified payment record for contracts
 model ApplicationPayment {
-  id            String               @id @default(cuid())
-  applicationId    String
-  application Application             @relation(fields: [applicationId], references: [id], onDelete: Cascade)
+  id            String              @id @default(cuid())
+  tenantId      String
+  tenant        Tenant              @relation(fields: [tenantId], references: [id], onDelete: Cascade)
+  applicationId String
+  application   Application         @relation(fields: [applicationId], references: [id], onDelete: Cascade)
   phaseId       String?
-  phase         ApplicationPhase?       @relation(fields: [phaseId], references: [id])
+  phase         ApplicationPhase?   @relation(fields: [phaseId], references: [id])
   installmentId String?
   installment   PaymentInstallment? @relation(fields: [installmentId], references: [id])
   payerId       String?
-  payer         User?                @relation("ApplicationPayer", fields: [payerId], references: [id])
+  payer         User?               @relation("ApplicationPayer", fields: [payerId], references: [id])
 
   amount          Float
   principalAmount Float @default(0)
@@ -1822,6 +1928,7 @@ model ApplicationPayment {
   createdAt   DateTime  @default(now())
   updatedAt   DateTime  @updatedAt
 
+  @@index([tenantId])
   @@index([applicationId])
   @@index([phaseId])
   @@index([installmentId])
@@ -1833,11 +1940,13 @@ model ApplicationPayment {
 
 // Contract documents (owned by contract, linked to phases/steps as needed)
 model ApplicationDocument {
-  id         String   @id @default(cuid())
+  id            String      @id @default(cuid())
+  tenantId      String
+  tenant        Tenant      @relation(fields: [tenantId], references: [id], onDelete: Cascade)
   applicationId String
   application   Application @relation(fields: [applicationId], references: [id], onDelete: Cascade)
-  phaseId    String? // Optional link to specific phase
-  stepId     String? // Optional link to specific step
+  phaseId       String? // Optional link to specific phase
+  stepId        String? // Optional link to specific step
 
   name         String
   url          String
@@ -1850,6 +1959,7 @@ model ApplicationDocument {
   createdAt DateTime @default(now())
   updatedAt DateTime @updatedAt
 
+  @@index([tenantId])
   @@index([applicationId])
   @@index([phaseId])
   @@index([stepId])
@@ -1894,9 +2004,9 @@ model DocumentTemplate {
 }
 
 model OfferLetter {
-  id         String   @id @default(cuid())
-  tenantId   String
-  tenant     Tenant   @relation(fields: [tenantId], references: [id], onDelete: Cascade)
+  id            String      @id @default(cuid())
+  tenantId      String
+  tenant        Tenant      @relation(fields: [tenantId], references: [id], onDelete: Cascade)
   applicationId String
   application   Application @relation(fields: [applicationId], references: [id], onDelete: Cascade)
 
@@ -1959,11 +2069,11 @@ model OfferLetter {
 // =============================================================================
 
 model ApplicationTermination {
-  id         String   @id @default(cuid())
+  id            String      @id @default(cuid())
   applicationId String
   application   Application @relation(fields: [applicationId], references: [id], onDelete: Cascade)
-  tenantId   String
-  tenant     Tenant   @relation(fields: [tenantId], references: [id], onDelete: Cascade)
+  tenantId      String
+  tenant        Tenant      @relation(fields: [tenantId], references: [id], onDelete: Cascade)
 
   // Request identification
   requestNumber String @unique // TRM-XXXXXX
@@ -1991,8 +2101,8 @@ model ApplicationTermination {
   // Financial snapshot at time of request
   applicationSnapshot    Json // Full contract state snapshot
   totalApplicationAmount Float
-  totalPaidToDate     Float
-  outstandingBalance  Float
+  totalPaidToDate        Float
+  outstandingBalance     Float
 
   // Settlement calculation
   refundableAmount Float   @default(0) // Amount eligible for refund
@@ -2057,9 +2167,9 @@ enum PaymentMethodChangeStatus {
 }
 
 model PaymentMethodChangeRequest {
-  id         String   @id @default(cuid())
-  tenantId   String
-  tenant     Tenant   @relation(fields: [tenantId], references: [id], onDelete: Cascade)
+  id            String      @id @default(cuid())
+  tenantId      String
+  tenant        Tenant      @relation(fields: [tenantId], references: [id], onDelete: Cascade)
   applicationId String
   application   Application @relation(fields: [applicationId], references: [id], onDelete: Cascade)
 
@@ -2358,7 +2468,9 @@ model WorkflowEvent {
 
 /// Event Handler Execution - Log of a handler processing an event
 model EventHandlerExecution {
-  id String @id @default(cuid())
+  id       String @id @default(cuid())
+  tenantId String
+  tenant   Tenant @relation(fields: [tenantId], references: [id], onDelete: Cascade)
 
   /// The event being processed
   eventId String
@@ -2391,6 +2503,7 @@ model EventHandlerExecution {
 
   createdAt DateTime @default(now())
 
+  @@index([tenantId])
   @@index([eventId])
   @@index([handlerId])
   @@index([status])
@@ -2599,3 +2712,103 @@ model ApprovalRequest {
   @@index([type, status]) // Efficient queries for approval dashboard
   @@map("approval_requests")
 }
+
+// =============================================================================
+// WORKFLOW BLOCKER TRACKING - Analytics for workflow delays
+// =============================================================================
+// Tracks who is blocking the workflow at any point, enabling analytics like:
+// - Average time customers take to upload documents
+// - Average time admins take to review/approve
+// - Most common bottleneck steps
+// - SLA compliance tracking
+// - Customer service intervention triggers
+// =============================================================================
+
+/// Who is responsible for the current workflow block
+enum BlockerActor {
+  CUSTOMER // Customer action required (upload, sign, pay)
+  ADMIN // Admin action required (review, approve, reject)
+  SYSTEM // System processing (auto-generation, external checks)
+  EXTERNAL // External party (bank, government, third-party verification)
+}
+
+/// Category of action that is blocking workflow
+enum BlockerCategory {
+  UPLOAD // Document upload needed
+  RESUBMISSION // Document resubmission after rejection
+  SIGNATURE // Signature required
+  REVIEW // Admin review needed
+  APPROVAL // Admin approval needed
+  PAYMENT // Payment required
+  PROCESSING // System processing
+  EXTERNAL_CHECK // External verification
+  QUESTIONNAIRE // Form/questionnaire completion
+}
+
+/// Urgency level for prioritization and SLA tracking
+enum BlockerUrgency {
+  LOW // No immediate deadline
+  NORMAL // Standard processing
+  HIGH // Approaching deadline or overdue
+  CRITICAL // Significantly overdue or business-critical
+}
+
+/// Workflow Blocker - Records who is blocking workflow and for how long
+model WorkflowBlocker {
+  id       String @id @default(cuid())
+  tenantId String
+
+  // Reference to the blocked entity
+  applicationId String
+  phaseId       String?
+  stepId        String?
+
+  // Actor and action details
+  blockerActor    BlockerActor
+  blockerCategory BlockerCategory
+  urgency         BlockerUrgency  @default(NORMAL)
+
+  // Human-readable descriptions
+  actionRequired String  @db.VarChar(500) // What action is needed
+  context        String? @db.Text // Additional context
+
+  // SLA tracking
+  expectedByDate DateTime? // When this action should be completed
+  isOverdue      Boolean   @default(false)
+  overdueAt      DateTime? // When it became overdue
+
+  // Duration tracking
+  startedAt  DateTime  @default(now()) // When this block started
+  resolvedAt DateTime? // When it was resolved
+  durationMs Int? // Calculated duration on resolution
+
+  // Resolution details
+  resolvedByActor   String? // Who resolved it (userId or "SYSTEM")
+  resolutionTrigger String? // What action resolved it (e.g., "DOCUMENT_UPLOADED", "STEP_COMPLETED")
+
+  // Reminder tracking (for customer service)
+  reminderCount  Int       @default(0) // Number of reminders sent
+  lastReminderAt DateTime? // Last reminder timestamp
+  nextReminderAt DateTime? // Scheduled next reminder
+
+  // Metadata for additional analytics
+  metadata Json? // Flexible data: { documentType, stepType, phaseType, etc. }
+
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+
+  @@index([tenantId])
+  @@index([applicationId])
+  @@index([phaseId])
+  @@index([stepId])
+  @@index([blockerActor])
+  @@index([blockerCategory])
+  @@index([urgency])
+  @@index([isOverdue])
+  @@index([startedAt])
+  @@index([resolvedAt])
+  @@index([tenantId, blockerActor, resolvedAt]) // For "open blockers by actor" queries
+  @@index([tenantId, blockerCategory, resolvedAt]) // For "open blockers by category" queries
+  @@index([tenantId, isOverdue, blockerActor]) // For SLA violation queries
+  @@map("workflow_blockers")
+}