@valentine-efagene/qshelter-common 2.0.140 → 2.0.142

package/dist/generated/client/models/index.d.ts

@@ -52,6 +52,7 @@ export * from './PropertyVariantAmenity';
 export * from './PropertyVariantMedia';
 export * from './QuestionnaireField';
 export * from './QuestionnairePhase';
+export * from './QuestionnairePhaseReview';
 export * from './QuestionnairePlan';
 export * from './QuestionnairePlanQuestion';
 export * from './RefreshToken';

package/dist/generated/client/models/index.js

@@ -52,6 +52,7 @@ export * from './PropertyVariantAmenity';
 export * from './PropertyVariantMedia';
 export * from './QuestionnaireField';
 export * from './QuestionnairePhase';
+export * from './QuestionnairePhaseReview';
 export * from './QuestionnairePlan';
 export * from './QuestionnairePlanQuestion';
 export * from './RefreshToken';

package/dist/generated/client/models.d.ts

@@ -45,6 +45,7 @@ export type * from './models/Application.js';
 export type * from './models/ApplicationRefund.js';
 export type * from './models/ApplicationPhase.js';
 export type * from './models/QuestionnairePhase.js';
+export type * from './models/QuestionnairePhaseReview.js';
 export type * from './models/DocumentationPhase.js';
 export type * from './models/PaymentPhase.js';
 export type * from './models/QuestionnaireField.js';

package/package.json

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

package/prisma/schema.prisma

@@ -487,9 +487,9 @@ model User {
   applicationPayments ApplicationPayment[] @relation("ApplicationPayer")
 
   // Documentation (new model)
-  uploadedDocs      ApplicationDocument[]     @relation("DocumentUploader")
-  documentApprovals DocumentApproval[]        @relation("DocumentApprovalReviewer")
-  completedStages   ApprovalStageProgress[]   @relation("StageCompletedBy")
+  uploadedDocs      ApplicationDocument[]   @relation("DocumentUploader")
+  documentApprovals DocumentApproval[]      @relation("DocumentApprovalReviewer")
+  completedStages   ApprovalStageProgress[] @relation("StageCompletedBy")
 
   // Payment method changes
   paymentMethodChangeRequests PaymentMethodChangeRequest[] @relation("ChangeRequestor")
@@ -520,6 +520,9 @@ model User {
   // Document reviews by this user
   documentReviews DocumentReview[] @relation("DocumentReviewer")
 
+  // Questionnaire phase reviews by this user
+  questionnaireReviews QuestionnairePhaseReview[] @relation("QuestionnaireReviewer")
+
   // Organization memberships (user can be employee of banks/developers)
   organizationMemberships OrganizationMember[]
 
@@ -809,6 +812,7 @@ model Tenant {
   domainEvents                DomainEvent[]
   workflowBlockers            WorkflowBlocker[]
   questionnairePlans          QuestionnairePlan[]
+  questionnairePhaseReviews   QuestionnairePhaseReview[]
   documentReviews             DocumentReview[]
 
   // Organizations (Banks, Developers) operating on this tenant
@@ -1289,10 +1293,10 @@ model DocumentationPlan {
 
   // Document definitions (what documents to collect)
   documentDefinitions DocumentDefinition[]
-  
+
   // Approval stages (sequential workflow for reviewing documents)
-  approvalStages      ApprovalStage[]
-  
+  approvalStages ApprovalStage[]
+
   // Used by property payment method phases (templates)
   methodPhases        PropertyPaymentMethodPhase[]
   // Used by instantiated documentation phases
@@ -2144,6 +2148,9 @@ model QuestionnairePhase {
   // Child records
   fields QuestionnaireField[]
 
+  // Review audit trail
+  reviews QuestionnairePhaseReview[]
+
   // Back-relation: Documentation phases that use this questionnaire's answers for conditions
   dependentDocumentationPhases DocumentationPhase[] @relation("SourceQuestionnaire")
 
@@ -2153,6 +2160,39 @@ model QuestionnairePhase {
   @@map("questionnaire_phases")
 }
 
+// =============================================================================
+// QUESTIONNAIRE PHASE REVIEW - Audit trail for questionnaire reviews
+// =============================================================================
+// Captures every review decision made on a questionnaire phase.
+// Supports workflows where questionnaire may be rejected → resubmitted → approved.
+// The scoring serves as guidance; reviewer makes the final decision.
+// =============================================================================
+
+model QuestionnairePhaseReview {
+  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)
+
+  // Review details
+  reviewerId String
+  reviewer   User           @relation("QuestionnaireReviewer", fields: [reviewerId], references: [id])
+  decision   ReviewDecision
+  notes      String?        @db.Text
+
+  // Snapshot of scores at time of review (for audit)
+  scoreAtReview   Int? // The totalScore when this review was made
+  passedAtReview  Boolean? // The passed flag when this review was made
+
+  createdAt DateTime @default(now())
+
+  @@index([tenantId])
+  @@index([questionnairePhaseId])
+  @@index([reviewerId])
+  @@map("questionnaire_phase_reviews")
+}
+
 // =============================================================================
 // DOCUMENTATION PHASE DATA - Extension for DOCUMENTATION phases
 // =============================================================================