@adaptware/eagles-db 0.5.57 → 0.5.60

package/client/schema.prisma

@@ -414,58 +414,62 @@ enum ApplicationOfferSubstatus {
 
 model Application {
   /// Primary key
-  id                        String                     @id @default(uuid())
+  id                            String                     @id @default(uuid())
   /// Foreign keys
-  organisation_id           String
-  candidate_id              String
-  resume_id                 String
-  job_description_id        String
-  evaluation_plan_id        String?
-  recruiter_id              String?
-  source_id                 String?
+  organisation_id               String
+  candidate_id                  String
+  resume_id                     String
+  job_description_id            String
+  evaluation_plan_id            String?
+  recruiter_id                  String?
+  source_id                     String?
   /// Data fields
-  fit_check_score           Float?
-  applied_at                DateTime                   @default(now())
-  round_no                  Int                        @default(0)
-  is_jaf_completed          Boolean                    @default(false)
-  proceed_to_next_round     Boolean?                   @default(false)
-  evaluationComment         String?
+  fit_check_score               Float?
+  applied_at                    DateTime                   @default(now())
+  round_no                      Int                        @default(0)
+  is_jaf_completed              Boolean                    @default(false)
+  proceed_to_next_round         Boolean?                   @default(false)
+  evaluationComment             String?
   /// Candidate flag (orthogonal to ApplicationStatus). Latest actor/comment only.
-  is_flagged                Boolean                    @default(false)
-  flag_comment              String?
-  flagged_at                DateTime?
-  flagged_by                String?
-  unflag_comment            String?
-  unflagged_at              DateTime?
-  unflagged_by              String?
-  fit_check_status          FitCheckStatus?
-  status                    ApplicationStatus          @default(PENDING)
+  is_flagged                    Boolean                    @default(false)
+  flag_comment                  String?
+  flagged_at                    DateTime?
+  flagged_by                    String?
+  unflag_comment                String?
+  unflagged_at                  DateTime?
+  unflagged_by                  String?
+  fit_check_status              FitCheckStatus?
+  status                        ApplicationStatus          @default(PENDING)
   /// Fine-grained offer-stage state. Meaningful only when status = OFFER (or was OFFER for a terminal-substatus that flipped to REJECTED / JOINED).
-  offer_substatus           ApplicationOfferSubstatus?
+  offer_substatus               ApplicationOfferSubstatus?
   /// Audit fields
-  created_at                DateTime                   @default(now())
-  updated_at                DateTime                   @updatedAt
-  created_by                String
-  updated_by                String
-  is_active                 Boolean                    @default(true)
+  created_at                    DateTime                   @default(now())
+  updated_at                    DateTime                   @updatedAt
+  created_by                    String
+  updated_by                    String
+  is_active                     Boolean                    @default(true)
+  fit_check_report_document_id  String?                    @unique
+  fit_check_report_updated_flag Boolean                    @default(false)
+  fit_check_report_data         Json?                      @default("{}")
   /// Relations
-  evaluation_plan           EvaluationPlan?            @relation(fields: [evaluation_plan_id], references: [id])
-  candidate                 User                       @relation(fields: [candidate_id], references: [id], onDelete: Cascade, onUpdate: Cascade)
-  organisation              Organisation               @relation(fields: [organisation_id], references: [id], onDelete: Cascade, onUpdate: Cascade)
-  resume                    Resume                     @relation(fields: [resume_id], references: [id], onDelete: Cascade, onUpdate: Cascade)
-  job_description           JobDescription             @relation(fields: [job_description_id], references: [id], onDelete: Cascade, onUpdate: Cascade)
-  fit_check                 FitCheck?
-  recruiter                 User?                      @relation("ApplicationRecruiter", fields: [recruiter_id], references: [id])
-  source                    Source?                    @relation(fields: [source_id], references: [id], onDelete: SetNull)
-  interviews                Interview[]
-  assignments               Assignment[]
-  ongoing_evaluations       OngoingEvaluation[]
-  activity_logs             ActivityLog[]
-  notes                     Notes[]
-  conversations             Conversation[]
-  communication_messages    CommunicationMessage[]
-  job_application_responses JobApplicationResponse[]
-  offer                     Offer?
+  evaluation_plan               EvaluationPlan?            @relation(fields: [evaluation_plan_id], references: [id])
+  candidate                     User                       @relation(fields: [candidate_id], references: [id], onDelete: Cascade, onUpdate: Cascade)
+  organisation                  Organisation               @relation(fields: [organisation_id], references: [id], onDelete: Cascade, onUpdate: Cascade)
+  resume                        Resume                     @relation(fields: [resume_id], references: [id], onDelete: Cascade, onUpdate: Cascade)
+  job_description               JobDescription             @relation(fields: [job_description_id], references: [id], onDelete: Cascade, onUpdate: Cascade)
+  fit_check                     FitCheck?
+  recruiter                     User?                      @relation("ApplicationRecruiter", fields: [recruiter_id], references: [id])
+  source                        Source?                    @relation(fields: [source_id], references: [id], onDelete: SetNull)
+  interviews                    Interview[]
+  assignments                   Assignment[]
+  ongoing_evaluations           OngoingEvaluation[]
+  activity_logs                 ActivityLog[]
+  notes                         Notes[]
+  conversations                 Conversation[]
+  communication_messages        CommunicationMessage[]
+  job_application_responses     JobApplicationResponse[]
+  offer                         Offer?
+  fit_check_report_document     Document?                  @relation("ApplicationFitCheckReportDocument", fields: [fit_check_report_document_id], references: [id], onDelete: SetNull)
 
   @@unique([candidate_id, job_description_id]) // Ensures candidate applies only once per job
   @@index([candidate_id])
@@ -552,6 +556,8 @@ model AssessmentLibrary {
   created_by       String
   updated_by       String
   is_active        Boolean          @default(true)
+  /// Frozen question plan, batch cursor, and bank-generation status (JSON).
+  generation_state Json?
   organisation     Organisation     @relation(fields: [organisation_id], references: [id], onDelete: Cascade, onUpdate: Cascade)
   questions        Question[] // One assessment → many questions
   assessments      Assessment[]
@@ -1401,6 +1407,7 @@ model Document {
   offer_letters                   OfferLetter[]            @relation("OfferLetterPdf")
   offer_letter_template_snapshots OfferLetter[]            @relation("OfferLetterTemplateSnapshot")
   offer_draft_edited_html         Offer[]                  @relation("OfferDraftEditedHtml")
+  application_fit_check_report    Application?             @relation("ApplicationFitCheckReportDocument")
 
   // Indexes
   @@index([candidate_id])
@@ -1445,6 +1452,8 @@ model EvaluationCriteria {
 
 enum RoundType {
   ASSESSMENT
+  GENERAL_APTITUDE_ASSESSMENT
+  DOMAIN_KNOWLEDGE_ASSESSMENT
   INTERVIEW
   ASSIGNMENT
   SCREENING
@@ -1539,26 +1548,6 @@ model EvaluationPlan {
   @@schema("public")
 }
 
-model Feedback {
-  id           String @id @default(uuid())
-  interview_id String
-  order_no     Int
-
-  ai_feedback    Json?
-  human_feedback Json?
-
-  created_at DateTime  @default(now())
-  updated_at DateTime  @updatedAt
-  created_by String
-  updated_by String
-  is_active  Boolean   @default(true)
-  interview  Interview @relation(fields: [interview_id], references: [id], onDelete: Cascade, onUpdate: Cascade)
-
-  @@unique([interview_id, order_no])
-  @@index([interview_id])
-  @@schema("public")
-}
-
 enum FitCheckStatus {
   RECOMMENDED
   TO_REVIEW
@@ -1567,37 +1556,54 @@ enum FitCheckStatus {
   @@schema("public")
 }
 
+/// 5-level current evaluation. LEVEL_1 is weakest, LEVEL_5 is strongest.
+/// Display copy and numeric rank live in backend `CurrentEvaluationMapper`.
+enum CurrentEvaluation {
+  LEVEL_1
+  LEVEL_2
+  LEVEL_3
+  LEVEL_4
+  LEVEL_5
+
+  @@schema("public")
+}
+
 model FitCheck {
   /// Primary key (UUID)
-  id                     String         @id @default(uuid())
+  id                     String             @id @default(uuid())
   /// FK to organisations table
   organisation_id        String?
   candidate_id           String?
   resume_id              String
   job_description_id     String
   /// Owning application (inverted from Application.fit_check_id)
-  application_id         String?        @unique
+  application_id         String?            @unique
   skills_analysis        Json?
   overall_analysis       Json?
   overall_score          Float
   /// Free-text from Overall Analysis agent; preferred over recommendation Json.
   overall_recommendation String?
+  /// Why `overall_score` is this value. Distinct from `overall_recommendation`.
+  score_reasoning        String?
+  /// 5-level current evaluation (`CurrentEvaluation`). Independent of overall_score.
+  current_evaluation     CurrentEvaluation?
   short_match_analysis   Json[]
   fit_comparison         Json?
   recommendation         Json?
   competencies_analysis  Json?
+  competencies_verdict   Json?
   /// Audit fields
   created_by             String
   updated_by             String
-  is_active              Boolean        @default(true)
-  created_at             DateTime       @default(now())
-  updated_at             DateTime       @updatedAt
+  is_active              Boolean            @default(true)
+  created_at             DateTime           @default(now())
+  updated_at             DateTime           @updatedAt
   /// Relations
-  organisation           Organisation?  @relation(fields: [organisation_id], references: [id], onDelete: Cascade, onUpdate: Cascade)
-  candidate              User?          @relation(fields: [candidate_id], references: [id], onDelete: Cascade, onUpdate: Cascade)
-  resume                 Resume         @relation(fields: [resume_id], references: [id], onDelete: Cascade, onUpdate: Cascade)
-  job_description        JobDescription @relation(fields: [job_description_id], references: [id], onDelete: Cascade, onUpdate: Cascade)
-  application            Application?   @relation(fields: [application_id], references: [id], onDelete: Cascade, onUpdate: Cascade)
+  organisation           Organisation?      @relation(fields: [organisation_id], references: [id], onDelete: Cascade, onUpdate: Cascade)
+  candidate              User?              @relation(fields: [candidate_id], references: [id], onDelete: Cascade, onUpdate: Cascade)
+  resume                 Resume             @relation(fields: [resume_id], references: [id], onDelete: Cascade, onUpdate: Cascade)
+  job_description        JobDescription     @relation(fields: [job_description_id], references: [id], onDelete: Cascade, onUpdate: Cascade)
+  application            Application?       @relation(fields: [application_id], references: [id], onDelete: Cascade, onUpdate: Cascade)
 
   /// Ensure one FitCheck per (resume_id, job_description_id) pair
   @@unique([resume_id, job_description_id])
@@ -1970,18 +1976,21 @@ enum AiAssistanceMode {
 model Interview {
   id                            String            @id @default(uuid())
   /// Foreign keys
-  organisation_id               String
+  organisation_id               String?
   candidate_id                  String
   interviewer_id                String?
-  evaluation_plan_id            String
+  evaluation_plan_id            String?
   application_id                String?
   resume_id                     String
-  job_description_id            String
+  job_description_id            String?
   calendar_event_id             String?
+  calendar_events               Json?
+  /// True for candidate-initiated profile enrichment voice sessions (not hiring).
+  candidate_initiated           Boolean           @default(false)
+  /// Profile AI: purpose, focusAreas, focusAreaCoverage, etc.
+  candidate_interview_metadata  Json?
   /// Data
   room_name                     String?
-  /// @deprecated Prefer `ai_feedback.feedback` (narrative string on AI feedback JSON).
-  interview_summary             String[]
   scheduled_start_time          DateTime?
   scheduled_end_time            DateTime?
   actual_start_time             DateTime?
@@ -1995,17 +2004,18 @@ model Interview {
   ai_assistance_mode            AiAssistanceMode? @default(ASSISTED)
   interview_status              InterviewStatus   @default(SCHEDULED)
   interview_platform            InterviewPlatform @default(TREADSPACE)
-  overall_feedback              String?
   /// Feedback JSON fields
   /// AI overall payload: `{ score, rating, feedback? }` where `feedback` is the
-  /// narrative summary string (replaces deprecated `interview_summary`).
+  /// narrative summary string.
   ai_feedback                   Json?
   human_feedback                Json?
-  section_feedback              Json[]
   interview_preparation         Json?
   final_feedback                Json?
   interview_analysis_ranges     Json?
   interview_flow_summary        String?
+  /// Extra Orion prose for downstream AI input (FitCheck, interview prep).
+  /// Not interviewer-facing; omit from evidence GET / snapshots / Zoho.
+  ai_context                    String?
   /// When Orion AI feedback was last persisted on this interview.
   ai_feedback_generated_at      DateTime?
   /// Experimental Beta AI feedback store (parallel to production AI columns).
@@ -2014,6 +2024,7 @@ model Interview {
   beta_section_feedback         Json[]            @default([])
   beta_final_feedback           Json?
   beta_interview_flow_summary   String?
+  beta_ai_context               String?
   beta_ai_feedback_generated_at DateTime?
   /// When recruiter human feedback was last saved (draft or final).
   human_feedback_updated_at     DateTime?
@@ -2038,27 +2049,27 @@ model Interview {
   // Relations
   candidate                 User?              @relation("CandidateInterviews", fields: [candidate_id], references: [id], onDelete: SetNull)
   interviewer               User?              @relation("InterviewerInterviews", fields: [interviewer_id], references: [id], onDelete: SetNull)
-  organisation              Organisation       @relation(fields: [organisation_id], references: [id], onDelete: Cascade, onUpdate: Cascade)
+  organisation              Organisation?      @relation(fields: [organisation_id], references: [id], onDelete: SetNull, onUpdate: Cascade)
   recording_document        Document?          @relation(fields: [recording_document_id], references: [id], onDelete: SetNull, onUpdate: Cascade)
-  job_description           JobDescription     @relation(fields: [job_description_id], references: [id], onDelete: Cascade, onUpdate: Cascade)
+  job_description           JobDescription?    @relation(fields: [job_description_id], references: [id], onDelete: SetNull, onUpdate: Cascade)
   resume                    Resume             @relation(fields: [resume_id], references: [id], onDelete: Cascade, onUpdate: Cascade)
   evaluation_plan           EvaluationPlan?    @relation(fields: [evaluation_plan_id], references: [id], onDelete: SetNull, onUpdate: Cascade)
   application               Application?       @relation(fields: [application_id], references: [id], onDelete: SetNull, onUpdate: Cascade)
   ongoing_evaluation        OngoingEvaluation?
   transcripts               Transcript[]
   suggestions               Suggestion[]
-  feedback                  Feedback[]
   interviewNotes            InterviewNotes[]
   liveAnalysis              LiveAnalysis[]
   zoom_meeting              ZoomMeeting?
 
   // Indexes
-  @@unique([interviewer_id, candidate_id, evaluation_plan_id])
   @@index([candidate_id])
+  @@index([candidate_id, candidate_initiated, created_at])
   @@index([interviewer_id])
   @@index([job_description_id])
   @@index([organisation_id, interview_status])
   @@index([interview_status, scheduled_start_time])
+  @@index([candidate_initiated, interview_status])
   @@schema("public")
 }
 
@@ -2381,13 +2392,15 @@ model JobApplicationField {
   updated_by                String
   created_at                DateTime                 @default(now())
   updated_at                DateTime                 @updatedAt
+  /// order of question
+  order_no                  Int? //nullable for now to allow migration
   /// Relations
   organisation              Organisation             @relation(fields: [organisation_id], references: [id], onDelete: Cascade, onUpdate: Cascade)
   job_application_template  JobApplicationTemplate   @relation(fields: [template_id], references: [id], onDelete: Cascade, onUpdate: Cascade)
   job_application_responses JobApplicationResponse[]
 
   /// Indexes
-  @@index([organisation_id, template_id])
+  @@index([organisation_id, template_id, order_no])
   @@schema("public")
 }
 
@@ -2415,13 +2428,14 @@ model JobApplicationResponse {
   created_by               String
   updated_by               String
   is_active                Boolean                  @default(true)
+  order_no                 Int? //nullable for now to allow migration
   /// Relations
   application              Application              @relation(fields: [application_id], references: [id], onDelete: Cascade, onUpdate: Cascade)
   field                    JobApplicationField?     @relation(fields: [job_application_field_id], references: [id], onDelete: Restrict, onUpdate: Cascade)
   document                 Document?                @relation(fields: [document_id], references: [id], onDelete: SetNull, onUpdate: Cascade)
 
-  /// Partial unique on (application_id, job_application_field_id) WHERE job_application_field_id IS NOT NULL — see migration SQL
-  @@index([application_id])
+  // / Partial unique on (application_id, job_application_field_id) WHERE job_application_field_id IS NOT NULL — see migration SQL
+  @@index([application_id, is_active, order_no])
   @@index([job_application_field_id])
   @@schema("public")
 }
@@ -2761,13 +2775,15 @@ model AiCostLedgerEntry {
   @@schema("licensing")
 }
 
-/// Immutable assignment history for Hiring Unit department/job changes.
+/// Immutable assignment history for Hiring Unit department/user/job changes.
 model PurchasedHiringUnitAssignmentEvent {
   id                          String                                 @id @default(uuid())
   purchased_hiring_unit_id    String
   event_kind                  PurchasedHiringUnitAssignmentEventKind
   previous_department_id      String?
   new_department_id           String?
+  previous_assigned_user_id   String?
+  new_assigned_user_id        String?
   previous_job_description_id String?
   new_job_description_id      String?
   effective_at                DateTime                               @default(now())
@@ -2880,6 +2896,8 @@ enum PurchasedTopUpStatus {
 enum PurchasedHiringUnitAssignmentEventKind {
   DEPARTMENT_ASSIGNED
   DEPARTMENT_UNASSIGNED
+  USER_ASSIGNED
+  USER_UNASSIGNED
   JOB_LINKED
   JOB_UNLINKED
 
@@ -3001,6 +3019,8 @@ model PurchasedHiringUnit {
   status                       PurchasedHiringUnitStatus @default(AVAILABLE)
   /// Current department allocation (licensing allocation, not hiring manager).
   department_id                String?
+  /// Optional person reservation. Units with this set are consumed before dept/org pools.
+  assigned_user_id             String?
   /// Set once when department_id is first assigned; not cleared on reassignment.
   first_assigned_at            DateTime?
   /// Optional unit expiry.
@@ -3017,6 +3037,7 @@ model PurchasedHiringUnit {
   organisation              Organisation                         @relation(fields: [organisation_id], references: [id], onDelete: Restrict, onUpdate: Cascade)
   purchased_license_package PurchasedLicensePackage              @relation(fields: [purchased_license_package_id], references: [id], onDelete: Restrict, onUpdate: Cascade)
   department                Department?                          @relation(fields: [department_id], references: [id], onDelete: SetNull, onUpdate: Cascade)
+  assigned_user             User?                                @relation("AssignedHiringUnits", fields: [assigned_user_id], references: [id], onDelete: SetNull, onUpdate: Cascade)
   job_description           JobDescription?                      @relation(fields: [job_description_id], references: [id], onDelete: SetNull, onUpdate: Cascade)
   assignment_events         PurchasedHiringUnitAssignmentEvent[]
   ledger_entries            LicensingLedgerEntry[]
@@ -3025,9 +3046,11 @@ model PurchasedHiringUnit {
   @@index([organisation_id])
   @@index([purchased_license_package_id])
   @@index([department_id])
+  @@index([assigned_user_id])
   @@index([job_description_id])
   @@index([organisation_id, status])
   @@index([organisation_id, department_id])
+  @@index([organisation_id, assigned_user_id])
   @@index([organisation_id, job_description_id])
   @@map("purchased_hiring_units")
   @@schema("licensing")
@@ -3331,58 +3354,61 @@ enum OngoingEvaluationRoundStatus {
 
 model OngoingEvaluation {
   // Primary Key
-  id                 String                        @id @default(uuid())
+  id                  String                        @id @default(uuid())
   // Foreign Keys 
-  organisation_id    String
-  application_id     String
-  candidate_id       String
-  resume_id          String
-  job_description_id String
-  evaluation_plan_id String
-  interview_id       String?                       @unique
-  assignment_id      String?                       @unique
-  assessment_id      String?                       @unique
+  organisation_id     String
+  application_id      String
+  candidate_id        String
+  resume_id           String
+  job_description_id  String
+  evaluation_plan_id  String
+  interview_id        String?                       @unique
+  assignment_id       String?                       @unique
+  assessment_id       String?                       @unique
   // Data Fields
-  state              OngoingEvaluationState?       @default(NOT_STARTED)
-  round_status       OngoingEvaluationRoundStatus? @default(NOT_SCHEDULED)
-  comments           String?                       @default("")
-  completed_at       DateTime?
-  assigned_at        DateTime?
-  result_at          DateTime?
-  is_committed       Boolean?
+  state               OngoingEvaluationState?       @default(NOT_STARTED)
+  round_status        OngoingEvaluationRoundStatus? @default(NOT_SCHEDULED)
+  comments            String?                       @default("")
+  completed_at        DateTime?
+  assigned_at         DateTime?
+  result_at           DateTime?
+  is_committed        Boolean?
   /// Evaluation Plan Fields Filled After Round Started
-  title              String?
-  description        String?
-  order_no           Int?
-  round_purpose      String?
-  focus_areas        String[]
-  topics             String[]
-  assignee           String?
-  elimination_round  Boolean?                      @default(false)
-  evaluation_type    EvaluationType?
-  type_of_round      RoundType?
-  duration           Int?
-  deadline           Int?
-  duration_unit      DurationUnit?
-  details            Json?
-  category           EvaluationCategory?
+  title               String?
+  description         String?
+  order_no            Int?
+  round_purpose       String?
+  focus_areas         String[]
+  topics              String[]
+  assignee            String?
+  elimination_round   Boolean?                      @default(false)
+  evaluation_type     EvaluationType?
+  type_of_round       RoundType?
+  duration            Int?
+  deadline            Int?
+  duration_unit       DurationUnit?
+  details             Json?
+  category            EvaluationCategory?
+  /// Round relevance vs JD / application. Unused until a later writer.
+  relevance_score     Float?
+  relevance_reasoning String?
   // Audit Fields
-  created_at         DateTime                      @default(now())
-  updated_at         DateTime                      @updatedAt
-  created_by         String
-  updated_by         String
-  is_active          Boolean                       @default(true)
-  is_current         Boolean                       @default(false)
+  created_at          DateTime                      @default(now())
+  updated_at          DateTime                      @updatedAt
+  created_by          String
+  updated_by          String
+  is_active           Boolean                       @default(true)
+  is_current          Boolean                       @default(false)
   // Relations
-  jobDescription     JobDescription?               @relation(fields: [job_description_id], references: [id], onDelete: SetNull)
-  application        Application                   @relation(fields: [application_id], references: [id], onDelete: Cascade, onUpdate: Cascade)
-  candidate          User?                         @relation(fields: [candidate_id], references: [id], onDelete: Cascade, onUpdate: Cascade)
-  resume             Resume?                       @relation(fields: [resume_id], references: [id], onDelete: Cascade, onUpdate: Cascade)
-  organisation       Organisation?                 @relation(fields: [organisation_id], references: [id], onDelete: Cascade, onUpdate: Cascade)
-  evaluation_plan    EvaluationPlan                @relation(fields: [evaluation_plan_id], references: [id], onDelete: Cascade, onUpdate: Cascade)
-  interview          Interview?                    @relation(fields: [interview_id], references: [id], onDelete: SetNull, onUpdate: Cascade)
-  assignment         Assignment?
-  assessment         Assessment?                   @relation(fields: [assessment_id], references: [id], onDelete: SetNull)
+  jobDescription      JobDescription?               @relation(fields: [job_description_id], references: [id], onDelete: SetNull)
+  application         Application                   @relation(fields: [application_id], references: [id], onDelete: Cascade, onUpdate: Cascade)
+  candidate           User?                         @relation(fields: [candidate_id], references: [id], onDelete: Cascade, onUpdate: Cascade)
+  resume              Resume?                       @relation(fields: [resume_id], references: [id], onDelete: Cascade, onUpdate: Cascade)
+  organisation        Organisation?                 @relation(fields: [organisation_id], references: [id], onDelete: Cascade, onUpdate: Cascade)
+  evaluation_plan     EvaluationPlan                @relation(fields: [evaluation_plan_id], references: [id], onDelete: Cascade, onUpdate: Cascade)
+  interview           Interview?                    @relation(fields: [interview_id], references: [id], onDelete: SetNull, onUpdate: Cascade)
+  assignment          Assignment?
+  assessment          Assessment?                   @relation(fields: [assessment_id], references: [id], onDelete: SetNull)
 
   @@unique([application_id, evaluation_plan_id])
   @@index([application_id])
@@ -3494,6 +3520,15 @@ enum OrganisationSize {
   @@schema("public")
 }
 
+/// Who may consume unused hiring units. Changing this does not rewrite unit rows.
+enum HiringUnitAssignmentScope {
+  USER
+  DEPARTMENT
+  ORGANISATION
+
+  @@schema("public")
+}
+
 model Organisation {
   id                            String                       @id @default(uuid())
   name                          String                       @unique
@@ -3536,6 +3571,8 @@ model Organisation {
   timezone                      String                       @default("Asia/Kolkata")
   /// ISO 3166-1 alpha-2 (e.g. IN).
   country_code                  String                       @default("IN")
+  /// Who may consume unused hiring units. Does not rewrite unit rows when changed.
+  hiring_unit_assignment_scope  HiringUnitAssignmentScope    @default(DEPARTMENT)
   organisation_configs          OrganisationConfig[]
   activity_events               ActivityEvent[]
   usage_ledger_entries          UsageLedgerEntry[]
@@ -3716,12 +3753,24 @@ enum Difficulty {
   @@schema("public")
 }
 
+enum QuestionCategory {
+  /// Aptitude, logical reasoning, numerical, verbal — non-domain general tests.
+  GENERAL_APTITUDE
+  /// Role/domain/technical knowledge (skills from JD and competencies).
+  DOMAIN_KNOWLEDGE
+
+  @@schema("public")
+}
+
 model Question {
   id                    String                      @id @default(uuid())
   assessment_library_id String?
   evaluation_plan_id    String?
   candidate_id          String?
   skill                 String?
+  category              QuestionCategory?
+  /// Stable idempotency key for reusable bank rows: `{generationSeed}:{planSlot}`.
+  bank_item_key         String?
   question              String
   answer                String
   options               String[] // For MCQ's
@@ -3738,6 +3787,7 @@ model Question {
   evaluationPlan        EvaluationPlan?             @relation(fields: [evaluation_plan_id], references: [id], onDelete: SetNull)
   candidateResponse     CandidateQuestionResponse[]
 
+  @@unique([assessment_library_id, bank_item_key])
   @@schema("public")
 }
 
@@ -3804,6 +3854,25 @@ model ReportingOverviewJobRecruiter {
   @@schema("analytics")
 }
 
+/// Lifecycle of an AI-authored resume. Legacy/uploaded rows leave this null.
+enum ResumeStatus {
+  DRAFT
+  GENERATING
+  COMPLETED
+
+  @@schema("public")
+}
+
+/// How a resume came to exist. Legacy rows leave this null (read as UPLOADED).
+enum ResumeOrigin {
+  UPLOADED
+  PARSED
+  AI_GENERATED
+  TAILORED
+
+  @@schema("public")
+}
+
 model Resume {
   id                          String              @id @default(uuid())
   user_id                     String?
@@ -3840,8 +3909,40 @@ model Resume {
   candidate_profile CandidateProfile? // one-to-one link
   yearsOfExperience Int?
 
+  /// Lifecycle for AI-authored resumes. Null for legacy/uploaded rows (treated as COMPLETED).
+  status               ResumeStatus?
+  /// How this resume came to exist. Null for legacy rows (treated as UPLOADED).
+  origin               ResumeOrigin?
+  /// Intake session id echoed to the client so a refresh can resume the conversation.
+  intake_session_id    String?
+  /// Durable copy of the chat transcript for the AI intake; Redis is the hot path.
+  conversation_history Json?
+  /// Progress 0-100 reported by the ResumeIntake workflow.
+  intake_progress      Int?
+  /// Last Orion execution id for the intake/generate workflow, for tracing.
+  orion_execution_id   String?
+  /// Snapshot of the candidate's own words, taken immediately before the
+  /// `GenerateResumeFromIntake` polish overwrites `resume_data`. Makes the
+  /// polish reversible, keeps regeneration idempotent (always polish from raw,
+  /// never from already-polished prose), and is the base for a "what changed"
+  /// diff. Null until the first generate; cleared again on revert.
+  intake_raw_data      Json?
+
+  /// Raw job description text the candidate pasted to start a tailoring session.
+  tailoring_jd_text      String?
+  /// Cached JobDescriptionParser output; computed once per tailoring session.
+  tailoring_jd_parsed    Json?
+  /// Cached ResumeGapAnalysis output; computed once per tailoring session.
+  tailoring_gap_analysis Json?
+  /// Working tailoring state: the draft ResumeFormData, tailoring notes, the
+  /// pending contradiction awaiting resolution, and the question counter.
+  /// Scratch space only — the draft is materialised into `resume_data` when the
+  /// candidate saves it.
+  tailoring_draft        Json?
+
   @@index([user_id])
   @@index([file_hash])
+  @@index([user_id, status])
   @@schema("public")
 }
 
@@ -4336,6 +4437,8 @@ model User {
   created_by                      String
   updated_by                      String
   is_active                       Boolean                     @default(true)
+  /// Set when removed from team (Delete); null for active/inactive-only users.
+  deleted_at                      DateTime?
   is_self_registered              Boolean                     @default(true)
   permission_id                   String?                     @unique
   preferences                     Json?                       @default("{}")
@@ -4381,32 +4484,34 @@ model User {
   notes                           Notes[]
   recruiter_applications          Application[]               @relation("ApplicationRecruiter")
 
-  name                   String?
-  phone                  String?
+  name                              String?
+  phone                             String?
   /// Contact email for interviews, assessments, and resume export. Login stays on `email`.
-  communication_email    String?
-  description            String?
-  date_of_birth          DateTime?
-  designation            String?
-  location               String?
-  salary                 String?
-  work_experience        Json?
-  education              Json?
-  skills                 Json?
-  notice_period          String?
-  preferred_work_mode    String?
-  gender                 String?
-  ethnicity              String?
-  veteran_status         String?
-  disability_status      String?
-  professional_expertise String?
-  documents              Document[]
-  offers                 Offer[]    @relation("OfferCandidate")
+  communication_email               String?
+  description                       String?
+  date_of_birth                     DateTime?
+  designation                       String?
+  location                          String?
+  salary                            String?
+  work_experience                   Json?
+  education                         Json?
+  skills                            Json?
+  notice_period                     String?
+  preferred_work_mode               String?
+  gender                            String?
+  ethnicity                         String?
+  veteran_status                    String?
+  self_registered_organisation_name String?
+  disability_status                 String?
+  professional_expertise            String?
+  documents                         Document[]
+  offers                            Offer[]    @relation("OfferCandidate")
 
   employee_number Int?
   employee_code   String? @unique
 
-  department_members DepartmentMember[] @relation("DepartmentMemberships")
+  department_members    DepartmentMember[]    @relation("DepartmentMemberships")
+  assigned_hiring_units PurchasedHiringUnit[] @relation("AssignedHiringUnits")
 
   @@index([role_id])
   @@index([permission_id])