@varaos/db 1.3.5 → 1.4.1

package/prisma/schema.prisma

@@ -1,1394 +1,1989 @@
-generator client {
-  provider = "prisma-client-js"
-}
-
-datasource db {
-  provider  = "postgresql"
-  url       = env("DATABASE_URL")
-  directUrl = env("DIRECT_URL")
-}
-
-/// ─────────────────────────────────────────────
-/// ENUMS
-/// ─────────────────────────────────────────────
-
-enum Role {
-  user
-  support
-  business
-  superadmin
-  moderator
-  admin
-}
-
-enum Status {
-  active // Visible and usable in production
-  suspended // Temporarily disabled but can be restored
-  deleted // Soft-deleted or removed from UI
-  draft // Being worked on but not yet published
-  pending_review // Awaiting manual or automated approval
-  deprecated // Old but still accessible for legacy users
-  archived // Hidden from new users, preserved for history
-  disconnected
-}
-
-enum Plan {
-  free
-  starter
-  pro
-  business
-  enterprise
-}
-
-enum AuthType {
-  credentials
-  oauth
-  hybrid
-}
-
-enum MessageRole {
-  user
-  assistant
-  system
-  tool
-  moderator
-}
-
-enum PostType {
-  BLOG
-  ANNOUNCEMENT
-  SESSION
-}
-
-enum ReactionType {
-  LIKE
-  LOVE
-  CLAP
-  FIRE
-  WOW
-}
-
-enum FileCategory {
-  avatar
-  media
-  attachment
-  memory
-  export
-}
-
-enum TwoFactorMethod {
-  totp
-  email
-  webauthn
-}
-
-enum SubscriptionStatus {
-  created // intent created, payment pending
-  active
-  trialing
-  past_due
-  canceled
-  paused
-}
-
-enum WorkflowStatus {
-  draft
-  active
-  paused
-  archived
-}
-
-enum WorkflowRunStatus {
-  running
-  completed
-  failed
-  canceled
-}
-
-enum WorkflowStepStatus {
-  draft
-  active
-  paused
-  deprecated
-}
-
-enum WorkflowStepRunStatus {
-  pending
-  running
-  completed
-  failed
-  skipped
-}
-
-enum BillingProvider {
-  razorpay
-  stripe
-  juspay
-}
-
-enum SubscriptionEventType {
-  created // Subscription object created (before activation)
-  activated // First successful activation
-  trial_started // Trial period started
-  trial_ended // Trial expired or converted
-
-  charged // Successful recurring or first charge
-  payment_failed // Charge attempt failed
-  payment_recovered // Previously failed payment later succeeded
-
-  paused // Subscription paused (manual or system)
-  resumed // Subscription resumed after pause
-
-  plan_changed // Upgrade / downgrade
-  quantity_changed // Seats / units changed (enterprise)
-
-  canceled // User or system initiated cancellation
-  completed // Subscription ran its full course
-  expired // Ended due to non-payment / mandate expiry
-
-  refunded // Full or partial refund issued
-}
-
-enum InvoiceStatus {
-  draft
-  open
-  paid
-  partially_paid
-  failed
-  void
-  refunded
-}
-
-enum PaymentMethodType {
-  card
-  upi
-  bank
-  wallet
-}
-
-enum PaymentMethodStatus {
-  active
-  inactive
-  expired
-  revoked
-}
-
-enum BillingEventStatus {
-  received
-  processing
-  processed
-  failed
-}
-
-enum BillingLedgerEntryType {
-  charge
-  refund
-  credit
-  debit
-  adjustment
-}
-
-enum BillingLedgerDirection {
-  debit
-  credit
-}
-
-enum JobStatus {
-  pending
-  scheduled
-  running
-  completed
-  failed
-  dead
-}
-
-enum CouponDiscountType {
-  percentage
-  flat
-}
-
-enum CouponRedemptionScope {
-  subscription
-  invoice
-  one_time
-}
-
-enum CreditPurchaseStatus {
-  pending
-  paid
-  failed
-  refunded
-  partially_refunded
-}
-
-/// ─────────────────────────────────────────────
-/// USERS & AUTH
-/// ─────────────────────────────────────────────
-
-model User {
-  id   String @id @default(uuid())
-  name String
-
-  image             String? // provider image
-  avatarOverrideUrl String?
-
-  email              String    @unique
-  password           String?
-  emailVerified      DateTime?
-  onboarding         DateTime?
-  role               Role      @default(user)
-  timezone           String?
-  language           String?
-  status             Status    @default(active)
-  lastLogin          DateTime?
-  lastPasswordChange DateTime?
-  twoFactorEnabled   Boolean   @default(false)
-
-  userTwoFactor UserTwoFactor?
-
-  metadata     Json?
-  deletedAt    DateTime?
-  plan         Plan      @default(free)
-  tokenBalance Int       @default(0)
-  creditsUsed  Int       @default(0)
-
-  chatCount        Int @default(0)
-  workflowCount    Int @default(0)
-  integrationCount Int @default(0)
-
-  lastActiveAt DateTime?
-
-  authType AuthType @default(oauth)
-
-  passwordStrength String? // weak | medium | strong
-
-  storageUsed  BigInt @default(0) // bytes
-  storageLimit BigInt @default(524288000) // 500 MB (beta)
-
-  accounts           Account[]
-  integrations       Integration[]
-  tokenTransactions  TokenTransaction[]
-  auditLogs          AuditLog[]
-  subscriptions      Subscription[]
-  workspaces         Workspace[]        @relation("UserWorkspaces")
-  defaultWorkspaceId String?            @unique
-  defaultWorkspace   Workspace?         @relation("UserDefaultWorkspace", fields: [defaultWorkspaceId], references: [id])
-  Workflow           Workflow[]
-  Notification       Notification[]
-  Onboarding         Onboarding?
-  ChatSession        ChatSession[]
-
-  createdAt        DateTime          @default(now())
-  updatedAt        DateTime          @updatedAt
-  posts            Post[]
-  userSessions     UserSession[]
-  paymentMethods   PaymentMethod[]
-  userEmails       UserEmail[]
-  invoices         Invoice[]
-  userFiles        UserFile[]
-  billingCustomers BillingCustomer[]
-  billingLedgers   BillingLedger[]
-  creditPurchases  CreditPurchase[]
-  refunds          Refund[]
-
-  @@index([status])
-}
-
-model UserFile {
-  id     String @id @default(uuid())
-  userId String
-
-  path     String // Spaces object key (users/{userId}/{category}/{fileId}.ext)
-  size     BigInt // bytes
-  mimeType String
-  category FileCategory
-
-  checksum String? // sha256 or md5 for integrity verification
-  metadata Json?
-
-  createdAt DateTime @default(now())
-
-  user User @relation(fields: [userId], references: [id], onDelete: Cascade)
-
-  @@index([userId])
-  @@index([category])
-  @@index([userId, category])
-}
-
-model UserSession {
-  id        String   @id @default(uuid())
-  userId    String
-  ip        String?
-  userAgent String?
-  lastUsed  DateTime
-
-  revoked   Boolean   @default(false)
-  revokedAt DateTime?
-
-  expiresAt DateTime
-  createdAt DateTime @default(now())
-
-  user User @relation(fields: [userId], references: [id], onDelete: Cascade)
-
-  @@index([userId, revoked])
-}
-
-model UploadIntent {
-  id        String       @id
-  userId    String
-  category  FileCategory
-  size      BigInt
-  objectKey String
-  createdAt DateTime     @default(now())
-
-  @@index([userId])
-  @@index([userId, category])
-}
-
-model UserEmail {
-  id        String   @id @default(uuid())
-  userId    String
-  email     String   @unique
-  verified  Boolean  @default(false)
-  primary   Boolean  @default(false)
-  type      String? // billing | security | notifications
-  createdAt DateTime @default(now())
-
-  user User @relation(fields: [userId], references: [id], onDelete: Cascade)
-}
-
-model UserTwoFactor {
-  id     String @id @default(uuid())
-  userId String @unique
-
-  method  TwoFactorMethod @default(totp)
-  secret  String? // null when disabled or method != totp
-  enabled Boolean         @default(false)
-
-  lastVerifiedAt DateTime?
-  enabledAt      DateTime?
-
-  recoveryEmailVerifiedAt DateTime?
-
-  backupCodes Json? // [{ hash, used, usedAt }]
-
-  createdAt DateTime @default(now())
-  updatedAt DateTime @updatedAt
-
-  user User @relation(fields: [userId], references: [id], onDelete: Cascade)
-
-  @@index([userId])
-}
-
-model Account {
-  id                String  @id @default(uuid())
-  userId            String
-  type              String
-  provider          String
-  providerAccountId String
-  refresh_token     String? @db.Text
-  access_token      String? @db.Text
-  expires_at        Int?
-  token_type        String?
-  scope             String?
-  id_token          String? @db.Text
-  session_state     String?
-
-  createdAt DateTime @default(now())
-  updatedAt DateTime @updatedAt
-
-  user User @relation(fields: [userId], references: [id], onDelete: Cascade)
-
-  @@unique([provider, providerAccountId])
-}
-
-model VerificationToken {
-  id        String   @id @default(uuid())
-  email     String
-  token     String   @unique
-  expiresAt DateTime
-
-  @@unique([email, token])
-}
-
-model PasswordResetToken {
-  id        String   @id @default(uuid())
-  email     String
-  token     String   @unique
-  expiresAt DateTime
-
-  @@unique([email, token])
-}
-
-/// ─────────────────────────────────────────────
-/// WORKSPACES & INTEGRATIONS
-/// ─────────────────────────────────────────────
-
-model Workspace {
-  id          String    @id @default(uuid())
-  name        String
-  description String?
-  ownerId     String
-  status      Status    @default(active)
-  deletedAt   DateTime?
-
-  createdAt DateTime @default(now())
-  updatedAt DateTime @updatedAt
-
-  owner      User  @relation("UserWorkspaces", fields: [ownerId], references: [id])
-  defaultFor User? @relation("UserDefaultWorkspace")
-
-  integrations Integration[]
-  aiAgents     AIAgent[]
-  Workflow     Workflow[]
-  ChatSession  ChatSession[]
-
-  @@index([status])
-  @@index([ownerId])
-}
-
-model Integration {
-  id                String    @id @default(cuid())
-  userId            String
-  workspaceId       String?
-  provider          String
-  providerAccountId String
-  integration       String
-  accessToken       String
-  refreshToken      String?
-  expiresAt         DateTime?
-  scopes            Json
-  profile           Json
-  status            Status    @default(active)
-  metadata          Json?
-  deletedAt         DateTime?
-
-  catalogId String?
-  catalog   IntegrationCatalog? @relation(fields: [catalogId], references: [id])
-
-  createdAt DateTime @default(now())
-  updatedAt DateTime @updatedAt
-
-  user               User                 @relation(fields: [userId], references: [id], onDelete: Cascade)
-  workspace          Workspace?           @relation(fields: [workspaceId], references: [id])
-  integrationSyncLog IntegrationSyncLog[]
-
-  @@unique([userId, provider, integration, workspaceId], name: "user_provider_integration_workspace")
-  @@index([workspaceId])
-  @@index([status])
-  @@map("integrations")
-}
-
-model IntegrationCatalog {
-  id                   String  @id @default(uuid())
-  provider             String
-  integration          String
-  name                 String
-  category             String?
-  showDuringOnboarding Boolean @default(true)
-  default              Boolean @default(false)
-  premium              Boolean @default(false)
-  iconUrl              String?
-  description          String?
-  docsUrl              String?
-  oauthType            String?
-  setupInstructions    Json?
-  status               Status  @default(draft)
-
-  // ✅ NEW
-  capabilities   Json?
-  examplePrompts String[]
-
-  createdAt   DateTime      @default(now())
-  updatedAt   DateTime      @updatedAt
-  Integration Integration[]
-
-  @@unique([provider, integration])
-  @@index([status])
-  @@map("integration_catalog")
-}
-
-model IntegrationSyncLog {
-  id            String   @id @default(uuid())
-  integrationId String
-  syncStatus    String
-  errorMessage  String?
-  timestamp     DateTime @default(now())
-
-  integration Integration @relation(fields: [integrationId], references: [id])
-}
-
-/// ─────────────────────────────────────────────
-/// AUTOMATIONS / AI / WORKFLOWS
-/// ─────────────────────────────────────────────
-
-model AIAgent {
-  id          String     @id @default(uuid())
-  name        String
-  key         String     @unique
-  description String?
-  active      Boolean    @default(true)
-  config      Json?
-  workspaceId String?
-  workspace   Workspace? @relation(fields: [workspaceId], references: [id])
-
-  createdAt DateTime @default(now())
-  updatedAt DateTime @updatedAt
-
-  tokenTransactions TokenTransaction[]
-  ChatSession       ChatSession[]
-}
-
-model UsageAggregate {
-  id            String   @id @default(uuid())
-  userId        String
-  workspaceId   String?
-  billingPeriod String
-  source        String // chat | automation | api
-  tokensUsed    Int
-  requestCount  Int
-  updatedAt     DateTime @updatedAt
-
-  @@unique([userId, workspaceId, billingPeriod, source])
-}
-
-model TokenTransaction {
-  id         String  @id @default(uuid())
-  userId     String
-  agentId    String?
-  tokensUsed Int
-  action     String
-
-  source      String? // chat | automation | api
-  workspaceId String?
-  integration String?
-
-  billingPeriod String? // e.g. "2025-01" (YYYY-MM)
-
-  metadata  Json?
-  createdAt DateTime @default(now())
-
-  user  User     @relation(fields: [userId], references: [id])
-  agent AIAgent? @relation(fields: [agentId], references: [id])
-}
-
-model Workflow {
-  id          String         @id @default(uuid())
-  name        String
-  description String?
-  status      WorkflowStatus @default(active)
-  userId      String
-  workspaceId String?
-
-  user      User           @relation(fields: [userId], references: [id])
-  workspace Workspace?     @relation(fields: [workspaceId], references: [id])
-  steps     WorkflowStep[]
-
-  createdAt   DateTime      @default(now())
-  updatedAt   DateTime      @updatedAt
-  WorkflowRun WorkflowRun[]
-}
-
-model WorkflowStep {
-  id         String             @id @default(uuid())
-  workflowId String
-  type       String
-  config     Json
-  order      Int
-  status     WorkflowStepStatus @default(active)
-
-  workflow Workflow @relation(fields: [workflowId], references: [id])
-
-  createdAt       DateTime          @default(now())
-  updatedAt       DateTime          @updatedAt
-  WorkflowStepRun WorkflowStepRun[]
-}
-
-model WorkflowRun {
-  id         String            @id @default(uuid())
-  workflowId String
-  status     WorkflowRunStatus @default(running)
-  input      Json?
-  output     Json?
-  error      String?
-
-  startedAt  DateTime  @default(now())
-  finishedAt DateTime?
-
-  workflow Workflow          @relation(fields: [workflowId], references: [id])
-  steps    WorkflowStepRun[]
-
-  @@index([workflowId, startedAt])
-}
-
-model WorkflowStepRun {
-  id             String                @id @default(uuid())
-  workflowRunId  String
-  workflowStepId String
-  status         WorkflowStepRunStatus @default(pending)
-  input          Json?
-  output         Json?
-  error          String?
-
-  startedAt  DateTime?
-  finishedAt DateTime?
-
-  workflowRun  WorkflowRun  @relation(fields: [workflowRunId], references: [id])
-  workflowStep WorkflowStep @relation(fields: [workflowStepId], references: [id])
-}
-
-/// ─────────────────────────────────────────────
-/// COMMUNICATION / CHAT / EMAIL
-/// ─────────────────────────────────────────────
-
-model Notification {
-  id     String  @id @default(uuid())
-  userId String?
-  type   String
-  title  String
-  body   String?
-  read   Boolean @default(false)
-
-  createdAt DateTime @default(now())
-
-  user User? @relation(fields: [userId], references: [id])
-}
-
-model ChatSession {
-  id          String    @id @default(uuid())
-  title       String?
-  userId      String?
-  workspaceId String?
-  aiAgentId   String?
-  status      String    @default("active")
-  metadata    Json?
-  deletedAt   DateTime?
-
-  user      User?         @relation(fields: [userId], references: [id], onDelete: Cascade)
-  workspace Workspace?    @relation(fields: [workspaceId], references: [id])
-  aiAgent   AIAgent?      @relation(fields: [aiAgentId], references: [id])
-  messages  ChatMessage[]
-
-  createdAt DateTime @default(now())
-  updatedAt DateTime @updatedAt
-
-  @@index([userId, createdAt])
-  @@index([workspaceId, createdAt])
-  @@index([status])
-}
-
-model ChatMessage {
-  id            String      @id @default(uuid())
-  chatSessionId String
-  sender        MessageRole
-  content       String
-  style         String?
-  tokensUsed    Int?
-  metadata      Json?
-  deletedAt     DateTime?
-
-  chatSession ChatSession @relation(fields: [chatSessionId], references: [id])
-
-  createdAt DateTime @default(now())
-
-  @@index([chatSessionId, createdAt])
-}
-
-model EmailLog {
-  id       String   @id @default(uuid())
-  to       String
-  subject  String
-  type     String // verification, marketing, notification, etc.
-  status   String   @default("sent")
-  metadata Json?
-  sentAt   DateTime @default(now())
-  error    String?
-}
-
-/// ─────────────────────────────────────────────
-/// WORKFLOW TEMPLATES & ONBOARDING PERSONAS
-/// ─────────────────────────────────────────────
-
-model WorkflowTemplate {
-  id                 String  @id @default(uuid())
-  name               String
-  description        String?
-  category           String?
-  recommended        Boolean @default(false)
-  iconUrl            String?
-  estimatedSetupTime Int?
-  status             Status  @default(active)
-
-  createdAt DateTime @default(now())
-  updatedAt DateTime @updatedAt
-
-  steps WorkflowStepTemplate[]
-}
-
-model WorkflowStepTemplate {
-  id         String @id @default(uuid())
-  templateId String
-  type       String
-  config     Json
-  order      Int
-  status     String @default("active")
-
-  template WorkflowTemplate @relation(fields: [templateId], references: [id])
-}
-
-model OnboardingPersona {
-  id          String  @id @default(uuid())
-  key         String  @unique
-  title       String
-  description String?
-  iconUrl     String?
-  recommended Boolean @default(false)
-  status      Status  @default(active)
-
-  createdAt DateTime @default(now())
-  updatedAt DateTime @updatedAt
-}
-
-/// ─────────────────────────────────────────────
-/// MONITORING / ADMIN / SYSTEM CONFIG
-/// ─────────────────────────────────────────────
-
-model Service {
-  id          String    @id @default(uuid())
-  name        String
-  description String?
-  endpoint    String
-  status      String    @default("healthy")
-  lastPing    DateTime?
-  uptime      Float?
-  region      String?
-  metadata    Json?
-  createdAt   DateTime  @default(now())
-  updatedAt   DateTime  @updatedAt
-
-  logs   ServiceLog[]
-  errors ErrorLog[]
-}
-
-model ServiceLog {
-  id        String   @id @default(uuid())
-  serviceId String
-  level     String
-  message   String
-  metadata  Json?
-  createdAt DateTime @default(now())
-
-  service Service @relation(fields: [serviceId], references: [id])
-}
-
-model ErrorLog {
-  id         String   @id @default(uuid())
-  serviceId  String?
-  errorType  String?
-  message    String
-  stackTrace String?
-  context    Json?
-  createdAt  DateTime @default(now())
-
-  service Service? @relation(fields: [serviceId], references: [id])
-}
-
-model SystemConfig {
-  id        String   @id @default(uuid())
-  key       String   @unique
-  value     Json
-  category  String?
-  updatedAt DateTime @updatedAt
-}
-
-model AuditLog {
-  id          String   @id @default(uuid())
-  userId      String?
-  actorRole   Role?
-  eventType   String
-  targetType  String?
-  targetId    String?
-  description String?
-  metadata    Json?
-  createdAt   DateTime @default(now())
-
-  user User? @relation(fields: [userId], references: [id])
-
-  @@index([userId, createdAt])
-}
-
-model SecurityEvent {
-  id        String   @id @default(uuid())
-  userId    String?
-  type      String // login | logout | password_change | session_revoked
-  ip        String?
-  userAgent String?
-  success   Boolean
-  metadata  Json?
-  createdAt DateTime @default(now())
-
-  @@index([userId, createdAt])
-}
-
-/// ─────────────────────────────────────────────
-/// BILLING / WAITLIST / JOBS / ONBOARDING
-/// ─────────────────────────────────────────────
-
-model Subscription {
-  id String @id @default(uuid())
-
-  userId String
-  plan   Plan
-  status SubscriptionStatus
-
-  provider               BillingProvider // razorpay | stripe | juspay
-  providerSubscriptionId String          @unique
-  providerPlanId         String?
-
-  billingCustomerId String
-
-  // Lifecycle
-  startedAt DateTime
-  endedAt   DateTime?
-
-  // Billing cycle
-  currentPeriodStart DateTime?
-  currentPeriodEnd   DateTime?
-  nextPayment        DateTime?
-
-  metadata Json?
-
-  user               User                @relation(fields: [userId], references: [id])
-  billingCustomer    BillingCustomer     @relation(fields: [billingCustomerId], references: [id])
-  invoices           Invoice[]
-  subscriptionEvents SubscriptionEvent[]
-
-  @@index([provider, providerSubscriptionId])
-  @@index([billingCustomerId])
-}
-
-model Invoice {
-  id String @id @default(uuid())
-
-  userId            String
-  subscriptionId    String?
-  billingCustomerId String
-
-  provider          BillingProvider // razorpay | stripe | juspay
-  providerInvoiceId String
-
-  amount   Int
-  currency String
-  status   InvoiceStatus
-
-  periodStart DateTime?
-  periodEnd   DateTime?
-
-  hostedInvoiceUrl String?
-  pdfUrl           String?
-
-  metadata Json?
-
-  createdAt DateTime @default(now())
-
-  user            User            @relation(fields: [userId], references: [id])
-  subscription    Subscription?   @relation(fields: [subscriptionId], references: [id])
-  billingCustomer BillingCustomer @relation(fields: [billingCustomerId], references: [id])
-
-  @@unique([provider, providerInvoiceId])
-  @@index([billingCustomerId])
-}
-
-model BillingEvent {
-  id String @id @default(uuid())
-
-  provider  BillingProvider // razorpay | stripe | juspay
-  eventType String
-  eventId   String
-
-  payload Json
-
-  status      BillingEventStatus @default(received)
-  processedAt DateTime?
-  error       String?
-
-  createdAt DateTime @default(now())
-
-  @@unique([provider, eventId])
-  @@index([provider, eventType])
-}
-
-model PaymentMethod {
-  id String @id @default(uuid())
-
-  userId            String
-  billingCustomerId String
-
-  provider                BillingProvider // razorpay | stripe | juspay
-  providerPaymentMethodId String // token_xxx, pm_xxx
-
-  type     PaymentMethodType // card | upi | bank
-  brand    String?
-  last4    String?
-  expMonth Int?
-  expYear  Int?
-
-  isDefault Boolean             @default(false)
-  status    PaymentMethodStatus @default(active)
-
-  metadata Json?
-
-  createdAt DateTime @default(now())
-  updatedAt DateTime @updatedAt
-
-  user            User            @relation(fields: [userId], references: [id], onDelete: Cascade)
-  billingCustomer BillingCustomer @relation(fields: [billingCustomerId], references: [id])
-
-  @@unique([provider, providerPaymentMethodId])
-  @@index([billingCustomerId])
-}
-
-model BillingCustomer {
-  id String @id @default(uuid())
-
-  userId             String
-  provider           BillingProvider // razorpay | stripe | juspay
-  providerCustomerId String // cust_xxx, cus_xxx
-
-  email    String?
-  metadata Json?
-
-  createdAt DateTime @default(now())
-  updatedAt DateTime @updatedAt
-
-  user            User             @relation(fields: [userId], references: [id], onDelete: Cascade)
-  subscriptions   Subscription[]
-  invoices        Invoice[]
-  paymentMethods  PaymentMethod[]
-  billingLedgers  BillingLedger[]
-  creditPurchases CreditPurchase[]
-  refunds         Refund[]
-
-  @@unique([provider, providerCustomerId])
-  @@unique([userId, provider])
-  @@index([providerCustomerId])
-}
-
-model SubscriptionEvent {
-  id String @id @default(uuid())
-
-  subscriptionId String
-  provider       BillingProvider
-  eventType      SubscriptionEventType
-  payload        Json
-
-  createdAt DateTime @default(now())
-
-  subscription Subscription @relation(fields: [subscriptionId], references: [id])
-
-  @@index([subscriptionId, createdAt])
-}
-
-model BillingLedger {
-  id String @id @default(uuid())
-
-  userId            String
-  billingCustomerId String
-
-  provider BillingProvider
-
-  entryType BillingLedgerEntryType // charge | refund | credit | debit | adjustment
-  direction BillingLedgerDirection // debit | credit
-
-  amount   Int
-  currency String
-
-  referenceType String // invoice | subscription | payment | coupon | reward
-  referenceId   String
-
-  description String?
-  metadata    Json?
-
-  createdAt DateTime @default(now())
-
-  user            User            @relation(fields: [userId], references: [id])
-  billingCustomer BillingCustomer @relation(fields: [billingCustomerId], references: [id])
-
-  @@index([userId, createdAt])
-  @@index([billingCustomerId, createdAt])
-  @@index([provider, createdAt])
-}
-
-model Coupon {
-  id String @id @default(uuid())
-
-  code String @unique
-
-  discountType  CouponDiscountType
-  discountValue Int // % or flat amount (minor units)
-
-  currency String? // required for flat discounts
-
-  maxRedemptions Int?
-  redeemedCount  Int  @default(0)
-
-  validFrom  DateTime?
-  validUntil DateTime?
-
-  applicablePlans Plan[]
-  redemptionScope CouponRedemptionScope
-
-  active Boolean @default(true)
-
-  metadata Json?
-
-  createdAt       DateTime         @default(now())
-  updatedAt       DateTime         @updatedAt
-  creditPurchases CreditPurchase[]
-}
-
-model RevenueAggregate {
-  id String @id @default(uuid())
-
-  period   String // YYYY-MM (e.g. 2026-02)
-  provider BillingProvider
-
-  grossRevenue Int
-  refunds      Int
-  credits      Int
-  netRevenue   Int
-
-  currency String
-
-  updatedAt DateTime @updatedAt
-
-  @@unique([period, provider, currency])
-  @@index([period])
-}
-
-model WaitList {
-  id               String  @id @default(uuid())
-  email            String  @unique
-  name             String?
-  company          String?
-  role             String?
-  teamSize         String?
-  useCase          String?
-  consentToUpdates Boolean
-  referralCode     String? @unique
-  referredBy       String?
-
-  createdAt DateTime @default(now())
-  updatedAt DateTime @updatedAt
-}
-
-model Job {
-  id          String    @id @default(uuid())
-  type        String
-  status      JobStatus @default(pending)
-  payload     Json
-  retries     Int       @default(0)
-  maxRetries  Int       @default(3)
-  error       String?
-  scheduledAt DateTime?
-  startedAt   DateTime?
-  finishedAt  DateTime?
-
-  createdAt DateTime @default(now())
-  updatedAt DateTime @updatedAt
-}
-
-model Onboarding {
-  id        String  @id @default(uuid())
-  userId    String  @unique
-  persona   String?
-  setupType String?
-  progress  Json?
-  completed Boolean @default(false)
-
-  createdAt DateTime @default(now())
-  updatedAt DateTime @updatedAt
-
-  user User @relation(fields: [userId], references: [id], onDelete: Cascade)
-}
-
-/////////////////////
-// Unique Visitors
-//////////////////////
-model Visitor {
-  id         String   @id @default(uuid())
-  visitorId  String   @unique // cookie or fingerprint ID
-  ipAddress  String?
-  userAgent  String?
-  country    String? // optional if you plan to use GeoIP later
-  referrer   String?
-  firstVisit DateTime @default(now())
-  lastVisit  DateTime @updatedAt
-  visitCount Int      @default(1)
-
-  createdAt     DateTime       @default(now())
-  updatedAt     DateTime       @updatedAt
-  postReactions PostReaction[]
-  postShares    PostShare[]
-
-  @@index([createdAt])
-}
-
-model EmailCampaign {
-  id            String   @id @default(uuid())
-  name          String
-  templateId    String
-  subject       String
-  audience      String // e.g. "waitlist", "users", "custom"
-  segmentFilter Json? // optional query/filter metadata
-  sentCount     Int      @default(0)
-  status        String   @default("draft") // draft | sending | sent | failed
-  metadata      Json?
-  createdById   String?
-  createdAt     DateTime @default(now())
-  updatedAt     DateTime @updatedAt
-
-  logs EmailSendLog[]
-}
-
-model EmailSendLog {
-  id          String    @id @default(uuid())
-  campaignId  String
-  recipient   String
-  status      String
-  messageId   String?
-  error       String?
-  metadata    Json?
-  sentAt      DateTime  @default(now())
-  openCount   Int       @default(0)
-  clickCount  Int       @default(0)
-  lastEventAt DateTime?
-
-  campaign EmailCampaign @relation(fields: [campaignId], references: [id])
-}
-
-model Post {
-  id      String   @id @default(uuid())
-  title   String
-  slug    String   @unique
-  excerpt String?
-  type    PostType @default(BLOG)
-  status  Status   @default(draft)
-
-  content     Json
-  contentHtml String?
-
-  featuredImage String?
-
-  // many-to-many pivot
-  tags PostTag[] @relation("PostTags")
-
-  authorId String?
-  author   User?   @relation(fields: [authorId], references: [id])
-
-  publishedAt   DateTime?
-  createdAt     DateTime       @default(now())
-  updatedAt     DateTime       @updatedAt
-  postComments  PostComment[]
-  postReactions PostReaction[]
-  postShares    PostShare[]
-
-  @@index([type])
-  @@index([status])
-  @@index([publishedAt])
-}
-
-model Tag {
-  id    String    @id @default(uuid())
-  name  String    @unique
-  color String    @default("blue")
-  // inverse many-to-many pivot
-  posts PostTag[] @relation("PostTags")
-}
-
-model PostTag {
-  postId String
-  tagId  String
-
-  // Add relation names
-  post Post @relation("PostTags", fields: [postId], references: [id], onDelete: Cascade)
-  tag  Tag  @relation("PostTags", fields: [tagId], references: [id], onDelete: Cascade)
-
-  @@id([postId, tagId])
-  @@index([tagId])
-}
-
-/// ─────────────────────────────────────────────
-/// COMMENT IDENTITIES (Name + Email Login-less System)
-/// ─────────────────────────────────────────────
-
-model CommentIdentity {
-  id       String  @id @default(uuid())
-  name     String
-  email    String  @unique
-  verified Boolean @default(false)
-  metadata Json?
-
-  createdAt DateTime @default(now())
-  updatedAt DateTime @updatedAt
-
-  comments      PostComment[]
-  postReactions PostReaction[]
-  postShares    PostShare[]
-
-  @@index([email])
-}
-
-/// ─────────────────────────────────────────────
-/// POST COMMENTS (Revised to use CommentIdentity)
-/// ─────────────────────────────────────────────
-
-model PostComment {
-  id         String  @id @default(uuid())
-  postId     String
-  identityId String? // Instead of userId (for public commenters)
-  parentId   String? // Threaded comments
-
-  content   String
-  status    Status    @default(active)
-  deletedAt DateTime?
-
-  // Relations
-  post     Post             @relation(fields: [postId], references: [id], onDelete: Cascade)
-  identity CommentIdentity? @relation(fields: [identityId], references: [id])
-  parent   PostComment?     @relation("CommentReplies", fields: [parentId], references: [id])
-  replies  PostComment[]    @relation("CommentReplies")
-
-  createdAt DateTime @default(now())
-  updatedAt DateTime @updatedAt
-
-  @@index([postId])
-  @@index([identityId])
-  @@index([parentId])
-  @@index([status])
-}
-
-/// ─────────────────────────────────────────────
-/// POST REACTIONS (LIKE, LOVE, CLAP, FIRE, WOW)
-/// ─────────────────────────────────────────────
-
-model PostReaction {
-  id         String       @id @default(uuid())
-  postId     String
-  visitorId  String? // Could be Visitor.visitorId
-  identityId String? // If commenter also reacts
-  type       ReactionType
-
-  status    Status    @default(active)
-  deletedAt DateTime?
-
-  post     Post             @relation(fields: [postId], references: [id], onDelete: Cascade)
-  visitor  Visitor?         @relation(fields: [visitorId], references: [visitorId])
-  identity CommentIdentity? @relation(fields: [identityId], references: [id])
-
-  createdAt DateTime @default(now())
-  updatedAt DateTime @updatedAt
-
-  @@unique([postId, visitorId, type])
-  @@unique([postId, identityId, type])
-  @@index([postId])
-  @@index([visitorId])
-  @@index([identityId])
-  @@index([type])
-}
-
-/// ─────────────────────────────────────────────
-/// POST SHARES (Analytics + Share Platform Info)
-/// ─────────────────────────────────────────────
-
-model PostShare {
-  id         String  @id @default(uuid())
-  postId     String
-  visitorId  String?
-  identityId String?
-  platform   String? // twitter | whatsapp | copy | linkedin | etc.
-  metadata   Json?
-
-  post     Post             @relation(fields: [postId], references: [id], onDelete: Cascade)
-  visitor  Visitor?         @relation(fields: [visitorId], references: [visitorId])
-  identity CommentIdentity? @relation(fields: [identityId], references: [id])
-
-  createdAt DateTime @default(now())
-
-  @@index([postId])
-  @@index([visitorId])
-  @@index([identityId])
-  @@index([platform])
-}
-
-//// _________________________________________________________________
-//// CREDITS PURCHASES & REFUNDS
-//// _________________________________________________________________
-
-model CreditPurchase {
-  id String @id @default(uuid())
-
-  userId            String
-  billingCustomerId String?
-
-  provider          BillingProvider
-  providerOrderId   String          @unique // Razorpay order_xxx
-  providerPaymentId String? // Razorpay pay_xxx
-
-  creditAmount Int // Number of credits purchased
-  pricePaid    Int // Amount in paise/cents
-  currency     String @default("INR")
-
-  status CreditPurchaseStatus @default(pending)
-
-  couponId       String?
-  discountAmount Int?
-
-  metadata Json?
-
-  paidAt     DateTime?
-  refundedAt DateTime?
-
-  createdAt DateTime @default(now())
-  updatedAt DateTime @updatedAt
-
-  user            User             @relation(fields: [userId], references: [id])
-  billingCustomer BillingCustomer? @relation(fields: [billingCustomerId], references: [id])
-  coupon          Coupon?          @relation(fields: [couponId], references: [id])
-
-  @@index([userId])
-  @@index([provider, providerOrderId])
-  @@index([status])
-}
-
-model Refund {
-  id String @id @default(uuid())
-
-  userId            String
-  billingCustomerId String?
-
-  provider          BillingProvider
-  providerRefundId  String          @unique // Razorpay rfnd_xxx
-  providerPaymentId String // Original payment
-
-  amount   Int
-  currency String
-
-  reason String?
-  status String  @default("pending") // pending | processed | failed
-
-  // Link to original purchase
-  invoiceId        String?
-  creditPurchaseId String?
-
-  metadata Json?
-
-  processedAt DateTime?
-  createdAt   DateTime  @default(now())
-
-  user            User             @relation(fields: [userId], references: [id])
-  billingCustomer BillingCustomer? @relation(fields: [billingCustomerId], references: [id])
-
-  @@index([userId])
-  @@index([provider, providerRefundId])
-}
+generator client {
+  provider        = "prisma-client-js"
+}
+
+datasource db {
+  provider   = "postgresql"
+  url        = env("DATABASE_URL")
+  directUrl  = env("DIRECT_URL")
+}
+
+/// ─────────────────────────────────────────────
+/// ENUMS
+/// ─────────────────────────────────────────────
+
+enum Role {
+  user
+  support
+  business
+  superadmin
+  moderator
+  admin
+}
+
+enum Status {
+  active // Visible and usable in production
+  suspended // Temporarily disabled but can be restored
+  deleted // Soft-deleted or removed from UI
+  draft // Being worked on but not yet published
+  pending_review // Awaiting manual or automated approval
+  deprecated // Old but still accessible for legacy users
+  archived // Hidden from new users, preserved for history
+  disconnected
+}
+
+enum Plan {
+  free
+  starter
+  pro
+  business
+  enterprise
+}
+
+enum AuthType {
+  credentials
+  oauth
+  hybrid
+}
+
+enum IntegrationStatus {
+  active // Connected and syncing
+  disconnected // User disconnected the integration
+  suspended // Temporarily disabled
+  failed // Sync or auth failed
+  expired
+  error
+}
+
+enum MessageRole {
+  user
+  assistant
+  system
+  tool
+  moderator
+}
+
+enum PostType {
+  BLOG
+  ANNOUNCEMENT
+  SESSION
+}
+
+enum ReactionType {
+  LIKE
+  LOVE
+  CLAP
+  FIRE
+  WOW
+}
+
+enum FileCategory {
+  avatar
+  media
+  attachment
+  memory
+  export
+}
+
+enum TwoFactorMethod {
+  totp
+  email
+  webauthn
+}
+
+enum SubscriptionStatus {
+  created // intent created, payment pending
+  active
+  trialing
+  past_due
+  canceled
+  paused
+}
+
+enum WorkflowStatus {
+  draft
+  pending_review // NEW: Awaiting user approval
+  active
+  paused
+  archived
+  failed // NEW: Execution failures
+}
+
+/// NEW: Trigger type enum for workflow automation
+enum TriggerType {
+  manual // User-initiated
+  scheduled // Cron/time-based
+  event // External event
+  webhook // Incoming webhook
+  condition // When condition met
+}
+
+enum WorkflowRunStatus {
+  pending // NEW: Queued for execution
+  running
+  completed
+  failed
+  canceled
+  timeout // NEW: Execution timed out
+}
+
+enum WorkflowStepStatus {
+  draft
+  active
+  paused
+  deprecated
+}
+
+enum WorkflowStepRunStatus {
+  pending
+  running
+  completed
+  failed
+  skipped
+  timeout // NEW: Step timed out
+}
+
+enum BillingProvider {
+  razorpay
+  stripe
+  juspay
+}
+
+enum SubscriptionEventType {
+  created // Subscription object created (before activation)
+  activated // First successful activation
+  trial_started // Trial period started
+  trial_ended // Trial expired or converted
+
+  charged // Successful recurring or first charge
+  payment_failed // Charge attempt failed
+  payment_recovered // Previously failed payment later succeeded
+
+  paused // Subscription paused (manual or system)
+  resumed // Subscription resumed after pause
+
+  plan_changed // Upgrade / downgrade
+  quantity_changed // Seats / units changed (enterprise)
+
+  canceled // User or system initiated cancellation
+  completed // Subscription ran its full course
+  expired // Ended due to non-payment / mandate expiry
+
+  refunded // Full or partial refund issued
+}
+
+enum InvoiceStatus {
+  draft
+  open
+  paid
+  partially_paid
+  failed
+  void
+  refunded
+}
+
+enum PaymentMethodType {
+  card
+  upi
+  bank
+  wallet
+}
+
+enum PaymentMethodStatus {
+  active
+  inactive
+  expired
+  revoked
+}
+
+enum BillingEventStatus {
+  received
+  processing
+  processed
+  failed
+}
+
+enum BillingLedgerEntryType {
+  charge
+  refund
+  credit
+  debit
+  adjustment
+}
+
+enum BillingLedgerDirection {
+  debit
+  credit
+}
+
+enum JobStatus {
+  pending
+  scheduled
+  running
+  completed
+  failed
+  dead
+}
+
+enum CouponDiscountType {
+  percentage
+  flat
+}
+
+enum CouponRedemptionScope {
+  subscription
+  invoice
+  one_time
+}
+
+enum CreditPurchaseStatus {
+  pending
+  paid
+  failed
+  refunded
+  partially_refunded
+}
+
+/// ─────────────────────────────────────────────────────────────
+/// ENUMS FOR MEMORY & RAG SYSTEM
+/// ─────────────────────────────────────────────────────────────
+
+enum MemoryType {
+  preference // "User prefers formal emails"
+  fact // "CEO is John Smith"
+  context // "Currently working on Q1 report"
+  instruction // "Always CC manager on reports"
+  relationship // "John is user's manager"
+}
+
+enum MemorySource {
+  chat // Extracted from conversation
+  document // Extracted from uploaded doc
+  integration // Synced from connected service
+  explicit // User explicitly told us
+  inferred // AI inferred from behavior
+}
+
+enum DocumentStatus {
+  pending // Queued for processing
+  processing // Being chunked/embedded
+  completed // Ready for RAG
+  failed // Processing error
+  archived // No longer active
+}
+
+enum DocumentSourceType {
+  user_file // From UserFile upload
+  integration // From Gmail, Drive, etc
+  url // Fetched from URL
+  paste // Direct text paste
+  chat // Extracted from chat
+}
+
+/// ─────────────────────────────────────────────────────────────
+/// ENUMS FOR TOOL SYSTEM
+/// ─────────────────────────────────────────────────────────────
+
+enum ToolStatus {
+  active
+  deprecated
+  disabled
+  beta
+}
+
+/// ─────────────────────────────────────────────
+/// USERS & AUTH
+/// ─────────────────────────────────────────────
+
+model User {
+  id   String @id @default(uuid())
+  name String
+
+  image             String? // provider image
+  avatarOverrideUrl String?
+
+  email              String    @unique
+  password           String?
+  emailVerified      DateTime?
+  onboarding         DateTime?
+  role               Role      @default(user)
+  timezone           String?
+  language           String?
+  status             Status    @default(active)
+  lastLogin          DateTime?
+  lastPasswordChange DateTime?
+  twoFactorEnabled   Boolean   @default(false)
+
+  userTwoFactor UserTwoFactor?
+
+  metadata     Json?
+  deletedAt    DateTime?
+  plan         Plan      @default(free)
+  tokenBalance Int       @default(0)
+  creditsUsed  Int       @default(0)
+
+  chatCount        Int @default(0)
+  workflowCount    Int @default(0)
+  integrationCount Int @default(0)
+
+  lastActiveAt DateTime?
+
+  authType AuthType @default(oauth)
+
+  passwordStrength String? // weak | medium | strong
+
+  storageUsed  BigInt @default(0) // bytes
+  storageLimit BigInt @default(524288000) // 500 MB (beta)
+
+  accounts           Account[]
+  integrations       Integration[]
+  tokenTransactions  TokenTransaction[]
+  auditLogs          AuditLog[]
+  subscriptions      Subscription[]
+  workspaces         Workspace[]        @relation("UserWorkspaces")
+  defaultWorkspaceId String?            @unique
+  defaultWorkspace   Workspace?         @relation("UserDefaultWorkspace", fields: [defaultWorkspaceId], references: [id])
+  Workflow           Workflow[]
+  Notification       Notification[]
+  Onboarding         Onboarding?
+  ChatSession        ChatSession[]
+
+  createdAt        DateTime          @default(now())
+  updatedAt        DateTime          @updatedAt
+  posts            Post[]
+  userSessions     UserSession[]
+  paymentMethods   PaymentMethod[]
+  userEmails       UserEmail[]
+  invoices         Invoice[]
+  userFiles        UserFile[]
+  billingCustomers BillingCustomer[]
+  billingLedgers   BillingLedger[]
+  creditPurchases  CreditPurchase[]
+  refunds          Refund[]
+
+  /// Memory & RAG system relations
+  memories  Memory[]
+  documents Document[]
+
+  @@index([status])
+}
+
+model UserFile {
+  id     String @id @default(uuid())
+  userId String
+
+  path     String // Spaces object key (users/{userId}/{category}/{fileId}.ext)
+  size     BigInt // bytes
+  mimeType String
+  category FileCategory
+
+  /// Link to Document if this file has been ingested for RAG
+  documentId String? @unique
+
+  checksum String? // sha256 or md5 for integrity verification
+  metadata Json?
+
+  createdAt DateTime @default(now())
+
+  user     User      @relation(fields: [userId], references: [id], onDelete: Cascade)
+  document Document? @relation(fields: [documentId], references: [id])
+
+  @@index([userId])
+  @@index([category])
+  @@index([userId, category])
+}
+
+model UserSession {
+  id        String   @id @default(uuid())
+  userId    String
+  ip        String?
+  userAgent String?
+  lastUsed  DateTime
+
+  revoked   Boolean   @default(false)
+  revokedAt DateTime?
+
+  expiresAt DateTime
+  createdAt DateTime @default(now())
+
+  user User @relation(fields: [userId], references: [id], onDelete: Cascade)
+
+  @@index([userId, revoked])
+}
+
+model UploadIntent {
+  id        String       @id
+  userId    String
+  category  FileCategory
+  size      BigInt
+  objectKey String
+  createdAt DateTime     @default(now())
+
+  @@index([userId])
+  @@index([userId, category])
+}
+
+model UserEmail {
+  id        String   @id @default(uuid())
+  userId    String
+  email     String   @unique
+  verified  Boolean  @default(false)
+  primary   Boolean  @default(false)
+  type      String? // billing | security | notifications
+  createdAt DateTime @default(now())
+
+  user User @relation(fields: [userId], references: [id], onDelete: Cascade)
+}
+
+model UserTwoFactor {
+  id     String @id @default(uuid())
+  userId String @unique
+
+  method  TwoFactorMethod @default(totp)
+  secret  String? // null when disabled or method != totp
+  enabled Boolean         @default(false)
+
+  lastVerifiedAt DateTime?
+  enabledAt      DateTime?
+
+  recoveryEmailVerifiedAt DateTime?
+
+  backupCodes Json? // [{ hash, used, usedAt }]
+
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+
+  user User @relation(fields: [userId], references: [id], onDelete: Cascade)
+
+  @@index([userId])
+}
+
+model Account {
+  id                String  @id @default(uuid())
+  userId            String
+  type              String
+  provider          String
+  providerAccountId String
+  refresh_token     String? @db.Text
+  access_token      String? @db.Text
+  expires_at        Int?
+  token_type        String?
+  scope             String?
+  id_token          String? @db.Text
+  session_state     String?
+
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+
+  user User @relation(fields: [userId], references: [id], onDelete: Cascade)
+
+  @@unique([provider, providerAccountId])
+}
+
+model VerificationToken {
+  id        String   @id @default(uuid())
+  email     String
+  token     String   @unique
+  expiresAt DateTime
+
+  @@unique([email, token])
+}
+
+model PasswordResetToken {
+  id        String   @id @default(uuid())
+  email     String
+  token     String   @unique
+  expiresAt DateTime
+
+  @@unique([email, token])
+}
+
+/// ─────────────────────────────────────────────
+/// WORKSPACES & INTEGRATIONS
+/// ─────────────────────────────────────────────
+
+model Workspace {
+  id          String    @id @default(uuid())
+  name        String
+  description String?
+  ownerId     String
+  status      Status    @default(active)
+  deletedAt   DateTime?
+
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+
+  owner      User  @relation("UserWorkspaces", fields: [ownerId], references: [id])
+  defaultFor User? @relation("UserDefaultWorkspace")
+
+  integrations Integration[]
+  aiAgents     AIAgent[]
+  Workflow     Workflow[]
+  ChatSession  ChatSession[]
+
+  /// Memory & RAG system relations
+  memories  Memory[]
+  documents Document[]
+
+  @@index([status])
+  @@index([ownerId])
+}
+
+model Integration {
+  id                String    @id @default(cuid())
+  userId            String
+  workspaceId       String?
+  provider          String
+  providerAccountId String
+  integration       String
+  accessToken       String
+  refreshToken      String?
+  expiresAt         DateTime?
+  scopes            Json
+  profile           Json
+  status            IntegrationStatus @default(active)
+  metadata          Json?
+  deletedAt         DateTime?
+
+  catalogId String?
+  catalog   IntegrationCatalog? @relation(fields: [catalogId], references: [id])
+
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+
+  user               User                 @relation(fields: [userId], references: [id], onDelete: Cascade)
+  workspace          Workspace?           @relation(fields: [workspaceId], references: [id])
+  integrationSyncLog IntegrationSyncLog[]
+
+  @@unique([userId, provider, integration, workspaceId], name: "user_provider_integration_workspace")
+  @@index([workspaceId])
+  @@index([status])
+  @@map("integrations")
+}
+
+model IntegrationCatalog {
+  id                   String  @id @default(uuid())
+  provider             String
+  integration          String
+  name                 String
+  category             String?
+  showDuringOnboarding Boolean @default(true)
+  default              Boolean @default(false)
+  premium              Boolean @default(false)
+  iconUrl              String?
+  description          String?
+  docsUrl              String?
+  oauthType            String?
+  setupInstructions    Json?
+  status               Status  @default(draft)
+
+  // ✅ NEW
+  capabilities   Json?
+  examplePrompts String[]
+
+  createdAt   DateTime      @default(now())
+  updatedAt   DateTime      @updatedAt
+  Integration Integration[]
+
+  @@unique([provider, integration])
+  @@index([status])
+  @@map("integration_catalog")
+}
+
+model IntegrationSyncLog {
+  id            String   @id @default(uuid())
+  integrationId String
+  syncStatus    String
+  errorMessage  String?
+  timestamp     DateTime @default(now())
+
+  integration Integration @relation(fields: [integrationId], references: [id])
+}
+
+/// ─────────────────────────────────────────────
+/// AUTOMATIONS / AI / WORKFLOWS
+/// ─────────────────────────────────────────────
+
+model AIAgent {
+  id          String     @id @default(uuid())
+  name        String
+  key         String     @unique
+  description String?
+  active      Boolean    @default(true)
+  config      Json?
+  workspaceId String?
+  workspace   Workspace? @relation(fields: [workspaceId], references: [id])
+
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+
+  tokenTransactions TokenTransaction[]
+  ChatSession       ChatSession[]
+}
+
+model UsageAggregate {
+  id            String   @id @default(uuid())
+  userId        String
+  workspaceId   String?
+  billingPeriod String
+  source        String // chat | automation | api
+  tokensUsed    Int
+  requestCount  Int
+  updatedAt     DateTime @updatedAt
+
+  @@unique([userId, workspaceId, billingPeriod, source])
+}
+
+model TokenTransaction {
+  id         String  @id @default(uuid())
+  userId     String
+  agentId    String?
+  tokensUsed Int
+  action     String
+
+  source      String? // chat | automation | api
+  workspaceId String?
+  integration String?
+
+  billingPeriod String? // e.g. "2025-01" (YYYY-MM)
+
+  metadata  Json?
+  createdAt DateTime @default(now())
+
+  user  User     @relation(fields: [userId], references: [id])
+  agent AIAgent? @relation(fields: [agentId], references: [id])
+}
+
+model Workflow {
+  id          String         @id @default(uuid())
+  name        String
+  description String?
+  status      WorkflowStatus @default(active)
+  userId      String
+  workspaceId String?
+
+  /// Full workflow spec from AI service (for AI-generated workflows)
+  /// Includes: trigger, conditions, actions, etc.
+  spec Json?
+
+  /// How this workflow is triggered
+  triggerType TriggerType?
+
+  /// Trigger configuration (e.g., cron schedule)
+  triggerConfig Json?
+
+  /// Which integrations this workflow needs
+  /// e.g., ["gmail", "calendar", "slack"]
+  requiredIntegrations String[] @default([])
+
+  /// Execution stats
+  runCount      Int       @default(0)
+  lastRunAt     DateTime?
+  lastRunStatus String?
+
+  /// For scheduled workflows
+  nextScheduledAt DateTime?
+
+  /// Soft delete support
+  deletedAt DateTime?
+
+  metadata Json?
+
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+
+  user      User           @relation(fields: [userId], references: [id], onDelete: Cascade)
+  workspace Workspace?     @relation(fields: [workspaceId], references: [id])
+  steps     WorkflowStep[]
+  runs      WorkflowRun[]
+
+  @@index([userId, status])
+  @@index([triggerType])
+  @@index([nextScheduledAt])
+}
+
+model WorkflowStep {
+  id         String             @id @default(uuid())
+  workflowId String
+  type       String
+  config     Json
+  order      Int
+  status     WorkflowStepStatus @default(active)
+
+  /// What action this step performs (for AI-generated)
+  /// e.g., "email.send", "calendar.create", "slack.post"
+  actionTarget String?
+
+  /// Which integration is required for this step
+  integrationId String?
+
+  /// Whether this step requires user confirmation before executing
+  requiresConfirmation Boolean @default(false)
+
+  workflow Workflow @relation(fields: [workflowId], references: [id], onDelete: Cascade)
+
+  createdAt DateTime          @default(now())
+  updatedAt DateTime          @updatedAt
+  stepRuns  WorkflowStepRun[]
+
+  @@index([workflowId, order])
+  @@index([actionTarget])
+}
+
+model WorkflowRun {
+  id         String @id @default(uuid())
+  workflowId String
+
+  /// Link to Job table for background execution tracking
+  jobId String? @unique
+
+  status WorkflowRunStatus @default(pending)
+
+  /// What triggered this run
+  triggeredBy String? // user_id, scheduler, event_id
+  triggerType String? // manual, scheduled, event
+
+  /// Input to this run (trigger payload)
+  input Json?
+
+  /// Final output
+  output Json?
+
+  /// Error message if failed
+  error String?
+
+  startedAt  DateTime?
+  finishedAt DateTime?
+
+  /// How long execution took
+  durationMs Int?
+
+  /// Tokens used for this run (for AI workflows)
+  tokensUsed Int?
+
+  metadata Json?
+
+  createdAt DateTime @default(now())
+
+  workflow Workflow @relation(fields: [workflowId], references: [id], onDelete: Cascade)
+
+  /// Link to Job for background execution
+  job Job? @relation(fields: [jobId], references: [id])
+
+  steps WorkflowStepRun[]
+
+  @@index([workflowId, startedAt])
+  @@index([status])
+}
+
+model WorkflowStepRun {
+  id             String @id @default(uuid())
+  workflowRunId  String
+  workflowStepId String
+
+  /// Step index for ordering (useful for AI-generated dynamic steps)
+  stepIndex Int?
+
+  status WorkflowStepRunStatus @default(pending)
+
+  /// Input to this step
+  input Json?
+
+  /// Output from this step
+  output Json?
+
+  /// Error if step failed
+  error String?
+
+  /// Which integration was used for this step
+  integrationId String?
+
+  /// External request/order ID (for tracking in external system)
+  externalRequestId String?
+
+  startedAt  DateTime?
+  finishedAt DateTime?
+
+  /// Step execution time
+  durationMs Int?
+
+  /// How many times this step was retried
+  retryCount Int @default(0)
+
+  metadata Json?
+
+  createdAt DateTime @default(now())
+
+  workflowRun  WorkflowRun  @relation(fields: [workflowRunId], references: [id], onDelete: Cascade)
+  workflowStep WorkflowStep @relation(fields: [workflowStepId], references: [id])
+
+  @@index([workflowRunId, stepIndex])
+  @@index([workflowStepId])
+}
+
+/// ─────────────────────────────────────────────────────────────
+/// MEMORY SYSTEM (USER CONTEXT PERSISTENCE)
+/// ─────────────────────────────────────────────────────────────
+
+/// Lightweight facts about user learned over time
+/// Examples:
+/// - "Prefers formal email tone"
+/// - "CEO is Jane Smith"
+/// - "Current project is Q1 launch"
+model Memory {
+  id          String  @id @default(uuid())
+  userId      String
+  workspaceId String?
+
+  /// Type of memory: preference, fact, context, instruction, relationship
+  type MemoryType
+
+  /// Where this memory came from: chat, document, integration, explicit, inferred
+  source MemorySource
+
+  /// The actual memory content
+  content String @db.Text
+
+  /// Optional condensed version for quick retrieval
+  summary String?
+
+  /// Importance scoring (0-1 scale)
+  /// Decays over time for less relevant memories
+  importance Float @default(0.5)
+
+  /// How many times this memory was accessed/recalled
+  accessCount Int @default(0)
+
+  /// Last time this memory was used in response
+  lastAccessed DateTime?
+
+  /// Source tracking - where this memory came from
+  sourceId   String? // chatSessionId, documentId, workflowRunId
+  sourceType String? // chat, document, workflow, integration
+
+  /// TTL for temporary memories
+  expiresAt DateTime?
+
+  /// Soft delete
+  active Boolean @default(true)
+
+  metadata Json?
+
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+
+  user      User       @relation(fields: [userId], references: [id], onDelete: Cascade)
+  workspace Workspace? @relation(fields: [workspaceId], references: [id])
+
+  @@index([userId, type, active])
+  @@index([userId, importance])
+  @@index([expiresAt])
+}
+
+/// ─────────────────────────────────────────────────────────────
+/// DOCUMENT SYSTEM (RAG - RETRIEVAL AUGMENTED GENERATION)
+/// ─────────────────────────────────────────────────────────────
+
+/// Tracks document ingestion progress
+/// When user uploads a file, Document record created
+/// Workers then chunk, embed, and store DocumentChunks
+model Document {
+  id          String  @id @default(uuid())
+  userId      String
+  workspaceId String?
+
+  /// Where document came from
+  sourceType DocumentSourceType
+
+  /// ID of the source (e.g., UserFile.id, Integration.id)
+  sourceId String?
+
+  /// Original name/title
+  sourceName String?
+
+  /// Original URL (for web sources)
+  sourceUrl String?
+
+  /// Raw content stored temporarily during processing
+  rawContent String? @db.Text
+
+  /// MIME type (application/pdf, text/plain, etc.)
+  mimeType String?
+
+  /// Ingestion status
+  status DocumentStatus @default(pending)
+
+  /// How many chunks were created
+  chunkCount Int @default(0)
+
+  /// Error message if ingestion failed
+  error String?
+
+  /// AI-generated summary of document
+  summary String?
+
+  /// Extracted topics/tags from content
+  topics String[] @default([])
+
+  metadata Json?
+
+  processedAt DateTime?
+  createdAt   DateTime  @default(now())
+  updatedAt   DateTime  @updatedAt
+
+  user      User       @relation(fields: [userId], references: [id], onDelete: Cascade)
+  workspace Workspace? @relation(fields: [workspaceId], references: [id])
+
+  /// Chunks of this document
+  chunks DocumentChunk[]
+
+  /// If this document came from UserFile, link it
+  userFile UserFile?
+
+  @@index([userId, status])
+  @@index([sourceType, sourceId])
+  @@index([status])
+}
+
+/// Chunks of documents for semantic search
+/// Created by ingestion worker
+/// Examples: paragraphs from PDF, sections from doc, etc.
+model DocumentChunk {
+  id         String @id @default(uuid())
+  documentId String
+
+  /// Order within document (for context)
+  chunkIndex Int
+
+  /// The actual text content
+  content String @db.Text
+
+  /// Tokens in this chunk (for context window management)
+  tokenCount Int?
+
+  /// Position in original document (for citation)
+  startChar Int?
+  endChar   Int?
+
+  /// Metadata from original
+  sectionTitle String?
+  pageNumber   Int?
+
+  metadata Json?
+
+  createdAt DateTime @default(now())
+
+  document Document @relation(fields: [documentId], references: [id], onDelete: Cascade)
+
+  /// Note: Vector index needs to be added via raw SQL:
+  /// CREATE INDEX ON "DocumentChunk" USING ivfflat (embedding vector_cosine_ops)
+
+  @@index([documentId, chunkIndex])
+}
+
+/// Summaries of conversations for context window management
+/// When conversation gets long, summarize earlier parts
+/// Keep summary in context instead of full messages
+model ConversationSummary {
+  id            String @id @default(uuid())
+  chatSessionId String
+
+  /// Which messages are summarized
+  fromMessageId String?
+  toMessageId   String?
+  messageCount  Int
+
+  /// Summary text
+  summary String @db.Text
+
+  /// Key points extracted (for quick reference)
+  keyPoints Json?
+
+  createdAt DateTime @default(now())
+
+  chatSession ChatSession @relation(fields: [chatSessionId], references: [id], onDelete: Cascade)
+
+  @@index([chatSessionId, createdAt])
+}
+
+/// ─────────────────────────────────────────────
+/// COMMUNICATION / CHAT / EMAIL
+/// ─────────────────────────────────────────────
+
+model Notification {
+  id     String  @id @default(uuid())
+  userId String?
+  type   String
+  title  String
+  body   String?
+  read   Boolean @default(false)
+
+  createdAt DateTime @default(now())
+
+  user User? @relation(fields: [userId], references: [id])
+}
+
+model ChatSession {
+  id          String  @id @default(uuid())
+  title       String?
+  userId      String?
+  workspaceId String?
+  aiAgentId   String?
+  status      String  @default("active")
+
+  /// Memory and RAG context management
+  contextMode   String? @default("standard") // standard | deep | rag
+  memoryEnabled Boolean @default(true)
+
+  /// Track summarization for long conversations
+  lastSummaryAt DateTime?
+  summaryCount  Int       @default(0)
+
+  metadata  Json?
+  deletedAt DateTime?
+
+  user      User?                 @relation(fields: [userId], references: [id], onDelete: Cascade)
+  workspace Workspace?            @relation(fields: [workspaceId], references: [id])
+  aiAgent   AIAgent?              @relation(fields: [aiAgentId], references: [id])
+  messages  ChatMessage[]
+  summaries ConversationSummary[]
+
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+
+  @@index([userId, createdAt])
+  @@index([workspaceId, createdAt])
+  @@index([status])
+}
+
+model ChatMessage {
+  id            String      @id @default(uuid())
+  chatSessionId String
+  sender        MessageRole
+  content       String
+  style         String?
+  tokensUsed    Int?
+
+  /// Track which memories/documents/tools were used to generate this message
+  memoriesUsed  String[] @default([]) // IDs of Memory records used
+  documentsUsed String[] @default([]) // IDs of DocumentChunk records used
+  toolsUsed     String[] @default([]) // IDs of Tool records used
+
+  /// Mark important messages for memory extraction
+  isKeyMessage Boolean @default(false)
+
+  metadata  Json?
+  deletedAt DateTime?
+
+  chatSession ChatSession @relation(fields: [chatSessionId], references: [id])
+
+  createdAt DateTime @default(now())
+
+  @@index([chatSessionId, createdAt])
+  @@index([isKeyMessage])
+}
+
+model EmailLog {
+  id       String   @id @default(uuid())
+  to       String
+  subject  String
+  type     String // verification, marketing, notification, etc.
+  status   String   @default("sent")
+  metadata Json?
+  sentAt   DateTime @default(now())
+  error    String?
+}
+
+/// ─────────────────────────────────────────────
+/// WORKFLOW TEMPLATES & ONBOARDING PERSONAS
+/// ─────────────────────────────────────────────
+
+model WorkflowTemplate {
+  id                 String  @id @default(uuid())
+  name               String
+  description        String?
+  category           String?
+  recommended        Boolean @default(false)
+  iconUrl            String?
+  estimatedSetupTime Int?
+  status             Status  @default(active)
+
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+
+  steps WorkflowStepTemplate[]
+}
+
+model WorkflowStepTemplate {
+  id         String @id @default(uuid())
+  templateId String
+  type       String
+  config     Json
+  order      Int
+  status     String @default("active")
+
+  template WorkflowTemplate @relation(fields: [templateId], references: [id])
+}
+
+model OnboardingPersona {
+  id          String  @id @default(uuid())
+  key         String  @unique
+  title       String
+  description String?
+  iconUrl     String?
+  recommended Boolean @default(false)
+  status      Status  @default(active)
+
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+}
+
+/// ─────────────────────────────────────────────
+/// MONITORING / ADMIN / SYSTEM CONFIG
+/// ─────────────────────────────────────────────
+
+model Service {
+  id          String    @id @default(uuid())
+  name        String
+  description String?
+  endpoint    String
+  status      String    @default("healthy")
+  lastPing    DateTime?
+  uptime      Float?
+  region      String?
+  metadata    Json?
+  createdAt   DateTime  @default(now())
+  updatedAt   DateTime  @updatedAt
+
+  logs   ServiceLog[]
+  errors ErrorLog[]
+}
+
+model ServiceLog {
+  id        String   @id @default(uuid())
+  serviceId String
+  level     String
+  message   String
+  metadata  Json?
+  createdAt DateTime @default(now())
+
+  service Service @relation(fields: [serviceId], references: [id])
+}
+
+model ErrorLog {
+  id         String   @id @default(uuid())
+  serviceId  String?
+  errorType  String?
+  message    String
+  stackTrace String?
+  context    Json?
+  createdAt  DateTime @default(now())
+
+  service Service? @relation(fields: [serviceId], references: [id])
+}
+
+model SystemConfig {
+  id        String   @id @default(uuid())
+  key       String   @unique
+  value     Json
+  category  String?
+  updatedAt DateTime @updatedAt
+}
+
+model AuditLog {
+  id          String   @id @default(uuid())
+  userId      String?
+  actorRole   Role?
+  eventType   String
+  targetType  String?
+  targetId    String?
+  description String?
+  metadata    Json?
+  createdAt   DateTime @default(now())
+
+  user User? @relation(fields: [userId], references: [id])
+
+  @@index([userId, createdAt])
+}
+
+model SecurityEvent {
+  id        String   @id @default(uuid())
+  userId    String?
+  type      String // login | logout | password_change | session_revoked
+  ip        String?
+  userAgent String?
+  success   Boolean
+  metadata  Json?
+  createdAt DateTime @default(now())
+
+  @@index([userId, createdAt])
+}
+
+/// ─────────────────────────────────────────────
+/// BILLING / WAITLIST / JOBS / ONBOARDING
+/// ─────────────────────────────────────────────
+
+model Subscription {
+  id String @id @default(uuid())
+
+  userId String
+  plan   Plan
+  status SubscriptionStatus
+
+  provider               BillingProvider // razorpay | stripe | juspay
+  providerSubscriptionId String          @unique
+  providerPlanId         String?
+
+  billingCustomerId String
+
+  // Lifecycle
+  startedAt DateTime
+  endedAt   DateTime?
+
+  // Billing cycle
+  currentPeriodStart DateTime?
+  currentPeriodEnd   DateTime?
+  nextPayment        DateTime?
+
+  metadata Json?
+
+  user               User                @relation(fields: [userId], references: [id])
+  billingCustomer    BillingCustomer     @relation(fields: [billingCustomerId], references: [id])
+  invoices           Invoice[]
+  subscriptionEvents SubscriptionEvent[]
+
+  @@index([provider, providerSubscriptionId])
+  @@index([billingCustomerId])
+}
+
+model Invoice {
+  id String @id @default(uuid())
+
+  userId            String
+  subscriptionId    String?
+  billingCustomerId String
+
+  provider          BillingProvider // razorpay | stripe | juspay
+  providerInvoiceId String
+
+  amount   Int
+  currency String
+  status   InvoiceStatus
+
+  periodStart DateTime?
+  periodEnd   DateTime?
+
+  hostedInvoiceUrl String?
+  pdfUrl           String?
+
+  metadata Json?
+
+  createdAt DateTime @default(now())
+
+  user            User            @relation(fields: [userId], references: [id])
+  subscription    Subscription?   @relation(fields: [subscriptionId], references: [id])
+  billingCustomer BillingCustomer @relation(fields: [billingCustomerId], references: [id])
+
+  @@unique([provider, providerInvoiceId])
+  @@index([billingCustomerId])
+}
+
+model BillingEvent {
+  id String @id @default(uuid())
+
+  provider  BillingProvider // razorpay | stripe | juspay
+  eventType String
+  eventId   String
+
+  payload Json
+
+  status      BillingEventStatus @default(received)
+  processedAt DateTime?
+  error       String?
+
+  createdAt DateTime @default(now())
+
+  @@unique([provider, eventId])
+  @@index([provider, eventType])
+}
+
+model PaymentMethod {
+  id String @id @default(uuid())
+
+  userId            String
+  billingCustomerId String
+
+  provider                BillingProvider // razorpay | stripe | juspay
+  providerPaymentMethodId String // token_xxx, pm_xxx
+
+  type     PaymentMethodType // card | upi | bank
+  brand    String?
+  last4    String?
+  expMonth Int?
+  expYear  Int?
+
+  isDefault Boolean             @default(false)
+  status    PaymentMethodStatus @default(active)
+
+  metadata Json?
+
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+
+  user            User            @relation(fields: [userId], references: [id], onDelete: Cascade)
+  billingCustomer BillingCustomer @relation(fields: [billingCustomerId], references: [id])
+
+  @@unique([provider, providerPaymentMethodId])
+  @@index([billingCustomerId])
+}
+
+model BillingCustomer {
+  id String @id @default(uuid())
+
+  userId             String
+  provider           BillingProvider // razorpay | stripe | juspay
+  providerCustomerId String // cust_xxx, cus_xxx
+
+  email    String?
+  metadata Json?
+
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+
+  user            User             @relation(fields: [userId], references: [id], onDelete: Cascade)
+  subscriptions   Subscription[]
+  invoices        Invoice[]
+  paymentMethods  PaymentMethod[]
+  billingLedgers  BillingLedger[]
+  creditPurchases CreditPurchase[]
+  refunds         Refund[]
+
+  @@unique([provider, providerCustomerId])
+  @@unique([userId, provider])
+  @@index([providerCustomerId])
+}
+
+model SubscriptionEvent {
+  id String @id @default(uuid())
+
+  subscriptionId String
+  provider       BillingProvider
+  eventType      SubscriptionEventType
+  payload        Json
+
+  createdAt DateTime @default(now())
+
+  subscription Subscription @relation(fields: [subscriptionId], references: [id])
+
+  @@index([subscriptionId, createdAt])
+}
+
+model BillingLedger {
+  id String @id @default(uuid())
+
+  userId            String
+  billingCustomerId String
+
+  provider BillingProvider
+
+  entryType BillingLedgerEntryType // charge | refund | credit | debit | adjustment
+  direction BillingLedgerDirection // debit | credit
+
+  amount   Int
+  currency String
+
+  referenceType String // invoice | subscription | payment | coupon | reward
+  referenceId   String
+
+  description String?
+  metadata    Json?
+
+  createdAt DateTime @default(now())
+
+  user            User            @relation(fields: [userId], references: [id])
+  billingCustomer BillingCustomer @relation(fields: [billingCustomerId], references: [id])
+
+  @@index([userId, createdAt])
+  @@index([billingCustomerId, createdAt])
+  @@index([provider, createdAt])
+}
+
+model Coupon {
+  id String @id @default(uuid())
+
+  code String @unique
+
+  discountType  CouponDiscountType
+  discountValue Int // % or flat amount (minor units)
+
+  currency String? // required for flat discounts
+
+  maxRedemptions Int?
+  redeemedCount  Int  @default(0)
+
+  validFrom  DateTime?
+  validUntil DateTime?
+
+  applicablePlans Plan[]
+  redemptionScope CouponRedemptionScope
+
+  active Boolean @default(true)
+
+  metadata Json?
+
+  createdAt       DateTime         @default(now())
+  updatedAt       DateTime         @updatedAt
+  creditPurchases CreditPurchase[]
+}
+
+model RevenueAggregate {
+  id String @id @default(uuid())
+
+  period   String // YYYY-MM (e.g. 2026-02)
+  provider BillingProvider
+
+  grossRevenue Int
+  refunds      Int
+  credits      Int
+  netRevenue   Int
+
+  currency String
+
+  updatedAt DateTime @updatedAt
+
+  @@unique([period, provider, currency])
+  @@index([period])
+}
+
+model WaitList {
+  id               String  @id @default(uuid())
+  email            String  @unique
+  name             String?
+  company          String?
+  role             String?
+  teamSize         String?
+  useCase          String?
+  consentToUpdates Boolean
+  referralCode     String? @unique
+  referredBy       String?
+
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+}
+
+model Job {
+  id      String    @id @default(uuid())
+  type    String
+  status  JobStatus @default(pending)
+  payload Json
+
+  /// Retry management
+  retries      Int     @default(0)
+  maxRetries   Int     @default(3)
+  lastError    String?
+  /// Track all errors for debugging
+  errorHistory Json?
+
+  /// Exponential backoff handling
+  nextRetryAt DateTime?
+  backoffMs   Int       @default(1000)
+
+  /// Priority for queue ordering
+  priority Int @default(0) // Higher = more urgent
+
+  /// Which queue this belongs to
+  queueName String @default("default")
+
+  /// Job locking (for distributed workers)
+  lockedBy    String? // Worker instance ID
+  lockedAt    DateTime?
+  lockTimeout DateTime?
+
+  /// Progress tracking for long-running jobs
+  progress        Int? // 0-100 percentage
+  progressMessage String?
+
+  /// Timing
+  scheduledAt DateTime?
+  startedAt   DateTime?
+  finishedAt  DateTime?
+
+  /// Execution timeout
+  timeoutMs Int?
+
+  /// Dead letter handling
+  movedToDlq Boolean @default(false)
+  dlqReason  String?
+
+  /// Idempotency check
+  idempotencyKey String? @unique
+
+  /// Links to domain models
+  userId        String?
+  workflowRunId String?
+
+  metadata Json?
+
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+
+  workflowRun WorkflowRun?
+
+  @@index([status, scheduledAt])
+  @@index([status, priority])
+  @@index([queueName, status])
+  @@index([lockedBy, status])
+  @@index([type, status])
+  @@index([userId])
+  @@index([movedToDlq])
+}
+
+model Onboarding {
+  id        String  @id @default(uuid())
+  userId    String  @unique
+  persona   String?
+  setupType String?
+  progress  Json?
+  completed Boolean @default(false)
+
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+
+  user User @relation(fields: [userId], references: [id], onDelete: Cascade)
+}
+
+/////////////////////
+// Unique Visitors
+//////////////////////
+model Visitor {
+  id         String   @id @default(uuid())
+  visitorId  String   @unique // cookie or fingerprint ID
+  ipAddress  String?
+  userAgent  String?
+  country    String? // optional if you plan to use GeoIP later
+  referrer   String?
+  firstVisit DateTime @default(now())
+  lastVisit  DateTime @updatedAt
+  visitCount Int      @default(1)
+
+  createdAt     DateTime       @default(now())
+  updatedAt     DateTime       @updatedAt
+  postReactions PostReaction[]
+  postShares    PostShare[]
+
+  @@index([createdAt])
+}
+
+model EmailCampaign {
+  id            String   @id @default(uuid())
+  name          String
+  templateId    String
+  subject       String
+  audience      String // e.g. "waitlist", "users", "custom"
+  segmentFilter Json? // optional query/filter metadata
+  sentCount     Int      @default(0)
+  status        String   @default("draft") // draft | sending | sent | failed
+  metadata      Json?
+  createdById   String?
+  createdAt     DateTime @default(now())
+  updatedAt     DateTime @updatedAt
+
+  logs EmailSendLog[]
+}
+
+model EmailSendLog {
+  id          String    @id @default(uuid())
+  campaignId  String
+  recipient   String
+  status      String
+  messageId   String?
+  error       String?
+  metadata    Json?
+  sentAt      DateTime  @default(now())
+  openCount   Int       @default(0)
+  clickCount  Int       @default(0)
+  lastEventAt DateTime?
+
+  campaign EmailCampaign @relation(fields: [campaignId], references: [id])
+}
+
+model Post {
+  id      String   @id @default(uuid())
+  title   String
+  slug    String   @unique
+  excerpt String?
+  type    PostType @default(BLOG)
+  status  Status   @default(draft)
+
+  content     Json
+  contentHtml String?
+
+  featuredImage String?
+
+  // many-to-many pivot
+  tags PostTag[] @relation("PostTags")
+
+  authorId String?
+  author   User?   @relation(fields: [authorId], references: [id])
+
+  publishedAt   DateTime?
+  createdAt     DateTime       @default(now())
+  updatedAt     DateTime       @updatedAt
+  postComments  PostComment[]
+  postReactions PostReaction[]
+  postShares    PostShare[]
+
+  @@index([type])
+  @@index([status])
+  @@index([publishedAt])
+}
+
+model Tag {
+  id    String    @id @default(uuid())
+  name  String    @unique
+  color String    @default("blue")
+  // inverse many-to-many pivot
+  posts PostTag[] @relation("PostTags")
+}
+
+model PostTag {
+  postId String
+  tagId  String
+
+  // Add relation names
+  post Post @relation("PostTags", fields: [postId], references: [id], onDelete: Cascade)
+  tag  Tag  @relation("PostTags", fields: [tagId], references: [id], onDelete: Cascade)
+
+  @@id([postId, tagId])
+  @@index([tagId])
+}
+
+/// ─────────────────────────────────────────────
+/// COMMENT IDENTITIES (Name + Email Login-less System)
+/// ─────────────────────────────────────────────
+
+model CommentIdentity {
+  id       String  @id @default(uuid())
+  name     String
+  email    String  @unique
+  verified Boolean @default(false)
+  metadata Json?
+
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+
+  comments      PostComment[]
+  postReactions PostReaction[]
+  postShares    PostShare[]
+
+  @@index([email])
+}
+
+/// ─────────────────────────────────────────────
+/// POST COMMENTS (Revised to use CommentIdentity)
+/// ─────────────────────────────────────────────
+
+model PostComment {
+  id         String  @id @default(uuid())
+  postId     String
+  identityId String? // Instead of userId (for public commenters)
+  parentId   String? // Threaded comments
+
+  content   String
+  status    Status    @default(active)
+  deletedAt DateTime?
+
+  // Relations
+  post     Post             @relation(fields: [postId], references: [id], onDelete: Cascade)
+  identity CommentIdentity? @relation(fields: [identityId], references: [id])
+  parent   PostComment?     @relation("CommentReplies", fields: [parentId], references: [id])
+  replies  PostComment[]    @relation("CommentReplies")
+
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+
+  @@index([postId])
+  @@index([identityId])
+  @@index([parentId])
+  @@index([status])
+}
+
+/// ─────────────────────────────────────────────
+/// POST REACTIONS (LIKE, LOVE, CLAP, FIRE, WOW)
+/// ─────────────────────────────────────────────
+
+model PostReaction {
+  id         String       @id @default(uuid())
+  postId     String
+  visitorId  String? // Could be Visitor.visitorId
+  identityId String? // If commenter also reacts
+  type       ReactionType
+
+  status    Status    @default(active)
+  deletedAt DateTime?
+
+  post     Post             @relation(fields: [postId], references: [id], onDelete: Cascade)
+  visitor  Visitor?         @relation(fields: [visitorId], references: [visitorId])
+  identity CommentIdentity? @relation(fields: [identityId], references: [id])
+
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+
+  @@unique([postId, visitorId, type])
+  @@unique([postId, identityId, type])
+  @@index([postId])
+  @@index([visitorId])
+  @@index([identityId])
+  @@index([type])
+}
+
+/// ─────────────────────────────────────────────
+/// POST SHARES (Analytics + Share Platform Info)
+/// ─────────────────────────────────────────────
+
+model PostShare {
+  id         String  @id @default(uuid())
+  postId     String
+  visitorId  String?
+  identityId String?
+  platform   String? // twitter | whatsapp | copy | linkedin | etc.
+  metadata   Json?
+
+  post     Post             @relation(fields: [postId], references: [id], onDelete: Cascade)
+  visitor  Visitor?         @relation(fields: [visitorId], references: [visitorId])
+  identity CommentIdentity? @relation(fields: [identityId], references: [id])
+
+  createdAt DateTime @default(now())
+
+  @@index([postId])
+  @@index([visitorId])
+  @@index([identityId])
+  @@index([platform])
+}
+
+//// _________________________________________________________________
+//// CREDITS PURCHASES & REFUNDS
+//// _________________________________________________________________
+
+model CreditPurchase {
+  id String @id @default(uuid())
+
+  userId            String
+  billingCustomerId String?
+
+  provider          BillingProvider
+  providerOrderId   String          @unique // Razorpay order_xxx
+  providerPaymentId String? // Razorpay pay_xxx
+
+  creditAmount Int // Number of credits purchased
+  pricePaid    Int // Amount in paise/cents
+  currency     String @default("INR")
+
+  status CreditPurchaseStatus @default(pending)
+
+  couponId       String?
+  discountAmount Int?
+
+  metadata Json?
+
+  paidAt     DateTime?
+  refundedAt DateTime?
+
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+
+  user            User             @relation(fields: [userId], references: [id])
+  billingCustomer BillingCustomer? @relation(fields: [billingCustomerId], references: [id])
+  coupon          Coupon?          @relation(fields: [couponId], references: [id])
+
+  @@index([userId])
+  @@index([provider, providerOrderId])
+  @@index([status])
+}
+
+model Refund {
+  id String @id @default(uuid())
+
+  userId            String
+  billingCustomerId String?
+
+  provider          BillingProvider
+  providerRefundId  String          @unique // Razorpay rfnd_xxx
+  providerPaymentId String // Original payment
+
+  amount   Int
+  currency String
+
+  reason String?
+  status String  @default("pending") // pending | processed | failed
+
+  // Link to original purchase
+  invoiceId        String?
+  creditPurchaseId String?
+
+  metadata Json?
+
+  processedAt DateTime?
+  createdAt   DateTime  @default(now())
+
+  user            User             @relation(fields: [userId], references: [id])
+  billingCustomer BillingCustomer? @relation(fields: [billingCustomerId], references: [id])
+
+  @@index([userId])
+  @@index([provider, providerRefundId])
+}
+
+/// ─────────────────────────────────────────────────────────────
+/// TOOL REGISTRY (FUNCTION CALLING)
+/// ─────────────────────────────────────────────────────────────
+
+/// Dynamic tool registry
+/// Defines what tools/functions AI can call
+/// Each tool has OpenAI-style function schema
+model Tool {
+  id String @id @default(uuid())
+
+  /// Unique identifier: "email.send", "calendar.create", etc.
+  name String @unique
+
+  /// Human-readable name: "Send Email", "Create Event"
+  displayName String
+
+  /// Description for AI understanding
+  description String?
+
+  /// Categorization
+  category String // email, calendar, files, messaging, etc.
+  provider String? // google, slack, notion, internal, etc.
+
+  /// JSON Schema for function parameters
+  /// Compatible with OpenAI function_calling
+  schema Json
+
+  /// Which integration this tool requires
+  requiredIntegration String?
+
+  /// OAuth scopes needed
+  requiredScopes String[] @default([])
+
+  /// Where to call this tool
+  /// e.g., "/api/integrations/google/gmail/send"
+  endpoint String?
+
+  /// Whether execution is async
+  isAsync Boolean @default(false)
+
+  /// Max execution time in ms
+  timeoutMs Int @default(30000)
+
+  /// Whether AI should ask for confirmation before executing
+  requiresConfirmation Boolean @default(false)
+
+  /// Danger level: 0=safe, 1=moderate, 2=dangerous
+  /// Used for safety checks and warnings
+  dangerLevel Int @default(0)
+
+  status ToolStatus @default(active)
+
+  /// Semantic versioning for tool changes
+  version String @default("1.0.0")
+
+  metadata Json?
+
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+
+  /// Execution history
+  executions ToolExecution[]
+
+  @@index([category])
+  @@index([provider])
+  @@index([status])
+}
+
+/// Audit trail of tool executions
+/// Track when tools are called, success/failure, duration
+model ToolExecution {
+  id String @id @default(uuid())
+
+  toolId String
+  userId String
+
+  /// Context where tool was called
+  chatSessionId String?
+  workflowRunId String?
+
+  /// What was passed to the tool
+  input Json
+
+  /// What tool returned
+  output Json?
+
+  /// Error message if failed
+  error String?
+
+  /// Did execution succeed
+  success Boolean
+
+  /// How long it took
+  durationMs Int?
+
+  /// Tokens used (for LLM calls)
+  tokensUsed Int?
+
+  createdAt DateTime @default(now())
+
+  tool Tool @relation(fields: [toolId], references: [id])
+
+  @@index([toolId, createdAt])
+  @@index([userId, createdAt])
+  @@index([success])
+}
+
+/// ─────────────────────────────────────────────────────────────
+/// DEAD LETTER QUEUE (FAILED JOB TRACKING)
+/// ─────────────────────────────────────────────────────────────
+
+/// Failed jobs that exhausted all retries
+/// Kept for manual review and potential replay
+model DeadLetterJob {
+  id String @id @default(uuid())
+
+  /// Reference to original job ID
+  originalJobId String
+
+  /// Job type (workflow, ingestion, etc.)
+  type String
+
+  /// Original payload
+  payload Json
+
+  /// Why it ended up in DLQ
+  failureReason String
+
+  /// History of errors from all retry attempts
+  errorHistory Json?
+
+  /// How many times it was retried
+  retryCount Int
+
+  /// Manual review tracking
+  reviewed   Boolean   @default(false)
+  reviewedBy String?
+  reviewedAt DateTime?
+
+  /// When/if this job was replayed
+  replayedAt DateTime?
+
+  metadata Json?
+
+  /// When the original job was created
+  originalCreatedAt DateTime
+
+  /// When it was moved to DLQ
+  createdAt DateTime @default(now())
+
+  @@index([type])
+  @@index([reviewed])
+  @@index([createdAt])
+}