add subscription upgrade plan

2026-08-10 23:23:58 -04:00
parent 5f06256271
commit 7b8f81336a
15 changed files with 1957 additions and 104 deletions
@@ -0,0 +1,179 @@
+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;