carmanagement/packages/database/prisma/migrations/20260810130000_subscription_upgrade_requests/migration.sql

CREATE TYPE "SubscriptionUpgradeRequestType" AS ENUM (
  'IMMEDIATE_PRORATED',
  'AT_RENEWAL',
  'TERM_RESET'
);

CREATE TYPE "SubscriptionUpgradeRequestStatus" AS ENUM (
  'DRAFT',
  'QUOTED',
  'PAYMENT_PENDING',
  'PAYMENT_REVIEW',
  'CORRECTION_REQUIRED',
  'APPROVED',
  'ACTIVATED',
  'SCHEDULED',
  'REJECTED',
  'EXPIRED',
  'CANCELLED',
  'ACTIVATION_FAILED',
  'SUPERSEDED'
);

CREATE TABLE "subscription_upgrade_requests" (
  "id" TEXT NOT NULL,
  "companyId" TEXT NOT NULL,
  "subscriptionId" TEXT NOT NULL,
  "requestType" "SubscriptionUpgradeRequestType" NOT NULL,
  "fromPlan" "Plan" NOT NULL,
  "fromBillingPeriod" "BillingPeriod" NOT NULL,
  "toPlan" "Plan" NOT NULL,
  "toBillingPeriod" "BillingPeriod" NOT NULL,
  "status" "SubscriptionUpgradeRequestStatus" NOT NULL DEFAULT 'DRAFT',
  "requestedByEmployeeId" TEXT NOT NULL,
  "requestedAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
  "effectiveAt" TIMESTAMP(3),
  "scheduledFor" TIMESTAMP(3),
  "quoteId" TEXT,
  "companyLanguageSnapshot" TEXT NOT NULL DEFAULT 'en',
  "billingTimezoneSnapshot" TEXT NOT NULL DEFAULT 'Africa/Casablanca',
  "acceptedTermsVersion" TEXT,
  "acceptedAt" TIMESTAMP(3),
  "cancelledAt" TIMESTAMP(3),
  "cancelledByEmployeeId" TEXT,
  "cancellationReason" TEXT,
  "expiresAt" TIMESTAMP(3),
  "billingInvoiceId" TEXT,
  "approvedPaymentAttemptId" TEXT,
  "approvedByAdminId" TEXT,
  "approvedAt" TIMESTAMP(3),
  "activationKey" TEXT,
  "activatedAt" TIMESTAMP(3),
  "rejectionReason" TEXT,
  "correctionReason" TEXT,
  "version" INTEGER NOT NULL DEFAULT 1,
  "metadata" JSONB NOT NULL DEFAULT '{}',
  "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
  "updatedAt" TIMESTAMP(3) NOT NULL,

  CONSTRAINT "subscription_upgrade_requests_pkey" PRIMARY KEY ("id")
);

CREATE TABLE "subscription_upgrade_quotes" (
  "id" TEXT NOT NULL,
  "upgradeRequestId" TEXT NOT NULL,
  "currency" TEXT NOT NULL DEFAULT 'MAD',
  "currentEligibleNetTermPrice" INTEGER NOT NULL,
  "targetNetTermPrice" INTEGER NOT NULL,
  "termStart" TIMESTAMP(3) NOT NULL,
  "renewalDate" TIMESTAMP(3) NOT NULL,
  "pricingEffectiveAt" TIMESTAMP(3) NOT NULL,
  "termDays" INTEGER NOT NULL,
  "remainingDays" INTEGER NOT NULL,
  "prorationNumerator" INTEGER NOT NULL,
  "prorationDenominator" INTEGER NOT NULL,
  "currentCredit" INTEGER NOT NULL,
  "targetRemainingValue" INTEGER NOT NULL,
  "discountAmount" INTEGER NOT NULL DEFAULT 0,
  "taxAmount" INTEGER NOT NULL DEFAULT 0,
  "feeAmount" INTEGER NOT NULL DEFAULT 0,
  "subtotalAmount" INTEGER NOT NULL,
  "totalAmount" INTEGER NOT NULL,
  "calculationVersion" TEXT NOT NULL,
  "inputSnapshot" JSONB NOT NULL DEFAULT '{}',
  "integrityHash" TEXT NOT NULL,
  "expiresAt" TIMESTAMP(3) NOT NULL,
  "expiredAt" TIMESTAMP(3),
  "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,

  CONSTRAINT "subscription_upgrade_quotes_pkey" PRIMARY KEY ("id")
);

CREATE TABLE "subscription_plan_history" (
  "id" TEXT NOT NULL,
  "subscriptionId" TEXT NOT NULL,
  "companyId" TEXT NOT NULL,
  "previousPlan" "Plan" NOT NULL,
  "previousBillingPeriod" "BillingPeriod" NOT NULL,
  "newPlan" "Plan" NOT NULL,
  "newBillingPeriod" "BillingPeriod" NOT NULL,
  "changeType" TEXT NOT NULL,
  "sourceUpgradeRequestId" TEXT,
  "approvedPaymentAttemptId" TEXT,
  "effectiveAt" TIMESTAMP(3) NOT NULL,
  "previousTermStart" TIMESTAMP(3),
  "previousTermEnd" TIMESTAMP(3),
  "newTermStart" TIMESTAMP(3),
  "newTermEnd" TIMESTAMP(3),
  "actorType" TEXT NOT NULL,
  "actorId" TEXT,
  "approvingAdminId" TEXT,
  "entitlementSnapshot" JSONB NOT NULL DEFAULT '{}',
  "auditCorrelationId" TEXT NOT NULL,
  "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,

  CONSTRAINT "subscription_plan_history_pkey" PRIMARY KEY ("id")
);

CREATE UNIQUE INDEX "subscription_upgrade_requests_quoteId_key" ON "subscription_upgrade_requests"("quoteId");
CREATE UNIQUE INDEX "subscription_upgrade_requests_billingInvoiceId_key" ON "subscription_upgrade_requests"("billingInvoiceId");
CREATE UNIQUE INDEX "subscription_upgrade_requests_activationKey_key" ON "subscription_upgrade_requests"("activationKey");
CREATE UNIQUE INDEX "subscription_plan_history_sourceUpgradeRequestId_key" ON "subscription_plan_history"("sourceUpgradeRequestId");
CREATE INDEX "subscription_upgrade_requests_companyId_status_idx" ON "subscription_upgrade_requests"("companyId", "status");
CREATE INDEX "subscription_upgrade_requests_subscriptionId_status_idx" ON "subscription_upgrade_requests"("subscriptionId", "status");
CREATE INDEX "subscription_upgrade_requests_expiresAt_idx" ON "subscription_upgrade_requests"("expiresAt");
CREATE INDEX "subscription_upgrade_requests_scheduledFor_idx" ON "subscription_upgrade_requests"("scheduledFor");
CREATE INDEX "subscription_upgrade_quotes_upgradeRequestId_idx" ON "subscription_upgrade_quotes"("upgradeRequestId");
CREATE INDEX "subscription_upgrade_quotes_expiresAt_idx" ON "subscription_upgrade_quotes"("expiresAt");
CREATE INDEX "subscription_plan_history_subscriptionId_idx" ON "subscription_plan_history"("subscriptionId");
CREATE INDEX "subscription_plan_history_companyId_idx" ON "subscription_plan_history"("companyId");
CREATE INDEX "subscription_plan_history_changeType_idx" ON "subscription_plan_history"("changeType");

CREATE UNIQUE INDEX "subscription_upgrade_requests_one_non_terminal_per_subscription"
  ON "subscription_upgrade_requests"("subscriptionId")
  WHERE "status" IN (
    'DRAFT',
    'QUOTED',
    'PAYMENT_PENDING',
    'PAYMENT_REVIEW',
    'CORRECTION_REQUIRED',
    'APPROVED',
    'SCHEDULED',
    'ACTIVATION_FAILED'
  );

ALTER TABLE "subscription_upgrade_requests"
  ADD CONSTRAINT "subscription_upgrade_requests_companyId_fkey"
  FOREIGN KEY ("companyId") REFERENCES "companies"("id") ON DELETE CASCADE ON UPDATE CASCADE;

ALTER TABLE "subscription_upgrade_requests"
  ADD CONSTRAINT "subscription_upgrade_requests_subscriptionId_fkey"
  FOREIGN KEY ("subscriptionId") REFERENCES "subscriptions"("id") ON DELETE CASCADE ON UPDATE CASCADE;

ALTER TABLE "subscription_upgrade_requests"
  ADD CONSTRAINT "subscription_upgrade_requests_requestedByEmployeeId_fkey"
  FOREIGN KEY ("requestedByEmployeeId") REFERENCES "employees"("id") ON DELETE RESTRICT ON UPDATE CASCADE;

ALTER TABLE "subscription_upgrade_requests"
  ADD CONSTRAINT "subscription_upgrade_requests_quoteId_fkey"
  FOREIGN KEY ("quoteId") REFERENCES "subscription_upgrade_quotes"("id") ON DELETE SET NULL ON UPDATE CASCADE;

ALTER TABLE "subscription_upgrade_requests"
  ADD CONSTRAINT "subscription_upgrade_requests_billingInvoiceId_fkey"
  FOREIGN KEY ("billingInvoiceId") REFERENCES "billing_invoices"("id") ON DELETE SET NULL ON UPDATE CASCADE;

ALTER TABLE "subscription_upgrade_requests"
  ADD CONSTRAINT "subscription_upgrade_requests_approvedByAdminId_fkey"
  FOREIGN KEY ("approvedByAdminId") REFERENCES "admin_users"("id") ON DELETE SET NULL ON UPDATE CASCADE;

ALTER TABLE "subscription_upgrade_quotes"
  ADD CONSTRAINT "subscription_upgrade_quotes_upgradeRequestId_fkey"
  FOREIGN KEY ("upgradeRequestId") REFERENCES "subscription_upgrade_requests"("id") ON DELETE CASCADE ON UPDATE CASCADE;

ALTER TABLE "subscription_plan_history"
  ADD CONSTRAINT "subscription_plan_history_subscriptionId_fkey"
  FOREIGN KEY ("subscriptionId") REFERENCES "subscriptions"("id") ON DELETE CASCADE ON UPDATE CASCADE;

ALTER TABLE "subscription_plan_history"
  ADD CONSTRAINT "subscription_plan_history_companyId_fkey"
  FOREIGN KEY ("companyId") REFERENCES "companies"("id") ON DELETE CASCADE ON UPDATE CASCADE;