@valentine-efagene/qshelter-common 2.0.101 → 2.0.103

package/prisma/schema.prisma

@@ -492,11 +492,12 @@ model Tenant {
   updatedAt DateTime @updatedAt
 
   // Back-relations for multitenancy
-  users          User[]
-  properties     Property[]
-  paymentPlans   PaymentPlan[]
-  paymentMethods PropertyPaymentMethod[]
-  applications   Application[]
+  users              User[]
+  properties         Property[]
+  paymentPlans       PaymentPlan[]
+  documentationPlans DocumentationPlan[]
+  paymentMethods     PropertyPaymentMethod[]
+  applications       Application[]
 
   // RBAC: Tenant-scoped roles and permissions
   roles       Role[]
@@ -560,6 +561,12 @@ model Tenant {
   propertyAmenities           PropertyAmenity[]
   eventHandlerExecutions      EventHandlerExecution[]
   amenities                   Amenity[]
+  socials                     Social[]
+  wallets                     Wallet[]
+  transactions                Transaction[]
+  settings                    Settings[]
+  domainEvents                DomainEvent[]
+  workflowBlockers            WorkflowBlocker[]
 
   @@index([subdomain])
   @@map("tenants")
@@ -692,6 +699,8 @@ model DeviceEndpoint {
 
 model Social {
   id        String   @id @default(cuid())
+  tenantId  String
+  tenant    Tenant   @relation(fields: [tenantId], references: [id], onDelete: Cascade)
   userId    String
   user      User     @relation(fields: [userId], references: [id], onDelete: Cascade)
   provider  String // google, facebook, twitter, etc
@@ -701,6 +710,7 @@ model Social {
 
   @@unique([provider, socialId])
   @@index([userId])
+  @@index([tenantId])
   @@map("socials")
 }
 
@@ -717,6 +727,8 @@ model OAuthState {
 
 model Wallet {
   id           String        @id @default(cuid())
+  tenantId     String
+  tenant       Tenant        @relation(fields: [tenantId], references: [id], onDelete: Cascade)
   balance      Float         @default(0)
   currency     String        @default("USD")
   user         User?
@@ -724,11 +736,14 @@ model Wallet {
   createdAt    DateTime      @default(now())
   updatedAt    DateTime      @updatedAt
 
+  @@index([tenantId])
   @@map("wallets")
 }
 
 model Transaction {
   id          String   @id @default(cuid())
+  tenantId    String
+  tenant      Tenant   @relation(fields: [tenantId], references: [id], onDelete: Cascade)
   walletId    String
   wallet      Wallet   @relation(fields: [walletId], references: [id], onDelete: Cascade)
   amount      Float
@@ -740,18 +755,23 @@ model Transaction {
   updatedAt   DateTime @updatedAt
 
   @@index([walletId])
+  @@index([tenantId])
   @@map("transactions")
 }
 
 model Settings {
   id        String   @id @default(cuid())
-  key       String   @unique
+  tenantId  String
+  tenant    Tenant   @relation(fields: [tenantId], references: [id], onDelete: Cascade)
+  key       String
   value     String   @db.Text
   category  String?
   createdAt DateTime @default(now())
   updatedAt DateTime @updatedAt
 
+  @@unique([tenantId, key])
   @@index([category])
+  @@index([tenantId])
   @@map("settings")
 }
 
@@ -1004,6 +1024,59 @@ model PropertyAmenity {
   @@map("property_amenities")
 }
 
+// =============================================================================
+// DOCUMENTATION PLAN DOMAIN - Reusable step workflow templates
+// =============================================================================
+
+// DocumentationPlan = reusable structure for documentation workflows
+// Examples: "Standard KYC", "Quick Verification", "Full Underwriting"
+model DocumentationPlan {
+  id          String  @id @default(cuid())
+  tenantId    String? // NULL = global template available to all tenants
+  tenant      Tenant? @relation(fields: [tenantId], references: [id], onDelete: Cascade)
+  name        String
+  description String? @db.Text
+  isActive    Boolean @default(true)
+
+  // Document requirements for this plan
+  requiredDocumentTypes Json? // Array of document type strings, e.g., ["ID_CARD", "BANK_STATEMENT"]
+
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+
+  // Steps that make up this plan
+  steps               DocumentationPlanStep[]
+  // Used by property payment method phases (templates)
+  methodPhases        PropertyPaymentMethodPhase[]
+  // Used by instantiated documentation phases
+  documentationPhases DocumentationPhase[]
+
+  @@unique([tenantId, name]) // Unique per tenant, or globally if tenantId is null
+  @@index([tenantId])
+  @@map("documentation_plans")
+}
+
+// Step template within a DocumentationPlan
+model DocumentationPlanStep {
+  id     String            @id @default(cuid())
+  planId String
+  plan   DocumentationPlan @relation(fields: [planId], references: [id], onDelete: Cascade)
+
+  name     String
+  stepType StepType
+  order    Int
+
+  // Optional: which document type this step handles (for UPLOAD steps)
+  documentType String?
+  metadata     Json?
+
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+
+  @@index([planId])
+  @@map("documentation_plan_steps")
+}
+
 // =============================================================================
 // PAYMENT PLAN DOMAIN - Reusable installment structure templates
 // =============================================================================
@@ -1123,8 +1196,12 @@ model PropertyPaymentMethodPhase {
   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
-  paymentPlan     PaymentPlan?          @relation(fields: [paymentPlanId], references: [id])
+
+  // Plan references (only one should be set based on phaseCategory)
+  paymentPlanId       String? // Only for PAYMENT phases
+  paymentPlan         PaymentPlan?       @relation(fields: [paymentPlanId], references: [id])
+  documentationPlanId String? // Only for DOCUMENTATION phases
+  documentationPlan   DocumentationPlan? @relation(fields: [documentationPlanId], references: [id])
 
   name        String
   description String? @db.Text
@@ -1149,13 +1226,14 @@ model PropertyPaymentMethodPhase {
   completionCriterion             CompletionCriterion?
 
   // Snapshots for audit (original config at creation time)
+  // These are still needed for inline definitions (backward compatibility)
   stepDefinitionsSnapshot  Json?
   requiredDocumentSnapshot Json?
 
   createdAt DateTime @default(now())
   updatedAt DateTime @updatedAt
 
-  // Normalized child tables (for DOCUMENTATION phases)
+  // Normalized child tables (for DOCUMENTATION phases - inline definitions)
   steps               PaymentMethodPhaseStep[]
   requiredDocuments   PaymentMethodPhaseDocument[]
   // Normalized child tables (for QUESTIONNAIRE phases)
@@ -1166,6 +1244,7 @@ model PropertyPaymentMethodPhase {
   @@index([tenantId])
   @@index([paymentMethodId])
   @@index([paymentPlanId])
+  @@index([documentationPlanId])
   @@index([phaseCategory])
   @@map("property_payment_method_phases")
 }
@@ -1593,6 +1672,10 @@ model DocumentationPhase {
   phaseId  String           @unique
   phase    ApplicationPhase @relation(fields: [phaseId], references: [id], onDelete: Cascade)
 
+  // Documentation plan reference (if created from a plan)
+  documentationPlanId String?
+  documentationPlan   DocumentationPlan? @relation(fields: [documentationPlanId], references: [id])
+
   // Current step pointer for UX and orchestration
   currentStepId String?
   currentStep   DocumentationStep? @relation("CurrentStep", fields: [currentStepId], references: [id])
@@ -2515,7 +2598,9 @@ model EventHandlerExecution {
 // =============================================================================
 
 model DomainEvent {
-  id String @id @default(cuid())
+  id       String @id @default(cuid())
+  tenantId String
+  tenant   Tenant @relation(fields: [tenantId], references: [id], onDelete: Cascade)
 
   // Event identification
   eventType     String // MORTGAGE.CREATED, PHASE.ACTIVATED, PAYMENT.COMPLETED, etc
@@ -2544,6 +2629,7 @@ model DomainEvent {
   createdAt DateTime @default(now())
   updatedAt DateTime @updatedAt
 
+  @@index([tenantId])
   @@index([status, nextRetryAt])
   @@index([eventType])
   @@index([aggregateType, aggregateId])
@@ -2757,6 +2843,7 @@ enum BlockerUrgency {
 model WorkflowBlocker {
   id       String @id @default(cuid())
   tenantId String
+  tenant   Tenant @relation(fields: [tenantId], references: [id], onDelete: Cascade)
 
   // Reference to the blocked entity
   applicationId String