@opprs/db-prisma 2.2.1-canary.840995 → 2.2.1-canary.93558b4

package/prisma/schema.prisma

@@ -21,25 +21,19 @@ model Player {
   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([playerNumber])
-  @@index([rating])
-  @@index([ranking])
 }
 
 // Tournament model - represents a pinball tournament event
@@ -50,10 +44,19 @@ model Tournament {
 
   // Tournament identification
   externalId       String?  @unique // External ID from OPPR or other systems
+  externalUrl      String?          // URL to external tournament page (e.g., IFPA, Matchplay)
   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?
@@ -72,48 +75,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
@@ -129,6 +201,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())
@@ -149,5 +227,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
+}

package/prisma/seed.ts

@@ -15,54 +15,43 @@ async function main() {
       externalId: 'player-1',
       playerNumber: 10001,
       name: 'Alice Champion',
-      rating: 1850,
-      ratingDeviation: 50,
-      ranking: 5,
-      isRated: true,
       eventCount: 25,
     },
     {
       externalId: 'player-2',
       playerNumber: 10002,
       name: 'Bob Wizard',
-      rating: 1750,
-      ratingDeviation: 60,
-      ranking: 12,
-      isRated: true,
       eventCount: 18,
     },
     {
       externalId: 'player-3',
       playerNumber: 10003,
       name: 'Charlie Flipper',
-      rating: 1650,
-      ratingDeviation: 75,
-      ranking: 28,
-      isRated: true,
       eventCount: 12,
     },
     {
       externalId: 'player-4',
       playerNumber: 10004,
       name: 'Diana Tilt',
-      rating: 1550,
-      ratingDeviation: 100,
-      ranking: 45,
-      isRated: true,
       eventCount: 8,
     },
     {
       externalId: 'player-5',
       playerNumber: 10005,
       name: 'Eve Plunger',
-      rating: 1300,
-      ratingDeviation: 150,
-      ranking: null,
-      isRated: false,
       eventCount: 3,
     },
   ];
 
+  // OPPR ranking data for each player
+  const rankingData = [
+    { rating: 1850, ratingDeviation: 50, ranking: 5, isRated: true },
+    { rating: 1750, ratingDeviation: 60, ranking: 12, isRated: true },
+    { rating: 1650, ratingDeviation: 75, ranking: 28, isRated: true },
+    { rating: 1550, ratingDeviation: 100, ranking: 45, isRated: true },
+    { rating: 1300, ratingDeviation: 150, ranking: null, isRated: false },
+  ];
+
   const player1 = await prisma.player.upsert({
     where: { externalId: 'player-1' },
     update: playerData[0],
@@ -95,6 +84,18 @@ async function main() {
 
   console.log(`✓ Created ${await prisma.player.count()} players`);
 
+  // Create OPPR rankings for each player
+  console.log('Creating OPPR rankings...');
+  const players = [player1, player2, player3, player4, player5];
+  for (let i = 0; i < players.length; i++) {
+    await prisma.opprPlayerRanking.upsert({
+      where: { playerId: players[i].id },
+      update: rankingData[i],
+      create: { playerId: players[i].id, ...rankingData[i] },
+    });
+  }
+  console.log(`✓ Created ${await prisma.opprPlayerRanking.count()} OPPR rankings`);
+
   // Seed users from environment variables (development only)
   const seedAdminEmail = process.env.SEED_ADMIN_EMAIL;
   const seedAdminPassword = process.env.SEED_ADMIN_PASSWORD;
@@ -149,13 +150,71 @@ async function main() {
 
   console.log(`✓ Created admin user (admin@example.com / ${adminPassword})`);
 
+  // Create sample locations (using upsert for idempotency)
+  console.log('Creating locations...');
+
+  const location1 = await prisma.location.upsert({
+    where: { externalId: 'location-1' },
+    update: {
+      name: 'Las Vegas Convention Center',
+      city: 'Las Vegas',
+      state: 'NV',
+      country: 'USA',
+    },
+    create: {
+      externalId: 'location-1',
+      name: 'Las Vegas Convention Center',
+      city: 'Las Vegas',
+      state: 'NV',
+      country: 'USA',
+    },
+  });
+
+  const location2 = await prisma.location.upsert({
+    where: { externalId: 'location-2' },
+    update: {
+      name: 'Ground Kontrol',
+      address: '115 NW 5th Ave',
+      city: 'Portland',
+      state: 'OR',
+      country: 'USA',
+    },
+    create: {
+      externalId: 'location-2',
+      name: 'Ground Kontrol',
+      address: '115 NW 5th Ave',
+      city: 'Portland',
+      state: 'OR',
+      country: 'USA',
+    },
+  });
+
+  const location3 = await prisma.location.upsert({
+    where: { externalId: 'location-3' },
+    update: {
+      name: 'Add-a-Ball Amusements',
+      city: 'Seattle',
+      state: 'WA',
+      country: 'USA',
+    },
+    create: {
+      externalId: 'location-3',
+      name: 'Add-a-Ball Amusements',
+      city: 'Seattle',
+      state: 'WA',
+      country: 'USA',
+    },
+  });
+
+  console.log(`✓ Created ${await prisma.location.count()} locations`);
+
   // Create sample tournaments (using upsert for idempotency)
   console.log('Creating tournaments...');
 
   const tournament1Data = {
     externalId: 'tournament-1',
     name: 'World Pinball Championship 2024',
-    location: 'Las Vegas, NV',
+    locationId: location1.id,
     date: new Date('2024-03-15'),
     eventBooster: EventBoosterType.MAJOR,
     allowsOptOut: false,
@@ -191,7 +250,7 @@ async function main() {
   const tournament2Data = {
     externalId: 'tournament-2',
     name: 'Spring Classics 2024',
-    location: 'Portland, OR',
+    locationId: location2.id,
     date: new Date('2024-04-20'),
     eventBooster: EventBoosterType.CERTIFIED,
     allowsOptOut: true,
@@ -225,7 +284,7 @@ async function main() {
   const tournament3Data = {
     externalId: 'tournament-3',
     name: 'Monthly League Finals',
-    location: 'Seattle, WA',
+    locationId: location3.id,
     date: new Date('2024-05-10'),
     eventBooster: EventBoosterType.NONE,
     allowsOptOut: false,
@@ -258,11 +317,11 @@ async function main() {
 
   console.log(`✓ Created ${await prisma.tournament.count()} tournaments`);
 
-  // Create tournament results (delete existing first for idempotency)
-  console.log('Creating tournament results...');
+  // Create tournament standings (delete existing first for idempotency)
+  console.log('Creating tournament standings...');
 
-  // Delete existing results for seeded tournaments
-  await prisma.tournamentResult.deleteMany({
+  // Delete existing standings for seeded tournaments
+  await prisma.standing.deleteMany({
     where: {
       tournamentId: {
         in: [tournament1.id, tournament2.id, tournament3.id],
@@ -270,13 +329,14 @@ async function main() {
     },
   });
 
-  // World Championship results
-  await prisma.tournamentResult.createMany({
+  // World Championship standings
+  await prisma.standing.createMany({
     data: [
       {
         playerId: player1.id,
         tournamentId: tournament1.id,
         position: 1,
+        isFinals: true,
         totalPoints: 411.84,
         linearPoints: 41.18,
         dynamicPoints: 370.66,
@@ -289,6 +349,7 @@ async function main() {
         playerId: player2.id,
         tournamentId: tournament1.id,
         position: 2,
+        isFinals: true,
         totalPoints: 298.45,
         linearPoints: 41.18,
         dynamicPoints: 257.27,
@@ -301,6 +362,7 @@ async function main() {
         playerId: player3.id,
         tournamentId: tournament1.id,
         position: 3,
+        isFinals: true,
         totalPoints: 215.32,
         linearPoints: 41.18,
         dynamicPoints: 174.14,
@@ -313,6 +375,7 @@ async function main() {
         playerId: player4.id,
         tournamentId: tournament1.id,
         position: 5,
+        isFinals: true,
         totalPoints: 125.18,
         linearPoints: 41.18,
         dynamicPoints: 84.00,
@@ -324,13 +387,14 @@ async function main() {
     ],
   });
 
-  // Spring Classics results
-  await prisma.tournamentResult.createMany({
+  // Spring Classics standings
+  await prisma.standing.createMany({
     data: [
       {
         playerId: player2.id,
         tournamentId: tournament2.id,
         position: 1,
+        isFinals: true,
         totalPoints: 87.28,
         linearPoints: 8.73,
         dynamicPoints: 78.55,
@@ -343,6 +407,7 @@ async function main() {
         playerId: player1.id,
         tournamentId: tournament2.id,
         position: 2,
+        isFinals: true,
         totalPoints: 63.25,
         linearPoints: 8.73,
         dynamicPoints: 54.52,
@@ -355,6 +420,7 @@ async function main() {
         playerId: player4.id,
         tournamentId: tournament2.id,
         position: 3,
+        isFinals: true,
         totalPoints: 45.67,
         linearPoints: 8.73,
         dynamicPoints: 36.94,
@@ -367,6 +433,7 @@ async function main() {
         playerId: player5.id,
         tournamentId: tournament2.id,
         position: 6,
+        isFinals: true,
         totalPoints: 18.52,
         linearPoints: 8.73,
         dynamicPoints: 9.79,
@@ -378,13 +445,14 @@ async function main() {
     ],
   });
 
-  // Monthly League results
-  await prisma.tournamentResult.createMany({
+  // Monthly League standings
+  await prisma.standing.createMany({
     data: [
       {
         playerId: player3.id,
         tournamentId: tournament3.id,
         position: 1,
+        isFinals: true,
         totalPoints: 28.4,
         linearPoints: 2.84,
         dynamicPoints: 25.56,
@@ -397,6 +465,7 @@ async function main() {
         playerId: player4.id,
         tournamentId: tournament3.id,
         position: 2,
+        isFinals: true,
         totalPoints: 20.58,
         linearPoints: 2.84,
         dynamicPoints: 17.74,
@@ -409,6 +478,7 @@ async function main() {
         playerId: player5.id,
         tournamentId: tournament3.id,
         position: 3,
+        isFinals: true,
         totalPoints: 14.85,
         linearPoints: 2.84,
         dynamicPoints: 12.01,
@@ -420,16 +490,18 @@ async function main() {
     ],
   });
 
-  console.log(`✓ Created ${await prisma.tournamentResult.count()} tournament results`);
+  console.log(`✓ Created ${await prisma.standing.count()} tournament standings`);
 
   console.log('');
   console.log('✅ Database seeded successfully!');
   console.log('');
   console.log('Summary:');
   console.log(`  - ${await prisma.player.count()} players`);
+  console.log(`  - ${await prisma.opprPlayerRanking.count()} OPPR rankings`);
   console.log(`  - ${await prisma.user.count()} users`);
+  console.log(`  - ${await prisma.location.count()} locations`);
   console.log(`  - ${await prisma.tournament.count()} tournaments`);
-  console.log(`  - ${await prisma.tournamentResult.count()} tournament results`);
+  console.log(`  - ${await prisma.standing.count()} standings`);
 }
 
 main()