Db Schema

DB Schema Skill

Canonical Prisma schema

// prisma/schema.prisma

generator client {
  provider = "prisma-client-js"
}

datasource db {
  provider = "postgresql"
  url      = env("DATABASE_URL")
}

// ─── Auth.js required tables ────────────────────────────────
model User {
  id            String    @id @default(cuid())
  name          String?
  email         String    @unique
  emailVerified DateTime?
  image         String?
  createdAt     DateTime  @default(now())

  accounts      Account[]
  sessions      Session[]
  listItems     ListItem[]
  interactions  InteractionEvent[]
}

model Account {
  id                String  @id @default(cuid())
  userId            String
  type              String
  provider          String
  providerAccountId String
  refresh_token     String?
  access_token      String?
  expires_at        Int?
  token_type        String?
  scope             String?
  id_token          String?
  session_state     String?

  user User @relation(fields: [userId], references: [id], onDelete: Cascade)
  @@unique([provider, providerAccountId])
}

model Session {
  id           String   @id @default(cuid())
  sessionToken String   @unique
  userId       String
  expires      DateTime
  user         User     @relation(fields: [userId], references: [id], onDelete: Cascade)
}

model VerificationToken {
  identifier String
  token      String   @unique
  expires    DateTime
  @@unique([identifier, token])
}

// ─── Showbiz domain tables ──────────────────────────────────
model ListItem {
  id          String    @id @default(cuid())
  userId      String
  externalId  String                         // TMDb ID
  mediaType   MediaType
  listType    ListType
  createdAt   DateTime  @default(now())

  user        User      @relation(fields: [userId], references: [id], onDelete: Cascade)

  @@unique([userId, externalId, mediaType, listType])
  @@index([userId, listType])
}

model InteractionEvent {
  id          String    @id @default(cuid())
  userId      String
  eventType   EventType
  externalId  String?
  mediaType   MediaType?
  timestamp   DateTime  @default(now())
  context     Json?                          // page, referrer, ranking source, etc.

  user        User      @relation(fields: [userId], references: [id], onDelete: Cascade)

  @@index([userId, eventType])
  @@index([userId, timestamp])
}

// ─── Enums ──────────────────────────────────────────────────
enum MediaType {
  movie
  tv
}

enum ListType {
  watchlist
  favorite
  seen
}

enum EventType {
  view_title
  view_person
  search
  search_click
  add_watchlist
  remove_watchlist
  favorite
  unfavorite
  mark_seen
  unmark_seen
  rec_impression
  rec_click
  rec_why_open
}