@adaptware/eagles-db 0.6.14 → 0.6.16

package/prisma/schema/migrations/20260909140000_profile_interview_session/migration.sql

@@ -0,0 +1,99 @@
+-- CreateEnum (idempotent: enum may already exist from a prior partial apply)
+DO $$ BEGIN
+  CREATE TYPE "public"."ProfileInterviewSessionStatus" AS ENUM (
+    'SCHEDULED',
+    'IN_PROGRESS',
+    'COMPLETED',
+    'CANCELLED'
+  );
+EXCEPTION
+  WHEN duplicate_object THEN NULL;
+END $$;
+
+-- CreateTable
+CREATE TABLE IF NOT EXISTS "public"."ProfileInterviewSession" (
+    "id" TEXT NOT NULL,
+    "candidate_id" TEXT NOT NULL,
+    "organisation_id" TEXT,
+    "resume_id" TEXT NOT NULL,
+    "job_description_id" TEXT,
+    "purpose" TEXT NOT NULL,
+    "focus_areas" JSONB NOT NULL,
+    "duration_minutes" INTEGER NOT NULL,
+    "room_name" TEXT NOT NULL,
+    "status" "public"."ProfileInterviewSessionStatus" NOT NULL DEFAULT 'SCHEDULED',
+    "actual_start_time" TIMESTAMP(3),
+    "actual_end_time" TIMESTAMP(3),
+    "evidence_result" JSONB,
+    "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 "ProfileInterviewSession_pkey" PRIMARY KEY ("id")
+);
+
+-- AlterTable
+ALTER TABLE "public"."Transcript"
+  ADD COLUMN IF NOT EXISTS "profile_interview_session_id" TEXT;
+
+-- CreateIndex
+CREATE INDEX IF NOT EXISTS "ProfileInterviewSession_candidate_id_idx"
+  ON "public"."ProfileInterviewSession"("candidate_id");
+
+CREATE INDEX IF NOT EXISTS "ProfileInterviewSession_candidate_id_status_idx"
+  ON "public"."ProfileInterviewSession"("candidate_id", "status");
+
+CREATE INDEX IF NOT EXISTS "Transcript_profile_interview_session_id_idx"
+  ON "public"."Transcript"("profile_interview_session_id");
+
+CREATE UNIQUE INDEX IF NOT EXISTS "Transcript_profile_interview_session_id_order_no_key"
+  ON "public"."Transcript"("profile_interview_session_id", "order_no");
+
+-- AddForeignKey (idempotent)
+DO $$ BEGIN
+  ALTER TABLE "public"."ProfileInterviewSession"
+    ADD CONSTRAINT "ProfileInterviewSession_candidate_id_fkey"
+    FOREIGN KEY ("candidate_id") REFERENCES "public"."User"("id")
+    ON DELETE CASCADE ON UPDATE CASCADE;
+EXCEPTION
+  WHEN duplicate_object THEN NULL;
+END $$;
+
+DO $$ BEGIN
+  ALTER TABLE "public"."ProfileInterviewSession"
+    ADD CONSTRAINT "ProfileInterviewSession_organisation_id_fkey"
+    FOREIGN KEY ("organisation_id") REFERENCES "public"."Organisation"("id")
+    ON DELETE SET NULL ON UPDATE CASCADE;
+EXCEPTION
+  WHEN duplicate_object THEN NULL;
+END $$;
+
+DO $$ BEGIN
+  ALTER TABLE "public"."ProfileInterviewSession"
+    ADD CONSTRAINT "ProfileInterviewSession_resume_id_fkey"
+    FOREIGN KEY ("resume_id") REFERENCES "public"."Resume"("id")
+    ON DELETE CASCADE ON UPDATE CASCADE;
+EXCEPTION
+  WHEN duplicate_object THEN NULL;
+END $$;
+
+DO $$ BEGIN
+  ALTER TABLE "public"."ProfileInterviewSession"
+    ADD CONSTRAINT "ProfileInterviewSession_job_description_id_fkey"
+    FOREIGN KEY ("job_description_id") REFERENCES "public"."JobDescription"("id")
+    ON DELETE SET NULL ON UPDATE CASCADE;
+EXCEPTION
+  WHEN duplicate_object THEN NULL;
+END $$;
+
+DO $$ BEGIN
+  ALTER TABLE "public"."Transcript"
+    ADD CONSTRAINT "Transcript_profile_interview_session_id_fkey"
+    FOREIGN KEY ("profile_interview_session_id")
+    REFERENCES "public"."ProfileInterviewSession"("id")
+    ON DELETE SET NULL ON UPDATE SET NULL;
+EXCEPTION
+  WHEN duplicate_object THEN NULL;
+END $$;

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

@@ -0,0 +1,139 @@
+-- AlterTable: candidate-initiated profile AI on Interview
+ALTER TABLE "public"."Interview" ADD COLUMN "candidate_initiated" BOOLEAN NOT NULL DEFAULT false;
+ALTER TABLE "public"."Interview" ADD COLUMN "candidate_interview_metadata" JSONB;
+
+-- Relax FK columns for profile rows
+ALTER TABLE "public"."Interview" ALTER COLUMN "organisation_id" DROP NOT NULL;
+ALTER TABLE "public"."Interview" ALTER COLUMN "job_description_id" DROP NOT NULL;
+ALTER TABLE "public"."Interview" ALTER COLUMN "evaluation_plan_id" DROP NOT NULL;
+
+-- Drop old composite unique (replaced by partial index below)
+DROP INDEX IF EXISTS "public"."Interview_interviewer_id_candidate_id_evaluation_plan_id_key";
+
+-- Backfill ProfileInterviewSession -> Interview (preserve ids for URLs)
+INSERT INTO "public"."Interview" (
+  "id",
+  "organisation_id",
+  "candidate_id",
+  "interviewer_id",
+  "evaluation_plan_id",
+  "application_id",
+  "resume_id",
+  "job_description_id",
+  "candidate_initiated",
+  "candidate_interview_metadata",
+  "room_name",
+  "duration",
+  "actual_start_time",
+  "actual_end_time",
+  "evaluation_type",
+  "interview_status",
+  "interview_platform",
+  "ai_feedback",
+  "ai_feedback_generated_at",
+  "created_at",
+  "updated_at",
+  "created_by",
+  "updated_by",
+  "is_active",
+  "interview_summary",
+  "section_feedback",
+  "beta_section_feedback",
+  "reschedule_count",
+  "awaiting_recruiter_action"
+)
+SELECT
+  pis."id",
+  pis."organisation_id",
+  pis."candidate_id",
+  NULL,
+  NULL,
+  NULL,
+  pis."resume_id",
+  pis."job_description_id",
+  true,
+  jsonb_build_object(
+    'purpose', pis."purpose",
+    'focusAreas', pis."focus_areas"
+  ),
+  pis."room_name",
+  pis."duration_minutes",
+  pis."actual_start_time",
+  pis."actual_end_time",
+  'TREADSPACE_FULL_AI'::"public"."EvaluationType",
+  CASE pis."status"
+    WHEN 'SCHEDULED' THEN 'SCHEDULED'::"public"."InterviewStatus"
+    WHEN 'IN_PROGRESS' THEN 'IN_PROGRESS'::"public"."InterviewStatus"
+    WHEN 'CANCELLED' THEN 'CANCELLED'::"public"."InterviewStatus"
+    WHEN 'COMPLETED' THEN
+      CASE
+        WHEN pis."evidence_result" IS NOT NULL THEN 'EVALUATED'::"public"."InterviewStatus"
+        ELSE 'EVALUATION_PENDING'::"public"."InterviewStatus"
+      END
+    ELSE 'SCHEDULED'::"public"."InterviewStatus"
+  END,
+  'TREADSPACE'::"public"."InterviewPlatform",
+  pis."evidence_result",
+  CASE WHEN pis."evidence_result" IS NOT NULL THEN pis."updated_at" ELSE NULL END,
+  pis."created_at",
+  pis."updated_at",
+  pis."created_by",
+  pis."updated_by",
+  pis."is_active",
+  ARRAY[]::TEXT[],
+  ARRAY[]::JSONB[],
+  ARRAY[]::JSONB[],
+  0,
+  false
+FROM "public"."ProfileInterviewSession" pis
+ON CONFLICT ("id") DO NOTHING;
+
+-- Point transcripts at Interview rows
+UPDATE "public"."Transcript" t
+SET "interview_id" = t."profile_interview_session_id"
+WHERE t."profile_interview_session_id" IS NOT NULL
+  AND t."interview_id" IS NULL;
+
+-- Transcript: drop profile session FK
+ALTER TABLE "public"."Transcript" DROP CONSTRAINT IF EXISTS "Transcript_profile_interview_session_id_fkey";
+DROP INDEX IF EXISTS "public"."Transcript_profile_interview_session_id_order_no_key";
+DROP INDEX IF EXISTS "public"."Transcript_profile_interview_session_id_idx";
+ALTER TABLE "public"."Transcript" DROP COLUMN IF EXISTS "profile_interview_session_id";
+
+-- Drop profile session table
+DROP TABLE IF EXISTS "public"."ProfileInterviewSession";
+DROP TYPE IF EXISTS "public"."ProfileInterviewSessionStatus";
+
+-- Interview FK: organisation / job_description ON DELETE SET NULL
+ALTER TABLE "public"."Interview" DROP CONSTRAINT IF EXISTS "Interview_organisation_id_fkey";
+ALTER TABLE "public"."Interview" ADD CONSTRAINT "Interview_organisation_id_fkey"
+  FOREIGN KEY ("organisation_id") REFERENCES "public"."Organisation"("id")
+  ON DELETE SET NULL ON UPDATE CASCADE;
+
+ALTER TABLE "public"."Interview" DROP CONSTRAINT IF EXISTS "Interview_job_description_id_fkey";
+ALTER TABLE "public"."Interview" ADD CONSTRAINT "Interview_job_description_id_fkey"
+  FOREIGN KEY ("job_description_id") REFERENCES "public"."JobDescription"("id")
+  ON DELETE SET NULL ON UPDATE CASCADE;
+
+-- Hiring row invariants
+ALTER TABLE "public"."Interview" ADD CONSTRAINT "interview_hiring_required_fks"
+  CHECK (
+    "candidate_initiated" = true
+    OR (
+      "organisation_id" IS NOT NULL
+      AND "job_description_id" IS NOT NULL
+      AND "evaluation_plan_id" IS NOT NULL
+    )
+  );
+
+-- Partial unique for hiring triple only
+CREATE UNIQUE INDEX "interview_hiring_triple_uidx"
+  ON "public"."Interview" ("interviewer_id", "candidate_id", "evaluation_plan_id")
+  WHERE "candidate_initiated" = false AND "evaluation_plan_id" IS NOT NULL;
+
+-- List indexes
+CREATE INDEX IF NOT EXISTS "Interview_candidate_id_candidate_initiated_created_at_idx"
+  ON "public"."Interview" ("candidate_id", "candidate_initiated", "created_at");
+
+CREATE INDEX IF NOT EXISTS "Interview_candidate_initiated_interview_status_idx"
+  ON "public"."Interview" ("candidate_initiated", "interview_status");

package/prisma/schema/migrations/20260929120000_add_evaluation_type_in_person/migration.sql

@@ -0,0 +1,2 @@
+-- In-person interviews: staff schedules on-site; feedback without a platform session.
+ALTER TYPE "public"."EvaluationType" ADD VALUE IF NOT EXISTS 'IN_PERSON';

package/prisma/schema/migrations/20261015130000_interview_whiteboard_scene/migration.sql

@@ -0,0 +1,2 @@
+-- Persisted Excalidraw snapshot when live Redis state is flushed (interview end / backup).
+ALTER TABLE "Interview" ADD COLUMN IF NOT EXISTS "whiteboard_scene" JSONB;

package/prisma/schema/migrations/20261022120000_billing_failure_category_provider_neutral/migration.sql

@@ -0,0 +1,28 @@
+-- BillingTransactionFailureCategory: rename Razorpay-specific values to provider-neutral ones.
+-- RENAME VALUE keeps existing billing_transactions rows on the renamed label.
+-- Guarded so it is a no-op where the enum was never created (migration-managed DBs
+-- without billing tables) or was already renamed.
+DO $$
+BEGIN
+  IF EXISTS (
+    SELECT 1 FROM pg_enum e
+    JOIN pg_type t ON t.oid = e.enumtypid
+    JOIN pg_namespace n ON n.oid = t.typnamespace
+    WHERE n.nspname = 'public'
+      AND t.typname = 'BillingTransactionFailureCategory'
+      AND e.enumlabel = 'RAZORPAY_ORDER'
+  ) THEN
+    ALTER TYPE "public"."BillingTransactionFailureCategory" RENAME VALUE 'RAZORPAY_ORDER' TO 'ORDER';
+  END IF;
+
+  IF EXISTS (
+    SELECT 1 FROM pg_enum e
+    JOIN pg_type t ON t.oid = e.enumtypid
+    JOIN pg_namespace n ON n.oid = t.typnamespace
+    WHERE n.nspname = 'public'
+      AND t.typname = 'BillingTransactionFailureCategory'
+      AND e.enumlabel = 'RAZORPAY_PAYMENT'
+  ) THEN
+    ALTER TYPE "public"."BillingTransactionFailureCategory" RENAME VALUE 'RAZORPAY_PAYMENT' TO 'PAYMENT';
+  END IF;
+END $$;

package/prisma/schema/organisation.prisma

@@ -59,6 +59,11 @@ model Organisation {
   timezone                  String                   @default("Asia/Kolkata")
   /// ISO 3166-1 alpha-2 (e.g. IN).
   country_code              String                   @default("IN")
+  /// Customer GSTIN; first 2 digits give the state for the CGST/SGST vs IGST split.
+  /// Optional: an Indian org without one is still charged GST.
+  gstin                     String?
+  /// Currency the organisation is billed in (INR or USD). Catalogue and checkout use only packages in this currency.
+  billing_currency          String                   @default("INR")
   /// Who may consume unused hiring units. Does not rewrite unit rows when changed.
   hiring_unit_assignment_scope HiringUnitAssignmentScope @default(DEPARTMENT)
   organisation_configs      OrganisationConfig[]
@@ -86,6 +91,9 @@ model Organisation {
   license_package_organisations  LicensePackageOrganisation[]
   ai_cost_ledger_entries         AiCostLedgerEntry[]
   consent_documents              ConsentDocument[]
+  billing_transactions      BillingTransaction[]
+  payment_webhook_events    PaymentWebhookEvent[]
+  invoices                  Invoice[]
 
   @@index([name])
   @@schema("public")

package/prisma/schema/payment/billingTransaction.prisma

@@ -0,0 +1,87 @@
+// PAYMENT SERVICE boundary — portable payment microservice owns these enums/columns.
+
+enum BillingTransactionStatus {
+  INITIATED
+  ORDER_CREATED
+  PAYMENT_PENDING
+  SUCCESS
+  FAILED
+  CANCELLED
+  REFUND_PENDING
+  REFUND_FAILED
+  REFUNDED
+
+  @@schema("public")
+}
+
+enum BillingTransactionType {
+  PURCHASE
+  TOP_UP
+  REFUND
+
+  @@schema("public")
+}
+
+/// Provider-neutral failure stage; provider detail goes in failure_reason.
+enum BillingTransactionFailureCategory {
+  ORDER
+  PAYMENT
+  REFUND
+  INTERNAL
+
+  @@schema("public")
+}
+
+/// Payment reconciliation state when Treadspace status is FAILED but Razorpay captured payment.
+enum BillingPaymentMismatchStatus {
+  DETECTED
+  UNFULFILLED
+
+  @@schema("public")
+}
+
+/// Financial transaction lifecycle for organisation billing purchases.
+model BillingTransaction {
+  id                               String                           @id @default(uuid())
+  organisation_id                  String
+  /// Opaque plan/product identity supplied at checkout. Not a catalog FK.
+  purchase_reference               String
+  /// Human-readable snapshot captured at checkout for invoices and receipts.
+  purchase_display_name            String?
+  transaction_type                 BillingTransactionType
+  status                           BillingTransactionStatus         @default(INITIATED)
+  failure_category                 BillingTransactionFailureCategory?
+  /// Human-readable or provider detail (e.g. Razorpay error_description).
+  failure_reason                   String?
+  amount                           Int
+  currency                         String                           @default("INR")
+  razorpay_order_id                String?
+  razorpay_payment_id              String?                          @unique
+  /// Razorpay payment method at capture (card, netbanking, upi, wallet, etc.).
+  payment_method                   String?
+  razorpay_subscription_id         String?
+  razorpay_refund_id               String?
+  refund_reason                    String?
+  refund_amount                    Int?
+  idempotency_key                  String                           @unique
+  /// Email of the org Admin who initiated checkout (bill-to).
+  purchaser_email                  String?
+  /// User id of the org Admin who started checkout; actor for fulfilment and the invoice.
+  created_by                       String?
+  /// Set when FAILED but Razorpay order/payment is captured (reconciliation path).
+  payment_mismatch_status          BillingPaymentMismatchStatus?
+  /// Strict same-intent SUCCESS transaction that fulfilled the purchase (UNFULFILLED only).
+  payment_mismatch_fulfilled_by_id String?
+  created_at                       DateTime                         @default(now())
+  updated_at                       DateTime                         @updatedAt
+
+  organisation Organisation @relation(fields: [organisation_id], references: [id])
+  /// Tax invoice issued for this payment (set once fulfilled).
+  invoice      Invoice?
+
+  @@index([organisation_id, status])
+  @@index([purchase_reference])
+  @@index([razorpay_order_id])
+  @@map("billing_transactions")
+  @@schema("public")
+}

package/prisma/schema/payment/invoice.prisma

@@ -0,0 +1,68 @@
+// Tax invoices issued by Treadspace. Shared by license package purchases and (later) platform subscriptions.
+
+/// What the invoice was raised for.
+enum InvoiceKind {
+  PACKAGE
+
+  @@schema("public")
+}
+
+/// Tax invoice. Raised only after money is received (or for a zero-amount purchase). Immutable once written.
+/// All amounts are integer minor units (paise / cents); total = cost + tax + fee + fee_tax (not stored).
+model Invoice {
+  id                     String      @id @default(uuid())
+  /// Sequential number, e.g. TS/26-27/000001 (at most 16 chars). The financial year is part of the number.
+  invoice_number         String      @unique
+  kind                   InvoiceKind
+  organisation_id        String
+  /// Payment that funded this invoice. Null for zero-amount purchases.
+  billing_transaction_id String?     @unique
+  currency               String
+  /// Optional line description snapshot, e.g. "Pro hiring pack (v2)".
+  description            String?
+  quantity               Int
+  /// Net cost of the goods/service (excludes GST and processing fee).
+  cost_amount            Int
+  /// GST on cost. 0 for non-Indian organisations.
+  tax_amount             Int
+  /// Payment processing fee.
+  fee_amount             Int
+  /// GST on the processing fee. 0 for non-Indian organisations.
+  fee_tax_amount         Int
+  /// GST rate in basis points (1800 = 18%) at issue time.
+  tax_rate_bps           Int
+  /// Processing fee rate in basis points (200 = 2%) at issue time.
+  fee_rate_bps           Int
+  /// Buyer snapshot from the organisation at issue time.
+  buyer_name             String
+  buyer_address          String
+  /// ISO 3166-1 alpha-2 (e.g. IN).
+  buyer_country_code     String
+  buyer_gstin            String?
+  /// Seller snapshot at issue time: { name, gstin, address, sac }.
+  seller_snapshot        Json
+  issued_at              DateTime    @default(now())
+  created_at             DateTime    @default(now())
+  /// User id that triggered the issue (checkout admin), or "system".
+  created_by             String
+
+  organisation              Organisation             @relation(fields: [organisation_id], references: [id], onDelete: Restrict)
+  billing_transaction       BillingTransaction?      @relation(fields: [billing_transaction_id], references: [id], onDelete: Restrict)
+  purchased_license_package PurchasedLicensePackage?
+
+  @@index([organisation_id, issued_at])
+  @@map("invoices")
+  @@schema("public")
+}
+
+/// Invoice number counter: one row per financial year (e.g. "2026-27"); the key only lives here, not on Invoice.
+/// Incremented inside the invoice-issuing transaction: concurrent issues wait on the row lock (no duplicate
+/// numbers, no retries) and a rolled-back issue rolls the counter back too (no gaps).
+model InvoiceSequence {
+  financial_year String   @id
+  last_sequence  Int      @default(0)
+  updated_at     DateTime @updatedAt
+
+  @@map("invoice_sequences")
+  @@schema("public")
+}

package/prisma/schema/payment/paymentWebhookEvent.prisma

@@ -0,0 +1,28 @@
+enum PaymentWebhookEventStatus {
+  RECEIVED
+  PROCESSED
+  FAILED
+
+  @@schema("public")
+}
+
+/// Idempotent record of payment provider webhook deliveries.
+model PaymentWebhookEvent {
+  id                     String                    @id @default(uuid())
+  organisation_id        String?
+  provider               String
+  provider_event_id      String
+  event_type             String
+  status                 PaymentWebhookEventStatus @default(RECEIVED)
+  billing_transaction_id String?
+  error_message          String?
+  processed_at           DateTime?
+  created_at             DateTime                  @default(now())
+
+  organisation Organisation? @relation(fields: [organisation_id], references: [id])
+
+  @@unique([provider, provider_event_id])
+  @@index([status, created_at])
+  @@map("payment_webhook_events")
+  @@schema("public")
+}