@adaptware/eagles-db 0.5.48 → 0.5.49

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adaptware/eagles-db",
-  "version": "0.5.48",
+  "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/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])