npm - @varaos/db - Versions diffs - 1.3.5 → 1.4.0 - Mend

@varaos/db 1.3.5 → 1.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (4) hide show

package/prisma/schema.prisma CHANGED Viewed

@@ -1,1394 +1,1980 @@
-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 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            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?
+  /// 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])
+}