@adaptware/eagles-db 0.5.47 → 0.5.49

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adaptware/eagles-db",
-  "version": "0.5.47",
+  "version": "0.5.49",
   "description": "A Prisma client package for Treadspace database operations",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/prisma/migrations/20260519120000_migrate_shortlisted_to_selected/migration.sql

@@ -0,0 +1,2 @@
+-- Migrate legacy terminal-positive status to SELECTED (SHORTLISTED enum value retained but unused).
+UPDATE applications SET status = 'SELECTED' WHERE status = 'SHORTLISTED';

package/prisma/schema/interview.prisma

@@ -25,57 +25,58 @@ enum AiAssistanceMode {
 }
 
 model Interview {
-  id                        String            @id @default(uuid())
+  id                            String            @id @default(uuid())
   /// Foreign keys
-  organisation_id           String
-  candidate_id              String
-  interviewer_id            String?
-  evaluation_plan_id        String
-  application_id            String?
-  resume_id                 String
-  job_description_id        String
-  calendar_event_id         String?
+  organisation_id               String
+  candidate_id                  String
+  interviewer_id                String?
+  evaluation_plan_id            String
+  application_id                String?
+  resume_id                     String
+  job_description_id            String
+  calendar_event_id             String?
+  calendar_events               Json?
   /// Data
-  room_name                 String?
+  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?
-  actual_end_time           DateTime?
+  interview_summary             String[]
+  scheduled_start_time          DateTime?
+  scheduled_end_time            DateTime?
+  actual_start_time             DateTime?
+  actual_end_time               DateTime?
   /// Interview length in minutes (source of truth; not derived from schedule window).
-  duration                  Int?
+  duration                      Int?
   /// @deprecated Prefer `recording_document_id` + `Document` (type INTERVIEW_RECORDING).
-  recording_url             String?
-  recording_document_id     String?           @unique
-  evaluation_type           EvaluationType?   @default(TREADSPACE_AI_ASSISTED)
-  ai_assistance_mode        AiAssistanceMode? @default(ASSISTED)
-  interview_status          InterviewStatus   @default(SCHEDULED)
-  interview_platform        InterviewPlatform @default(TREADSPACE)
-  overall_feedback          String?
+  recording_url                 String?
+  recording_document_id         String?           @unique
+  evaluation_type               EvaluationType?   @default(TREADSPACE_AI_ASSISTED)
+  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`).
-  ai_feedback               Json?
-  human_feedback            Json?
-  section_feedback          Json[]
-  interview_preparation     Json?
-  final_feedback            Json?
-  interview_analysis_ranges Json?
-  interview_flow_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?
   /// When Orion AI feedback was last persisted on this interview.
-  ai_feedback_generated_at  DateTime?
+  ai_feedback_generated_at      DateTime?
   /// Experimental Beta AI feedback store (parallel to production AI columns).
   /// Used by Beta Feedback page so regenerating AI does not overwrite production.
-  beta_ai_feedback               Json?
-  beta_section_feedback          Json[]    @default([])
-  beta_final_feedback            Json?
-  beta_interview_flow_summary    String?
-  beta_ai_feedback_generated_at  DateTime?
+  beta_ai_feedback              Json?
+  beta_section_feedback         Json[]            @default([])
+  beta_final_feedback           Json?
+  beta_interview_flow_summary   String?
+  beta_ai_feedback_generated_at DateTime?
   /// When recruiter human feedback was last saved (draft or final).
-  human_feedback_updated_at DateTime?
+  human_feedback_updated_at     DateTime?
   /// When final human feedback was submitted.
-  evaluated_at              DateTime?
+  evaluated_at                  DateTime?
 
   /// Self-scheduling
   reschedule_count          Int                @default(0)

package/prisma/schema/licensing/assignmentHistory.prisma

@@ -1,10 +1,12 @@
-/// 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())

package/prisma/schema/licensing/licensingEnums.prisma

@@ -34,6 +34,8 @@ enum PurchasedTopUpStatus {
 enum PurchasedHiringUnitAssignmentEventKind {
   DEPARTMENT_ASSIGNED
   DEPARTMENT_UNASSIGNED
+  USER_ASSIGNED
+  USER_UNASSIGNED
   JOB_LINKED
   JOB_UNLINKED
 

package/prisma/schema/licensing/purchasedLicense.prisma

@@ -41,6 +41,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.
@@ -57,6 +59,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[]
@@ -65,9 +68,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")

package/prisma/schema/migrations/20260911120000_hiring_unit_assignment_scope/migration.sql

@@ -0,0 +1,38 @@
+-- Org policy for who may consume unused hiring units, plus optional user
+-- reservation on each hiring unit. No row rewrite / backfill: existing units
+-- stay department-only (assigned_user_id NULL). Scope default DEPARTMENT
+-- matches current assign-to-department behaviour.
+
+-- CreateEnum
+CREATE TYPE "public"."HiringUnitAssignmentScope" AS ENUM ('USER', 'DEPARTMENT', 'ORGANISATION');
+
+-- AlterTable
+ALTER TABLE "Organisation"
+ADD COLUMN "hiring_unit_assignment_scope" "public"."HiringUnitAssignmentScope" NOT NULL DEFAULT 'DEPARTMENT';
+
+-- AlterEnum
+-- Postgres 12+ permits ADD VALUE inside the migration transaction as long as
+-- the new value is not also used there.
+ALTER TYPE "licensing"."PurchasedHiringUnitAssignmentEventKind" ADD VALUE 'USER_ASSIGNED';
+ALTER TYPE "licensing"."PurchasedHiringUnitAssignmentEventKind" ADD VALUE 'USER_UNASSIGNED';
+
+-- AlterTable
+ALTER TABLE "licensing"."purchased_hiring_units"
+ADD COLUMN "assigned_user_id" TEXT;
+
+ALTER TABLE "licensing"."purchased_hiring_unit_assignment_events"
+ADD COLUMN "previous_assigned_user_id" TEXT,
+ADD COLUMN "new_assigned_user_id" TEXT;
+
+-- CreateIndex
+CREATE INDEX "purchased_hiring_units_assigned_user_id_idx"
+  ON "licensing"."purchased_hiring_units"("assigned_user_id");
+
+CREATE INDEX "purchased_hiring_units_organisation_id_assigned_user_id_idx"
+  ON "licensing"."purchased_hiring_units"("organisation_id", "assigned_user_id");
+
+-- AddForeignKey
+ALTER TABLE "licensing"."purchased_hiring_units"
+ADD CONSTRAINT "purchased_hiring_units_assigned_user_id_fkey"
+FOREIGN KEY ("assigned_user_id") REFERENCES "User"("id")
+ON DELETE SET NULL ON UPDATE CASCADE;

package/prisma/schema/organisation.prisma

@@ -8,6 +8,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
@@ -50,6 +59,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[]

package/prisma/schema/user.prisma

@@ -100,7 +100,8 @@ model User {
   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])