@valentine-efagene/qshelter-common 2.0.139 → 2.0.140

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

@@ -18,10 +18,6 @@ export * from './DocumentReview';
 export * from './DocumentTemplate';
 export * from './DocumentationPhase';
 export * from './DocumentationPlan';
-export * from './DocumentationPlanStep';
-export * from './DocumentationStep';
-export * from './DocumentationStepApproval';
-export * from './DocumentationStepDocument';
 export * from './DomainEvent';
 export * from './EmailPreference';
 export * from './EventChannel';

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

@@ -18,10 +18,6 @@ export * from './DocumentReview';
 export * from './DocumentTemplate';
 export * from './DocumentationPhase';
 export * from './DocumentationPlan';
-export * from './DocumentationPlanStep';
-export * from './DocumentationStep';
-export * from './DocumentationStepApproval';
-export * from './DocumentationStepDocument';
 export * from './DomainEvent';
 export * from './EmailPreference';
 export * from './EventChannel';

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

@@ -28,7 +28,6 @@ export type * from './models/PropertyVariantMedia.js';
 export type * from './models/PropertyUnit.js';
 export type * from './models/PropertyAmenity.js';
 export type * from './models/DocumentationPlan.js';
-export type * from './models/DocumentationPlanStep.js';
 export type * from './models/DocumentDefinition.js';
 export type * from './models/ApprovalStage.js';
 export type * from './models/QuestionnairePlan.js';
@@ -50,9 +49,6 @@ export type * from './models/DocumentationPhase.js';
 export type * from './models/PaymentPhase.js';
 export type * from './models/QuestionnaireField.js';
 export type * from './models/ApplicationEvent.js';
-export type * from './models/DocumentationStep.js';
-export type * from './models/DocumentationStepDocument.js';
-export type * from './models/DocumentationStepApproval.js';
 export type * from './models/PaymentInstallment.js';
 export type * from './models/ApplicationPayment.js';
 export type * from './models/ApplicationDocument.js';

package/package.json

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

package/prisma/schema.prisma

@@ -486,11 +486,10 @@ model User {
   soldApplications    Application[]        @relation("ApplicationSeller")
   applicationPayments ApplicationPayment[] @relation("ApplicationPayer")
 
-  // Documentation step assignments and approvals
-  assignedSteps  DocumentationStep[]         @relation("DocumentationStepAssignee")
-  gateActedSteps DocumentationStep[]         @relation("GateActedBy")
-  stepApprovals  DocumentationStepApproval[] @relation("DocumentationStepApprover")
-  uploadedDocs   ApplicationDocument[]       @relation("DocumentUploader")
+  // Documentation (new model)
+  uploadedDocs      ApplicationDocument[]     @relation("DocumentUploader")
+  documentApprovals DocumentApproval[]        @relation("DocumentApprovalReviewer")
+  completedStages   ApprovalStageProgress[]   @relation("StageCompletedBy")
 
   // Payment method changes
   paymentMethodChangeRequests PaymentMethodChangeRequest[] @relation("ChangeRequestor")
@@ -521,12 +520,6 @@ model User {
   // Document reviews by this user
   documentReviews DocumentReview[] @relation("DocumentReviewer")
 
-  // NEW: Document approval trail entries by this user
-  documentApprovals DocumentApproval[] @relation("DocumentApprovalReviewer")
-
-  // NEW: Approval stages completed by this user
-  completedStages ApprovalStageProgress[] @relation("StageCompletedBy")
-
   // Organization memberships (user can be employee of banks/developers)
   organizationMemberships OrganizationMember[]
 
@@ -795,12 +788,11 @@ model Tenant {
   paymentPhases               PaymentPhase[]
   questionnaireFields         QuestionnaireField[]
   applicationEvents           ApplicationEvent[]
-  documentationSteps          DocumentationStep[]
-  documentationStepDocuments  DocumentationStepDocument[]
-  documentationStepApprovals  DocumentationStepApproval[]
   paymentInstallments         PaymentInstallment[]
   applicationPayments         ApplicationPayment[]
   applicationDocuments        ApplicationDocument[]
+  documentApprovals           DocumentApproval[]
+  approvalStageProgress       ApprovalStageProgress[]
   propertyMedia               PropertyMedia[]
   propertyDocuments           PropertyDocument[]
   propertyVariants            PropertyVariant[]
@@ -819,10 +811,6 @@ model Tenant {
   questionnairePlans          QuestionnairePlan[]
   documentReviews             DocumentReview[]
 
-  // NEW: Approval stage progress and document approvals
-  approvalStageProgress ApprovalStageProgress[]
-  documentApprovals     DocumentApproval[]
-
   // Organizations (Banks, Developers) operating on this tenant
   organizations Organization[]
 
@@ -1299,13 +1287,10 @@ model DocumentationPlan {
   createdAt DateTime @default(now())
   updatedAt DateTime @updatedAt
 
-  // Steps that make up this plan (DEPRECATED - use documentDefinitions + approvalStages)
-  steps               DocumentationPlanStep[]
-  
-  // NEW: Document definitions (what documents to collect)
+  // Document definitions (what documents to collect)
   documentDefinitions DocumentDefinition[]
   
-  // NEW: Approval stages (sequential workflow for reviewing documents)
+  // Approval stages (sequential workflow for reviewing documents)
   approvalStages      ApprovalStage[]
   
   // Used by property payment method phases (templates)
@@ -1318,70 +1303,6 @@ model DocumentationPlan {
   @@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?
-  // Human-readable document name (e.g., "Valid ID Card" for ID_CARD)
-  // If not provided, step name can be auto-generated: "Upload ${documentName}"
-  documentName String?
-  metadata     Json?
-
-  // Document validation rules (for UPLOAD steps)
-  isRequired           Boolean @default(true)
-  description          String? @db.Text // Instructions for the user
-  maxSizeBytes         Int? // Max file size allowed (e.g., 5242880 for 5MB)
-  allowedMimeTypes     String? // CSV: application/pdf,image/jpeg,image/png
-  expiryDays           Int? // Document must not be older than X days
-  requiresManualReview Boolean @default(false)
-  minFiles             Int     @default(1) // Minimum number of files required
-  maxFiles             Int     @default(1) // Maximum number of files allowed
-
-  // Conditional logic - when is this step required?
-  // NULL = always required (unconditional)
-  // Examples:
-  // { "questionKey": "mortgage_type", "operator": "EQUALS", "value": "JOINT" }
-  // { "questionKey": "employment_status", "operator": "IN", "values": ["SELF_EMPLOYED", "BUSINESS_OWNER"] }
-  // { "all": [{ "questionKey": "has_spouse", "operator": "EQUALS", "value": "YES" }, { "questionKey": "spouse_employed", "operator": "EQUALS", "value": "YES" }] }
-  condition Json?
-
-  // =========================================================================
-  // MULTI-PARTY REVIEW CONFIGURATION (for UPLOAD steps)
-  // =========================================================================
-  // Defines which parties must review documents uploaded in this step
-  // Format: [{ party: "INTERNAL", required: true }, { party: "BANK", required: true }]
-  // If null, defaults to single internal review (backward compatible)
-  reviewRequirements Json?
-
-  // Review order: 'SEQUENTIAL' = parties review in order, 'PARALLEL' = all review simultaneously
-  reviewOrder String? // 'SEQUENTIAL' | 'PARALLEL'
-
-  // =========================================================================
-  // GATE STEP CONFIGURATION (only applicable when stepType = GATE)
-  // =========================================================================
-  gateActor        GateActor? // Who must perform the action
-  gateAction       GateAction? // What action is required
-  gateRoleId       String? // If gateActor = SPECIFIC_ROLE, which role
-  gateInstructions String?             @db.Text // Instructions shown to actor
-  allowReject      Boolean             @default(true) // Can the actor reject?
-  rejectBehavior   GateRejectBehavior? // What happens on reject
-  requiresComment  Boolean             @default(false) // Must actor provide a comment?
-
-  createdAt DateTime @default(now())
-  updatedAt DateTime @updatedAt
-
-  @@index([planId])
-  @@map("documentation_plan_steps")
-}
-
 // =============================================================================
 // DOCUMENT DEFINITION - What documents to collect (template)
 // =============================================================================
@@ -2235,7 +2156,7 @@ model QuestionnairePhase {
 // =============================================================================
 // DOCUMENTATION PHASE DATA - Extension for DOCUMENTATION phases
 // =============================================================================
-// Manages document upload/approval workflow with FSM steps
+// Manages document upload/approval workflow with sequential approval stages
 // =============================================================================
 
 model DocumentationPhase {
@@ -2249,41 +2170,30 @@ model DocumentationPhase {
   documentationPlanId String?
   documentationPlan   DocumentationPlan? @relation(fields: [documentationPlanId], references: [id])
 
-  // Source questionnaire for conditional step evaluation
-  // Links to the questionnaire phase whose answers determine which steps apply
+  // Source questionnaire for conditional document evaluation
+  // Links to the questionnaire phase whose answers determine which documents are required
   sourceQuestionnairePhaseId String?
   sourceQuestionnairePhase   QuestionnairePhase? @relation("SourceQuestionnaire", fields: [sourceQuestionnairePhaseId], references: [id])
 
-  // Current step pointer for UX and orchestration
-  currentStepId String?
-  currentStep   DocumentationStep? @relation("CurrentStep", fields: [currentStepId], references: [id])
+  // Current approval stage pointer for UX and orchestration
+  currentStageOrder Int @default(1)
 
   // Progress counters
   approvedDocumentsCount Int @default(0)
   requiredDocumentsCount Int @default(0)
-  completedStepsCount    Int @default(0)
-  totalStepsCount        Int @default(0)
-
-  // Completion criteria
-  minimumCompletionPercentage Float?
-  completionCriterion         CompletionCriterion?
 
   // Snapshots for audit
-  stepDefinitionsSnapshot  Json?
-  requiredDocumentSnapshot Json?
+  documentDefinitionsSnapshot Json?
+  approvalStagesSnapshot      Json?
 
   createdAt DateTime @default(now())
   updatedAt DateTime @updatedAt
 
-  // Child records
-  steps DocumentationStep[]
-
-  // NEW: Approval stage progress (tracks which stages are completed)
+  // Approval stage progress (tracks which stages are completed)
   stageProgress ApprovalStageProgress[]
 
   @@index([tenantId])
   @@index([phaseId])
-  @@index([currentStepId])
   @@index([sourceQuestionnairePhaseId])
   @@map("documentation_phases")
 }
@@ -2433,140 +2343,6 @@ model ApplicationEvent {
   @@map("application_events")
 }
 
-// Steps within a DOCUMENTATION phase (FSM for document collection/approval)
-model DocumentationStep {
-  id                   String             @id @default(cuid())
-  tenantId             String
-  tenant               Tenant             @relation(fields: [tenantId], references: [id], onDelete: Cascade)
-  documentationPhaseId String
-  documentationPhase   DocumentationPhase @relation(fields: [documentationPhaseId], references: [id], onDelete: Cascade)
-
-  name         String
-  // Human-readable document name (e.g., "Valid ID Card" for ID_CARD)
-  documentName String?
-  description  String?  @db.Text
-  stepType     StepType
-  order        Int
-
-  status StepStatus @default(PENDING)
-
-  // =========================================================================
-  // USER ACTION TRACKING - For rejection/resubmission flows
-  // =========================================================================
-  // When status is NEEDS_RESUBMISSION or ACTION_REQUIRED, this explains why.
-  // Populated from DocumentationStepApproval.comment on rejection.
-  actionReason String? @db.Text
-
-  // Number of times this step has been submitted (for tracking resubmissions)
-  submissionCount Int @default(0)
-
-  // Last submission timestamp (for tracking resubmission timing)
-  lastSubmittedAt DateTime?
-
-  // Configuration metadata (for GENERATE_DOCUMENT steps, etc.)
-  metadata Json?
-
-  // Document validation rules (copied from plan for UPLOAD steps)
-  requiresManualReview Boolean @default(false)
-
-  // Conditional step logic (copied from plan)
-  // When set, this step is only applicable if the condition evaluates to true
-  // Format: { "questionKey": "mortgage_type", "operator": "EQUALS", "value": "JOINT" }
-  // Or: { "questionKey": "employment_status", "operator": "IN", "values": ["SELF_EMPLOYED", "BUSINESS_OWNER"] }
-  condition Json?
-
-  // =========================================================================
-  // MULTI-PARTY REVIEW CONFIGURATION (for UPLOAD steps)
-  // =========================================================================
-  // Defines which parties must review documents uploaded in this step
-  // Format: [{ party: "INTERNAL", required: true }, { party: "BANK", required: true }]
-  // If null, defaults to single internal review (backward compatible)
-  reviewRequirements Json?
-
-  // Review order: 'SEQUENTIAL' = parties review in order, 'PARALLEL' = all review simultaneously
-  reviewOrder String? // 'SEQUENTIAL' | 'PARALLEL'
-
-  // Assignment
-  assigneeId String?
-  assignee   User?   @relation("DocumentationStepAssignee", fields: [assigneeId], references: [id])
-
-  // Required document types for UPLOAD steps (normalized)
-  requiredDocuments DocumentationStepDocument[]
-
-  // =========================================================================
-  // GATE STEP CONFIGURATION (only applicable when stepType = GATE)
-  // =========================================================================
-  gateActor        GateActor? // Who must perform the action
-  gateAction       GateAction? // What action is required
-  gateRoleId       String? // If gateActor = SPECIFIC_ROLE, which role
-  gateInstructions String?             @db.Text // Instructions shown to actor
-  allowReject      Boolean             @default(true) // Can the actor reject?
-  rejectBehavior   GateRejectBehavior? // What happens on reject
-  requiresComment  Boolean             @default(false) // Must actor provide a comment?
-
-  // Gate action tracking
-  gateActedAt   DateTime? // When the gate action was performed
-  gateActedById String? // Who performed the gate action
-  gateActedBy   User?     @relation("GateActedBy", fields: [gateActedById], references: [id])
-  gateDecision  String? // APPROVED, REJECTED, ACKNOWLEDGED, etc.
-  gateComment   String?   @db.Text // Comment from actor
-
-  // Timing
-  dueDate     DateTime?
-  completedAt DateTime?
-
-  createdAt DateTime @default(now())
-  updatedAt DateTime @updatedAt
-
-  approvals       DocumentationStepApproval[]
-  currentForPhase DocumentationPhase[]        @relation("CurrentStep")
-
-  @@index([tenantId])
-  @@index([documentationPhaseId])
-  @@index([status])
-  @@index([order])
-  @@map("documentation_steps")
-}
-
-// Required documents for a step (normalized from CSV)
-model DocumentationStepDocument {
-  id       String            @id @default(cuid())
-  tenantId String
-  tenant   Tenant            @relation(fields: [tenantId], references: [id], onDelete: Cascade)
-  stepId   String
-  step     DocumentationStep @relation(fields: [stepId], references: [id], onDelete: Cascade)
-
-  documentType String
-  isRequired   Boolean @default(true)
-
-  createdAt DateTime @default(now())
-
-  @@index([tenantId])
-  @@index([stepId, documentType])
-  @@map("documentation_step_documents")
-}
-
-// Approvals for documentation steps
-model DocumentationStepApproval {
-  id         String            @id @default(cuid())
-  tenantId   String
-  tenant     Tenant            @relation(fields: [tenantId], references: [id], onDelete: Cascade)
-  stepId     String
-  step       DocumentationStep @relation(fields: [stepId], references: [id], onDelete: Cascade)
-  approverId String?
-  approver   User?             @relation("DocumentationStepApprover", fields: [approverId], references: [id])
-
-  decision  ApprovalDecision
-  comment   String?          @db.Text
-  decidedAt DateTime         @default(now())
-
-  createdAt DateTime @default(now())
-
-  @@index([tenantId])
-  @@index([stepId])
-  @@map("documentation_step_approvals")
-}
-
 // Installments within a PAYMENT phase
 model PaymentInstallment {
   id             String       @id @default(cuid())