@opprs/db-prisma 2.2.1 → 2.5.0

package/prisma/schema.prisma

@@ -18,26 +18,22 @@ model Player {
 
   // Player identification
   externalId       String?  @unique // External ID from OPPR or other systems
+  playerNumber     Int      @unique // 5-digit unique identifier (10000-99999)
   name             String?
 
-  // OPPR Rating fields
-  rating           Float    @default(1500) // Glicko rating
-  ratingDeviation  Float    @default(200)  // Rating uncertainty (RD)
-  ranking          Int?                     // World ranking position
-  isRated          Boolean  @default(false) // Has 5+ events
+  // General player statistics
   eventCount       Int      @default(0)     // Number of events participated
-
-  // Timestamps for rating calculations
-  lastRatingUpdate DateTime @default(now())
   lastEventDate    DateTime?
 
   // Relations
-  tournamentResults TournamentResult[]
-  user              User?
+  standings            Standing[]
+  entries              Entry[]
+  user                 User?
+  organizedTournaments Tournament[] @relation("OrganizedTournaments")
+  opprRanking          OpprPlayerRanking?
 
   @@index([externalId])
-  @@index([rating])
-  @@index([ranking])
+  @@index([playerNumber])
 }
 
 // Tournament model - represents a pinball tournament event
@@ -49,9 +45,17 @@ model Tournament {
   // Tournament identification
   externalId       String?  @unique // External ID from OPPR or other systems
   name             String
-  location         String?
+  description      String?  @db.VarChar(2000)
   date             DateTime
 
+  // Location relation
+  locationId       String?
+  location         Location? @relation(fields: [locationId], references: [id], onDelete: SetNull)
+
+  // Organizer relation
+  organizerId      String?
+  organizer        Player?   @relation("OrganizedTournaments", fields: [organizerId], references: [id], onDelete: SetNull)
+
   // Tournament configuration (stored as JSON)
   // Contains TGPConfig structure from OPPR
   tgpConfig        Json?
@@ -70,48 +74,117 @@ model Tournament {
   firstPlaceValue  Float?
 
   // Relations
-  results          TournamentResult[]
+  rounds                Round[]
+  matches               Match[]
+  standings             Standing[]
+  rankingHistoryRecords OpprRankingHistory[]
 
   @@index([date])
   @@index([eventBooster])
   @@index([externalId])
+  @@index([locationId])
+  @@index([organizerId])
 }
 
-// Tournament Result - junction table linking players to tournaments
-model TournamentResult {
-  id               String   @id @default(cuid())
-  createdAt        DateTime @default(now())
-  updatedAt        DateTime @updatedAt
+// Round model - groups matches within a tournament stage
+model Round {
+  id            String     @id @default(cuid())
+  createdAt     DateTime   @default(now())
+  updatedAt     DateTime   @updatedAt
+
+  tournamentId  String
+  tournament    Tournament @relation(fields: [tournamentId], references: [id], onDelete: Cascade)
+
+  number        Int        // Round number within the stage (1, 2, 3...)
+  name          String?    // Optional name (e.g., "Quarterfinals", "Semifinal")
+  isFinals      Boolean    @default(false)
 
   // Relations
-  playerId         String
-  player           Player     @relation(fields: [playerId], references: [id], onDelete: Cascade)
-  tournamentId     String
-  tournament       Tournament @relation(fields: [tournamentId], references: [id], onDelete: Cascade)
+  matches       Match[]
+
+  @@unique([tournamentId, number, isFinals])
+  @@index([tournamentId])
+  @@index([tournamentId, isFinals])
+}
+
+// Match model - a single game with 1-4 players
+model Match {
+  id            String     @id @default(cuid())
+  createdAt     DateTime   @default(now())
+  updatedAt     DateTime   @updatedAt
+
+  tournamentId  String
+  tournament    Tournament @relation(fields: [tournamentId], references: [id], onDelete: Cascade)
+  roundId       String?
+  round         Round?     @relation(fields: [roundId], references: [id], onDelete: SetNull)
 
-  // Result data
-  position         Int      // Finishing position (1 = first place)
-  optedOut         Boolean  @default(false)
+  number        Int?       // Match number within the round
+  machineName   String?    // Machine played on
 
-  // Points awarded
-  linearPoints     Float?   @default(0) // Linear distribution points
-  dynamicPoints    Float?   @default(0) // Dynamic distribution points
-  totalPoints      Float?   // Total points (linear + dynamic)
+  // Relations
+  entries       Entry[]
 
-  // Time decay tracking
-  ageInDays        Int?     @default(0) // Age of event in days at calculation time
-  decayMultiplier  Float?   @default(1.0) // Time decay multiplier (1.0, 0.75, 0.5, or 0.0)
-  decayedPoints    Float?   // Points after applying decay (defaults to totalPoints via application logic)
+  @@index([tournamentId])
+  @@index([roundId])
+}
 
-  // Efficiency tracking
-  efficiency       Float?   // Performance efficiency percentage
+// Entry model - a player's participation in a match
+model Entry {
+  id            String      @id @default(cuid())
+  createdAt     DateTime    @default(now())
+  updatedAt     DateTime    @updatedAt
 
-  @@unique([playerId, tournamentId])
+  matchId       String
+  match         Match       @relation(fields: [matchId], references: [id], onDelete: Cascade)
+  playerId      String
+  player        Player      @relation(fields: [playerId], references: [id], onDelete: Cascade)
+
+  result        MatchResult // WIN, LOSS, TIE
+  position      Int?        // Position within the match (1st, 2nd, 3rd, 4th for group games)
+
+  @@unique([matchId, playerId])
+  @@index([matchId])
+  @@index([playerId])
+}
+
+// Standing model - final position for qualifying or finals
+model Standing {
+  id               String     @id @default(cuid())
+  createdAt        DateTime   @default(now())
+  updatedAt        DateTime   @updatedAt
+
+  tournamentId     String
+  tournament       Tournament @relation(fields: [tournamentId], references: [id], onDelete: Cascade)
+  playerId         String
+  player           Player     @relation(fields: [playerId], references: [id], onDelete: Cascade)
+
+  position         Int        // Finishing position (1 = first place)
+  isFinals         Boolean    @default(false)
+  optedOut         Boolean    @default(false)
+
+  // Points (calculated from merged standings)
+  linearPoints     Float?     @default(0)
+  dynamicPoints    Float?     @default(0)
+  totalPoints      Float?
+  ageInDays        Int?       @default(0)
+  decayMultiplier  Float?     @default(1.0)
+  decayedPoints    Float?
+  efficiency       Float?
+
+  @@unique([playerId, tournamentId, isFinals])
   @@index([playerId])
   @@index([tournamentId])
+  @@index([tournamentId, isFinals])
   @@index([position])
 }
 
+// Enum for match results
+enum MatchResult {
+  WIN
+  LOSS
+  TIE
+}
+
 // Enum for event booster types
 enum EventBoosterType {
   NONE
@@ -127,6 +200,12 @@ enum Role {
   ADMIN
 }
 
+// Enum for blog post status
+enum PostStatus {
+  DRAFT
+  PUBLISHED
+}
+
 // User model - represents an authenticated user account
 model User {
   id               String   @id @default(cuid())
@@ -147,5 +226,181 @@ model User {
   // Session management (for token revocation)
   refreshTokenHash String?
 
+  // Policy acceptance timestamps (null = not accepted)
+  tosAcceptedAt           DateTime?
+  privacyPolicyAcceptedAt DateTime?
+  codeOfConductAcceptedAt DateTime?
+
+  // Blog posts authored by this user
+  blogPosts               BlogPost[]
+
+  // API Keys
+  apiKeys          ApiKey[]
+
   @@index([email])
 }
+
+// ApiKey model - represents an API key for programmatic access
+model ApiKey {
+  id           String    @id @default(cuid())
+  createdAt    DateTime  @default(now())
+  updatedAt    DateTime  @updatedAt
+
+  // Key identification
+  name         String    // User-provided name (e.g., "CI Pipeline", "Mobile App")
+  keyPrefix    String    // First 14 characters of the key for display/lookup
+  keyHash      String    // bcrypt hash of the full key
+
+  // Ownership
+  userId       String
+  user         User      @relation(fields: [userId], references: [id], onDelete: Cascade)
+
+  // Lifecycle
+  expiresAt    DateTime? // Optional expiration date
+  lastUsedAt   DateTime? // Updated on each successful authentication
+
+  @@index([userId])
+  @@index([keyPrefix])
+}
+
+// Location model - represents a venue where tournaments are held
+model Location {
+  id            String   @id @default(cuid())
+  createdAt     DateTime @default(now())
+  updatedAt     DateTime @updatedAt
+
+  externalId    String?  @unique
+  name          String
+  address       String?
+  city          String?
+  state         String?
+  country       String?
+
+  // Relations
+  tournaments   Tournament[]
+
+  @@index([externalId])
+  @@index([name])
+  @@index([city])
+}
+
+// BlogPost model - represents a blog article
+model BlogPost {
+  id               String      @id @default(cuid())
+  createdAt        DateTime    @default(now())
+  updatedAt        DateTime    @updatedAt
+
+  // Content
+  title            String
+  slug             String      @unique
+  content          String      @db.Text
+  excerpt          String?     @db.VarChar(500)
+
+  // Status
+  status           PostStatus  @default(DRAFT)
+  publishedAt      DateTime?
+
+  // Featured image (external URL)
+  featuredImageUrl String?
+  featuredImageAlt String?
+
+  // SEO fields
+  metaTitle        String?     @db.VarChar(60)
+  metaDescription  String?     @db.VarChar(160)
+  ogTitle          String?
+  ogDescription    String?
+  ogImageUrl       String?
+
+  // Author (User who created the post)
+  authorId         String
+  author           User        @relation(fields: [authorId], references: [id], onDelete: Restrict)
+
+  // Tags relation
+  tags             BlogTag[]
+
+  @@index([slug])
+  @@index([status])
+  @@index([publishedAt])
+  @@index([authorId])
+}
+
+// BlogTag model - for categorizing blog posts
+model BlogTag {
+  id          String     @id @default(cuid())
+  createdAt   DateTime   @default(now())
+  updatedAt   DateTime   @updatedAt
+
+  name        String     @unique
+  slug        String     @unique
+  description String?
+
+  // Posts with this tag
+  posts       BlogPost[]
+
+  @@index([slug])
+}
+
+// OPPR Player Ranking - OPPR-specific rating and ranking data
+// Separated from Player to allow for future alternative ranking systems
+model OpprPlayerRanking {
+  id               String   @id @default(cuid())
+  createdAt        DateTime @default(now())
+  updatedAt        DateTime @updatedAt
+
+  // Relation to Player (one-to-one)
+  playerId         String   @unique
+  player           Player   @relation(fields: [playerId], references: [id], onDelete: Cascade)
+
+  // Glicko Rating fields
+  rating           Float    @default(1500) // Glicko rating
+  ratingDeviation  Float    @default(200)  // Rating uncertainty (RD)
+  lastRatingUpdate DateTime @default(now())
+
+  // World Ranking fields
+  ranking          Int?                     // World ranking position (1 = best)
+  isRated          Boolean  @default(false) // Has 5+ events (eligible for ranking)
+
+  // Relations
+  history          OpprRankingHistory[]
+
+  @@index([playerId])
+  @@index([rating])
+  @@index([ranking])
+  @@index([isRated])
+}
+
+// OPPR Ranking History - Historical record of ranking/rating changes
+model OpprRankingHistory {
+  id                    String   @id @default(cuid())
+  createdAt             DateTime @default(now())
+
+  // Relation to OpprPlayerRanking
+  opprPlayerRankingId   String
+  opprPlayerRanking     OpprPlayerRanking @relation(fields: [opprPlayerRankingId], references: [id], onDelete: Cascade)
+
+  // Snapshot of values at this point in time
+  rating                Float
+  ratingDeviation       Float
+  ranking               Int?
+  isRated               Boolean
+
+  // Context for the change
+  changeType            OpprRankingChangeType
+  tournamentId          String?
+  tournament            Tournament? @relation(fields: [tournamentId], references: [id], onDelete: SetNull)
+  notes                 String?  @db.VarChar(500)
+
+  @@index([opprPlayerRankingId])
+  @@index([createdAt])
+  @@index([tournamentId])
+  @@index([opprPlayerRankingId, createdAt])
+}
+
+// Enum for tracking what caused the ranking change
+enum OpprRankingChangeType {
+  INITIAL           // First ranking record created
+  TOURNAMENT_RESULT // Rating updated after tournament
+  RANKING_REFRESH   // Periodic ranking recalculation
+  RD_DECAY          // RD increased due to inactivity
+  MANUAL_ADJUSTMENT // Administrative correction
+}