@valentine-efagene/qshelter-common 2.0.141 → 2.0.143

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.141",
+  "version": "2.0.143",
   "description": "Shared database schemas and utilities for QShelter services",
   "main": "dist/src/index.js",
   "types": "dist/src/index.d.ts",

package/prisma/migrations/20260120024650_add_questionnaire_phase_review/migration.sql

@@ -0,0 +1,102 @@
+/*
+  Warnings:
+
+  - You are about to drop the column `completedStepsCount` on the `documentation_phases` table. All the data in the column will be lost.
+  - You are about to drop the column `completionCriterion` on the `documentation_phases` table. All the data in the column will be lost.
+  - You are about to drop the column `currentStepId` on the `documentation_phases` table. All the data in the column will be lost.
+  - You are about to drop the column `minimumCompletionPercentage` on the `documentation_phases` table. All the data in the column will be lost.
+  - You are about to drop the column `requiredDocumentSnapshot` on the `documentation_phases` table. All the data in the column will be lost.
+  - You are about to drop the column `stepDefinitionsSnapshot` on the `documentation_phases` table. All the data in the column will be lost.
+  - You are about to drop the column `totalStepsCount` on the `documentation_phases` table. All the data in the column will be lost.
+  - You are about to drop the `documentation_plan_steps` table. If the table is not empty, all the data it contains will be lost.
+  - You are about to drop the `documentation_step_approvals` table. If the table is not empty, all the data it contains will be lost.
+  - You are about to drop the `documentation_step_documents` table. If the table is not empty, all the data it contains will be lost.
+  - You are about to drop the `documentation_steps` table. If the table is not empty, all the data it contains will be lost.
+
+*/
+-- DropForeignKey
+ALTER TABLE `documentation_phases` DROP FOREIGN KEY `documentation_phases_currentStepId_fkey`;
+
+-- DropForeignKey
+ALTER TABLE `documentation_plan_steps` DROP FOREIGN KEY `documentation_plan_steps_planId_fkey`;
+
+-- DropForeignKey
+ALTER TABLE `documentation_step_approvals` DROP FOREIGN KEY `documentation_step_approvals_approverId_fkey`;
+
+-- DropForeignKey
+ALTER TABLE `documentation_step_approvals` DROP FOREIGN KEY `documentation_step_approvals_stepId_fkey`;
+
+-- DropForeignKey
+ALTER TABLE `documentation_step_approvals` DROP FOREIGN KEY `documentation_step_approvals_tenantId_fkey`;
+
+-- DropForeignKey
+ALTER TABLE `documentation_step_documents` DROP FOREIGN KEY `documentation_step_documents_stepId_fkey`;
+
+-- DropForeignKey
+ALTER TABLE `documentation_step_documents` DROP FOREIGN KEY `documentation_step_documents_tenantId_fkey`;
+
+-- DropForeignKey
+ALTER TABLE `documentation_steps` DROP FOREIGN KEY `documentation_steps_assigneeId_fkey`;
+
+-- DropForeignKey
+ALTER TABLE `documentation_steps` DROP FOREIGN KEY `documentation_steps_documentationPhaseId_fkey`;
+
+-- DropForeignKey
+ALTER TABLE `documentation_steps` DROP FOREIGN KEY `documentation_steps_gateActedById_fkey`;
+
+-- DropForeignKey
+ALTER TABLE `documentation_steps` DROP FOREIGN KEY `documentation_steps_tenantId_fkey`;
+
+-- DropIndex
+DROP INDEX `documentation_phases_currentStepId_idx` ON `documentation_phases`;
+
+-- AlterTable
+ALTER TABLE `documentation_phases` DROP COLUMN `completedStepsCount`,
+    DROP COLUMN `completionCriterion`,
+    DROP COLUMN `currentStepId`,
+    DROP COLUMN `minimumCompletionPercentage`,
+    DROP COLUMN `requiredDocumentSnapshot`,
+    DROP COLUMN `stepDefinitionsSnapshot`,
+    DROP COLUMN `totalStepsCount`,
+    ADD COLUMN `approvalStagesSnapshot` JSON NULL,
+    ADD COLUMN `currentStageOrder` INTEGER NOT NULL DEFAULT 1,
+    ADD COLUMN `documentDefinitionsSnapshot` JSON NULL;
+
+-- DropTable
+DROP TABLE `documentation_plan_steps`;
+
+-- DropTable
+DROP TABLE `documentation_step_approvals`;
+
+-- DropTable
+DROP TABLE `documentation_step_documents`;
+
+-- DropTable
+DROP TABLE `documentation_steps`;
+
+-- CreateTable
+CREATE TABLE `questionnaire_phase_reviews` (
+    `id` VARCHAR(191) NOT NULL,
+    `tenantId` VARCHAR(191) NOT NULL,
+    `questionnairePhaseId` VARCHAR(191) NOT NULL,
+    `reviewerId` VARCHAR(191) NOT NULL,
+    `decision` ENUM('PENDING', 'APPROVED', 'REJECTED', 'CHANGES_REQUESTED', 'WAIVED') NOT NULL,
+    `notes` TEXT NULL,
+    `scoreAtReview` INTEGER NULL,
+    `passedAtReview` BOOLEAN NULL,
+    `createdAt` DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3),
+
+    INDEX `questionnaire_phase_reviews_tenantId_idx`(`tenantId`),
+    INDEX `questionnaire_phase_reviews_questionnairePhaseId_idx`(`questionnairePhaseId`),
+    INDEX `questionnaire_phase_reviews_reviewerId_idx`(`reviewerId`),
+    PRIMARY KEY (`id`)
+) DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
+
+-- AddForeignKey
+ALTER TABLE `questionnaire_phase_reviews` ADD CONSTRAINT `questionnaire_phase_reviews_tenantId_fkey` FOREIGN KEY (`tenantId`) REFERENCES `tenants`(`id`) ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE `questionnaire_phase_reviews` ADD CONSTRAINT `questionnaire_phase_reviews_questionnairePhaseId_fkey` FOREIGN KEY (`questionnairePhaseId`) REFERENCES `questionnaire_phases`(`id`) ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE `questionnaire_phase_reviews` ADD CONSTRAINT `questionnaire_phase_reviews_reviewerId_fkey` FOREIGN KEY (`reviewerId`) REFERENCES `users`(`id`) ON DELETE RESTRICT ON UPDATE CASCADE;

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
 // =============================================================================