@danielcok17/prisma-db 1.16.0 → 1.17.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@danielcok17/prisma-db",
-  "version": "1.16.0",
+  "version": "1.17.0",
   "description": "Shared Prisma schema for Legal AI applications",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/prisma/app.prisma

@@ -88,6 +88,18 @@ model User {
   phoneVerified     DateTime?                                        // Kedy bol telefón overený cez OTP
   occupation        String?                                          // Povolanie (Právnik, Účtovník, etc.)
   preferredLanguage String?  @default("sk")                          // Jazyk odpovedi (sk, cs, en)
+  // Email Lifecycle — 360° user view
+  lastActiveAt             DateTime?
+  lastLoginAt              DateTime?
+  activatedAt              DateTime?
+  lifecycleStage           LifecycleStage    @default(REGISTERED)
+  lifetimeValue            Int               @default(0)
+  lastEmailSentAt          DateTime?
+  lastMarketingEmailSentAt DateTime?
+  isEmailSuppressed        Boolean           @default(false)
+  referralCode             String?           @unique
+  churnRiskScore           Int               @default(0)
+  churnRiskUpdatedAt       DateTime?
   // Relations
   approvalRequest         UserApprovalRequest?
   stripeCustomer          StripeCustomer? // ✨ B2C Stripe customer
@@ -118,6 +130,12 @@ model User {
   // Ingestion pipeline
   ingestedDocuments       IngestedDocument[]
   adminGrants             AdminGrant[]
+  emailSends              EmailSend[]
+  emailConsent            EmailConsent?
+  userScore               UserScore?
+  sequenceEnrollments     EmailSequenceEnrollment[]
+  referralsSent           Referral[]  @relation("ReferralsSent")
+  referralsReceived       Referral[]  @relation("ReferralsReceived")
 
   // Multi-brand: compound unique allows same email across brands
   @@unique([email, brand])
@@ -133,6 +151,9 @@ model User {
   @@index([registrationUtmSource])
   @@index([registrationUtmCampaign])
   @@index([firstVisitAt])
+  @@index([lifecycleStage])
+  @@index([lastActiveAt])
+  @@index([isEmailSuppressed])
 }
 
 // Nový model pre žiadosti o schválenie
@@ -1065,6 +1086,70 @@ enum IngestionStatus {
   ERROR
 }
 
+enum LifecycleStage {
+  REGISTERED
+  ACTIVATED
+  PAYING
+  SUSPENDED
+  CHURNED
+  REACTIVATED
+}
+
+enum EmailStatus {
+  QUEUED
+  SENT
+  DELIVERED
+  BOUNCED
+  FAILED
+  COMPLAINED
+}
+
+enum EnrollmentStatus {
+  ACTIVE
+  COMPLETED
+  EXITED
+  PAUSED
+}
+
+enum LeadSegment {
+  COLD
+  WARM
+  HOT
+  CONVERTING
+}
+
+enum ChurnRisk {
+  NONE
+  LOW
+  MEDIUM
+  HIGH
+}
+
+enum BounceType {
+  HARD
+  SOFT
+}
+
+enum ConsentAction {
+  GRANTED
+  WITHDRAWN
+  MODIFIED
+}
+
+enum SuppressionReason {
+  HARD_BOUNCE
+  COMPLAINT
+  MANUAL
+  SUNSET
+}
+
+enum ReferralStatus {
+  PENDING
+  REGISTERED
+  CONVERTED
+  REWARDED
+}
+
 // ============================================
 // CANVAS DOCUMENT MODELS
 // ============================================
@@ -1308,3 +1393,233 @@ model AppInvite {
   @@index([token])
   @@index([isActive])
 }
+
+// ============================================
+// EMAIL LIFECYCLE MODELS
+// ============================================
+
+model EmailSend {
+  id               String       @id @default(cuid())
+  userId           String?
+  templateSlug     String
+  campaignId       String?
+
+  status           EmailStatus  @default(QUEUED)
+  sentAt           DateTime?
+  deliveredAt      DateTime?
+  toEmail          String
+  fromEmail        String       @default("info@mail.smartlex.sk")
+
+  openedAt         DateTime?
+  openCount        Int          @default(0)
+  clickedAt        DateTime?
+  clickCount       Int          @default(0)
+
+  bouncedAt        DateTime?
+  bounceType       BounceType?
+  complainedAt     DateTime?
+  unsubscribedAt   DateTime?
+
+  errorMessage     String?
+  errorCode        String?
+
+  subjectLine      String?
+  espMessageId     String?      @unique
+  idempotencyKey   String?      @unique
+  isTransactional  Boolean      @default(false)
+  metadata         Json?
+
+  createdAt        DateTime     @default(now())
+
+  user             User?        @relation(fields: [userId], references: [id], onDelete: SetNull)
+
+  @@index([userId])
+  @@index([templateSlug])
+  @@index([status])
+  @@index([sentAt])
+  @@index([campaignId])
+  @@index([toEmail])
+  @@index([userId, sentAt])
+  @@index([status, sentAt])
+  @@index([userId, isTransactional, sentAt])
+}
+
+model EmailSequence {
+  id            String    @id @default(cuid())
+  slug          String    @unique
+  name          String
+  description   String?
+  triggerEvent  String
+  isActive      Boolean   @default(true)
+
+  steps         EmailSequenceStep[]
+  enrollments   EmailSequenceEnrollment[]
+
+  createdAt     DateTime  @default(now())
+  updatedAt     DateTime  @updatedAt
+}
+
+model EmailSequenceStep {
+  id            String    @id @default(cuid())
+  sequenceId    String
+  templateSlug  String
+  stepOrder     Int
+  delayMinutes  Int       @default(0)
+  sendCondition Json?
+  skipCondition Json?
+  isActive      Boolean   @default(true)
+
+  sequence      EmailSequence @relation(fields: [sequenceId], references: [id], onDelete: Cascade)
+
+  createdAt     DateTime  @default(now())
+
+  @@unique([sequenceId, stepOrder])
+}
+
+model EmailSequenceEnrollment {
+  id                 String           @id @default(cuid())
+  userId             String
+  sequenceId         String
+  currentStep        Int              @default(0)
+  status             EnrollmentStatus @default(ACTIVE)
+
+  enrolledAt         DateTime  @default(now())
+  completedAt        DateTime?
+  exitedAt           DateTime?
+  exitReason         String?
+  nextSendAt         DateTime?
+  processingLockedAt DateTime?
+
+  user               User          @relation(fields: [userId], references: [id], onDelete: Cascade)
+  sequence           EmailSequence @relation(fields: [sequenceId], references: [id])
+
+  @@index([status, nextSendAt])
+  @@index([userId, sequenceId, status])
+}
+
+model EmailConsent {
+  id                      String    @id @default(cuid())
+  userId                  String    @unique
+
+  marketingConsent        Boolean   @default(false)
+  productUpdatesConsent   Boolean   @default(false)
+  legalNewsConsent        Boolean   @default(false)
+
+  doubleOptinSentAt       DateTime?
+  doubleOptinConfirmedAt  DateTime?
+  doubleOptinToken        String?   @unique
+
+  user                    User      @relation(fields: [userId], references: [id], onDelete: Restrict)
+  history                 EmailConsentHistory[]
+
+  createdAt               DateTime  @default(now())
+  updatedAt               DateTime  @updatedAt
+}
+
+model EmailConsentHistory {
+  id              String        @id @default(cuid())
+  consentId       String
+  userId          String
+
+  action          ConsentAction
+  channel         String
+  oldValue        Boolean?
+  newValue        Boolean
+
+  consentText     String
+  consentVersion  String
+  consentMethod   String
+  ipAddress       String?
+  userAgent       String?
+
+  consent         EmailConsent @relation(fields: [consentId], references: [id], onDelete: Restrict)
+
+  createdAt       DateTime  @default(now())
+
+  @@index([userId, createdAt])
+  @@index([consentId])
+  @@index([createdAt])
+}
+
+model UserScore {
+  id              String      @id @default(cuid())
+  userId          String      @unique
+  score           Int         @default(0)
+  leadSegment     LeadSegment @default(COLD)
+  churnRisk       ChurnRisk   @default(NONE)
+
+  signupScore     Int         @default(0)
+  engagementScore Int         @default(0)
+  usageScore      Int         @default(0)
+  intentScore     Int         @default(0)
+  decayScore      Int         @default(0)
+
+  lastActivityAt  DateTime?
+  scoreUpdatedAt  DateTime    @default(now())
+
+  user            User        @relation(fields: [userId], references: [id], onDelete: Cascade)
+  events          UserScoreEvent[]
+
+  createdAt       DateTime    @default(now())
+
+  @@index([score])
+  @@index([leadSegment])
+  @@index([churnRisk])
+}
+
+model UserScoreEvent {
+  id            String    @id @default(cuid())
+  userScoreId   String
+  userId        String
+  eventType     String
+  pointsDelta   Int
+  scoreBefore   Int
+  scoreAfter    Int
+  metadata      Json?
+
+  userScore     UserScore @relation(fields: [userScoreId], references: [id], onDelete: Cascade)
+
+  createdAt     DateTime  @default(now())
+
+  @@index([userId, createdAt])
+  @@index([userScoreId])
+  @@index([eventType])
+  @@index([createdAt])
+}
+
+model EmailSuppression {
+  id            String            @id @default(cuid())
+  email         String
+  reason        SuppressionReason
+  source        String?
+
+  suppressedAt  DateTime  @default(now())
+
+  @@unique([email, reason])
+  @@index([email])
+}
+
+model Referral {
+  id              String         @id @default(cuid())
+  referrerId      String?
+  referredUserId  String?
+  referredEmail   String?
+  status          ReferralStatus @default(PENDING)
+  referralCode    String         @unique
+
+  rewardType      String?
+  rewardedAt      DateTime?
+  clickCount      Int            @default(0)
+  registeredAt    DateTime?
+  convertedAt     DateTime?
+
+  createdAt       DateTime       @default(now())
+
+  referrer        User?  @relation("ReferralsSent", fields: [referrerId], references: [id], onDelete: SetNull)
+  referredUser    User?  @relation("ReferralsReceived", fields: [referredUserId], references: [id], onDelete: SetNull)
+
+  @@index([referrerId])
+  @@index([referredUserId])
+  @@index([referralCode])
+  @@index([status])
+}

package/prisma/migrations/20260320120000_add_phone_verified/migration.sql

@@ -1,2 +1,2 @@
 -- AlterTable
-ALTER TABLE "User" ADD COLUMN "phoneVerified" TIMESTAMP(3);
+ALTER TABLE "User" ADD COLUMN IF NOT EXISTS "phoneVerified" TIMESTAMP(3);

package/prisma/migrations/20260322170005_add_admin_grant_and_app_invite/migration.sql

@@ -1,5 +1,5 @@
 -- CreateTable
-CREATE TABLE "PhoneOtp" (
+CREATE TABLE IF NOT EXISTS "PhoneOtp" (
     "id" TEXT NOT NULL,
     "userId" TEXT NOT NULL,
     "phone" TEXT NOT NULL,
@@ -11,7 +11,7 @@ CREATE TABLE "PhoneOtp" (
 );
 
 -- CreateTable
-CREATE TABLE "AdminGrant" (
+CREATE TABLE IF NOT EXISTS "AdminGrant" (
     "id" TEXT NOT NULL,
     "userId" TEXT,
     "organizationId" TEXT,
@@ -31,7 +31,7 @@ CREATE TABLE "AdminGrant" (
 );
 
 -- CreateTable
-CREATE TABLE "AppInvite" (
+CREATE TABLE IF NOT EXISTS "AppInvite" (
     "id" TEXT NOT NULL,
     "email" TEXT NOT NULL,
     "token" TEXT NOT NULL,
@@ -52,49 +52,70 @@ CREATE TABLE "AppInvite" (
 );
 
 -- CreateIndex
-CREATE UNIQUE INDEX "PhoneOtp_bulkgateId_key" ON "PhoneOtp"("bulkgateId");
+CREATE UNIQUE INDEX IF NOT EXISTS "PhoneOtp_bulkgateId_key" ON "PhoneOtp"("bulkgateId");
 
 -- CreateIndex
-CREATE INDEX "PhoneOtp_userId_idx" ON "PhoneOtp"("userId");
+CREATE INDEX IF NOT EXISTS "PhoneOtp_userId_idx" ON "PhoneOtp"("userId");
 
 -- CreateIndex
-CREATE INDEX "PhoneOtp_bulkgateId_idx" ON "PhoneOtp"("bulkgateId");
+CREATE INDEX IF NOT EXISTS "PhoneOtp_bulkgateId_idx" ON "PhoneOtp"("bulkgateId");
 
 -- CreateIndex
-CREATE INDEX "PhoneOtp_expiresAt_idx" ON "PhoneOtp"("expiresAt");
+CREATE INDEX IF NOT EXISTS "PhoneOtp_expiresAt_idx" ON "PhoneOtp"("expiresAt");
 
 -- CreateIndex
-CREATE INDEX "AdminGrant_userId_idx" ON "AdminGrant"("userId");
+CREATE INDEX IF NOT EXISTS "AdminGrant_userId_idx" ON "AdminGrant"("userId");
 
 -- CreateIndex
-CREATE INDEX "AdminGrant_organizationId_idx" ON "AdminGrant"("organizationId");
+CREATE INDEX IF NOT EXISTS "AdminGrant_organizationId_idx" ON "AdminGrant"("organizationId");
 
 -- CreateIndex
-CREATE INDEX "AdminGrant_expiresAt_idx" ON "AdminGrant"("expiresAt");
+CREATE INDEX IF NOT EXISTS "AdminGrant_expiresAt_idx" ON "AdminGrant"("expiresAt");
 
 -- CreateIndex
-CREATE INDEX "AdminGrant_isActive_idx" ON "AdminGrant"("isActive");
+CREATE INDEX IF NOT EXISTS "AdminGrant_isActive_idx" ON "AdminGrant"("isActive");
 
 -- CreateIndex
-CREATE UNIQUE INDEX "AppInvite_token_key" ON "AppInvite"("token");
+CREATE UNIQUE INDEX IF NOT EXISTS "AppInvite_token_key" ON "AppInvite"("token");
 
 -- CreateIndex
-CREATE INDEX "AppInvite_email_idx" ON "AppInvite"("email");
+CREATE INDEX IF NOT EXISTS "AppInvite_email_idx" ON "AppInvite"("email");
 
 -- CreateIndex
-CREATE INDEX "AppInvite_token_idx" ON "AppInvite"("token");
+CREATE INDEX IF NOT EXISTS "AppInvite_token_idx" ON "AppInvite"("token");
 
 -- CreateIndex
-CREATE INDEX "AppInvite_isActive_idx" ON "AppInvite"("isActive");
+CREATE INDEX IF NOT EXISTS "AppInvite_isActive_idx" ON "AppInvite"("isActive");
 
 -- CreateIndex
-CREATE INDEX "User_phone_idx" ON "User"("phone");
-
--- AddForeignKey
-ALTER TABLE "PhoneOtp" ADD CONSTRAINT "PhoneOtp_userId_fkey" FOREIGN KEY ("userId") REFERENCES "User"("id") ON DELETE CASCADE ON UPDATE CASCADE;
-
--- AddForeignKey
-ALTER TABLE "AdminGrant" ADD CONSTRAINT "AdminGrant_userId_fkey" FOREIGN KEY ("userId") REFERENCES "User"("id") ON DELETE CASCADE ON UPDATE CASCADE;
-
--- AddForeignKey
-ALTER TABLE "AdminGrant" ADD CONSTRAINT "AdminGrant_organizationId_fkey" FOREIGN KEY ("organizationId") REFERENCES "Organization"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+CREATE INDEX IF NOT EXISTS "User_phone_idx" ON "User"("phone");
+
+-- AddForeignKey (idempotent)
+DO $$ BEGIN
+  IF NOT EXISTS (
+    SELECT 1 FROM pg_constraint WHERE conname = 'PhoneOtp_userId_fkey'
+  ) THEN
+    ALTER TABLE "PhoneOtp" ADD CONSTRAINT "PhoneOtp_userId_fkey"
+      FOREIGN KEY ("userId") REFERENCES "User"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+  END IF;
+END $$;
+
+-- AddForeignKey (idempotent)
+DO $$ BEGIN
+  IF NOT EXISTS (
+    SELECT 1 FROM pg_constraint WHERE conname = 'AdminGrant_userId_fkey'
+  ) THEN
+    ALTER TABLE "AdminGrant" ADD CONSTRAINT "AdminGrant_userId_fkey"
+      FOREIGN KEY ("userId") REFERENCES "User"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+  END IF;
+END $$;
+
+-- AddForeignKey (idempotent)
+DO $$ BEGIN
+  IF NOT EXISTS (
+    SELECT 1 FROM pg_constraint WHERE conname = 'AdminGrant_organizationId_fkey'
+  ) THEN
+    ALTER TABLE "AdminGrant" ADD CONSTRAINT "AdminGrant_organizationId_fkey"
+      FOREIGN KEY ("organizationId") REFERENCES "Organization"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+  END IF;
+END $$;

package/prisma/migrations/20260328120650_email_lifecycle/migration.sql

@@ -0,0 +1,372 @@
+/*
+  Warnings:
+
+  - A unique constraint covering the columns `[referralCode]` on the table `User` will be added. If there are existing duplicate values, this will fail.
+
+*/
+-- CreateEnum
+CREATE TYPE "LifecycleStage" AS ENUM ('REGISTERED', 'ACTIVATED', 'PAYING', 'SUSPENDED', 'CHURNED', 'REACTIVATED');
+
+-- CreateEnum
+CREATE TYPE "EmailStatus" AS ENUM ('QUEUED', 'SENT', 'DELIVERED', 'BOUNCED', 'FAILED', 'COMPLAINED');
+
+-- CreateEnum
+CREATE TYPE "EnrollmentStatus" AS ENUM ('ACTIVE', 'COMPLETED', 'EXITED', 'PAUSED');
+
+-- CreateEnum
+CREATE TYPE "LeadSegment" AS ENUM ('COLD', 'WARM', 'HOT', 'CONVERTING');
+
+-- CreateEnum
+CREATE TYPE "ChurnRisk" AS ENUM ('NONE', 'LOW', 'MEDIUM', 'HIGH');
+
+-- CreateEnum
+CREATE TYPE "BounceType" AS ENUM ('HARD', 'SOFT');
+
+-- CreateEnum
+CREATE TYPE "ConsentAction" AS ENUM ('GRANTED', 'WITHDRAWN', 'MODIFIED');
+
+-- CreateEnum
+CREATE TYPE "SuppressionReason" AS ENUM ('HARD_BOUNCE', 'COMPLAINT', 'MANUAL', 'SUNSET');
+
+-- CreateEnum
+CREATE TYPE "ReferralStatus" AS ENUM ('PENDING', 'REGISTERED', 'CONVERTED', 'REWARDED');
+
+-- AlterTable
+ALTER TABLE "User" ADD COLUMN     "activatedAt" TIMESTAMP(3),
+ADD COLUMN     "churnRiskScore" INTEGER NOT NULL DEFAULT 0,
+ADD COLUMN     "churnRiskUpdatedAt" TIMESTAMP(3),
+ADD COLUMN     "isEmailSuppressed" BOOLEAN NOT NULL DEFAULT false,
+ADD COLUMN     "lastActiveAt" TIMESTAMP(3),
+ADD COLUMN     "lastEmailSentAt" TIMESTAMP(3),
+ADD COLUMN     "lastLoginAt" TIMESTAMP(3),
+ADD COLUMN     "lastMarketingEmailSentAt" TIMESTAMP(3),
+ADD COLUMN     "lifecycleStage" "LifecycleStage" NOT NULL DEFAULT 'REGISTERED',
+ADD COLUMN     "lifetimeValue" INTEGER NOT NULL DEFAULT 0,
+ADD COLUMN     "referralCode" TEXT;
+
+-- CreateTable
+CREATE TABLE "EmailSend" (
+    "id" TEXT NOT NULL,
+    "userId" TEXT,
+    "templateSlug" TEXT NOT NULL,
+    "campaignId" TEXT,
+    "status" "EmailStatus" NOT NULL DEFAULT 'QUEUED',
+    "sentAt" TIMESTAMP(3),
+    "deliveredAt" TIMESTAMP(3),
+    "toEmail" TEXT NOT NULL,
+    "fromEmail" TEXT NOT NULL DEFAULT 'info@mail.smartlex.sk',
+    "openedAt" TIMESTAMP(3),
+    "openCount" INTEGER NOT NULL DEFAULT 0,
+    "clickedAt" TIMESTAMP(3),
+    "clickCount" INTEGER NOT NULL DEFAULT 0,
+    "bouncedAt" TIMESTAMP(3),
+    "bounceType" "BounceType",
+    "complainedAt" TIMESTAMP(3),
+    "unsubscribedAt" TIMESTAMP(3),
+    "errorMessage" TEXT,
+    "errorCode" TEXT,
+    "subjectLine" TEXT,
+    "espMessageId" TEXT,
+    "idempotencyKey" TEXT,
+    "isTransactional" BOOLEAN NOT NULL DEFAULT false,
+    "metadata" JSONB,
+    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+
+    CONSTRAINT "EmailSend_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "EmailSequence" (
+    "id" TEXT NOT NULL,
+    "slug" TEXT NOT NULL,
+    "name" TEXT NOT NULL,
+    "description" TEXT,
+    "triggerEvent" TEXT NOT NULL,
+    "isActive" BOOLEAN NOT NULL DEFAULT true,
+    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updatedAt" TIMESTAMP(3) NOT NULL,
+
+    CONSTRAINT "EmailSequence_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "EmailSequenceStep" (
+    "id" TEXT NOT NULL,
+    "sequenceId" TEXT NOT NULL,
+    "templateSlug" TEXT NOT NULL,
+    "stepOrder" INTEGER NOT NULL,
+    "delayMinutes" INTEGER NOT NULL DEFAULT 0,
+    "sendCondition" JSONB,
+    "skipCondition" JSONB,
+    "isActive" BOOLEAN NOT NULL DEFAULT true,
+    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+
+    CONSTRAINT "EmailSequenceStep_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "EmailSequenceEnrollment" (
+    "id" TEXT NOT NULL,
+    "userId" TEXT NOT NULL,
+    "sequenceId" TEXT NOT NULL,
+    "currentStep" INTEGER NOT NULL DEFAULT 0,
+    "status" "EnrollmentStatus" NOT NULL DEFAULT 'ACTIVE',
+    "enrolledAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "completedAt" TIMESTAMP(3),
+    "exitedAt" TIMESTAMP(3),
+    "exitReason" TEXT,
+    "nextSendAt" TIMESTAMP(3),
+    "processingLockedAt" TIMESTAMP(3),
+
+    CONSTRAINT "EmailSequenceEnrollment_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "EmailConsent" (
+    "id" TEXT NOT NULL,
+    "userId" TEXT NOT NULL,
+    "marketingConsent" BOOLEAN NOT NULL DEFAULT false,
+    "productUpdatesConsent" BOOLEAN NOT NULL DEFAULT false,
+    "legalNewsConsent" BOOLEAN NOT NULL DEFAULT false,
+    "doubleOptinSentAt" TIMESTAMP(3),
+    "doubleOptinConfirmedAt" TIMESTAMP(3),
+    "doubleOptinToken" TEXT,
+    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updatedAt" TIMESTAMP(3) NOT NULL,
+
+    CONSTRAINT "EmailConsent_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "EmailConsentHistory" (
+    "id" TEXT NOT NULL,
+    "consentId" TEXT NOT NULL,
+    "userId" TEXT NOT NULL,
+    "action" "ConsentAction" NOT NULL,
+    "channel" TEXT NOT NULL,
+    "oldValue" BOOLEAN,
+    "newValue" BOOLEAN NOT NULL,
+    "consentText" TEXT NOT NULL,
+    "consentVersion" TEXT NOT NULL,
+    "consentMethod" TEXT NOT NULL,
+    "ipAddress" TEXT,
+    "userAgent" TEXT,
+    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+
+    CONSTRAINT "EmailConsentHistory_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "UserScore" (
+    "id" TEXT NOT NULL,
+    "userId" TEXT NOT NULL,
+    "score" INTEGER NOT NULL DEFAULT 0,
+    "leadSegment" "LeadSegment" NOT NULL DEFAULT 'COLD',
+    "churnRisk" "ChurnRisk" NOT NULL DEFAULT 'NONE',
+    "signupScore" INTEGER NOT NULL DEFAULT 0,
+    "engagementScore" INTEGER NOT NULL DEFAULT 0,
+    "usageScore" INTEGER NOT NULL DEFAULT 0,
+    "intentScore" INTEGER NOT NULL DEFAULT 0,
+    "decayScore" INTEGER NOT NULL DEFAULT 0,
+    "lastActivityAt" TIMESTAMP(3),
+    "scoreUpdatedAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+
+    CONSTRAINT "UserScore_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "UserScoreEvent" (
+    "id" TEXT NOT NULL,
+    "userScoreId" TEXT NOT NULL,
+    "userId" TEXT NOT NULL,
+    "eventType" TEXT NOT NULL,
+    "pointsDelta" INTEGER NOT NULL,
+    "scoreBefore" INTEGER NOT NULL,
+    "scoreAfter" INTEGER NOT NULL,
+    "metadata" JSONB,
+    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+
+    CONSTRAINT "UserScoreEvent_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "EmailSuppression" (
+    "id" TEXT NOT NULL,
+    "email" TEXT NOT NULL,
+    "reason" "SuppressionReason" NOT NULL,
+    "source" TEXT,
+    "suppressedAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+
+    CONSTRAINT "EmailSuppression_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "Referral" (
+    "id" TEXT NOT NULL,
+    "referrerId" TEXT,
+    "referredUserId" TEXT,
+    "referredEmail" TEXT,
+    "status" "ReferralStatus" NOT NULL DEFAULT 'PENDING',
+    "referralCode" TEXT NOT NULL,
+    "rewardType" TEXT,
+    "rewardedAt" TIMESTAMP(3),
+    "clickCount" INTEGER NOT NULL DEFAULT 0,
+    "registeredAt" TIMESTAMP(3),
+    "convertedAt" TIMESTAMP(3),
+    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+
+    CONSTRAINT "Referral_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateIndex
+CREATE UNIQUE INDEX "EmailSend_espMessageId_key" ON "EmailSend"("espMessageId");
+
+-- CreateIndex
+CREATE UNIQUE INDEX "EmailSend_idempotencyKey_key" ON "EmailSend"("idempotencyKey");
+
+-- CreateIndex
+CREATE INDEX "EmailSend_userId_idx" ON "EmailSend"("userId");
+
+-- CreateIndex
+CREATE INDEX "EmailSend_templateSlug_idx" ON "EmailSend"("templateSlug");
+
+-- CreateIndex
+CREATE INDEX "EmailSend_status_idx" ON "EmailSend"("status");
+
+-- CreateIndex
+CREATE INDEX "EmailSend_sentAt_idx" ON "EmailSend"("sentAt");
+
+-- CreateIndex
+CREATE INDEX "EmailSend_campaignId_idx" ON "EmailSend"("campaignId");
+
+-- CreateIndex
+CREATE INDEX "EmailSend_toEmail_idx" ON "EmailSend"("toEmail");
+
+-- CreateIndex
+CREATE INDEX "EmailSend_userId_sentAt_idx" ON "EmailSend"("userId", "sentAt");
+
+-- CreateIndex
+CREATE INDEX "EmailSend_status_sentAt_idx" ON "EmailSend"("status", "sentAt");
+
+-- CreateIndex
+CREATE INDEX "EmailSend_userId_isTransactional_sentAt_idx" ON "EmailSend"("userId", "isTransactional", "sentAt");
+
+-- CreateIndex
+CREATE UNIQUE INDEX "EmailSequence_slug_key" ON "EmailSequence"("slug");
+
+-- CreateIndex
+CREATE UNIQUE INDEX "EmailSequenceStep_sequenceId_stepOrder_key" ON "EmailSequenceStep"("sequenceId", "stepOrder");
+
+-- CreateIndex
+CREATE INDEX "EmailSequenceEnrollment_status_nextSendAt_idx" ON "EmailSequenceEnrollment"("status", "nextSendAt");
+
+-- CreateIndex
+CREATE INDEX "EmailSequenceEnrollment_userId_sequenceId_status_idx" ON "EmailSequenceEnrollment"("userId", "sequenceId", "status");
+
+-- CreateIndex
+CREATE UNIQUE INDEX "EmailConsent_userId_key" ON "EmailConsent"("userId");
+
+-- CreateIndex
+CREATE UNIQUE INDEX "EmailConsent_doubleOptinToken_key" ON "EmailConsent"("doubleOptinToken");
+
+-- CreateIndex
+CREATE INDEX "EmailConsentHistory_userId_createdAt_idx" ON "EmailConsentHistory"("userId", "createdAt");
+
+-- CreateIndex
+CREATE INDEX "EmailConsentHistory_consentId_idx" ON "EmailConsentHistory"("consentId");
+
+-- CreateIndex
+CREATE INDEX "EmailConsentHistory_createdAt_idx" ON "EmailConsentHistory"("createdAt");
+
+-- CreateIndex
+CREATE UNIQUE INDEX "UserScore_userId_key" ON "UserScore"("userId");
+
+-- CreateIndex
+CREATE INDEX "UserScore_score_idx" ON "UserScore"("score");
+
+-- CreateIndex
+CREATE INDEX "UserScore_leadSegment_idx" ON "UserScore"("leadSegment");
+
+-- CreateIndex
+CREATE INDEX "UserScore_churnRisk_idx" ON "UserScore"("churnRisk");
+
+-- CreateIndex
+CREATE INDEX "UserScoreEvent_userId_createdAt_idx" ON "UserScoreEvent"("userId", "createdAt");
+
+-- CreateIndex
+CREATE INDEX "UserScoreEvent_userScoreId_idx" ON "UserScoreEvent"("userScoreId");
+
+-- CreateIndex
+CREATE INDEX "UserScoreEvent_eventType_idx" ON "UserScoreEvent"("eventType");
+
+-- CreateIndex
+CREATE INDEX "UserScoreEvent_createdAt_idx" ON "UserScoreEvent"("createdAt");
+
+-- CreateIndex
+CREATE INDEX "EmailSuppression_email_idx" ON "EmailSuppression"("email");
+
+-- CreateIndex
+CREATE UNIQUE INDEX "EmailSuppression_email_reason_key" ON "EmailSuppression"("email", "reason");
+
+-- CreateIndex
+CREATE UNIQUE INDEX "Referral_referralCode_key" ON "Referral"("referralCode");
+
+-- CreateIndex
+CREATE INDEX "Referral_referrerId_idx" ON "Referral"("referrerId");
+
+-- CreateIndex
+CREATE INDEX "Referral_referredUserId_idx" ON "Referral"("referredUserId");
+
+-- CreateIndex
+CREATE INDEX "Referral_referralCode_idx" ON "Referral"("referralCode");
+
+-- CreateIndex
+CREATE INDEX "Referral_status_idx" ON "Referral"("status");
+
+-- CreateIndex
+CREATE UNIQUE INDEX "User_referralCode_key" ON "User"("referralCode");
+
+-- CreateIndex
+CREATE INDEX "User_lifecycleStage_idx" ON "User"("lifecycleStage");
+
+-- CreateIndex
+CREATE INDEX "User_lastActiveAt_idx" ON "User"("lastActiveAt");
+
+-- CreateIndex
+CREATE INDEX "User_isEmailSuppressed_idx" ON "User"("isEmailSuppressed");
+
+-- AddForeignKey
+ALTER TABLE "EmailSend" ADD CONSTRAINT "EmailSend_userId_fkey" FOREIGN KEY ("userId") REFERENCES "User"("id") ON DELETE SET NULL ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "EmailSequenceStep" ADD CONSTRAINT "EmailSequenceStep_sequenceId_fkey" FOREIGN KEY ("sequenceId") REFERENCES "EmailSequence"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "EmailSequenceEnrollment" ADD CONSTRAINT "EmailSequenceEnrollment_userId_fkey" FOREIGN KEY ("userId") REFERENCES "User"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "EmailSequenceEnrollment" ADD CONSTRAINT "EmailSequenceEnrollment_sequenceId_fkey" FOREIGN KEY ("sequenceId") REFERENCES "EmailSequence"("id") ON DELETE RESTRICT ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "EmailConsent" ADD CONSTRAINT "EmailConsent_userId_fkey" FOREIGN KEY ("userId") REFERENCES "User"("id") ON DELETE RESTRICT ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "EmailConsentHistory" ADD CONSTRAINT "EmailConsentHistory_consentId_fkey" FOREIGN KEY ("consentId") REFERENCES "EmailConsent"("id") ON DELETE RESTRICT ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "UserScore" ADD CONSTRAINT "UserScore_userId_fkey" FOREIGN KEY ("userId") REFERENCES "User"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "UserScoreEvent" ADD CONSTRAINT "UserScoreEvent_userScoreId_fkey" FOREIGN KEY ("userScoreId") REFERENCES "UserScore"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "Referral" ADD CONSTRAINT "Referral_referrerId_fkey" FOREIGN KEY ("referrerId") REFERENCES "User"("id") ON DELETE SET NULL ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "Referral" ADD CONSTRAINT "Referral_referredUserId_fkey" FOREIGN KEY ("referredUserId") REFERENCES "User"("id") ON DELETE SET NULL ON UPDATE CASCADE;
+
+-- Partial unique index: max 1 ACTIVE enrollment per user per sequence
+CREATE UNIQUE INDEX IF NOT EXISTS "enrollment_active_unique"
+ON "EmailSequenceEnrollment" ("userId", "sequenceId")
+WHERE status = 'ACTIVE';