@adaptware/eagles-db 0.5.20 → 0.5.22

package/package.json

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

package/prisma/schema/activityEvent.prisma

@@ -44,16 +44,20 @@ enum ActivityEventType {
 
   /// Offer workflow — one semantic event per business moment.
   OFFER_CREATED
+  OFFER_GENERATED
   OFFER_SENT
+  OFFER_REVISED
+  OFFER_ACCEPTED
+  OFFER_DECLINED
+  OFFER_WITHDRAWN
+  OFFER_JOINED
+  OFFER_NO_SHOW
+  /// Legacy values kept for historic ActivityEvent rows; not emitted by current flow.
   OFFER_VIEWED
   OFFER_CHANGE_REQUESTED
   OFFER_CHANGE_UNDER_REVIEW
   OFFER_COUNTER_SENT
-  OFFER_ACCEPTED
-  OFFER_DECLINED
-  OFFER_WITHDRAWN
   OFFER_EXPIRED
-  OFFER_JOINED
   OFFER_CHANGE_REQUEST_REJECTED
   OFFER_CHANGE_REQUEST_WITHDRAWN
 

package/prisma/schema/applications.prisma

@@ -4,7 +4,7 @@ enum ApplicationStatus {
   IN_PROGRESS
   SELECTED
   OFFER
-  HIRED
+  JOINED
   SHORTLISTED
   REJECTED
   ON_HOLD
@@ -13,6 +13,29 @@ enum ApplicationStatus {
   @@schema("public")
 }
 
+/// Fine-grained state within ApplicationStatus.OFFER. Owned by Application —
+/// Offer table holds terms/letters/audit only, no lifecycle enum of its own.
+enum ApplicationOfferSubstatus {
+  /// Offer row created with terms, no letter generated yet.
+  PREPARING
+  /// Letter DOCX generated and downloaded — awaiting manual send outside TreadSpace.
+  GENERATED
+  /// Staff manually marked the letter as sent to the candidate.
+  SENT
+  /// Revising after SENT — current letter is superseded, no active letter until next Generate.
+  NEGOTIATING
+  /// Candidate accepted (staff-recorded, no candidate portal).
+  ACCEPTED
+  /// Candidate declined — Application.status also flips to REJECTED.
+  DECLINED
+  /// Offer withdrawn by staff — Application.status also flips to REJECTED.
+  WITHDRAWN
+  /// Candidate accepted but did not join — Application.status also flips to REJECTED.
+  NO_SHOW
+
+  @@schema("public")
+}
+
 model Application {
   /// Primary key
   id                        String                   @id @default(uuid())
@@ -41,8 +64,8 @@ model Application {
   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?
+  /// 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?
   /// Audit fields
   created_at                DateTime                 @default(now())
   updated_at                DateTime                 @updatedAt
@@ -76,5 +99,6 @@ model Application {
   @@index([job_description_id, is_flagged])
   @@index([organisation_id, is_active, status])
   @@index([job_description_id, is_active, status])
+  @@index([organisation_id, offer_substatus])
   @@schema("public")
 }

package/prisma/schema/integration.prisma

@@ -1,6 +1,7 @@
 enum IntegrationProvider {
   NAUKRI
   ZOHO_RECRUIT
+  ZOHO_SIGN
   LINKEDIN
   GOOGLE
   MICROSOFT

package/prisma/schema/migrations/20260610100000_add_communication/migration.sql

@@ -0,0 +1,131 @@
+-- CreateEnum
+CREATE TYPE "CommChannel" AS ENUM ('WHATSAPP', 'EMAIL', 'SMS', 'CALL');
+
+-- CreateEnum
+CREATE TYPE "CommProvider" AS ENUM ('META_WHATSAPP', 'TWILIO', 'GUPSHUP', 'MTALKZ', 'THREE_SIXTY_DIALOG', 'GMAIL', 'OUTLOOK', 'GENERIC_SMTP', 'GENERIC');
+
+-- CreateEnum
+CREATE TYPE "CommDirection" AS ENUM ('INBOUND', 'OUTBOUND');
+
+-- CreateEnum
+CREATE TYPE "CommMessageStatus" AS ENUM ('QUEUED', 'SENT', 'DELIVERED', 'READ', 'FAILED', 'RECEIVED');
+
+-- CreateTable
+CREATE TABLE "ChannelProviderConfig" (
+    "id" TEXT NOT NULL,
+    "organisation_id" TEXT NOT NULL,
+    "channel" "CommChannel" NOT NULL,
+    "provider" "CommProvider" NOT NULL,
+    "credentials" TEXT,
+    "metadata" JSONB NOT NULL DEFAULT '{}',
+    "is_active" BOOLEAN NOT NULL DEFAULT true,
+    "is_default" BOOLEAN NOT NULL DEFAULT true,
+    "created_at" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updated_at" TIMESTAMP(3) NOT NULL,
+    "created_by" TEXT NOT NULL,
+    "updated_by" TEXT NOT NULL,
+
+    CONSTRAINT "ChannelProviderConfig_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "Conversation" (
+    "id" TEXT NOT NULL,
+    "organisation_id" TEXT NOT NULL,
+    "channel" "CommChannel" NOT NULL,
+    "provider" "CommProvider" NOT NULL,
+    "channel_provider_id" TEXT,
+    "external_id" TEXT NOT NULL,
+    "contact_user_id" TEXT,
+    "provider_thread_id" TEXT,
+    "subject" TEXT,
+    "status" TEXT NOT NULL DEFAULT 'open',
+    "unread_count" INTEGER NOT NULL DEFAULT 0,
+    "last_message_at" TIMESTAMP(3),
+    "metadata" JSONB NOT NULL DEFAULT '{}',
+    "created_at" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updated_at" TIMESTAMP(3) NOT NULL,
+    "created_by" TEXT NOT NULL,
+    "updated_by" TEXT NOT NULL,
+
+    CONSTRAINT "Conversation_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "CommunicationMessage" (
+    "id" TEXT NOT NULL,
+    "conversation_id" TEXT NOT NULL,
+    "organisation_id" TEXT NOT NULL,
+    "channel" "CommChannel" NOT NULL,
+    "provider" "CommProvider" NOT NULL,
+    "channel_provider_id" TEXT,
+    "direction" "CommDirection" NOT NULL,
+    "status" "CommMessageStatus" NOT NULL,
+    "body" TEXT,
+    "from_identifier" TEXT NOT NULL,
+    "to_identifier" TEXT NOT NULL,
+    "sender_user_id" TEXT,
+    "provider_message_id" TEXT,
+    "template_name" TEXT,
+    "attachments" JSONB NOT NULL DEFAULT '[]',
+    "metadata" JSONB NOT NULL DEFAULT '{}',
+    "error" TEXT,
+    "sent_at" TIMESTAMP(3),
+    "delivered_at" TIMESTAMP(3),
+    "read_at" TIMESTAMP(3),
+    "created_at" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updated_at" TIMESTAMP(3) NOT NULL,
+
+    CONSTRAINT "CommunicationMessage_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateIndex
+CREATE UNIQUE INDEX "ChannelProviderConfig_organisation_id_channel_provider_key" ON "ChannelProviderConfig"("organisation_id", "channel", "provider");
+
+-- CreateIndex
+CREATE INDEX "ChannelProviderConfig_organisation_id_channel_idx" ON "ChannelProviderConfig"("organisation_id", "channel");
+
+-- CreateIndex
+CREATE INDEX "ChannelProviderConfig_organisation_id_channel_is_active_idx" ON "ChannelProviderConfig"("organisation_id", "channel", "is_active");
+
+-- CreateIndex
+CREATE UNIQUE INDEX "Conversation_organisation_id_channel_provider_external_id_key" ON "Conversation"("organisation_id", "channel", "provider", "external_id");
+
+-- CreateIndex
+CREATE INDEX "Conversation_organisation_id_channel_idx" ON "Conversation"("organisation_id", "channel");
+
+-- CreateIndex
+CREATE INDEX "Conversation_organisation_id_last_message_at_idx" ON "Conversation"("organisation_id", "last_message_at");
+
+-- CreateIndex
+CREATE INDEX "Conversation_external_id_idx" ON "Conversation"("external_id");
+
+-- CreateIndex
+CREATE UNIQUE INDEX "CommunicationMessage_provider_provider_message_id_key" ON "CommunicationMessage"("provider", "provider_message_id");
+
+-- CreateIndex
+CREATE INDEX "CommunicationMessage_conversation_id_created_at_idx" ON "CommunicationMessage"("conversation_id", "created_at");
+
+-- CreateIndex
+CREATE INDEX "CommunicationMessage_organisation_id_channel_created_at_idx" ON "CommunicationMessage"("organisation_id", "channel", "created_at");
+
+-- CreateIndex
+CREATE INDEX "CommunicationMessage_organisation_id_status_idx" ON "CommunicationMessage"("organisation_id", "status");
+
+-- AddForeignKey
+ALTER TABLE "ChannelProviderConfig" ADD CONSTRAINT "ChannelProviderConfig_organisation_id_fkey" FOREIGN KEY ("organisation_id") REFERENCES "Organisation"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "Conversation" ADD CONSTRAINT "Conversation_organisation_id_fkey" FOREIGN KEY ("organisation_id") REFERENCES "Organisation"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "Conversation" ADD CONSTRAINT "Conversation_channel_provider_id_fkey" FOREIGN KEY ("channel_provider_id") REFERENCES "ChannelProviderConfig"("id") ON DELETE SET NULL ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "CommunicationMessage" ADD CONSTRAINT "CommunicationMessage_conversation_id_fkey" FOREIGN KEY ("conversation_id") REFERENCES "Conversation"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "CommunicationMessage" ADD CONSTRAINT "CommunicationMessage_organisation_id_fkey" FOREIGN KEY ("organisation_id") REFERENCES "Organisation"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "CommunicationMessage" ADD CONSTRAINT "CommunicationMessage_channel_provider_id_fkey" FOREIGN KEY ("channel_provider_id") REFERENCES "ChannelProviderConfig"("id") ON DELETE SET NULL ON UPDATE CASCADE;

package/prisma/schema/migrations/20260610170000_add_communication_application_scope/migration.sql

@@ -0,0 +1,45 @@
+-- AlterTable: Conversation
+ALTER TABLE "Conversation"
+  ADD COLUMN "application_id" TEXT,
+  ADD COLUMN "job_description_id" TEXT;
+
+-- AlterTable: CommunicationMessage
+ALTER TABLE "CommunicationMessage"
+  ADD COLUMN "application_id" TEXT,
+  ADD COLUMN "job_description_id" TEXT;
+
+-- CreateIndex
+CREATE INDEX "Conversation_organisation_id_application_id_idx" ON "Conversation"("organisation_id", "application_id");
+
+-- CreateIndex
+CREATE INDEX "Conversation_organisation_id_job_description_id_idx" ON "Conversation"("organisation_id", "job_description_id");
+
+-- CreateIndex
+CREATE INDEX "CommunicationMessage_organisation_id_application_id_idx" ON "CommunicationMessage"("organisation_id", "application_id");
+
+-- CreateIndex
+CREATE INDEX "CommunicationMessage_organisation_id_job_description_id_idx" ON "CommunicationMessage"("organisation_id", "job_description_id");
+
+-- AddForeignKey
+ALTER TABLE "Conversation"
+  ADD CONSTRAINT "Conversation_application_id_fkey"
+    FOREIGN KEY ("application_id") REFERENCES "Application"("id")
+    ON DELETE SET NULL ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "Conversation"
+  ADD CONSTRAINT "Conversation_job_description_id_fkey"
+    FOREIGN KEY ("job_description_id") REFERENCES "JobDescription"("id")
+    ON DELETE SET NULL ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "CommunicationMessage"
+  ADD CONSTRAINT "CommunicationMessage_application_id_fkey"
+    FOREIGN KEY ("application_id") REFERENCES "Application"("id")
+    ON DELETE SET NULL ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "CommunicationMessage"
+  ADD CONSTRAINT "CommunicationMessage_job_description_id_fkey"
+    FOREIGN KEY ("job_description_id") REFERENCES "JobDescription"("id")
+    ON DELETE SET NULL ON UPDATE CASCADE;

package/prisma/schema/migrations/20260718120000_add_hiring_plan/migration.sql

@@ -0,0 +1,208 @@
+-- CreateEnum
+CREATE TYPE "HiringPlanStatus" AS ENUM ('DRAFT', 'ACTIVE', 'CLOSED');
+
+-- CreateEnum
+CREATE TYPE "PeriodType" AS ENUM ('ANNUAL');
+
+-- CreateEnum
+CREATE TYPE "EmployeeStatus" AS ENUM ('ACTIVE', 'ATTRITION_EXPECTED', 'DEPARTED');
+
+-- CreateEnum
+CREATE TYPE "AttritionRisk" AS ENUM ('LOW', 'MEDIUM', 'HIGH');
+
+-- CreateEnum
+CREATE TYPE "ReviewRating" AS ENUM (
+  'OUTSTANDING',
+  'EXCEEDS_EXPECTATIONS',
+  'MEETS_EXPECTATIONS',
+  'NEEDS_IMPROVEMENT',
+  'UNSATISFACTORY'
+);
+
+-- CreateEnum
+CREATE TYPE "PlannedCandidateStatus" AS ENUM (
+  'IDENTIFIED',
+  'IN_PIPELINE',
+  'OFFER',
+  'SELECTED',
+  'DECLINED'
+);
+
+-- CreateTable
+CREATE TABLE "HiringPlan" (
+    "id" TEXT NOT NULL,
+    "organisation_id" TEXT NOT NULL,
+    "fiscal_year" INTEGER NOT NULL,
+    "period_type" "PeriodType" NOT NULL DEFAULT 'ANNUAL',
+    "currency" TEXT NOT NULL DEFAULT 'INR',
+    "status" "HiringPlanStatus" NOT NULL DEFAULT 'DRAFT',
+    "total_headcount_budget" INTEGER,
+    "total_cost_budget" DECIMAL(18,2),
+    "notes" TEXT,
+    "created_at" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updated_at" TIMESTAMP(3) NOT NULL,
+    "created_by" TEXT NOT NULL,
+    "updated_by" TEXT NOT NULL,
+    "is_active" BOOLEAN NOT NULL DEFAULT true,
+
+    CONSTRAINT "HiringPlan_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "HiringPlanLine" (
+    "id" TEXT NOT NULL,
+    "hiring_plan_id" TEXT NOT NULL,
+    "business_unit" TEXT,
+    "level" TEXT,
+    "location" TEXT,
+    "role" TEXT,
+    "planned_headcount" INTEGER NOT NULL DEFAULT 1,
+    "cost_per_hire" DECIMAL(18,2) NOT NULL,
+    "start_month" INTEGER NOT NULL DEFAULT 1,
+    "hire_schedule" JSONB,
+    "job_description_id" TEXT,
+    "created_at" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updated_at" TIMESTAMP(3) NOT NULL,
+    "created_by" TEXT NOT NULL,
+    "updated_by" TEXT NOT NULL,
+    "is_active" BOOLEAN NOT NULL DEFAULT true,
+
+    CONSTRAINT "HiringPlanLine_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "Employee" (
+    "id" TEXT NOT NULL,
+    "organisation_id" TEXT NOT NULL,
+    "employee_code" TEXT,
+    "name" TEXT,
+    "email" TEXT,
+    "gender" TEXT,
+    "business_unit" TEXT,
+    "level" TEXT,
+    "location" TEXT,
+    "role" TEXT,
+    "employment_type" "JobType",
+    "starting_designation" TEXT,
+    "current_designation" TEXT,
+    "start_date" TIMESTAMP(3),
+    "starting_salary" DECIMAL(18,2),
+    "current_comp" DECIMAL(18,2) NOT NULL,
+    "currency" TEXT NOT NULL DEFAULT 'INR',
+    "last_increment_date" TIMESTAMP(3),
+    "last_increment_amount" DECIMAL(18,2),
+    "last_increment_pct" DECIMAL(8,4),
+    "last_review_date" TIMESTAMP(3),
+    "last_review_rating" "ReviewRating",
+    "last_feedback_date" TIMESTAMP(3),
+    "last_feedback_summary" TEXT,
+    "status" "EmployeeStatus" NOT NULL DEFAULT 'ACTIVE',
+    "attrition_risk" "AttritionRisk",
+    "expected_exit_date" TIMESTAMP(3),
+    "backfill_plan_line_id" TEXT,
+    "created_at" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updated_at" TIMESTAMP(3) NOT NULL,
+    "created_by" TEXT NOT NULL,
+    "updated_by" TEXT NOT NULL,
+    "is_active" BOOLEAN NOT NULL DEFAULT true,
+
+    CONSTRAINT "Employee_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "PlannedCandidate" (
+    "id" TEXT NOT NULL,
+    "hiring_plan_line_id" TEXT NOT NULL,
+    "candidate_profile_id" TEXT,
+    "name" TEXT,
+    "status" "PlannedCandidateStatus" NOT NULL DEFAULT 'IDENTIFIED',
+    "note" TEXT,
+    "created_at" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updated_at" TIMESTAMP(3) NOT NULL,
+    "created_by" TEXT NOT NULL,
+    "updated_by" TEXT NOT NULL,
+    "is_active" BOOLEAN NOT NULL DEFAULT true,
+
+    CONSTRAINT "PlannedCandidate_pkey" PRIMARY KEY ("id")
+);
+
+-- AlterTable
+ALTER TABLE "JobDescription" ADD COLUMN "hiring_plan_line_id" TEXT;
+
+-- AlterTable
+ALTER TABLE "Budget" ADD COLUMN "hiring_plan_line_id" TEXT;
+
+-- CreateIndex
+CREATE UNIQUE INDEX "HiringPlan_organisation_id_fiscal_year_key" ON "HiringPlan"("organisation_id", "fiscal_year");
+
+-- CreateIndex
+CREATE INDEX "HiringPlan_organisation_id_idx" ON "HiringPlan"("organisation_id");
+
+-- CreateIndex
+CREATE INDEX "HiringPlan_status_idx" ON "HiringPlan"("status");
+
+-- CreateIndex
+CREATE INDEX "HiringPlanLine_hiring_plan_id_idx" ON "HiringPlanLine"("hiring_plan_id");
+
+-- CreateIndex
+CREATE INDEX "HiringPlanLine_job_description_id_idx" ON "HiringPlanLine"("job_description_id");
+
+-- CreateIndex
+CREATE INDEX "HiringPlanLine_business_unit_level_location_role_idx" ON "HiringPlanLine"("business_unit", "level", "location", "role");
+
+-- CreateIndex
+CREATE UNIQUE INDEX "Employee_organisation_id_employee_code_key" ON "Employee"("organisation_id", "employee_code");
+
+-- CreateIndex
+CREATE INDEX "Employee_organisation_id_idx" ON "Employee"("organisation_id");
+
+-- CreateIndex
+CREATE INDEX "Employee_status_idx" ON "Employee"("status");
+
+-- CreateIndex
+CREATE INDEX "Employee_business_unit_level_location_role_idx" ON "Employee"("business_unit", "level", "location", "role");
+
+-- CreateIndex
+CREATE INDEX "Employee_backfill_plan_line_id_idx" ON "Employee"("backfill_plan_line_id");
+
+-- CreateIndex
+CREATE INDEX "PlannedCandidate_hiring_plan_line_id_idx" ON "PlannedCandidate"("hiring_plan_line_id");
+
+-- CreateIndex
+CREATE INDEX "PlannedCandidate_candidate_profile_id_idx" ON "PlannedCandidate"("candidate_profile_id");
+
+-- CreateIndex
+CREATE INDEX "PlannedCandidate_status_idx" ON "PlannedCandidate"("status");
+
+-- CreateIndex
+CREATE INDEX "JobDescription_hiring_plan_line_id_idx" ON "JobDescription"("hiring_plan_line_id");
+
+-- CreateIndex
+CREATE INDEX "Budget_hiring_plan_line_id_idx" ON "Budget"("hiring_plan_line_id");
+
+-- AddForeignKey
+ALTER TABLE "HiringPlan" ADD CONSTRAINT "HiringPlan_organisation_id_fkey" FOREIGN KEY ("organisation_id") REFERENCES "Organisation"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "HiringPlanLine" ADD CONSTRAINT "HiringPlanLine_hiring_plan_id_fkey" FOREIGN KEY ("hiring_plan_id") REFERENCES "HiringPlan"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "HiringPlanLine" ADD CONSTRAINT "HiringPlanLine_job_description_id_fkey" FOREIGN KEY ("job_description_id") REFERENCES "JobDescription"("id") ON DELETE SET NULL ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "Employee" ADD CONSTRAINT "Employee_organisation_id_fkey" FOREIGN KEY ("organisation_id") REFERENCES "Organisation"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "Employee" ADD CONSTRAINT "Employee_backfill_plan_line_id_fkey" FOREIGN KEY ("backfill_plan_line_id") REFERENCES "HiringPlanLine"("id") ON DELETE SET NULL ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "PlannedCandidate" ADD CONSTRAINT "PlannedCandidate_hiring_plan_line_id_fkey" FOREIGN KEY ("hiring_plan_line_id") REFERENCES "HiringPlanLine"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "PlannedCandidate" ADD CONSTRAINT "PlannedCandidate_candidate_profile_id_fkey" FOREIGN KEY ("candidate_profile_id") REFERENCES "CandidateProfile"("id") ON DELETE SET NULL ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "JobDescription" ADD CONSTRAINT "JobDescription_hiring_plan_line_id_fkey" FOREIGN KEY ("hiring_plan_line_id") REFERENCES "HiringPlanLine"("id") ON DELETE SET NULL ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "Budget" ADD CONSTRAINT "Budget_hiring_plan_line_id_fkey" FOREIGN KEY ("hiring_plan_line_id") REFERENCES "HiringPlanLine"("id") ON DELETE SET NULL ON UPDATE CASCADE;

package/prisma/schema/migrations/20260718140000_hiring_plan_assumptions/migration.sql

@@ -0,0 +1,2 @@
+-- AlterTable
+ALTER TABLE "HiringPlan" ADD COLUMN "assumptions" JSONB;

package/prisma/schema/migrations/20260807140000_simplify_offer_status_model/migration.sql

@@ -0,0 +1,109 @@
+-- Simplify offer status model:
+--   * Move lifecycle from Offer.status + Offer.substatus onto Application.offer_substatus
+--   * Rename ApplicationStatus.HIRED -> JOINED
+--   * Split OfferLetter.sent_at -> generated_at; Offer.sent_at now = "marked as sent"
+--   * Drop OfferChangeRequest, OfferApproval and their enums
+--   * Drop OfferLetterStatus.VOID (never written)
+
+-- 1. New enum for the single Application-owned offer substatus.
+CREATE TYPE "public"."ApplicationOfferSubstatus" AS ENUM (
+  'PREPARING',
+  'GENERATED',
+  'SENT',
+  'NEGOTIATING',
+  'ACCEPTED',
+  'DECLINED',
+  'WITHDRAWN',
+  'NO_SHOW'
+);
+
+-- 2. Add new column and backfill from existing Offer.status / Offer.substatus.
+ALTER TABLE "public"."Application"
+  ADD COLUMN "offer_substatus" "public"."ApplicationOfferSubstatus";
+
+UPDATE "public"."Application" a
+SET "offer_substatus" = CASE
+  WHEN o."status" = 'OPEN' AND o."substatus" IN ('OFFER_CREATED', 'PENDING_APPROVAL') THEN 'PREPARING'::"public"."ApplicationOfferSubstatus"
+  WHEN o."status" = 'OPEN' AND o."substatus" IN ('OFFER_SENT', 'VIEWED', 'COUNTER_OFFER_SENT') THEN 'SENT'::"public"."ApplicationOfferSubstatus"
+  WHEN o."status" = 'OPEN' AND o."substatus" IN ('CHANGE_REQUESTED', 'CHANGE_UNDER_REVIEW') THEN 'NEGOTIATING'::"public"."ApplicationOfferSubstatus"
+  WHEN o."status" = 'OPEN' THEN 'PREPARING'::"public"."ApplicationOfferSubstatus"
+  WHEN o."status" = 'ACCEPTED' THEN 'ACCEPTED'::"public"."ApplicationOfferSubstatus"
+  WHEN o."status" = 'JOINED' THEN 'ACCEPTED'::"public"."ApplicationOfferSubstatus"
+  WHEN o."status" = 'DECLINED' THEN 'DECLINED'::"public"."ApplicationOfferSubstatus"
+  WHEN o."status" IN ('WITHDRAWN', 'EXPIRED') THEN 'WITHDRAWN'::"public"."ApplicationOfferSubstatus"
+  WHEN o."status" = 'NO_SHOW' THEN 'NO_SHOW'::"public"."ApplicationOfferSubstatus"
+END
+FROM "public"."Offer" o
+WHERE o."application_id" = a."id";
+
+-- 3. Rename ApplicationStatus.HIRED -> JOINED (safe: all usages are offer-related).
+ALTER TYPE "public"."ApplicationStatus" RENAME VALUE 'HIRED' TO 'JOINED';
+
+-- 4. Terminal offer outcomes flip Application.status to REJECTED.
+UPDATE "public"."Application"
+SET "status" = 'REJECTED'
+WHERE "offer_substatus" IN ('DECLINED', 'WITHDRAWN', 'NO_SHOW')
+  AND "status" = 'OFFER';
+
+-- 5. Applications that were HIRED (now JOINED) with an ACCEPTED offer stay JOINED.
+--    Migration above already handled ApplicationStatus rename in place.
+
+-- 6. Drop legacy Application.offer_status mirror column and its dependent index (if any).
+ALTER TABLE "public"."Application" DROP COLUMN IF EXISTS "offer_status";
+
+-- 7. New indexes on Application.offer_substatus for pipeline filtering.
+CREATE INDEX "Application_organisation_id_offer_substatus_idx"
+  ON "public"."Application" ("organisation_id", "offer_substatus");
+
+-- 8. Drop Offer.status / Offer.substatus and dependent indexes.
+DROP INDEX IF EXISTS "public"."Offer_organisation_id_status_idx";
+DROP INDEX IF EXISTS "public"."Offer_organisation_id_substatus_idx";
+DROP INDEX IF EXISTS "public"."Offer_status_idx";
+DROP INDEX IF EXISTS "public"."Offer_substatus_idx";
+DROP INDEX IF EXISTS "public"."Offer_expires_at_idx";
+
+ALTER TABLE "public"."Offer"
+  DROP COLUMN IF EXISTS "status",
+  DROP COLUMN IF EXISTS "substatus",
+  DROP COLUMN IF EXISTS "change_request_count",
+  DROP COLUMN IF EXISTS "expires_at",
+  DROP COLUMN IF EXISTS "expired_at";
+
+-- 9. Rename OfferLetter.sent_at -> generated_at (semantic fix: it was really "issued").
+ALTER TABLE "public"."OfferLetter" RENAME COLUMN "sent_at" TO "generated_at";
+
+-- 9a. Drop OfferLetter.viewed_at (candidate-portal artefact) and rename change_request_note.
+ALTER TABLE "public"."OfferLetter" DROP COLUMN IF EXISTS "viewed_at";
+ALTER TABLE "public"."OfferLetter" RENAME COLUMN "change_request_note" TO "generation_note";
+
+-- 10. Drop change-request and approval tables (workflow removed entirely).
+DROP TABLE IF EXISTS "public"."OfferChangeRequest";
+DROP TABLE IF EXISTS "public"."OfferApproval";
+
+-- 11. Drop old enums no longer referenced.
+DROP TYPE IF EXISTS "public"."OfferStatus";
+DROP TYPE IF EXISTS "public"."OfferSubstatus";
+DROP TYPE IF EXISTS "public"."OfferChangeRequestStatus";
+DROP TYPE IF EXISTS "public"."OfferChangeCategory";
+DROP TYPE IF EXISTS "public"."OfferApprovalStatus";
+
+-- 12a. Add new ActivityEventType values for the new offer flow.
+ALTER TYPE "public"."ActivityEventType" ADD VALUE IF NOT EXISTS 'OFFER_GENERATED';
+ALTER TYPE "public"."ActivityEventType" ADD VALUE IF NOT EXISTS 'OFFER_REVISED';
+ALTER TYPE "public"."ActivityEventType" ADD VALUE IF NOT EXISTS 'OFFER_NO_SHOW';
+
+-- 12b. Add ZOHO_SIGN to IntegrationProvider (referenced by ZohoSignService).
+ALTER TYPE "public"."IntegrationProvider" ADD VALUE IF NOT EXISTS 'ZOHO_SIGN';
+
+-- 12. OfferLetterStatus.VOID is never written; remove by rebuilding the enum with only ACTIVE + SUPERSEDED.
+ALTER TYPE "public"."OfferLetterStatus" RENAME TO "OfferLetterStatus_old";
+CREATE TYPE "public"."OfferLetterStatus" AS ENUM ('ACTIVE', 'SUPERSEDED');
+ALTER TABLE "public"."OfferLetter"
+  ALTER COLUMN "status" DROP DEFAULT,
+  ALTER COLUMN "status" TYPE "public"."OfferLetterStatus"
+  USING CASE
+    WHEN "status"::text = 'VOID' THEN 'SUPERSEDED'::"public"."OfferLetterStatus"
+    ELSE "status"::text::"public"."OfferLetterStatus"
+  END,
+  ALTER COLUMN "status" SET DEFAULT 'ACTIVE';
+DROP TYPE "public"."OfferLetterStatus_old";