@goscribe/server 1.2.0 → 1.3.1

package/prisma/schema.prisma

@@ -5,11 +5,11 @@ generator client {
 datasource db {
   provider  = "postgresql"
   url       = env("DATABASE_URL")
-  directUrl = env("DIRECT_URL") // for shadow db in migrations
+  directUrl = env("DIRECT_URL")
 }
 
 //
-// Enums
+// Enums (match prisma1/migrations enum DDL)
 //
 enum ArtifactType {
   STUDY_GUIDE
@@ -17,6 +17,7 @@ enum ArtifactType {
   WORKSHEET
   MEETING_SUMMARY
   PODCAST_EPISODE
+  STORAGE
 }
 
 enum Difficulty {
@@ -34,60 +35,132 @@ enum QuestionType {
   FILL_IN_THE_BLANK
 }
 
+enum CopilotMessageRole {
+  USER
+  ASSISTANT
+}
+
+enum NotificationPriority {
+  LOW
+  NORMAL
+  HIGH
+}
+
+enum InvoiceType {
+  SUBSCRIPTION
+  TOPUP
+}
+
+enum ActivityLogCategory {
+  AUTH
+  WORKSPACE
+  BILLING
+  ADMIN
+  CONTENT
+  SYSTEM
+}
+
+enum ActivityLogStatus {
+  SUCCESS
+  FAILURE
+}
+
 //
 // NextAuth-compatible auth models (minimal)
 //
 model User {
-  id             String     @id @default(cuid())
-  name           String?
-  email          String?    @unique
-  emailVerified  DateTime?
-  passwordHash   String? // for credentials login
-  profilePicture FileAsset? @relation(fields: [fileAssetId], references: [id])
-  session        Session[]
-
-  // Ownership
-  folders              Folder[]          @relation("UserFolders")
-  workspaces           Workspace[]       @relation("UserWorkspaces")
-  invitedInWorkspaces  Workspace[]       @relation("WorkspaceSharedWith") // many-to-many (deprecated)
-  workspaceMemberships WorkspaceMember[] // proper member management
-  uploads              FileAsset[]       @relation("UserUploads")
-  artifacts            Artifact[]        @relation("UserArtifacts")
-  versions             ArtifactVersion[] @relation("UserArtifactVersions")
-
-  // Progress tracking
+  id                        String                      @id @default(cuid())
+  name                      String?
+  email                     String?                     @unique
+  emailVerified             DateTime?
+  passwordHash              String?
+  createdAt                 DateTime                    @default(now())
+  updatedAt                 DateTime                    @updatedAt
+  fileAssetId               String?
+  roleId                    String?
+  deletedAt                 DateTime?
+  stripe_customer_id        String?                     @unique
+  artifacts                 Artifact[]                  @relation("UserArtifacts")
+  versions                  ArtifactVersion[]           @relation("UserArtifactVersions")
+  chats                     Chat[]
+  uploads                   FileAsset[]                 @relation("UserUploads")
   flashcardProgress         FlashcardProgress[]         @relation("UserFlashcardProgress")
+  folders                   Folder[]                    @relation("UserFolders")
+  workspaces                Workspace[]                 @relation("UserWorkspaces")
+  workspaceMemberships      WorkspaceMember[]
+  invitedInWorkspaces       Workspace[]                 @relation("WorkspaceSharedWith")
+  notifications             Notification[]
+  actorNotifications        Notification[]              @relation("NotificationActor")
+  session                   Session[]
+  studyGuideComments        StudyGuideComment[]         @relation("UserStudyGuideComments")
+  highlights                StudyGuideHighlight[]       @relation("UserHighlights")
+  profilePicture            FileAsset?                  @relation(fields: [fileAssetId], references: [id])
+  role                      Role?                       @relation(fields: [roleId], references: [id])
   worksheetQuestionProgress WorksheetQuestionProgress[]
+  worksheetPresets          WorksheetPreset[]
+  copilotConversations      CopilotConversation[]
+  sentInvitations           WorkspaceInvitation[]       @relation("UserInvitations")
+  subscriptions             Subscription[]
+  invoices                  Invoice[]
+  credits                   UserCredit[]
+  idempotencyRecords        IdempotencyRecord[]
+  activityLogs              ActivityLog[]               @relation("ActivityLogActor")
+  passwordResetTokens       PasswordResetToken[]
+}
 
-  // Invitations
-  sentInvitations WorkspaceInvitation[] @relation("UserInvitations")
+/// One-time tokens for forgot-password flow (token stored as SHA-256 hash of the secret from the email link).
+model PasswordResetToken {
+  id        String    @id @default(cuid())
+  userId    String
+  tokenHash String    @unique
+  expiresAt DateTime
+  usedAt    DateTime?
+  createdAt DateTime  @default(now())
+  user      User      @relation(fields: [userId], references: [id], onDelete: Cascade)
 
-  // Study guide annotations
-  highlights        StudyGuideHighlight[] @relation("UserHighlights")
-  studyGuideComments StudyGuideComment[]  @relation("UserStudyGuideComments")
+  @@index([userId])
+}
 
-  notifications Notification[]
-  chats         Chat[]
-  createdAt     DateTime       @default(now())
-  updatedAt     DateTime       @updatedAt
-  fileAssetId   String?
+model Role {
+  id    String @id @default(cuid())
+  name  String @unique
+  users User[]
 }
 
 model Notification {
-  id        String   @id @default(cuid())
-  userId    String
-  user      User     @relation(fields: [userId], references: [id], onDelete: Cascade)
-  content   String
-  read      Boolean  @default(false)
-  createdAt DateTime @default(now())
-  updatedAt DateTime @updatedAt
+  id          String                 @id @default(cuid())
+  userId      String
+  actorUserId String?
+  workspaceId String?
+  type        String
+  title       String
+  body        String
+  content     String?
+  actionUrl   String?
+  metadata    Json?
+  priority    NotificationPriority   @default(NORMAL)
+  sourceId    String?
+  read        Boolean                @default(false)
+  readAt      DateTime?
+  deliveredAt DateTime?
+  createdAt   DateTime               @default(now())
+  updatedAt   DateTime               @updatedAt
+  user        User                   @relation(fields: [userId], references: [id], onDelete: Cascade)
+  actor       User?                  @relation("NotificationActor", fields: [actorUserId], references: [id], onDelete: SetNull)
+  workspace   Workspace?             @relation(fields: [workspaceId], references: [id], onDelete: SetNull)
+
+  @@index([userId, read, createdAt(sort: Desc)])
+  @@index([userId, createdAt(sort: Desc)])
+  @@index([type, createdAt(sort: Desc)])
+  @@index([workspaceId])
+  @@unique([userId, type, sourceId])
 }
 
 model Session {
   id      String   @id @default(cuid())
   userId  String
-  user    User     @relation(fields: [userId], references: [id], onDelete: Cascade)
   expires DateTime
+  user    User     @relation(fields: [userId], references: [id], onDelete: Cascade)
 }
 
 model VerificationToken {
@@ -98,66 +171,49 @@ model VerificationToken {
   @@unique([identifier, token])
 }
 
-//
-// Filesystem-like structure
-//
 model Folder {
-  id      String @id @default(cuid())
-  name    String
-  ownerId String
-  owner   User   @relation("UserFolders", fields: [ownerId], references: [id], onDelete: Cascade)
-
-  // Nested folders
-  parentId String?
-  parent   Folder?  @relation("FolderChildren", fields: [parentId], references: [id], onDelete: Cascade)
-  children Folder[] @relation("FolderChildren")
-  color    String   @default("#9D00FF")
-
-  // Files (workspaces) inside folders
-  workspaces Workspace[]
-
-  // Metadata
-  createdAt DateTime @default(now())
-  updatedAt DateTime @updatedAt
+  id          String      @id @default(cuid())
+  name        String
+  ownerId     String
+  parentId    String?
+  createdAt   DateTime    @default(now())
+  updatedAt   DateTime    @updatedAt
+  color       String      @default("#9D00FF")
+  markerColor String?
+  owner       User        @relation("UserFolders", fields: [ownerId], references: [id], onDelete: Cascade)
+  parent      Folder?     @relation("FolderChildren", fields: [parentId], references: [id], onDelete: Cascade)
+  children    Folder[]    @relation("FolderChildren")
+  workspaces  Workspace[]
 
-  // Helpful composite index: folders per owner + parent
   @@index([ownerId, parentId])
 }
 
 model Workspace {
-  id          String  @id @default(cuid())
-  title       String
-  description String? // optional notes/description for the "file"
-  ownerId     String
-  owner       User    @relation("UserWorkspaces", fields: [ownerId], references: [id], onDelete: Cascade)
-  icon        String  @default("📄")
-  color       String  @default("#9D00FF")
-
-  // A workspace (file) lives in a folder (nullable = root)
-  folderId String?
-  folder   Folder? @relation(fields: [folderId], references: [id], onDelete: SetNull)
-
-  channels Channel[]
-
-  sharedWith        User[]            @relation("WorkspaceSharedWith") // many-to-many for sharing (deprecated)
-  members           WorkspaceMember[] // proper member management with roles
-  fileBeingAnalyzed Boolean           @default(false)
-
-  analysisProgress Json?
-
-  needsAnalysis Boolean @default(false)
-
-  // Raw uploads attached to this workspace
-  uploads FileAsset[]
-
-  // AI outputs for this workspace (study guides, flashcards, etc.)
-  artifacts Artifact[]
-
-  // Invitations
-  invitations WorkspaceInvitation[]
-
-  createdAt DateTime @default(now())
-  updatedAt DateTime @updatedAt
+  id                   String                @id @default(cuid())
+  title                String
+  description          String?
+  ownerId              String
+  owner                User                  @relation("UserWorkspaces", fields: [ownerId], references: [id], onDelete: Cascade)
+  icon                 String                @default("📄")
+  color                String                @default("#9D00FF")
+  markerColor          String?
+  folderId             String?
+  folder               Folder?               @relation(fields: [folderId], references: [id], onDelete: SetNull)
+  channels             Channel[]
+  copilotConversations CopilotConversation[]
+  sharedWith           User[]                @relation("WorkspaceSharedWith")
+  members              WorkspaceMember[]
+  fileBeingAnalyzed    Boolean               @default(false)
+  analysisProgress     Json?
+  needsAnalysis        Boolean               @default(false)
+  uploads              FileAsset[]
+  artifacts            Artifact[]
+  worksheetPresets     WorksheetPreset[]
+  invitations          WorkspaceInvitation[]
+  notifications        Notification[]
+  activityLogs         ActivityLog[]
+  createdAt            DateTime              @default(now())
+  updatedAt            DateTime              @updatedAt
 
   @@index([ownerId, folderId])
 }
@@ -165,144 +221,132 @@ model Workspace {
 model Channel {
   id          String    @id @default(cuid())
   workspaceId String
+  name        String
+  createdAt   DateTime  @default(now())
   workspace   Workspace @relation(fields: [workspaceId], references: [id], onDelete: Cascade)
-
-  name String
-
-  createdAt DateTime @default(now())
-  chats     Chat[]
+  chats       Chat[]
 
   @@index([workspaceId])
 }
 
 model Chat {
-  id        String  @id @default(cuid())
+  id        String   @id @default(cuid())
   channelId String
-  channel   Channel @relation(fields: [channelId], references: [id], onDelete: Cascade)
-
-  user    User?   @relation(fields: [userId], references: [id], onDelete: SetNull)
-  userId  String?
-  message String // chat message content
-
+  userId    String?
+  message   String
   updatedAt DateTime @updatedAt
   createdAt DateTime @default(now())
+  channel   Channel  @relation(fields: [channelId], references: [id], onDelete: Cascade)
+  user      User?    @relation(fields: [userId], references: [id])
 
   @@index([channelId, createdAt])
 }
 
+model CopilotConversation {
+  id          String    @id @default(cuid())
+  workspaceId String
+  workspace   Workspace @relation(fields: [workspaceId], references: [id], onDelete: Cascade)
+  userId      String
+  user        User      @relation(fields: [userId], references: [id], onDelete: Cascade)
+  title       String    @default("New Chat")
+  messages    CopilotMessage[]
+  createdAt   DateTime  @default(now())
+  updatedAt   DateTime  @updatedAt
+
+  @@index([workspaceId, userId, updatedAt])
+}
+
+model CopilotMessage {
+  id             String              @id @default(cuid())
+  conversationId String
+  conversation   CopilotConversation @relation(fields: [conversationId], references: [id], onDelete: Cascade)
+  role           CopilotMessageRole
+  content        String
+  createdAt      DateTime            @default(now())
+
+  @@index([conversationId, createdAt])
+}
+
 //
 // User uploads (source materials for AI)
 //
 model FileAsset {
-  id          String    @id @default(cuid())
-  workspaceId String?
-  workspace   Workspace? @relation(fields: [workspaceId], references: [id], onDelete: Cascade)
-
-  userId String?
-  user   User?   @relation("UserUploads", fields: [userId], references: [id], onDelete: Cascade)
-
+  id              String     @id @default(cuid())
+  workspaceId     String?
+  userId          String?
   name            String
   mimeType        String
   size            Int
   bucket          String?
   objectKey       String?
-  url             String? // optional if serving via signed GET per-view
-  checksum        String? // optional server-side integrity
-  aiTranscription Json?   @default("{}")
-
-  meta Json? // arbitrary metadata
-
-  createdAt DateTime @default(now())
-  User      User[]
+  url             String?
+  checksum        String?
+  meta            Json?
+  createdAt       DateTime   @default(now())
+  aiTranscription Json?      @default("{}")
+  user            User?      @relation("UserUploads", fields: [userId], references: [id], onDelete: Cascade)
+  workspace       Workspace? @relation(fields: [workspaceId], references: [id], onDelete: Cascade)
+  User            User[]
 
   @@index([workspaceId])
   @@index([userId, createdAt])
 }
 
-//
-// AI Outputs (Artifacts) with Versioning
-// - One Artifact per output stream (e.g., one Study Guide, with many versions)
-// - Some artifact types (flashcards, worksheet) have child rows
-//
 model Artifact {
-  id          String    @id @default(cuid())
-  workspaceId String
-  workspace   Workspace @relation(fields: [workspaceId], references: [id], onDelete: Cascade)
-
-  type       ArtifactType
-  title      String
-  isArchived Boolean      @default(false)
-
-  generating         Boolean @default(false)
+  id                 String              @id @default(cuid())
+  workspaceId        String
+  type               ArtifactType
+  title              String
+  isArchived         Boolean             @default(false)
+  difficulty         Difficulty?
+  estimatedTime      String?
+  createdById        String?
+  createdAt          DateTime            @default(now())
+  updatedAt          DateTime            @updatedAt
+  description        String?
+  generating         Boolean             @default(false)
   generatingMetadata Json?
-
-  // Worksheet-specific fields
-  difficulty    Difficulty? // only meaningful for WORKSHEET
-  estimatedTime String? // only meaningful for WORKSHEET
-
-  imageObjectKey String?
-  description    String?
-
-  createdById String?
-  createdBy   User?   @relation("UserArtifacts", fields: [createdById], references: [id], onDelete: SetNull)
-
-  versions        ArtifactVersion[] // text/transcript versions etc.
-  flashcards      Flashcard[] // only meaningful for FLASHCARD_SET
-  questions       WorksheetQuestion[] // only meaningful for WORKSHEET
-  podcastSegments PodcastSegment[] // only meaningful for PODCAST_EPISODE
-
-  createdAt DateTime @default(now())
-  updatedAt DateTime @updatedAt
+  worksheetConfig    Json?
+  imageObjectKey     String?
+  createdBy          User?               @relation("UserArtifacts", fields: [createdById], references: [id])
+  workspace          Workspace           @relation(fields: [workspaceId], references: [id], onDelete: Cascade)
+  versions           ArtifactVersion[]
+  flashcards         Flashcard[]
+  podcastSegments    PodcastSegment[]
+  questions          WorksheetQuestion[]
 
   @@index([workspaceId, type])
 }
 
 model ArtifactVersion {
-  id         String   @id @default(cuid())
-  artifactId String
-  artifact   Artifact @relation(fields: [artifactId], references: [id], onDelete: Cascade)
-
-  // Plain text content (e.g., Study Guide body, Meeting Summary text, Podcast transcript)
-  content String // rich text serialized as markdown/HTML stored as TEXT
-
-  // For Podcast episodes or other media, store URLs / durations / etc. in data
-  data Json? // e.g., { "audioUrl": "...", "durationSec": 312, "voice": "..." }
-
-  // Version sequencing (auto-increment per artifact)
-  version Int
-
+  id          String                @id @default(cuid())
+  artifactId  String
+  content     String
+  data        Json?
+  version     Int
   createdById String?
-  createdBy   User?   @relation("UserArtifactVersions", fields: [createdById], references: [id], onDelete: SetNull)
-
-  // Highlights on this version
-  highlights StudyGuideHighlight[]
-
-  createdAt DateTime @default(now())
+  createdAt   DateTime              @default(now())
+  artifact    Artifact              @relation(fields: [artifactId], references: [id], onDelete: Cascade)
+  createdBy   User?                 @relation("UserArtifactVersions", fields: [createdById], references: [id])
+  highlights  StudyGuideHighlight[]
 
-  @@unique([artifactId, version]) // each artifact has 1,2,3...
+  @@unique([artifactId, version])
   @@index([artifactId])
 }
 
-//
-// Study Guide Highlights and Comments
-//
 model StudyGuideHighlight {
-  id                String          @id @default(cuid())
+  id                String              @id @default(cuid())
   artifactVersionId String
-  artifactVersion   ArtifactVersion @relation(fields: [artifactVersionId], references: [id], onDelete: Cascade)
-
-  userId String
-  user   User   @relation("UserHighlights", fields: [userId], references: [id], onDelete: Cascade)
-
-  startOffset  Int // character offset in the content
-  endOffset    Int
-  selectedText String // the highlighted text (preserved even if content changes)
-  color        String @default("#FBBF24") // highlight color
-
-  comments StudyGuideComment[]
-
-  createdAt DateTime @default(now())
-  updatedAt DateTime @updatedAt
+  userId            String
+  startOffset       Int
+  endOffset         Int
+  selectedText      String
+  color             String              @default("#FBBF24")
+  createdAt         DateTime            @default(now())
+  updatedAt         DateTime            @updatedAt
+  comments          StudyGuideComment[]
+  artifactVersion   ArtifactVersion     @relation(fields: [artifactVersionId], references: [id], onDelete: Cascade)
+  user              User                @relation("UserHighlights", fields: [userId], references: [id], onDelete: Cascade)
 
   @@index([artifactVersionId, userId])
 }
@@ -310,199 +354,302 @@ model StudyGuideHighlight {
 model StudyGuideComment {
   id          String              @id @default(cuid())
   highlightId String
+  userId      String
+  content     String
+  createdAt   DateTime            @default(now())
+  updatedAt   DateTime            @updatedAt
   highlight   StudyGuideHighlight @relation(fields: [highlightId], references: [id], onDelete: Cascade)
-
-  userId  String
-  user    User   @relation("UserStudyGuideComments", fields: [userId], references: [id], onDelete: Cascade)
-  content String
-
-  createdAt DateTime @default(now())
-  updatedAt DateTime @updatedAt
+  user        User                @relation("UserStudyGuideComments", fields: [userId], references: [id], onDelete: Cascade)
 
   @@index([highlightId])
 }
 
-//
-// Flashcards (child items of a FLASHCARD_SET Artifact)
-//
 model Flashcard {
-  id         String   @id @default(cuid())
-  artifactId String
-  artifact   Artifact @relation(fields: [artifactId], references: [id], onDelete: Cascade)
-
-  front String // question/term
-  back  String // answer/definition
-  tags  String[] // optional keywords
-  order Int      @default(0)
-
-  // User progress tracking
-  progress FlashcardProgress[]
-
-  createdAt DateTime @default(now())
+  id              String              @id @default(cuid())
+  artifactId      String
+  front           String
+  back            String
+  tags            String[]
+  order           Int                 @default(0)
+  createdAt       DateTime            @default(now())
+  acceptedAnswers String[]            @default([])
+  artifact        Artifact            @relation(fields: [artifactId], references: [id], onDelete: Cascade)
+  progress        FlashcardProgress[]
 
   @@index([artifactId])
 }
 
-//
-// User Progress on Flashcards (spaced repetition, mastery tracking)
-//
 model FlashcardProgress {
-  id     String @id @default(cuid())
-  userId String
-  user   User   @relation("UserFlashcardProgress", fields: [userId], references: [id], onDelete: Cascade)
-
-  flashcardId String
-  flashcard   Flashcard @relation(fields: [flashcardId], references: [id], onDelete: Cascade)
-
-  // Study statistics
-  timesStudied              Int @default(0)
-  timesCorrect              Int @default(0)
-  timesIncorrect            Int @default(0)
-  timesIncorrectConsecutive Int @default(0) // Track consecutive failures
-
-  // Spaced repetition data
-  easeFactor  Float @default(2.5) // SM-2 algorithm ease factor
-  interval    Int   @default(0) // Days until next review
-  repetitions Int   @default(0) // Consecutive correct answers
-
-  // Mastery level (0-100)
-  masteryLevel Int @default(0)
-
-  // Timestamps
-  lastStudiedAt DateTime?
-  nextReviewAt  DateTime?
-
-  createdAt DateTime @default(now())
-  updatedAt DateTime @updatedAt
+  id                        String    @id @default(cuid())
+  userId                    String
+  flashcardId               String
+  timesStudied              Int       @default(0)
+  timesCorrect              Int       @default(0)
+  timesIncorrect            Int       @default(0)
+  timesIncorrectConsecutive Int       @default(0)
+  easeFactor                Float     @default(2.5)
+  interval                  Int       @default(0)
+  repetitions               Int       @default(0)
+  masteryLevel              Int       @default(0)
+  lastStudiedAt             DateTime?
+  nextReviewAt              DateTime?
+  createdAt                 DateTime  @default(now())
+  updatedAt                 DateTime  @updatedAt
+  flashcard                 Flashcard @relation(fields: [flashcardId], references: [id], onDelete: Cascade)
+  user                      User      @relation("UserFlashcardProgress", fields: [userId], references: [id], onDelete: Cascade)
 
   @@unique([userId, flashcardId])
   @@index([userId, nextReviewAt])
   @@index([flashcardId])
 }
 
-//
-// Worksheet Questions (child items of a WORKSHEET Artifact)
-//
 model WorksheetQuestion {
-  id         String   @id @default(cuid())
+  id         String                      @id @default(cuid())
   artifactId String
-  artifact   Artifact @relation(fields: [artifactId], references: [id], onDelete: Cascade)
-
   prompt     String
   answer     String?
-  type       QuestionType @default(TEXT)
-  difficulty Difficulty   @default(MEDIUM)
-  order      Int          @default(0)
-
-  meta Json? // e.g., { "choices": ["A","B","C","D"], "correct": 1, "options": [...] }
-
-  createdAt DateTime                    @default(now())
-  progress  WorksheetQuestionProgress[]
+  type       QuestionType                @default(TEXT)
+  difficulty Difficulty                  @default(MEDIUM)
+  order      Int                         @default(0)
+  meta       Json?
+  createdAt  DateTime                    @default(now())
+  artifact   Artifact                    @relation(fields: [artifactId], references: [id], onDelete: Cascade)
+  progress   WorksheetQuestionProgress[]
 
   @@index([artifactId])
 }
 
-//
-// Per-user progress for Worksheet Questions
-//
 model WorksheetQuestionProgress {
   id                  String            @id @default(cuid())
   worksheetQuestionId String
+  userId              String
+  userAnswer          String?
+  completedAt         DateTime?
+  attempts            Int               @default(0)
+  timeSpentSec        Int?
+  meta                Json?
+  createdAt           DateTime          @default(now())
+  updatedAt           DateTime          @updatedAt
+  correct             Boolean?          @default(false)
+  modified            Boolean           @default(false)
+  user                User              @relation(fields: [userId], references: [id], onDelete: Cascade)
   worksheetQuestion   WorksheetQuestion @relation(fields: [worksheetQuestionId], references: [id], onDelete: Cascade)
 
-  userId String
-  user   User   @relation(fields: [userId], references: [id], onDelete: Cascade)
-
-  modified     Boolean   @default(false)
-  userAnswer   String?
-  correct      Boolean?  @default(false)
-  completedAt  DateTime?
-  attempts     Int       @default(0)
-  timeSpentSec Int?
-  meta         Json?
-
-  createdAt DateTime @default(now())
-  updatedAt DateTime @updatedAt
-
   @@unique([worksheetQuestionId, userId])
   @@index([userId])
 }
 
-//
-// Workspace Members (with roles)
-//
+model WorksheetPreset {
+  id          String    @id @default(cuid())
+  userId      String?
+  workspaceId String?
+  name        String
+  isSystem    Boolean   @default(false)
+  config      Json
+  createdAt   DateTime  @default(now())
+  updatedAt   DateTime  @updatedAt
+  user        User?     @relation(fields: [userId], references: [id], onDelete: Cascade)
+  workspace   Workspace? @relation(fields: [workspaceId], references: [id], onDelete: Cascade)
+
+  @@index([userId, workspaceId])
+  @@index([isSystem])
+}
+
 model WorkspaceMember {
   id          String    @id @default(cuid())
   workspaceId String
+  userId      String
+  role        String    @default("member")
+  joinedAt    DateTime  @default(now())
+  updatedAt   DateTime  @updatedAt
+  user        User      @relation(fields: [userId], references: [id], onDelete: Cascade)
   workspace   Workspace @relation(fields: [workspaceId], references: [id], onDelete: Cascade)
 
-  userId String
-  user   User   @relation(fields: [userId], references: [id], onDelete: Cascade)
-
-  role String @default("member") // "owner", "admin", "member"
-
-  joinedAt  DateTime @default(now())
-  updatedAt DateTime @updatedAt
-
-  @@unique([workspaceId, userId]) // One membership per user per workspace
+  @@unique([workspaceId, userId])
   @@index([workspaceId])
   @@index([userId])
 }
 
-//
-// Workspace Invitations
-//
 model WorkspaceInvitation {
   id          String    @id @default(cuid())
   workspaceId String
+  email       String
+  role        String    @default("member")
+  token       String    @unique @default(cuid())
+  invitedById String
+  acceptedAt  DateTime?
+  expiresAt   DateTime  @default(dbgenerated("(now() + '7 days'::interval)"))
+  createdAt   DateTime  @default(now())
+  updatedAt   DateTime  @updatedAt
+  invitedBy   User      @relation("UserInvitations", fields: [invitedById], references: [id], onDelete: Cascade)
   workspace   Workspace @relation(fields: [workspaceId], references: [id], onDelete: Cascade)
 
-  email String
-  role  String @default("member") // "owner", "admin", "member"
-  token String @unique @default(cuid()) // UUID for invitation link
+  @@unique([workspaceId, email])
+  @@index([token])
+  @@index([workspaceId])
+}
 
-  invitedById String
-  invitedBy   User   @relation("UserInvitations", fields: [invitedById], references: [id], onDelete: Cascade)
+model PodcastSegment {
+  id                 String   @id @default(cuid())
+  artifactId         String
+  title              String
+  content            String
+  startTime          Int
+  duration           Int
+  order              Int
+  objectKey          String?
+  audioUrl           String?
+  keyPoints          String[]
+  meta               Json?
+  createdAt          DateTime @default(now())
+  updatedAt          DateTime @updatedAt
+  generating         Boolean  @default(false)
+  generatingMetadata Json?
+  artifact           Artifact @relation(fields: [artifactId], references: [id], onDelete: Cascade)
 
-  acceptedAt DateTime?
-  expiresAt  DateTime  @default(dbgenerated("NOW() + INTERVAL '7 days'"))
+  @@index([artifactId, order])
+  @@index([artifactId, startTime])
+}
 
-  createdAt DateTime @default(now())
-  updatedAt DateTime @updatedAt
+model Invoice {
+  id               String      @id @default(cuid())
+  userId           String
+  subscriptionId   String?
+  stripeInvoiceId  String      @unique
+  amountPaid       Int
+  status           String
+  invoicePdfUrl    String?
+  hostedInvoiceUrl String?
+  paidAt           DateTime?
+  type             InvoiceType @default(SUBSCRIPTION)
+  createdAt        DateTime    @default(now())
+  user             User        @relation(fields: [userId], references: [id], onDelete: Cascade)
+  subscription     Subscription? @relation(fields: [subscriptionId], references: [id])
 
-  @@unique([workspaceId, email]) // One invitation per email per workspace
-  @@index([token])
-  @@index([workspaceId])
+  @@index([userId])
 }
 
-//
-// Podcast Segments (child items of a PODCAST_EPISODE Artifact)
-//
-model PodcastSegment {
-  id         String   @id @default(cuid())
-  artifactId String
-  artifact   Artifact @relation(fields: [artifactId], references: [id], onDelete: Cascade)
+model Plan {
+  id            String         @id @default(cuid())
+  name          String
+  description   String?
+  type          String
+  price         Int
+  stripePriceId String
+  interval      String?
+  active        Boolean        @default(true)
+  createdAt     DateTime       @default(now())
+  limit         PlanLimit?
+  subscriptions Subscription[]
+}
+
+model PlanLimit {
+  id              String   @id @default(cuid())
+  planId          String   @unique
+  maxStorageBytes BigInt   @default(0)
+  maxWorksheets   Int      @default(0)
+  maxFlashcards   Int      @default(0)
+  maxPodcasts     Int      @default(0)
+  maxStudyGuides  Int      @default(0)
+  createdAt       DateTime @default(now())
+  updatedAt       DateTime @updatedAt
+  plan            Plan     @relation(fields: [planId], references: [id], onDelete: Cascade)
+}
+
+model Subscription {
+  id                   String    @id @default(cuid())
+  userId               String
+  planId               String
+  stripeSubscriptionId String    @unique
+  stripeCustomerId     String?
+  status               String
+  currentPeriodStart   DateTime
+  currentPeriodEnd     DateTime
+  cancelAt             DateTime?
+  canceledAt           DateTime?
+  createdAt            DateTime  @default(now())
+  user                 User      @relation(fields: [userId], references: [id], onDelete: Cascade)
+  plan                 Plan      @relation(fields: [planId], references: [id], onDelete: Cascade)
+  invoices             Invoice[]
 
-  title     String
-  content   String // Full text content of the segment
-  startTime Int // Start time in seconds
-  duration  Int // Duration in seconds
-  order     Int // Display order within the episode
+  @@index([userId])
+  @@index([planId])
+}
 
-  // Audio file reference
-  objectKey String? // Google Cloud Storage object key
-  audioUrl  String? // Cached signed URL (temporary)
+model ResourcePrice {
+  id           String       @id @default(cuid())
+  resourceType ArtifactType @unique
+  priceCents   Int
+  updatedAt    DateTime     @updatedAt
+}
 
-  // Metadata
-  keyPoints String[] // Array of key points
-  meta      Json? // Additional metadata (voice settings, etc.)
+model UserCredit {
+  id              String       @id @default(cuid())
+  userId          String
+  resourceType    ArtifactType
+  amount          Int          @default(1)
+  stripeSessionId String       @unique
+  createdAt       DateTime     @default(now())
+  user            User         @relation(fields: [userId], references: [id], onDelete: Cascade)
 
-  generating         Boolean @default(false)
-  generatingMetadata Json? // Additional metadata (voice settings, etc.)
+  @@index([userId])
+}
 
-  createdAt DateTime @default(now())
-  updatedAt DateTime @updatedAt
+model IdempotencyRecord {
+  id               String   @id @default(cuid())
+  userId           String
+  planId           String?               // The plan being purchased
+  resourceType     ArtifactType?         // The resource for top-ups
+  stripeSessionId  String?               // The Stripe Checkout Session ID
+  status           String   @default("pending") // pending, completed, failed, expired
+  activeLockKey    String?  @unique      // Unique lock: "user_id_plan_id" (Nullified when done)
+  
+  createdAt        DateTime @default(now())
+  updatedAt        DateTime @updatedAt
+  user             User     @relation(fields: [userId], references: [id], onDelete: Cascade)
+
+  @@index([userId, status])
+  @@index([activeLockKey])
+}
 
-  @@index([artifactId, order]) // For efficient ordering
-  @@index([artifactId, startTime]) // For time-based queries
+model StripeEvent {
+  id               String   @id @default(cuid())
+  stripeEventId    String   @unique      // Stripe event ID (e.g. evt_...)
+  type             String                // Event type (e.g. checkout.session.completed)
+  status           String   @default("pending") // pending, processed, failed
+  error            String?               // Error message if processing fails
+  processedAt      DateTime?
+  createdAt        DateTime @default(now())
+  updatedAt        DateTime @updatedAt
+
+  @@index([stripeEventId])
 }
+
+/// Append-only system / user activity (tRPC and explicit events). Retention via admin or scheduled job.
+model ActivityLog {
+  id                 String               @id @default(cuid())
+  createdAt          DateTime             @default(now())
+  actorUserId        String?
+  actor              User?                @relation("ActivityLogActor", fields: [actorUserId], references: [id], onDelete: SetNull)
+  actorEmailSnapshot String?
+  action             String
+  category           ActivityLogCategory
+  resourceType       String?
+  resourceId         String?
+  workspaceId        String?
+  workspace          Workspace?           @relation(fields: [workspaceId], references: [id], onDelete: SetNull)
+  trpcPath           String?
+  httpMethod         String?
+  status             ActivityLogStatus
+  errorCode          String?
+  durationMs         Int
+  ipAddress          String?
+  userAgent          String?
+  metadata           Json?
+
+  @@index([createdAt(sort: Desc)])
+  @@index([actorUserId, createdAt(sort: Desc)])
+  @@index([workspaceId, createdAt(sort: Desc)])
+  @@index([category, createdAt(sort: Desc)])
+}
+