@adaptware/eagles-db 0.5.11 → 0.5.14

package/package.json

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

package/prisma/schema/applications.prisma

@@ -14,39 +14,48 @@ enum ApplicationStatus {
 }
 
 model Application {
+  /// Primary key
   id                        String                   @id @default(uuid())
+  /// Foreign keys
+  organisation_id           String
   candidate_id              String
   resume_id                 String
-  organisation_id           String
   job_description_id        String
-  fit_check_score           Float?
-  applied_at                DateTime                 @default(now())
   evaluation_plan_id        String?
-  fit_check_id              String?                  @unique
   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)
-  //Screening fields
-  on_notice_period          Boolean                  @default(false)
-  expected_joining_date     DateTime?
-  current_ctc               String?
-  expected_ctc              String?
-  notice_period             Int?
-  preferred_location        String?
   evaluationComment         String?
-  // Relations
+  /// 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)
   /// Mirror of Offer.status for list filters and combined status chips
   offer_status              OfferStatus?
+  /// Audit fields
+  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)
-  fit_check                 FitCheck?                @relation(fields: [fit_check_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[]
@@ -58,16 +67,14 @@ model Application {
   communication_messages    CommunicationMessage[]
   job_application_responses JobApplicationResponse[]
   offer                     Offer?
-  // Audit fields
-  created_at                DateTime                 @default(now())
-  updated_at                DateTime                 @updatedAt
-  created_by                String
-  updated_by                String
-  is_active                 Boolean                  @default(true)
 
   @@unique([candidate_id, job_description_id]) // Ensures candidate applies only once per job
   @@index([candidate_id])
   @@index([job_description_id])
   @@index([source_id])
+  @@index([organisation_id, is_flagged])
+  @@index([job_description_id, is_flagged])
+  @@index([organisation_id, is_active, status])
+  @@index([job_description_id, is_active, status])
   @@schema("public")
 }

package/prisma/schema/competencyDictionary.prisma

@@ -0,0 +1,38 @@
+enum CompetencyCategory {
+  TECHNICAL
+  BEHAVIOURAL
+  AI
+
+  @@schema("public")
+}
+
+model CompetencyDictionary {
+  /// Primary key
+  id              String             @id @default(uuid())
+  /// Foreign keys
+  organisation_id String?
+  /// Data fields
+  category        CompetencyCategory
+  industry        String
+  name            String
+  description     String?
+  /// Proficiency ladder definitions (competency-specific text)
+  level1          String?
+  level2          String?
+  level3          String?
+  level4          String?
+  level5          String?
+  metadata        Json?
+  /// Audit fields
+  created_by      String
+  updated_by      String
+  created_at      DateTime           @default(now())
+  updated_at      DateTime           @updatedAt
+  is_active       Boolean            @default(true)
+  /// Relations
+  organisation    Organisation?      @relation(fields: [organisation_id], references: [id], onDelete: Cascade, onUpdate: Cascade)
+
+  @@index([organisation_id])
+  @@index([organisation_id, category])
+  @@schema("public")
+}

package/prisma/schema/fitCheck.prisma

@@ -8,51 +8,33 @@ enum FitCheckStatus {
 
 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
-
-  /// Old Fields will be deprecated soon
-  skills_match             String[]
-  responsibilities_match   String[]
-  responsibilities_score   Float?
-  experience_match         String[]
-  experience_score         Float?
-  organisation_value_score Float?
-  organisation_value_match String[]
-  qualifications_match     String[]
-  qualifications_score     Float?
-  fit                      Json[]
-  fit_check_status         FitCheckStatus?
-  // Fields to be used now
-  skills_analysis          Json?
-  overall_analysis         Json?
-  skills_score             Float?
-  overall_score            Float
-  short_match_analysis     Json[]
-  fit_comparison           Json?
-  recommendation           Json?
-  // New Fields needs to be changed now
-  candidate_analysis       Json[]
-  technical_analysis       Json[]
-  competency_analysis      Json[]
-
+  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
+  skills_analysis       Json?
+  overall_analysis      Json?
+  overall_score         Float
+  short_match_analysis  Json[]
+  fit_comparison        Json?
+  recommendation        Json?
+  competencies_analysis Json?
   /// Audit fields
-  created_by      String
-  updated_by      String
-  is_active       Boolean        @default(true)
-  /// Timestamps
-  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
   /// 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?
+  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])

package/prisma/schema/interview.prisma

@@ -107,5 +107,7 @@ model Interview {
   @@index([candidate_id])
   @@index([interviewer_id])
   @@index([job_description_id])
+  @@index([organisation_id, interview_status])
+  @@index([interview_status, scheduled_start_time])
   @@schema("public")
 }

package/prisma/schema/jobDescription.prisma

@@ -78,5 +78,6 @@ model JobDescription {
   @@index([job_profile_id])
   @@index([hiring_plan_line_id])
   @@index([department_id])
+  @@index([organisation_id, status])
   @@schema("public")
 }

package/prisma/schema/migrations/20260522120000_ongoing_evaluation_record_kind/migration.sql

@@ -0,0 +1,25 @@
+-- Safe to re-run: adds record_kind without breaking existing ongoing evaluations.
+
+DO $$ BEGIN
+  CREATE TYPE "OngoingEvaluationRecordKind" AS ENUM (
+    'AI_RECOMMENDED',
+    'PLAN_SELECTED',
+    'COMMITTED'
+  );
+EXCEPTION
+  WHEN duplicate_object THEN NULL;
+END $$;
+
+ALTER TABLE "OngoingEvaluation"
+  ADD COLUMN IF NOT EXISTS "record_kind" "OngoingEvaluationRecordKind";
+
+ALTER TABLE "OngoingEvaluation"
+  ALTER COLUMN "evaluation_plan_id" DROP NOT NULL;
+
+-- All existing rows are real pipeline rounds — not pre-Proceed drafts.
+UPDATE "OngoingEvaluation"
+SET "record_kind" = 'COMMITTED'
+WHERE "record_kind" IS NULL;
+
+CREATE INDEX IF NOT EXISTS "OngoingEvaluation_application_id_record_kind_idx"
+  ON "OngoingEvaluation"("application_id", "record_kind");

package/prisma/schema/migrations/20260523120000_replace_record_kind_with_is_committed/migration.sql

@@ -0,0 +1,24 @@
+-- Replace record_kind enum with is_committed (null = legacy, false = draft, true = committed).
+
+ALTER TABLE "OngoingEvaluation"
+  ADD COLUMN IF NOT EXISTS "is_committed" BOOLEAN;
+
+UPDATE "OngoingEvaluation"
+SET "is_committed" = false
+WHERE "record_kind" IN ('AI_RECOMMENDED', 'PLAN_SELECTED');
+
+UPDATE "OngoingEvaluation"
+SET "is_committed" = true
+WHERE "record_kind" = 'COMMITTED';
+
+-- Legacy rows without record_kind stay null (treated as committed in app queries).
+
+DROP INDEX IF EXISTS "OngoingEvaluation_application_id_record_kind_idx";
+
+ALTER TABLE "OngoingEvaluation"
+  DROP COLUMN IF EXISTS "record_kind";
+
+DROP TYPE IF EXISTS "OngoingEvaluationRecordKind";
+
+CREATE INDEX IF NOT EXISTS "OngoingEvaluation_application_id_is_committed_idx"
+  ON "OngoingEvaluation"("application_id", "is_committed");

package/prisma/schema/migrations/20260528120000_drop_job_description_recommendation_config/migration.sql

@@ -0,0 +1,2 @@
+-- Drop unused per-job AI recommendation threshold storage (defaults live in application code).
+ALTER TABLE "JobDescription" DROP COLUMN IF EXISTS "recommendation_config";

package/prisma/schema/migrations/20260710120000_add_resume_rendered_export_fields/migration.sql

@@ -0,0 +1,9 @@
+-- AlterTable
+ALTER TABLE "Resume" ADD COLUMN "rendered_export_document_id" TEXT,
+ADD COLUMN "resume_template_id" TEXT;
+
+-- CreateIndex
+CREATE UNIQUE INDEX "Resume_rendered_export_document_id_key" ON "Resume"("rendered_export_document_id");
+
+-- AddForeignKey
+ALTER TABLE "Resume" ADD CONSTRAINT "Resume_rendered_export_document_id_fkey" FOREIGN KEY ("rendered_export_document_id") REFERENCES "Document"("id") ON DELETE SET NULL ON UPDATE CASCADE;

package/prisma/schema/migrations/20260714120000_add_job_description_display_html_document/migration.sql

@@ -0,0 +1,8 @@
+-- AlterTable
+ALTER TABLE "JobDescription" ADD COLUMN "display_html_document_id" TEXT;
+
+-- CreateIndex
+CREATE UNIQUE INDEX "JobDescription_display_html_document_id_key" ON "JobDescription"("display_html_document_id");
+
+-- AddForeignKey
+ALTER TABLE "JobDescription" ADD CONSTRAINT "JobDescription_display_html_document_id_fkey" FOREIGN KEY ("display_html_document_id") REFERENCES "Document"("id") ON DELETE SET NULL ON UPDATE CASCADE;

package/prisma/schema/migrations/20260716120000_add_offer_letters/migration.sql

@@ -0,0 +1,183 @@
+-- CreateEnum
+CREATE TYPE "OfferSubstatus" AS ENUM ('OFFER_CREATED', 'OFFER_SENT', 'VIEWED', 'CHANGE_REQUESTED', 'ACCEPTED', 'DECLINED', 'EXPIRED', 'WITHDRAWN', 'JOINED');
+
+-- CreateEnum
+CREATE TYPE "OfferLetterTemplateScope" AS ENUM ('ORGANIZATION', 'JOB');
+
+-- CreateEnum
+CREATE TYPE "OfferChangeCategory" AS ENUM ('BUDGET', 'BENEFITS', 'JOINING_DATE', 'ROLE_TITLE', 'LOCATION', 'OTHER');
+
+-- CreateEnum
+CREATE TYPE "OfferChangeRequestStatus" AS ENUM ('OPEN', 'ADDRESSED');
+
+-- AlterTable
+ALTER TABLE "Application" ADD COLUMN "offer_substatus" "OfferSubstatus";
+
+-- CreateTable
+CREATE TABLE "OfferLetterTemplate" (
+    "id" TEXT NOT NULL,
+    "organisation_id" TEXT NOT NULL,
+    "job_description_id" TEXT,
+    "name" TEXT NOT NULL,
+    "description" TEXT,
+    "document_id" TEXT NOT NULL,
+    "html_document_id" TEXT,
+    "scope" "OfferLetterTemplateScope" NOT NULL DEFAULT 'ORGANIZATION',
+    "is_default" BOOLEAN NOT NULL DEFAULT false,
+    "is_active" BOOLEAN NOT NULL DEFAULT true,
+    "created_by" TEXT NOT NULL,
+    "updated_by" TEXT NOT NULL,
+    "created_at" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updated_at" TIMESTAMP(3) NOT NULL,
+
+    CONSTRAINT "OfferLetterTemplate_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "Offer" (
+    "id" TEXT NOT NULL,
+    "application_id" TEXT NOT NULL,
+    "organisation_id" TEXT NOT NULL,
+    "candidate_id" TEXT NOT NULL,
+    "job_description_id" TEXT NOT NULL,
+    "template_id" TEXT,
+    "substatus" "OfferSubstatus" NOT NULL DEFAULT 'OFFER_CREATED',
+    "letter_version_count" INTEGER NOT NULL DEFAULT 0,
+    "change_request_count" INTEGER NOT NULL DEFAULT 0,
+    "terms" JSONB NOT NULL DEFAULT '{}',
+    "expires_at" TIMESTAMP(3),
+    "is_active" BOOLEAN NOT NULL DEFAULT true,
+    "created_by" TEXT NOT NULL,
+    "updated_by" TEXT NOT NULL,
+    "created_at" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updated_at" TIMESTAMP(3) NOT NULL,
+
+    CONSTRAINT "Offer_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "OfferLetter" (
+    "id" TEXT NOT NULL,
+    "offer_id" TEXT NOT NULL,
+    "version" INTEGER NOT NULL,
+    "document_id" TEXT NOT NULL,
+    "template_id" TEXT,
+    "template_document_id" TEXT,
+    "sent_at" TIMESTAMP(3),
+    "viewed_at" TIMESTAMP(3),
+    "change_request_note" TEXT,
+    "is_active" BOOLEAN NOT NULL DEFAULT true,
+    "created_by" TEXT NOT NULL,
+    "updated_by" TEXT NOT NULL,
+    "created_at" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updated_at" TIMESTAMP(3) NOT NULL,
+
+    CONSTRAINT "OfferLetter_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "OfferChangeRequest" (
+    "id" TEXT NOT NULL,
+    "offer_id" TEXT NOT NULL,
+    "offer_letter_id" TEXT NOT NULL,
+    "categories" "OfferChangeCategory"[],
+    "note" TEXT,
+    "status" "OfferChangeRequestStatus" NOT NULL DEFAULT 'OPEN',
+    "created_by" TEXT NOT NULL,
+    "updated_by" TEXT NOT NULL,
+    "created_at" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updated_at" TIMESTAMP(3) NOT NULL,
+
+    CONSTRAINT "OfferChangeRequest_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateIndex
+CREATE INDEX "OfferLetterTemplate_organisation_id_scope_idx" ON "OfferLetterTemplate"("organisation_id", "scope");
+
+-- CreateIndex
+CREATE INDEX "OfferLetterTemplate_job_description_id_idx" ON "OfferLetterTemplate"("job_description_id");
+
+-- CreateIndex
+CREATE INDEX "OfferLetterTemplate_document_id_idx" ON "OfferLetterTemplate"("document_id");
+
+-- CreateIndex
+CREATE INDEX "OfferLetterTemplate_html_document_id_idx" ON "OfferLetterTemplate"("html_document_id");
+
+-- CreateIndex
+CREATE UNIQUE INDEX "Offer_application_id_key" ON "Offer"("application_id");
+
+-- CreateIndex
+CREATE INDEX "Offer_organisation_id_idx" ON "Offer"("organisation_id");
+
+-- CreateIndex
+CREATE INDEX "Offer_candidate_id_idx" ON "Offer"("candidate_id");
+
+-- CreateIndex
+CREATE INDEX "Offer_job_description_id_idx" ON "Offer"("job_description_id");
+
+-- CreateIndex
+CREATE INDEX "Offer_substatus_idx" ON "Offer"("substatus");
+
+-- CreateIndex
+CREATE UNIQUE INDEX "OfferLetter_document_id_key" ON "OfferLetter"("document_id");
+
+-- CreateIndex
+CREATE INDEX "OfferLetter_offer_id_idx" ON "OfferLetter"("offer_id");
+
+-- CreateIndex
+CREATE INDEX "OfferLetter_template_id_idx" ON "OfferLetter"("template_id");
+
+-- CreateIndex
+CREATE UNIQUE INDEX "OfferLetter_offer_id_version_key" ON "OfferLetter"("offer_id", "version");
+
+-- CreateIndex
+CREATE INDEX "OfferChangeRequest_offer_id_status_idx" ON "OfferChangeRequest"("offer_id", "status");
+
+-- CreateIndex
+CREATE INDEX "OfferChangeRequest_offer_letter_id_idx" ON "OfferChangeRequest"("offer_letter_id");
+
+-- AddForeignKey
+ALTER TABLE "OfferLetterTemplate" ADD CONSTRAINT "OfferLetterTemplate_organisation_id_fkey" FOREIGN KEY ("organisation_id") REFERENCES "Organisation"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "OfferLetterTemplate" ADD CONSTRAINT "OfferLetterTemplate_job_description_id_fkey" FOREIGN KEY ("job_description_id") REFERENCES "JobDescription"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "OfferLetterTemplate" ADD CONSTRAINT "OfferLetterTemplate_document_id_fkey" FOREIGN KEY ("document_id") REFERENCES "Document"("id") ON DELETE RESTRICT ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "OfferLetterTemplate" ADD CONSTRAINT "OfferLetterTemplate_html_document_id_fkey" FOREIGN KEY ("html_document_id") REFERENCES "Document"("id") ON DELETE SET NULL ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "Offer" ADD CONSTRAINT "Offer_application_id_fkey" FOREIGN KEY ("application_id") REFERENCES "Application"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "Offer" ADD CONSTRAINT "Offer_organisation_id_fkey" FOREIGN KEY ("organisation_id") REFERENCES "Organisation"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "Offer" ADD CONSTRAINT "Offer_candidate_id_fkey" FOREIGN KEY ("candidate_id") REFERENCES "User"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "Offer" ADD CONSTRAINT "Offer_job_description_id_fkey" FOREIGN KEY ("job_description_id") REFERENCES "JobDescription"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "Offer" ADD CONSTRAINT "Offer_template_id_fkey" FOREIGN KEY ("template_id") REFERENCES "OfferLetterTemplate"("id") ON DELETE SET NULL ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "OfferLetter" ADD CONSTRAINT "OfferLetter_offer_id_fkey" FOREIGN KEY ("offer_id") REFERENCES "Offer"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "OfferLetter" ADD CONSTRAINT "OfferLetter_document_id_fkey" FOREIGN KEY ("document_id") REFERENCES "Document"("id") ON DELETE RESTRICT ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "OfferLetter" ADD CONSTRAINT "OfferLetter_template_id_fkey" FOREIGN KEY ("template_id") REFERENCES "OfferLetterTemplate"("id") ON DELETE SET NULL ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "OfferLetter" ADD CONSTRAINT "OfferLetter_template_document_id_fkey" FOREIGN KEY ("template_document_id") REFERENCES "Document"("id") ON DELETE SET NULL ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "OfferChangeRequest" ADD CONSTRAINT "OfferChangeRequest_offer_id_fkey" FOREIGN KEY ("offer_id") REFERENCES "Offer"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "OfferChangeRequest" ADD CONSTRAINT "OfferChangeRequest_offer_letter_id_fkey" FOREIGN KEY ("offer_letter_id") REFERENCES "OfferLetter"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+

package/prisma/schema/migrations/20260716140000_offer_schema_refinements/migration.sql

@@ -0,0 +1,13 @@
+-- CreateEnum
+CREATE TYPE "WorkMode" AS ENUM ('REMOTE', 'OFFICE', 'HYBRID');
+
+-- AlterEnum
+ALTER TYPE "OfferChangeRequestStatus" ADD VALUE 'IN_PROGRESS';
+ALTER TYPE "OfferChangeRequestStatus" ADD VALUE 'REJECTED';
+ALTER TYPE "OfferChangeRequestStatus" ADD VALUE 'WITHDRAWN';
+ALTER TYPE "OfferChangeRequestStatus" ADD VALUE 'EXPIRED';
+
+-- AlterTable
+ALTER TABLE "OfferChangeRequest" ADD COLUMN "details" JSONB,
+ADD COLUMN "hr_note" TEXT,
+ADD COLUMN "resolved_at" TIMESTAMP(3);

package/prisma/schema/migrations/20260716160000_offer_schema_hardening/migration.sql

@@ -0,0 +1,95 @@
+-- CreateEnum
+CREATE TYPE "OfferLetterStatus" AS ENUM ('ACTIVE', 'SUPERSEDED', 'VOID');
+
+-- CreateEnum
+CREATE TYPE "OfferWithdrawReason" AS ENUM ('ROLE_CLOSED', 'CANDIDATE_ACCEPTED_ELSEWHERE', 'BUDGET', 'MISFIT', 'OTHER');
+
+-- AlterEnum: OfferSubstatus — negotiation substatuses
+ALTER TYPE "OfferSubstatus" ADD VALUE 'CHANGE_UNDER_REVIEW';
+ALTER TYPE "OfferSubstatus" ADD VALUE 'COUNTER_OFFER_SENT';
+
+-- AlterEnum: OfferChangeRequestStatus — ADDRESSED → RESOLVED
+ALTER TYPE "OfferChangeRequestStatus" RENAME VALUE 'ADDRESSED' TO 'RESOLVED';
+
+-- AlterEnum: ActivityEventType — offer workflow events
+ALTER TYPE "ActivityEventType" ADD VALUE 'OFFER_CREATED';
+ALTER TYPE "ActivityEventType" ADD VALUE 'OFFER_SENT';
+ALTER TYPE "ActivityEventType" ADD VALUE 'OFFER_VIEWED';
+ALTER TYPE "ActivityEventType" ADD VALUE 'OFFER_CHANGE_REQUESTED';
+ALTER TYPE "ActivityEventType" ADD VALUE 'OFFER_CHANGE_UNDER_REVIEW';
+ALTER TYPE "ActivityEventType" ADD VALUE 'OFFER_COUNTER_SENT';
+ALTER TYPE "ActivityEventType" ADD VALUE 'OFFER_ACCEPTED';
+ALTER TYPE "ActivityEventType" ADD VALUE 'OFFER_DECLINED';
+ALTER TYPE "ActivityEventType" ADD VALUE 'OFFER_WITHDRAWN';
+ALTER TYPE "ActivityEventType" ADD VALUE 'OFFER_EXPIRED';
+ALTER TYPE "ActivityEventType" ADD VALUE 'OFFER_JOINED';
+ALTER TYPE "ActivityEventType" ADD VALUE 'OFFER_CHANGE_REQUEST_REJECTED';
+ALTER TYPE "ActivityEventType" ADD VALUE 'OFFER_CHANGE_REQUEST_WITHDRAWN';
+
+-- AlterEnum: ActivityEntityType — OFFER
+ALTER TYPE "ActivityEntityType" ADD VALUE 'OFFER';
+
+-- AlterTable: OfferLetterTemplate — template version
+ALTER TABLE "OfferLetterTemplate" ADD COLUMN "version" INTEGER NOT NULL DEFAULT 1;
+
+-- AlterTable: Offer — analytics, withdrawal, current letter pointer
+ALTER TABLE "Offer" ADD COLUMN "current_offer_letter_id" TEXT,
+ADD COLUMN "sent_at" TIMESTAMP(3),
+ADD COLUMN "responded_at" TIMESTAMP(3),
+ADD COLUMN "accepted_at" TIMESTAMP(3),
+ADD COLUMN "declined_at" TIMESTAMP(3),
+ADD COLUMN "withdrawn_at" TIMESTAMP(3),
+ADD COLUMN "expired_at" TIMESTAMP(3),
+ADD COLUMN "joined_at" TIMESTAMP(3),
+ADD COLUMN "withdraw_reason" "OfferWithdrawReason",
+ADD COLUMN "withdraw_note" TEXT;
+
+-- AlterTable: OfferLetter — business lifecycle status + template version snapshot
+ALTER TABLE "OfferLetter" ADD COLUMN "status" "OfferLetterStatus" NOT NULL DEFAULT 'ACTIVE',
+ADD COLUMN "template_version" INTEGER;
+
+-- Backfill: letter status — max version ACTIVE, others SUPERSEDED
+UPDATE "OfferLetter" ol
+SET "status" = CASE
+  WHEN ol."version" = (
+    SELECT MAX(ol2."version")
+    FROM "OfferLetter" ol2
+    WHERE ol2."offer_id" = ol."offer_id" AND ol2."is_active" = true
+  ) THEN 'ACTIVE'::"OfferLetterStatus"
+  ELSE 'SUPERSEDED'::"OfferLetterStatus"
+END
+WHERE ol."is_active" = true;
+
+-- Backfill: current_offer_letter_id = latest active letter by version
+UPDATE "Offer" o
+SET "current_offer_letter_id" = (
+  SELECT ol."id"
+  FROM "OfferLetter" ol
+  WHERE ol."offer_id" = o."id" AND ol."is_active" = true
+  ORDER BY ol."version" DESC
+  LIMIT 1
+)
+WHERE EXISTS (
+  SELECT 1 FROM "OfferLetter" ol WHERE ol."offer_id" = o."id" AND ol."is_active" = true
+);
+
+-- Backfill: sent_at from earliest letter sent_at
+UPDATE "Offer" o
+SET "sent_at" = (
+  SELECT MIN(ol."sent_at")
+  FROM "OfferLetter" ol
+  WHERE ol."offer_id" = o."id" AND ol."sent_at" IS NOT NULL
+)
+WHERE o."sent_at" IS NULL
+  AND EXISTS (
+    SELECT 1 FROM "OfferLetter" ol WHERE ol."offer_id" = o."id" AND ol."sent_at" IS NOT NULL
+  );
+
+-- CreateIndex
+CREATE INDEX "Offer_organisation_id_substatus_idx" ON "Offer"("organisation_id", "substatus");
+CREATE INDEX "Offer_expires_at_idx" ON "Offer"("expires_at");
+CREATE INDEX "Offer_current_offer_letter_id_idx" ON "Offer"("current_offer_letter_id");
+CREATE INDEX "OfferLetter_offer_id_status_idx" ON "OfferLetter"("offer_id", "status");
+
+-- AddForeignKey
+ALTER TABLE "Offer" ADD CONSTRAINT "Offer_current_offer_letter_id_fkey" FOREIGN KEY ("current_offer_letter_id") REFERENCES "OfferLetter"("id") ON DELETE SET NULL ON UPDATE CASCADE;

package/prisma/schema/migrations/20260716180000_offer_letter_template_config/migration.sql

@@ -0,0 +1,2 @@
+-- AlterTable
+ALTER TABLE "public"."OfferLetterTemplate" ADD COLUMN "template_config" JSONB NOT NULL DEFAULT '{}';

package/prisma/schema/migrations/20260716190000_add_evaluation_focus_areas/migration.sql

@@ -0,0 +1,6 @@
+-- Add focus_areas alongside legacy topics (backfill copies topics → focus_areas).
+ALTER TABLE "EvaluationPlan"
+ADD COLUMN "focus_areas" TEXT[] NOT NULL DEFAULT ARRAY[]::TEXT[];
+
+ALTER TABLE "OngoingEvaluation"
+ADD COLUMN "focus_areas" TEXT[] NOT NULL DEFAULT ARRAY[]::TEXT[];

package/prisma/schema/migrations/20260717120000_offer_workflow_approval/migration.sql

@@ -0,0 +1,30 @@
+-- AlterEnum
+ALTER TYPE "OfferSubstatus" ADD VALUE 'PENDING_APPROVAL' AFTER 'OFFER_CREATED';
+
+-- CreateEnum
+CREATE TYPE "OfferApprovalStatus" AS ENUM ('PENDING', 'APPROVED', 'REJECTED');
+
+-- CreateTable
+CREATE TABLE "OfferApproval" (
+    "id" TEXT NOT NULL,
+    "offer_id" TEXT NOT NULL,
+    "status" "OfferApprovalStatus" NOT NULL DEFAULT 'PENDING',
+    "note" TEXT,
+    "decided_at" TIMESTAMP(3),
+    "decided_by" TEXT,
+    "created_by" TEXT NOT NULL,
+    "updated_by" TEXT NOT NULL,
+    "created_at" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updated_at" TIMESTAMP(3) NOT NULL,
+
+    CONSTRAINT "OfferApproval_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateIndex
+CREATE INDEX "OfferApproval_offer_id_status_idx" ON "OfferApproval"("offer_id", "status");
+
+-- CreateIndex
+CREATE INDEX "OfferApproval_offer_id_created_at_idx" ON "OfferApproval"("offer_id", "created_at");
+
+-- AddForeignKey
+ALTER TABLE "OfferApproval" ADD CONSTRAINT "OfferApproval_offer_id_fkey" FOREIGN KEY ("offer_id") REFERENCES "Offer"("id") ON DELETE CASCADE ON UPDATE CASCADE;

package/prisma/schema/migrations/20260720120000_offer_letter_template_is_draft/migration.sql

@@ -0,0 +1,5 @@
+-- AlterTable
+ALTER TABLE "public"."OfferLetterTemplate" ADD COLUMN "is_draft" BOOLEAN NOT NULL DEFAULT false;
+
+-- CreateIndex
+CREATE INDEX "OfferLetterTemplate_job_description_id_is_draft_idx" ON "public"."OfferLetterTemplate"("job_description_id", "is_draft");