@valentine-efagene/qshelter-common 2.0.113 → 2.0.115

package/package.json

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

package/prisma/migrations/20260115055636_add_unit_locking/migration.sql

@@ -0,0 +1,16 @@
+-- AlterTable
+ALTER TABLE `applications` ADD COLUMN `supersededAt` DATETIME(3) NULL,
+    ADD COLUMN `supersededById` VARCHAR(191) NULL,
+    MODIFY `status` ENUM('DRAFT', 'PENDING', 'ACTIVE', 'COMPLETED', 'CANCELLED', 'TERMINATED', 'TRANSFERRED', 'SUPERSEDED') NOT NULL DEFAULT 'DRAFT';
+
+-- AlterTable
+ALTER TABLE `event_handlers` MODIFY `handlerType` ENUM('SEND_EMAIL', 'SEND_SMS', 'SEND_PUSH', 'CALL_WEBHOOK', 'ADVANCE_WORKFLOW', 'RUN_AUTOMATION', 'LOCK_UNIT') NOT NULL;
+
+-- AlterTable
+ALTER TABLE `property_payment_method_phases` ADD COLUMN `lockUnitOnComplete` BOOLEAN NOT NULL DEFAULT false;
+
+-- CreateIndex
+CREATE INDEX `applications_supersededById_idx` ON `applications`(`supersededById`);
+
+-- AddForeignKey
+ALTER TABLE `applications` ADD CONSTRAINT `applications_supersededById_fkey` FOREIGN KEY (`supersededById`) REFERENCES `applications`(`id`) ON DELETE SET NULL ON UPDATE CASCADE;

package/prisma/migrations/20260115060132_add_phase_template_reference/migration.sql

@@ -0,0 +1,8 @@
+-- AlterTable
+ALTER TABLE `application_phases` ADD COLUMN `phaseTemplateId` VARCHAR(191) NULL;
+
+-- CreateIndex
+CREATE INDEX `application_phases_phaseTemplateId_idx` ON `application_phases`(`phaseTemplateId`);
+
+-- AddForeignKey
+ALTER TABLE `application_phases` ADD CONSTRAINT `application_phases_phaseTemplateId_fkey` FOREIGN KEY (`phaseTemplateId`) REFERENCES `property_payment_method_phases`(`id`) ON DELETE SET NULL ON UPDATE CASCADE;

package/prisma/schema.prisma

@@ -59,6 +59,7 @@ enum ApplicationStatus {
   CANCELLED
   TERMINATED
   TRANSFERRED // Application was transferred to a different property
+  SUPERSEDED // Another buyer locked the unit - this application was outbid
 }
 
 enum TransferRequestStatus {
@@ -272,6 +273,7 @@ enum EventHandlerType {
   CALL_WEBHOOK // Call an external API/webhook
   ADVANCE_WORKFLOW // Advance or complete a workflow step
   RUN_AUTOMATION // Execute internal business logic
+  LOCK_UNIT // Lock the property unit for the applicant, supersede competing applications
 }
 
 /// Actor Type - Who triggered an event
@@ -1331,6 +1333,11 @@ model PropertyPaymentMethodPhase {
   minimumCompletionPercentage     Float?
   completionCriterion             CompletionCriterion?
 
+  // Unit locking configuration
+  // If true, completing this phase locks the unit for the applicant
+  // Only one phase per payment method should have this enabled
+  lockUnitOnComplete Boolean @default(false)
+
   // Snapshots for audit (original config at creation time)
   // These are still needed for inline definitions (backward compatibility)
   stepDefinitionsSnapshot  Json?
@@ -1346,6 +1353,8 @@ model PropertyPaymentMethodPhase {
   questionnaireFields PaymentMethodPhaseField[]
   // Event attachments - handlers that fire on phase transitions
   eventAttachments    PhaseEventAttachment[]
+  // Application phases created from this template
+  applicationPhases   ApplicationPhase[]
 
   @@index([tenantId])
   @@index([paymentMethodId])
@@ -1627,6 +1636,13 @@ model Application {
   transferredFrom   Application? @relation("ApplicationTransfer", fields: [transferredFromId], references: [id])
   transferredTo     Application? @relation("ApplicationTransfer")
 
+  // Supersede tracking - when another buyer locks the unit
+  // If status is SUPERSEDED, this references the application that took the unit
+  supersededById         String?
+  supersededBy           Application?  @relation("ApplicationSuperseded", fields: [supersededById], references: [id])
+  supersededAt           DateTime?
+  supersededApplications Application[] @relation("ApplicationSuperseded")
+
   // Transfer requests where this contract is the source
   outgoingTransferRequests PropertyTransferRequest[] @relation("SourceApplication")
   // Transfer requests where this contract is the target (created after approval)
@@ -1645,6 +1661,7 @@ model Application {
   @@index([paymentMethodId])
   @@index([status])
   @@index([currentPhaseId])
+  @@index([supersededById])
   @@map("applications")
 }
 
@@ -1723,6 +1740,10 @@ model ApplicationPhase {
   applicationId String
   application   Application @relation(fields: [applicationId], references: [id], onDelete: Cascade)
 
+  // Reference to the phase template this was instantiated from
+  phaseTemplateId String?
+  phaseTemplate   PropertyPaymentMethodPhase? @relation(fields: [phaseTemplateId], references: [id], onDelete: SetNull)
+
   // Admin-defined naming
   name        String
   description String? @db.Text
@@ -1761,6 +1782,7 @@ model ApplicationPhase {
 
   @@index([tenantId])
   @@index([applicationId])
+  @@index([phaseTemplateId])
   @@index([phaseCategory])
   @@index([status])
   @@index([order])