@adaptware/eagles-db 0.5.39 → 0.5.41

package/client/schema.prisma

@@ -414,53 +414,49 @@ 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)
-  fit_check_report_document_id  String?                    @unique
-  fit_check_report_updated_flag Boolean                    @default(false)
-  fit_check_report_data         Json?                      @default("{}")
-
+  created_at                DateTime                   @default(now())
+  updated_at                DateTime                   @updatedAt
+  created_by                String
+  updated_by                String
+  is_active                 Boolean                    @default(true)
   /// 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)
+  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)
+  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[]
@@ -470,7 +466,6 @@ model Application {
   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])
@@ -557,6 +552,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[]
@@ -1284,24 +1281,25 @@ enum HiringPlanSectionStatus {
 /// Replaces the free-text `business_unit` string on HiringPlanLine / Employee.
 /// Headship lives on DepartmentMember.is_head (at most one per dept, enforced in service).
 model Department {
-  id                String              @id @default(uuid())
-  organisation_id   String
-  name              String
-  code              String?
+  id                    String                @id @default(uuid())
+  organisation_id       String
+  name                  String
+  code                  String?
   /// Global display order across departments within the org (drag-reorder in plan grid).
-  sort_order        Int                 @default(0)
-  created_at        DateTime            @default(now())
-  updated_at        DateTime            @updatedAt
-  created_by        String
-  updated_by        String
-  is_active         Boolean             @default(true)
-  organisation      Organisation        @relation(fields: [organisation_id], references: [id], onDelete: Cascade, onUpdate: Cascade)
-  members           DepartmentMember[]
-  hiring_plan_lines HiringPlanLine[]
-  employees         Employee[]
-  job_descriptions  JobDescription[]
-  job_profiles      JobProfile[]
-  sections          HiringPlanSection[]
+  sort_order            Int                   @default(0)
+  created_at            DateTime              @default(now())
+  updated_at            DateTime              @updatedAt
+  created_by            String
+  updated_by            String
+  is_active             Boolean               @default(true)
+  organisation          Organisation          @relation(fields: [organisation_id], references: [id], onDelete: Cascade, onUpdate: Cascade)
+  members               DepartmentMember[]
+  hiring_plan_lines     HiringPlanLine[]
+  employees             Employee[]
+  job_descriptions      JobDescription[]
+  job_profiles          JobProfile[]
+  sections              HiringPlanSection[]
+  assigned_hiring_units PurchasedHiringUnit[]
 
   @@unique([organisation_id, name])
   @@index([organisation_id])
@@ -1405,7 +1403,6 @@ 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])
@@ -1448,8 +1445,17 @@ model EvaluationCriteria {
   @@schema("public")
 }
 
+/// MCQ / interview round classification on EvaluationPlan and analytics.
+/// ASSESSMENT is the legacy value kept for backward compatibility — do not drop it.
+/// GENERAL_APTITUDE_ASSESSMENT and DOMAIN_KNOWLEDGE_ASSESSMENT are explicit split
+/// types for new aptitude vs domain-knowledge MCQ rounds only.
 enum RoundType {
+  /// Legacy MCQ round type; existing plans and analytics may still use this.
   ASSESSMENT
+  /// New explicit general-aptitude MCQ round.
+  GENERAL_APTITUDE_ASSESSMENT
+  /// New explicit domain-knowledge MCQ round.
+  DOMAIN_KNOWLEDGE_ASSESSMENT
   INTERVIEW
   ASSIGNMENT
   SCREENING
@@ -2539,6 +2545,7 @@ model JobDescription {
   hiring_plan_line         HiringPlanLine?         @relation("PlanLineRequisitions", fields: [hiring_plan_line_id], references: [id], onDelete: SetNull, onUpdate: Cascade)
   /// Plan lines that use this JD as the role template/reference.
   referenced_by_plan_lines HiringPlanLine[]        @relation("PlanLineTemplateJd")
+  linked_hiring_units      PurchasedHiringUnit[]
 
   @@index([organisation_id])
   @@index([hiring_manager_id])
@@ -2730,6 +2737,353 @@ model JobRoundAnalyticsDaily {
   @@schema("analytics")
 }
 
+/// Append-only book of AI workflow cost (org pool, optionally a hiring unit).
+/// Covers every workflow (including license-included names). Amount is always USD.
+/// total_cost(unit) = SUM(DEBIT amount) - SUM(CREDIT amount) for that unit.
+/// CREDIT / PURCHASE is full package internal cost (USD) per hiring unit.
+/// DEBIT / USAGE is every workflow's Orion totalCost (USD), nothing excluded.
+model AiCostLedgerEntry {
+  id                       String                   @id @default(uuid())
+  organisation_id          String
+  purchased_hiring_unit_id String?
+  workflow_name            String
+  direction                LicensingLedgerDirection
+  /// Always non-negative. USD.
+  amount                   Decimal                  @db.Decimal(20, 4)
+  reason                   AiCostLedgerReason
+  occurred_at              DateTime                 @default(now())
+  source_type              String?
+  source_id                String?
+  description              String?
+  idempotency_key          String                   @unique
+  created_at               DateTime                 @default(now())
+  updated_at               DateTime                 @default(now()) @updatedAt
+  created_by               String
+  updated_by               String
+  is_active                Boolean                  @default(true)
+
+  organisation          Organisation         @relation(fields: [organisation_id], references: [id], onDelete: Restrict, onUpdate: Cascade)
+  purchased_hiring_unit PurchasedHiringUnit? @relation(fields: [purchased_hiring_unit_id], references: [id], onDelete: Restrict, onUpdate: Cascade)
+
+  @@index([purchased_hiring_unit_id, occurred_at], map: "ai_cost_ledger_unit_occurred_idx")
+  @@index([purchased_hiring_unit_id, workflow_name, occurred_at], map: "ai_cost_ledger_unit_workflow_occurred_idx")
+  @@index([organisation_id, occurred_at], map: "ai_cost_ledger_org_occurred_idx")
+  @@map("ai_cost_ledger")
+  @@schema("licensing")
+}
+
+/// Immutable assignment history for Hiring Unit department/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_job_description_id String?
+  new_job_description_id      String?
+  effective_at                DateTime                               @default(now())
+  created_by                  String
+
+  purchased_hiring_unit PurchasedHiringUnit @relation(fields: [purchased_hiring_unit_id], references: [id], onDelete: Restrict, onUpdate: Cascade)
+
+  @@index([purchased_hiring_unit_id], map: "purchased_hu_assignment_events_unit_id_idx")
+  @@index([purchased_hiring_unit_id, effective_at], map: "purchased_hu_assignment_events_unit_effective_idx")
+  @@map("purchased_hiring_unit_assignment_events")
+  @@schema("licensing")
+}
+
+/// Product catalogue: one wide row per (code, version) with fixed per-hiring-unit entitlements.
+/// See eagles-db/docs/eagles-db/licensing-catalog.md for column → usage metric_key mapping at purchase.
+model LicensePackage {
+  id                 String               @id @default(uuid())
+  code               String
+  version            Int
+  name               String
+  description        String?
+  price              Decimal              @db.Decimal(18, 2)
+  /// Internal cost of the package. Same currency as `currency`. Not for org-facing catalogue APIs.
+  cost_price         Decimal              @default(0) @db.Decimal(18, 2)
+  currency           String               @default("INR")
+  status             LicensePackageStatus @default(DRAFT)
+  /// Number of PurchasedHiringUnit rows created per package purchase.
+  units_per_purchase Int
+
+  /// Per-hiring-unit entitlements. null = not included; 0 = explicitly zero.
+  interview_ai_assisted_hours Decimal? @db.Decimal(20, 4)
+  interview_full_ai_hours     Decimal? @db.Decimal(20, 4)
+  interview_non_ai_hours      Decimal? @db.Decimal(20, 4)
+  assignment_count            Decimal? @db.Decimal(20, 4)
+  test_count                  Decimal? @db.Decimal(20, 4)
+  resume_count                Decimal? @db.Decimal(20, 4)
+  credits                     Decimal? @db.Decimal(20, 4)
+
+  created_at DateTime @default(now())
+  updated_at DateTime @updatedAt
+  created_by String
+  updated_by String
+  is_active  Boolean  @default(true)
+
+  purchased_license_packages PurchasedLicensePackage[]
+  organisations              LicensePackageOrganisation[]
+
+  @@unique([code, version])
+  @@index([code])
+  @@index([status])
+  @@map("license_packages")
+  @@schema("licensing")
+}
+
+/// Many-to-many: which organisations may see this catalogue package.
+/// Zero rows = visible to nobody except platform list (enforced later in eagles-backend).
+model LicensePackageOrganisation {
+  id                 String @id @default(uuid())
+  license_package_id String
+  organisation_id    String
+
+  created_at DateTime @default(now())
+  updated_at DateTime @updatedAt
+  created_by String
+  updated_by String
+  is_active  Boolean  @default(true)
+
+  license_package LicensePackage @relation(fields: [license_package_id], references: [id], onDelete: Restrict, onUpdate: Cascade)
+  organisation    Organisation   @relation(fields: [organisation_id], references: [id], onDelete: Restrict, onUpdate: Cascade)
+
+  @@unique([license_package_id, organisation_id], map: "license_package_orgs_pkg_org_key")
+  @@index([organisation_id])
+  @@map("license_package_organisations")
+  @@schema("licensing")
+}
+
+enum LicensePackageStatus {
+  DRAFT
+  ACTIVE
+  ARCHIVED
+
+  @@schema("licensing")
+}
+
+enum PurchasedLicensePackageStatus {
+  ACTIVE
+  EXPIRED
+  CANCELLED
+
+  @@schema("licensing")
+}
+
+enum PurchasedHiringUnitStatus {
+  AVAILABLE
+  ASSIGNED
+  ACTIVE
+  EXPIRED
+
+  @@schema("licensing")
+}
+
+enum PurchasedTopUpStatus {
+  ACTIVE
+  DEPLETED
+  CANCELLED
+
+  @@schema("licensing")
+}
+
+enum PurchasedHiringUnitAssignmentEventKind {
+  DEPARTMENT_ASSIGNED
+  DEPARTMENT_UNASSIGNED
+  JOB_LINKED
+  JOB_UNLINKED
+
+  @@schema("licensing")
+}
+
+enum LicensingLedgerEntitlementType {
+  INTERVIEW_AI_ASSISTED_HOURS
+  INTERVIEW_FULL_AI_HOURS
+  INTERVIEW_NON_AI_HOURS
+  ASSIGNMENT_COUNT
+  TEST_COUNT
+  RESUME_COUNT
+  CREDITS
+
+  @@schema("licensing")
+}
+
+enum LicensingLedgerDirection {
+  CREDIT
+  DEBIT
+
+  @@schema("licensing")
+}
+
+enum LicensingLedgerReason {
+  PURCHASE
+  TOP_UP
+  USAGE
+  ADJUSTMENT
+  REFUND
+  EXPIRY
+
+  @@schema("licensing")
+}
+
+enum AiCostLedgerReason {
+  PURCHASE
+  USAGE
+  ADJUSTMENT
+  REFUND
+
+  @@schema("licensing")
+}
+
+/// Append-only book of hiring-unit entitlement movements.
+/// remaining(unit, type) = SUM(CREDIT amount) - SUM(DEBIT amount).
+/// See eagles-db/docs/eagles-db/licensing-hiring-unit.md.
+model LicensingLedgerEntry {
+  id                       String                         @id @default(uuid())
+  organisation_id          String
+  /// Null for org-level rows (e.g. unallocated top-ups later).
+  purchased_hiring_unit_id String?
+  entitlement_type         LicensingLedgerEntitlementType
+  direction                LicensingLedgerDirection
+  /// Always non-negative. CREDIT of 0 means the stem is included at zero.
+  amount                   Decimal                        @db.Decimal(20, 4)
+  reason                   LicensingLedgerReason
+  occurred_at              DateTime                       @default(now())
+  source_type              String?
+  source_id                String?
+  description              String?
+  idempotency_key          String                         @unique
+  created_at               DateTime                       @default(now())
+  updated_at               DateTime                       @default(now()) @updatedAt
+  created_by               String
+  updated_by               String
+  is_active                Boolean                        @default(true)
+
+  organisation          Organisation         @relation(fields: [organisation_id], references: [id], onDelete: Restrict, onUpdate: Cascade)
+  purchased_hiring_unit PurchasedHiringUnit? @relation(fields: [purchased_hiring_unit_id], references: [id], onDelete: Restrict, onUpdate: Cascade)
+
+  @@index([purchased_hiring_unit_id, entitlement_type, occurred_at], map: "licensing_ledger_unit_type_occurred_idx")
+  @@index([organisation_id, entitlement_type, occurred_at], map: "licensing_ledger_org_type_occurred_idx")
+  @@map("licensing_ledger")
+  @@schema("licensing")
+}
+
+/// Historical package purchase by an organisation (independent per transaction).
+model PurchasedLicensePackage {
+  id                 String                        @id @default(uuid())
+  organisation_id    String
+  license_package_id String
+  /// Snapshot of catalogue identity at purchase time.
+  package_code       String
+  package_version    Int
+  package_name       String
+  price              Decimal                       @db.Decimal(18, 2)
+  currency           String                        @default("INR")
+  units_per_purchase Int
+  /// How many package instances were bought in this transaction.
+  package_quantity   Int                           @default(1)
+  purchased_at       DateTime                      @default(now())
+  status             PurchasedLicensePackageStatus @default(ACTIVE)
+  created_at         DateTime                      @default(now())
+  updated_at         DateTime                      @updatedAt
+  created_by         String
+  updated_by         String
+  is_active          Boolean                       @default(true)
+
+  organisation    Organisation          @relation(fields: [organisation_id], references: [id], onDelete: Restrict, onUpdate: Cascade)
+  license_package LicensePackage        @relation(fields: [license_package_id], references: [id], onDelete: Restrict, onUpdate: Cascade)
+  hiring_units    PurchasedHiringUnit[]
+
+  @@index([organisation_id])
+  @@index([organisation_id, status])
+  @@index([organisation_id, purchased_at])
+  @@map("purchased_license_packages")
+  @@schema("licensing")
+}
+
+/// Runtime hiring unit identity and allocation. Entitlement balances live on
+/// `licensing.licensing_ledger` (Prisma model `LicensingLedgerEntry`).
+/// See eagles-db/docs/eagles-db/licensing-hiring-unit.md.
+model PurchasedHiringUnit {
+  id                           String                    @id @default(uuid())
+  organisation_id              String
+  purchased_license_package_id String
+  status                       PurchasedHiringUnitStatus @default(AVAILABLE)
+  /// Current department allocation (licensing allocation, not hiring manager).
+  department_id                String?
+  /// Set once when department_id is first assigned; not cleared on reassignment.
+  first_assigned_at            DateTime?
+  /// Optional unit expiry.
+  expiry_at                    DateTime?
+  /// Optional job association (distinct from JobDescription.hiring_manager_id).
+  job_description_id           String?
+
+  created_at DateTime @default(now())
+  updated_at DateTime @updatedAt
+  created_by String
+  updated_by String
+  is_active  Boolean  @default(true)
+
+  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)
+  job_description           JobDescription?                      @relation(fields: [job_description_id], references: [id], onDelete: SetNull, onUpdate: Cascade)
+  assignment_events         PurchasedHiringUnitAssignmentEvent[]
+  ledger_entries            LicensingLedgerEntry[]
+  ai_cost_ledger_entries    AiCostLedgerEntry[]
+
+  @@index([organisation_id])
+  @@index([purchased_license_package_id])
+  @@index([department_id])
+  @@index([job_description_id])
+  @@index([organisation_id, status])
+  @@index([organisation_id, department_id])
+  @@index([organisation_id, job_description_id])
+  @@map("purchased_hiring_units")
+  @@schema("licensing")
+}
+
+/// Wide top-up purchase: org-level per-metric pool (purchased / remaining) before allocation to hiring units.
+model PurchasedTopUp {
+  id              String               @id @default(uuid())
+  organisation_id String
+  purchased_at    DateTime             @default(now())
+  status          PurchasedTopUpStatus @default(ACTIVE)
+  total_price     Decimal?             @db.Decimal(18, 2)
+  currency        String?              @default("INR")
+  description     String?
+
+  interview_ai_assisted_hours_purchased Decimal? @db.Decimal(20, 4)
+  interview_full_ai_hours_purchased     Decimal? @db.Decimal(20, 4)
+  interview_non_ai_hours_purchased      Decimal? @db.Decimal(20, 4)
+  assignment_count_purchased            Decimal? @db.Decimal(20, 4)
+  test_count_purchased                  Decimal? @db.Decimal(20, 4)
+  resume_count_purchased                Decimal? @db.Decimal(20, 4)
+  credits_purchased                     Decimal? @db.Decimal(20, 4)
+
+  interview_ai_assisted_hours_remaining Decimal? @db.Decimal(20, 4)
+  interview_full_ai_hours_remaining     Decimal? @db.Decimal(20, 4)
+  interview_non_ai_hours_remaining      Decimal? @db.Decimal(20, 4)
+  assignment_count_remaining            Decimal? @db.Decimal(20, 4)
+  test_count_remaining                  Decimal? @db.Decimal(20, 4)
+  resume_count_remaining                Decimal? @db.Decimal(20, 4)
+  credits_remaining                     Decimal? @db.Decimal(20, 4)
+
+  created_at DateTime @default(now())
+  updated_at DateTime @updatedAt
+  created_by String
+  updated_by String
+  is_active  Boolean  @default(true)
+
+  organisation Organisation @relation(fields: [organisation_id], references: [id], onDelete: Restrict, onUpdate: Cascade)
+
+  @@index([organisation_id])
+  @@index([organisation_id, status])
+  @@map("purchased_top_ups")
+  @@schema("licensing")
+}
+
 model LiveAnalysis {
   id           String    @id @default(uuid())
   //foreign keys
@@ -3152,65 +3506,71 @@ enum OrganisationSize {
 }
 
 model Organisation {
-  id                        String                   @id @default(uuid())
-  name                      String                   @unique
-  industry                  String
-  about                     String
-  website                   String
-  size                      OrganisationSize         @default(ONE_TO_TEN)
-  phone                     String
-  address                   String
-  company_values            Json[]
-  allowed_email_domains     String[]
-  send_email                Boolean                  @default(true)
-  interviewers              User[]
-  created_at                DateTime                 @default(now())
-  updated_at                DateTime                 @updatedAt
-  created_by                String
-  updated_by                String
-  is_active                 Boolean                  @default(true)
-  alias                     String?                  @unique
-  logo                      String?
-  job_sequence              Int                      @default(1)
-  employee_sequence         Int                      @default(1)
-  applications              Application[]
-  user_roles                UserRole[]
-  job_descriptions          JobDescription[]
-  job_profiles              JobProfile[]
-  assessment_library        AssessmentLibrary[]
-  assignment_library        AssignmentLibrary[]
-  interviews                Interview[]
-  assignments               Assignment[]
-  fit_check                 FitCheck[] //  one-to-many link
-  resumes                   Resume[] // one-to-many link
-  approvals                 Approval[] // one-to-many link
-  suggestions               Suggestion[]
-  ongoing_evaluations       OngoingEvaluation[] // optional one-to-many
-  actions                   Action[]
-  integration_credentials   IntegrationCredential[]
-  zoho_sync_mappings        ZohoSyncMapping[]
-  assessments               Assessment[]
-  timezone                  String                   @default("Asia/Kolkata")
+  id                            String                       @id @default(uuid())
+  name                          String                       @unique
+  industry                      String
+  about                         String
+  website                       String
+  size                          OrganisationSize             @default(ONE_TO_TEN)
+  phone                         String
+  address                       String
+  company_values                Json[]
+  allowed_email_domains         String[]
+  send_email                    Boolean                      @default(true)
+  interviewers                  User[]
+  created_at                    DateTime                     @default(now())
+  updated_at                    DateTime                     @updatedAt
+  created_by                    String
+  updated_by                    String
+  is_active                     Boolean                      @default(true)
+  alias                         String?                      @unique
+  logo                          String?
+  job_sequence                  Int                          @default(1)
+  employee_sequence             Int                          @default(1)
+  applications                  Application[]
+  user_roles                    UserRole[]
+  job_descriptions              JobDescription[]
+  job_profiles                  JobProfile[]
+  assessment_library            AssessmentLibrary[]
+  assignment_library            AssignmentLibrary[]
+  interviews                    Interview[]
+  assignments                   Assignment[]
+  fit_check                     FitCheck[] //  one-to-many link
+  resumes                       Resume[] // one-to-many link
+  approvals                     Approval[] // one-to-many link
+  suggestions                   Suggestion[]
+  ongoing_evaluations           OngoingEvaluation[] // optional one-to-many
+  actions                       Action[]
+  integration_credentials       IntegrationCredential[]
+  zoho_sync_mappings            ZohoSyncMapping[]
+  assessments                   Assessment[]
+  timezone                      String                       @default("Asia/Kolkata")
   /// ISO 3166-1 alpha-2 (e.g. IN).
-  country_code              String                   @default("IN")
-  organisation_configs      OrganisationConfig[]
-  activity_events           ActivityEvent[]
-  usage_ledger_entries      UsageLedgerEntry[]
-  usage_aggregates          UsageAggregate[]
-  channel_provider_configs  ChannelProviderConfig[]
-  conversations             Conversation[]
-  communication_messages    CommunicationMessage[]
-  job_application_fields    JobApplicationField[]
-  documents                 Document[]
-  job_application_templates JobApplicationTemplate[]
-  offer_letter_templates    OfferLetterTemplate[]
-  offers                    Offer[]
-  sources                   Source[]
-  evaluation_criteria       EvaluationCriteria[]
-  departments               Department[]
-  hiring_plans              HiringPlan[]
-  employees                 Employee[]
-  competency_dictionaries   CompetencyDictionary[]
+  country_code                  String                       @default("IN")
+  organisation_configs          OrganisationConfig[]
+  activity_events               ActivityEvent[]
+  usage_ledger_entries          UsageLedgerEntry[]
+  usage_aggregates              UsageAggregate[]
+  channel_provider_configs      ChannelProviderConfig[]
+  conversations                 Conversation[]
+  communication_messages        CommunicationMessage[]
+  job_application_fields        JobApplicationField[]
+  documents                     Document[]
+  job_application_templates     JobApplicationTemplate[]
+  offer_letter_templates        OfferLetterTemplate[]
+  offers                        Offer[]
+  sources                       Source[]
+  evaluation_criteria           EvaluationCriteria[]
+  departments                   Department[]
+  hiring_plans                  HiringPlan[]
+  employees                     Employee[]
+  competency_dictionaries       CompetencyDictionary[]
+  purchased_license_packages    PurchasedLicensePackage[]
+  purchased_hiring_units        PurchasedHiringUnit[]
+  purchased_top_ups             PurchasedTopUp[]
+  licensing_ledger_entries      LicensingLedgerEntry[]
+  license_package_organisations LicensePackageOrganisation[]
+  ai_cost_ledger_entries        AiCostLedgerEntry[]
 
   @@index([name])
   @@schema("public")
@@ -3367,12 +3727,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
@@ -3389,6 +3761,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")
 }
 
@@ -3675,7 +4048,7 @@ datasource db {
   provider = "postgresql"
   url      = env("DATABASE_URL")
 
-  schemas = ["public", "analytics", "usage"]
+  schemas = ["public", "analytics", "usage", "licensing"]
 }
 
 enum SourceCategory {