@valentine-efagene/qshelter-common 2.0.145 → 2.0.147

package/prisma/schema.prisma

@@ -367,6 +367,7 @@ enum ApplicationEventType {
   APPLICATION_TRANSFERRED
   UNDERWRITING_COMPLETED
   OFFER_LETTER_GENERATED
+  HANDLER_EXECUTED // Event handler was executed
 }
 
 enum ApplicationEventGroup {
@@ -375,6 +376,7 @@ enum ApplicationEventGroup {
   DOCUMENT
   NOTIFICATION
   WORKFLOW
+  AUTOMATION // Automated handler executions
 }
 
 enum EventActorType {
@@ -1304,6 +1306,9 @@ model PropertyUnit {
   // Ownership tracking (once sold)
   ownerId String?
 
+  // Optimistic locking for unit reservation race condition
+  version Int @default(0)
+
   createdAt DateTime @default(now())
   updatedAt DateTime @updatedAt
 
@@ -1719,6 +1724,7 @@ model PropertyPaymentMethodPhase {
   // Application phases created from this template
   applicationPhases   ApplicationPhase[]
 
+  @@unique([paymentMethodId, order]) // Enforce unique, sequential ordering
   @@index([tenantId])
   @@index([paymentMethodId])
   @@index([paymentPlanId])
@@ -1779,6 +1785,7 @@ model PaymentMethodPhaseStep {
   // Event attachments - handlers that fire on step transitions
   eventAttachments StepEventAttachment[]
 
+  @@unique([phaseId, order]) // Enforce unique, sequential ordering within phase
   @@index([tenantId])
   @@index([phaseId])
   @@map("payment_method_phase_steps")
@@ -1969,7 +1976,7 @@ model Application {
   tenant          Tenant                 @relation(fields: [tenantId], references: [id], onDelete: Cascade)
   // Link to specific unit being purchased/rented
   propertyUnitId  String
-  propertyUnit    PropertyUnit           @relation(fields: [propertyUnitId], references: [id], onDelete: Cascade)
+  propertyUnit    PropertyUnit           @relation(fields: [propertyUnitId], references: [id], onDelete: Restrict)
   buyerId         String
   buyer           User                   @relation("ApplicationBuyer", fields: [buyerId], references: [id], onDelete: Cascade)
   sellerId        String?
@@ -2451,6 +2458,9 @@ model PaymentPhase {
   // Snapshot for audit
   paymentPlanSnapshot Json?
 
+  // Optimistic locking for concurrent payment protection
+  version Int @default(0)
+
   createdAt DateTime @default(now())
   updatedAt DateTime @updatedAt
 
@@ -2583,6 +2593,9 @@ model PaymentInstallment {
   gracePeriodDays    Int       @default(0)
   gracePeriodEndDate DateTime?
 
+  // Optimistic locking for concurrent payment protection
+  version Int @default(0)
+
   createdAt DateTime @default(now())
   updatedAt DateTime @updatedAt