@adaptware/eagles-db 0.5.33 → 0.5.34

package/prisma/schema/migrations/20260810120000_add_licensing_schema/migration.sql

@@ -0,0 +1,237 @@
+-- CreateSchema
+CREATE SCHEMA IF NOT EXISTS "licensing";
+
+-- CreateEnum
+CREATE TYPE "licensing"."LicensePackageStatus" AS ENUM ('DRAFT', 'ACTIVE', 'ARCHIVED');
+
+-- CreateEnum
+CREATE TYPE "licensing"."PurchasedLicensePackageStatus" AS ENUM ('ACTIVE', 'EXPIRED', 'CANCELLED');
+
+-- CreateEnum
+CREATE TYPE "licensing"."PurchasedHiringUnitStatus" AS ENUM ('AVAILABLE', 'ASSIGNED', 'ACTIVE', 'EXHAUSTED', 'DEACTIVATED');
+
+-- CreateEnum
+CREATE TYPE "licensing"."PurchasedTopUpStatus" AS ENUM ('ACTIVE', 'DEPLETED', 'CANCELLED');
+
+-- CreateEnum
+CREATE TYPE "licensing"."PurchasedHiringUnitAssignmentEventKind" AS ENUM ('DEPARTMENT_ASSIGNED', 'DEPARTMENT_UNASSIGNED', 'JOB_LINKED', 'JOB_UNLINKED');
+
+-- CreateTable
+CREATE TABLE "licensing"."license_packages" (
+    "id" TEXT NOT NULL,
+    "code" TEXT NOT NULL,
+    "version" INTEGER NOT NULL,
+    "name" TEXT NOT NULL,
+    "description" TEXT,
+    "price" DECIMAL(18,2) NOT NULL,
+    "currency" TEXT NOT NULL DEFAULT 'INR',
+    "status" "licensing"."LicensePackageStatus" NOT NULL DEFAULT 'DRAFT',
+    "units_per_purchase" INTEGER NOT NULL,
+    "interview_ai_assisted_hours" DECIMAL(20,4),
+    "interview_full_ai_hours" DECIMAL(20,4),
+    "interview_non_ai_hours" DECIMAL(20,4),
+    "assignment_count" DECIMAL(20,4),
+    "test_count" DECIMAL(20,4),
+    "resume_count" DECIMAL(20,4),
+    "credits" DECIMAL(20,4),
+    "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 "license_packages_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "licensing"."purchased_license_packages" (
+    "id" TEXT NOT NULL,
+    "organisation_id" TEXT NOT NULL,
+    "license_package_id" TEXT NOT NULL,
+    "package_code" TEXT NOT NULL,
+    "package_version" INTEGER NOT NULL,
+    "package_name" TEXT NOT NULL,
+    "price" DECIMAL(18,2) NOT NULL,
+    "currency" TEXT NOT NULL DEFAULT 'INR',
+    "units_per_purchase" INTEGER NOT NULL,
+    "package_quantity" INTEGER NOT NULL DEFAULT 1,
+    "purchased_at" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "status" "licensing"."PurchasedLicensePackageStatus" NOT NULL DEFAULT 'ACTIVE',
+    "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 "purchased_license_packages_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "licensing"."purchased_hiring_units" (
+    "id" TEXT NOT NULL,
+    "organisation_id" TEXT NOT NULL,
+    "purchased_license_package_id" TEXT NOT NULL,
+    "unit_sequence" INTEGER NOT NULL,
+    "status" "licensing"."PurchasedHiringUnitStatus" NOT NULL DEFAULT 'AVAILABLE',
+    "department_id" TEXT,
+    "first_assigned_at" TIMESTAMP(3),
+    "expiry_at" TIMESTAMP(3),
+    "job_description_id" TEXT,
+    "interview_ai_assisted_hours" DECIMAL(20,4),
+    "interview_full_ai_hours" DECIMAL(20,4),
+    "interview_non_ai_hours" DECIMAL(20,4),
+    "assignment_count" DECIMAL(20,4),
+    "test_count" DECIMAL(20,4),
+    "resume_count" DECIMAL(20,4),
+    "credits" DECIMAL(20,4),
+    "interview_ai_assisted_hours_consumed" DECIMAL(20,4) DEFAULT 0,
+    "interview_full_ai_hours_consumed" DECIMAL(20,4) DEFAULT 0,
+    "interview_non_ai_hours_consumed" DECIMAL(20,4) DEFAULT 0,
+    "assignment_count_consumed" DECIMAL(20,4) DEFAULT 0,
+    "test_count_consumed" DECIMAL(20,4) DEFAULT 0,
+    "resume_count_consumed" DECIMAL(20,4) DEFAULT 0,
+    "credits_consumed" DECIMAL(20,4) DEFAULT 0,
+    "interview_ai_assisted_hours_topup" DECIMAL(20,4) DEFAULT 0,
+    "interview_full_ai_hours_topup" DECIMAL(20,4) DEFAULT 0,
+    "interview_non_ai_hours_topup" DECIMAL(20,4) DEFAULT 0,
+    "assignment_count_topup" DECIMAL(20,4) DEFAULT 0,
+    "test_count_topup" DECIMAL(20,4) DEFAULT 0,
+    "resume_count_topup" DECIMAL(20,4) DEFAULT 0,
+    "credits_topup" DECIMAL(20,4) DEFAULT 0,
+    "interview_ai_assisted_hours_updated" DECIMAL(20,4),
+    "interview_full_ai_hours_updated" DECIMAL(20,4),
+    "interview_non_ai_hours_updated" DECIMAL(20,4),
+    "assignment_count_updated" DECIMAL(20,4),
+    "test_count_updated" DECIMAL(20,4),
+    "resume_count_updated" DECIMAL(20,4),
+    "credits_updated" DECIMAL(20,4),
+    "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 "purchased_hiring_units_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "licensing"."purchased_top_ups" (
+    "id" TEXT NOT NULL,
+    "organisation_id" TEXT NOT NULL,
+    "purchased_at" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "status" "licensing"."PurchasedTopUpStatus" NOT NULL DEFAULT 'ACTIVE',
+    "total_price" DECIMAL(18,2),
+    "currency" TEXT DEFAULT 'INR',
+    "description" TEXT,
+    "interview_ai_assisted_hours_purchased" DECIMAL(20,4),
+    "interview_full_ai_hours_purchased" DECIMAL(20,4),
+    "interview_non_ai_hours_purchased" DECIMAL(20,4),
+    "assignment_count_purchased" DECIMAL(20,4),
+    "test_count_purchased" DECIMAL(20,4),
+    "resume_count_purchased" DECIMAL(20,4),
+    "credits_purchased" DECIMAL(20,4),
+    "interview_ai_assisted_hours_remaining" DECIMAL(20,4),
+    "interview_full_ai_hours_remaining" DECIMAL(20,4),
+    "interview_non_ai_hours_remaining" DECIMAL(20,4),
+    "assignment_count_remaining" DECIMAL(20,4),
+    "test_count_remaining" DECIMAL(20,4),
+    "resume_count_remaining" DECIMAL(20,4),
+    "credits_remaining" DECIMAL(20,4),
+    "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 "purchased_top_ups_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "licensing"."purchased_hiring_unit_assignment_events" (
+    "id" TEXT NOT NULL,
+    "purchased_hiring_unit_id" TEXT NOT NULL,
+    "event_kind" "licensing"."PurchasedHiringUnitAssignmentEventKind" NOT NULL,
+    "previous_department_id" TEXT,
+    "new_department_id" TEXT,
+    "previous_job_description_id" TEXT,
+    "new_job_description_id" TEXT,
+    "effective_at" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "created_by" TEXT NOT NULL,
+
+    CONSTRAINT "purchased_hiring_unit_assignment_events_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateIndex
+CREATE INDEX "license_packages_code_idx" ON "licensing"."license_packages"("code");
+
+-- CreateIndex
+CREATE INDEX "license_packages_status_idx" ON "licensing"."license_packages"("status");
+
+-- CreateIndex
+CREATE UNIQUE INDEX "license_packages_code_version_key" ON "licensing"."license_packages"("code", "version");
+
+-- CreateIndex
+CREATE INDEX "purchased_license_packages_organisation_id_idx" ON "licensing"."purchased_license_packages"("organisation_id");
+
+-- CreateIndex
+CREATE INDEX "purchased_license_packages_organisation_id_status_idx" ON "licensing"."purchased_license_packages"("organisation_id", "status");
+
+-- CreateIndex
+CREATE INDEX "purchased_license_packages_organisation_id_purchased_at_idx" ON "licensing"."purchased_license_packages"("organisation_id", "purchased_at");
+
+-- CreateIndex
+CREATE INDEX "purchased_hiring_units_organisation_id_idx" ON "licensing"."purchased_hiring_units"("organisation_id");
+
+-- CreateIndex
+CREATE INDEX "purchased_hiring_units_purchased_license_package_id_idx" ON "licensing"."purchased_hiring_units"("purchased_license_package_id");
+
+-- CreateIndex
+CREATE INDEX "purchased_hiring_units_department_id_idx" ON "licensing"."purchased_hiring_units"("department_id");
+
+-- CreateIndex
+CREATE INDEX "purchased_hiring_units_job_description_id_idx" ON "licensing"."purchased_hiring_units"("job_description_id");
+
+-- CreateIndex
+CREATE INDEX "purchased_hiring_units_organisation_id_status_idx" ON "licensing"."purchased_hiring_units"("organisation_id", "status");
+
+-- CreateIndex
+CREATE INDEX "purchased_hiring_units_organisation_id_department_id_idx" ON "licensing"."purchased_hiring_units"("organisation_id", "department_id");
+
+-- CreateIndex
+CREATE INDEX "purchased_hiring_units_organisation_id_job_description_id_idx" ON "licensing"."purchased_hiring_units"("organisation_id", "job_description_id");
+
+-- CreateIndex
+CREATE INDEX "purchased_top_ups_organisation_id_idx" ON "licensing"."purchased_top_ups"("organisation_id");
+
+-- CreateIndex
+CREATE INDEX "purchased_top_ups_organisation_id_status_idx" ON "licensing"."purchased_top_ups"("organisation_id", "status");
+
+-- CreateIndex
+CREATE INDEX "purchased_hu_assignment_events_unit_id_idx" ON "licensing"."purchased_hiring_unit_assignment_events"("purchased_hiring_unit_id");
+
+-- CreateIndex
+CREATE INDEX "purchased_hu_assignment_events_unit_effective_idx" ON "licensing"."purchased_hiring_unit_assignment_events"("purchased_hiring_unit_id", "effective_at");
+
+-- AddForeignKey
+ALTER TABLE "licensing"."purchased_license_packages" ADD CONSTRAINT "purchased_license_packages_organisation_id_fkey" FOREIGN KEY ("organisation_id") REFERENCES "Organisation"("id") ON DELETE RESTRICT ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "licensing"."purchased_license_packages" ADD CONSTRAINT "purchased_license_packages_license_package_id_fkey" FOREIGN KEY ("license_package_id") REFERENCES "licensing"."license_packages"("id") ON DELETE RESTRICT ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "licensing"."purchased_hiring_units" ADD CONSTRAINT "purchased_hiring_units_organisation_id_fkey" FOREIGN KEY ("organisation_id") REFERENCES "Organisation"("id") ON DELETE RESTRICT ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "licensing"."purchased_hiring_units" ADD CONSTRAINT "purchased_hiring_units_purchased_license_package_id_fkey" FOREIGN KEY ("purchased_license_package_id") REFERENCES "licensing"."purchased_license_packages"("id") ON DELETE RESTRICT ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "licensing"."purchased_hiring_units" ADD CONSTRAINT "purchased_hiring_units_department_id_fkey" FOREIGN KEY ("department_id") REFERENCES "Department"("id") ON DELETE SET NULL ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "licensing"."purchased_hiring_units" ADD CONSTRAINT "purchased_hiring_units_job_description_id_fkey" FOREIGN KEY ("job_description_id") REFERENCES "JobDescription"("id") ON DELETE SET NULL ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "licensing"."purchased_top_ups" ADD CONSTRAINT "purchased_top_ups_organisation_id_fkey" FOREIGN KEY ("organisation_id") REFERENCES "Organisation"("id") ON DELETE RESTRICT ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "licensing"."purchased_hiring_unit_assignment_events" ADD CONSTRAINT "purchased_hiring_unit_assignment_events_purchased_hiring_u_fkey" FOREIGN KEY ("purchased_hiring_unit_id") REFERENCES "licensing"."purchased_hiring_units"("id") ON DELETE RESTRICT ON UPDATE CASCADE;

package/prisma/schema/migrations/20260814153000_add_licensing_ledger/migration.sql

@@ -0,0 +1,236 @@
+-- CreateEnum
+CREATE TYPE "licensing"."LicensingLedgerEntitlementType" AS ENUM (
+  'INTERVIEW_AI_ASSISTED_HOURS',
+  'INTERVIEW_FULL_AI_HOURS',
+  'INTERVIEW_NON_AI_HOURS',
+  'ASSIGNMENT_COUNT',
+  'TEST_COUNT',
+  'RESUME_COUNT',
+  'CREDITS'
+);
+
+-- CreateEnum
+CREATE TYPE "licensing"."LicensingLedgerDirection" AS ENUM ('CREDIT', 'DEBIT');
+
+-- CreateEnum
+CREATE TYPE "licensing"."LicensingLedgerReason" AS ENUM (
+  'PURCHASE',
+  'TOP_UP',
+  'USAGE',
+  'ADJUSTMENT',
+  'REFUND',
+  'EXPIRY'
+);
+
+-- CreateTable
+CREATE TABLE "licensing"."licensing_ledger" (
+    "id" TEXT NOT NULL,
+    "organisation_id" TEXT NOT NULL,
+    "purchased_hiring_unit_id" TEXT,
+    "entitlement_type" "licensing"."LicensingLedgerEntitlementType" NOT NULL,
+    "direction" "licensing"."LicensingLedgerDirection" NOT NULL,
+    "amount" DECIMAL(20,4) NOT NULL,
+    "reason" "licensing"."LicensingLedgerReason" NOT NULL,
+    "occurred_at" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "source_type" TEXT,
+    "source_id" TEXT,
+    "description" TEXT,
+    "idempotency_key" TEXT NOT NULL,
+    "created_at" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updated_at" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "created_by" TEXT NOT NULL,
+    "updated_by" TEXT NOT NULL,
+    "is_active" BOOLEAN NOT NULL DEFAULT true,
+
+    CONSTRAINT "licensing_ledger_pkey" PRIMARY KEY ("id"),
+    CONSTRAINT "licensing_ledger_amount_non_negative" CHECK ("amount" >= 0)
+);
+
+-- CreateIndex
+CREATE UNIQUE INDEX "licensing_ledger_idempotency_key_key" ON "licensing"."licensing_ledger"("idempotency_key");
+
+-- CreateIndex
+CREATE INDEX "licensing_ledger_unit_type_occurred_idx" ON "licensing"."licensing_ledger"("purchased_hiring_unit_id", "entitlement_type", "occurred_at");
+
+-- CreateIndex
+CREATE INDEX "licensing_ledger_org_type_occurred_idx" ON "licensing"."licensing_ledger"("organisation_id", "entitlement_type", "occurred_at");
+
+-- AddForeignKey
+ALTER TABLE "licensing"."licensing_ledger" ADD CONSTRAINT "licensing_ledger_organisation_id_fkey" FOREIGN KEY ("organisation_id") REFERENCES "Organisation"("id") ON DELETE RESTRICT ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "licensing"."licensing_ledger" ADD CONSTRAINT "licensing_ledger_purchased_hiring_unit_id_fkey" FOREIGN KEY ("purchased_hiring_unit_id") REFERENCES "licensing"."purchased_hiring_units"("id") ON DELETE RESTRICT ON UPDATE CASCADE;
+
+-- Backfill PURCHASE credits from COALESCE(updated, base) when not null.
+INSERT INTO "licensing"."licensing_ledger" (
+    "id",
+    "organisation_id",
+    "purchased_hiring_unit_id",
+    "entitlement_type",
+    "direction",
+    "amount",
+    "reason",
+    "occurred_at",
+    "source_type",
+    "source_id",
+    "idempotency_key",
+    "created_at",
+    "updated_at",
+    "created_by",
+    "updated_by",
+    "is_active"
+)
+SELECT
+    gen_random_uuid()::text,
+    u."organisation_id",
+    u."id",
+    stem.entitlement_type::"licensing"."LicensingLedgerEntitlementType",
+    'CREDIT'::"licensing"."LicensingLedgerDirection",
+    COALESCE(stem.updated_amount, stem.base_amount),
+    'PURCHASE'::"licensing"."LicensingLedgerReason",
+    u."created_at",
+    'purchased_license_package',
+    u."purchased_license_package_id",
+    'purchase:' || u."id" || ':' || stem.entitlement_type,
+    u."created_at",
+    u."updated_at",
+    u."created_by",
+    u."updated_by",
+    true
+FROM "licensing"."purchased_hiring_units" u
+CROSS JOIN LATERAL (
+    VALUES
+        ('INTERVIEW_AI_ASSISTED_HOURS', u."interview_ai_assisted_hours", u."interview_ai_assisted_hours_updated"),
+        ('INTERVIEW_FULL_AI_HOURS', u."interview_full_ai_hours", u."interview_full_ai_hours_updated"),
+        ('INTERVIEW_NON_AI_HOURS', u."interview_non_ai_hours", u."interview_non_ai_hours_updated"),
+        ('ASSIGNMENT_COUNT', u."assignment_count", u."assignment_count_updated"),
+        ('TEST_COUNT', u."test_count", u."test_count_updated"),
+        ('RESUME_COUNT', u."resume_count", u."resume_count_updated"),
+        ('CREDITS', u."credits", u."credits_updated")
+) AS stem(entitlement_type, base_amount, updated_amount)
+WHERE COALESCE(stem.updated_amount, stem.base_amount) IS NOT NULL;
+
+-- Backfill TOP_UP credits when allocated top-up is greater than zero.
+INSERT INTO "licensing"."licensing_ledger" (
+    "id",
+    "organisation_id",
+    "purchased_hiring_unit_id",
+    "entitlement_type",
+    "direction",
+    "amount",
+    "reason",
+    "occurred_at",
+    "source_type",
+    "idempotency_key",
+    "created_at",
+    "updated_at",
+    "created_by",
+    "updated_by",
+    "is_active"
+)
+SELECT
+    gen_random_uuid()::text,
+    u."organisation_id",
+    u."id",
+    stem.entitlement_type::"licensing"."LicensingLedgerEntitlementType",
+    'CREDIT'::"licensing"."LicensingLedgerDirection",
+    stem.topup_amount,
+    'TOP_UP'::"licensing"."LicensingLedgerReason",
+    u."updated_at",
+    'purchased_top_up',
+    'topup-backfill:' || u."id" || ':' || stem.entitlement_type,
+    u."created_at",
+    u."updated_at",
+    u."created_by",
+    u."updated_by",
+    true
+FROM "licensing"."purchased_hiring_units" u
+CROSS JOIN LATERAL (
+    VALUES
+        ('INTERVIEW_AI_ASSISTED_HOURS', u."interview_ai_assisted_hours_topup"),
+        ('INTERVIEW_FULL_AI_HOURS', u."interview_full_ai_hours_topup"),
+        ('INTERVIEW_NON_AI_HOURS', u."interview_non_ai_hours_topup"),
+        ('ASSIGNMENT_COUNT', u."assignment_count_topup"),
+        ('TEST_COUNT', u."test_count_topup"),
+        ('RESUME_COUNT', u."resume_count_topup"),
+        ('CREDITS', u."credits_topup")
+) AS stem(entitlement_type, topup_amount)
+WHERE stem.topup_amount IS NOT NULL AND stem.topup_amount > 0;
+
+-- Backfill USAGE debits when consumed is greater than zero.
+INSERT INTO "licensing"."licensing_ledger" (
+    "id",
+    "organisation_id",
+    "purchased_hiring_unit_id",
+    "entitlement_type",
+    "direction",
+    "amount",
+    "reason",
+    "occurred_at",
+    "source_type",
+    "idempotency_key",
+    "created_at",
+    "updated_at",
+    "created_by",
+    "updated_by",
+    "is_active"
+)
+SELECT
+    gen_random_uuid()::text,
+    u."organisation_id",
+    u."id",
+    stem.entitlement_type::"licensing"."LicensingLedgerEntitlementType",
+    'DEBIT'::"licensing"."LicensingLedgerDirection",
+    stem.consumed_amount,
+    'USAGE'::"licensing"."LicensingLedgerReason",
+    u."updated_at",
+    'usage_ledger',
+    'usage-backfill:' || u."id" || ':' || stem.entitlement_type,
+    u."created_at",
+    u."updated_at",
+    u."created_by",
+    u."updated_by",
+    true
+FROM "licensing"."purchased_hiring_units" u
+CROSS JOIN LATERAL (
+    VALUES
+        ('INTERVIEW_AI_ASSISTED_HOURS', u."interview_ai_assisted_hours_consumed"),
+        ('INTERVIEW_FULL_AI_HOURS', u."interview_full_ai_hours_consumed"),
+        ('INTERVIEW_NON_AI_HOURS', u."interview_non_ai_hours_consumed"),
+        ('ASSIGNMENT_COUNT', u."assignment_count_consumed"),
+        ('TEST_COUNT', u."test_count_consumed"),
+        ('RESUME_COUNT', u."resume_count_consumed"),
+        ('CREDITS', u."credits_consumed")
+) AS stem(entitlement_type, consumed_amount)
+WHERE stem.consumed_amount IS NOT NULL AND stem.consumed_amount > 0;
+
+-- Drop the wide balance columns from purchased_hiring_units.
+ALTER TABLE "licensing"."purchased_hiring_units"
+    DROP COLUMN "interview_ai_assisted_hours",
+    DROP COLUMN "interview_full_ai_hours",
+    DROP COLUMN "interview_non_ai_hours",
+    DROP COLUMN "assignment_count",
+    DROP COLUMN "test_count",
+    DROP COLUMN "resume_count",
+    DROP COLUMN "credits",
+    DROP COLUMN "interview_ai_assisted_hours_consumed",
+    DROP COLUMN "interview_full_ai_hours_consumed",
+    DROP COLUMN "interview_non_ai_hours_consumed",
+    DROP COLUMN "assignment_count_consumed",
+    DROP COLUMN "test_count_consumed",
+    DROP COLUMN "resume_count_consumed",
+    DROP COLUMN "credits_consumed",
+    DROP COLUMN "interview_ai_assisted_hours_topup",
+    DROP COLUMN "interview_full_ai_hours_topup",
+    DROP COLUMN "interview_non_ai_hours_topup",
+    DROP COLUMN "assignment_count_topup",
+    DROP COLUMN "test_count_topup",
+    DROP COLUMN "resume_count_topup",
+    DROP COLUMN "credits_topup",
+    DROP COLUMN "interview_ai_assisted_hours_updated",
+    DROP COLUMN "interview_full_ai_hours_updated",
+    DROP COLUMN "interview_non_ai_hours_updated",
+    DROP COLUMN "assignment_count_updated",
+    DROP COLUMN "test_count_updated",
+    DROP COLUMN "resume_count_updated",
+    DROP COLUMN "credits_updated";

package/prisma/schema/migrations/20260828120000_license_package_orgs_cost_price_ai_cost_ledger/migration.sql

@@ -0,0 +1,74 @@
+-- AlterTable
+ALTER TABLE "licensing"."license_packages"
+    ADD COLUMN "cost_price" DECIMAL(18,2) NOT NULL DEFAULT 0;
+
+-- CreateEnum
+CREATE TYPE "licensing"."AiCostLedgerReason" AS ENUM ('USAGE', 'ADJUSTMENT', 'REFUND');
+
+-- CreateTable
+CREATE TABLE "licensing"."license_package_organisations" (
+    "id" TEXT NOT NULL,
+    "license_package_id" TEXT NOT NULL,
+    "organisation_id" TEXT NOT NULL,
+    "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 "license_package_organisations_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "licensing"."ai_cost_ledger" (
+    "id" TEXT NOT NULL,
+    "organisation_id" TEXT NOT NULL,
+    "purchased_hiring_unit_id" TEXT NOT NULL,
+    "workflow_name" TEXT NOT NULL,
+    "direction" "licensing"."LicensingLedgerDirection" NOT NULL,
+    "amount" DECIMAL(20,4) NOT NULL,
+    "reason" "licensing"."AiCostLedgerReason" NOT NULL,
+    "occurred_at" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "source_type" TEXT,
+    "source_id" TEXT,
+    "description" TEXT,
+    "idempotency_key" TEXT NOT NULL,
+    "created_at" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updated_at" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "created_by" TEXT NOT NULL,
+    "updated_by" TEXT NOT NULL,
+    "is_active" BOOLEAN NOT NULL DEFAULT true,
+
+    CONSTRAINT "ai_cost_ledger_pkey" PRIMARY KEY ("id"),
+    CONSTRAINT "ai_cost_ledger_amount_non_negative" CHECK ("amount" >= 0)
+);
+
+-- CreateIndex
+CREATE UNIQUE INDEX "license_package_orgs_pkg_org_key" ON "licensing"."license_package_organisations"("license_package_id", "organisation_id");
+
+-- CreateIndex
+CREATE INDEX "license_package_organisations_organisation_id_idx" ON "licensing"."license_package_organisations"("organisation_id");
+
+-- CreateIndex
+CREATE UNIQUE INDEX "ai_cost_ledger_idempotency_key_key" ON "licensing"."ai_cost_ledger"("idempotency_key");
+
+-- CreateIndex
+CREATE INDEX "ai_cost_ledger_unit_occurred_idx" ON "licensing"."ai_cost_ledger"("purchased_hiring_unit_id", "occurred_at");
+
+-- CreateIndex
+CREATE INDEX "ai_cost_ledger_unit_workflow_occurred_idx" ON "licensing"."ai_cost_ledger"("purchased_hiring_unit_id", "workflow_name", "occurred_at");
+
+-- CreateIndex
+CREATE INDEX "ai_cost_ledger_org_occurred_idx" ON "licensing"."ai_cost_ledger"("organisation_id", "occurred_at");
+
+-- AddForeignKey
+ALTER TABLE "licensing"."license_package_organisations" ADD CONSTRAINT "license_package_organisations_license_package_id_fkey" FOREIGN KEY ("license_package_id") REFERENCES "licensing"."license_packages"("id") ON DELETE RESTRICT ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "licensing"."license_package_organisations" ADD CONSTRAINT "license_package_organisations_organisation_id_fkey" FOREIGN KEY ("organisation_id") REFERENCES "Organisation"("id") ON DELETE RESTRICT ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "licensing"."ai_cost_ledger" ADD CONSTRAINT "ai_cost_ledger_organisation_id_fkey" FOREIGN KEY ("organisation_id") REFERENCES "Organisation"("id") ON DELETE RESTRICT ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "licensing"."ai_cost_ledger" ADD CONSTRAINT "ai_cost_ledger_purchased_hiring_unit_id_fkey" FOREIGN KEY ("purchased_hiring_unit_id") REFERENCES "licensing"."purchased_hiring_units"("id") ON DELETE RESTRICT ON UPDATE CASCADE;

package/prisma/schema/migrations/20260831120000_ai_cost_ledger_purchase_reason/migration.sql

@@ -0,0 +1,2 @@
+-- AlterEnum
+ALTER TYPE "licensing"."AiCostLedgerReason" ADD VALUE 'PURCHASE' BEFORE 'USAGE';

package/prisma/schema/migrations/20260831140000_ai_cost_ledger_nullable_hiring_unit/migration.sql

@@ -0,0 +1,3 @@
+-- Allow USAGE rows with no hiring unit (org pool).
+ALTER TABLE "licensing"."ai_cost_ledger"
+  ALTER COLUMN "purchased_hiring_unit_id" DROP NOT NULL;

package/prisma/schema/organisation.prisma

@@ -68,6 +68,12 @@ model Organisation {
   hiring_plans              HiringPlan[]
   employees                 Employee[]
   competency_dictionaries   CompetencyDictionary[]
+  purchased_license_packages     PurchasedLicensePackage[]
+  purchased_hiring_units         PurchasedHiringUnit[]
+  purchased_top_ups              PurchasedTopUp[]
+  licensing_ledger_entries       LicensingLedgerEntry[]
+  license_package_organisations  LicensePackageOrganisation[]
+  ai_cost_ledger_entries         AiCostLedgerEntry[]
 
   @@index([name])
   @@schema("public")

package/prisma/schema/schema.prisma

@@ -14,5 +14,5 @@ datasource db {
   provider = "postgresql"
   url      = env("DATABASE_URL")
 
-  schemas = ["public", "analytics", "usage"]
+  schemas = ["public", "analytics", "usage", "licensing"]
 }

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

@@ -1,25 +0,0 @@
--- 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

@@ -1,24 +0,0 @@
--- 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

@@ -1,2 +0,0 @@
--- 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

@@ -1,9 +0,0 @@
--- 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

@@ -1,8 +0,0 @@
--- 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;