Add rich demo seed data

Author: josedab

README.md

@@ -17,12 +17,12 @@
 | **🎯 Taste Profile Quiz** | Rate 10 well-known games and answer preference questions to build a personalized recommendation engine |
 | **🤖 Personalized Recommendations** | Content-based filtering scores games on complexity, theme, mechanics, and player count match |
 | **🎭 Mood-Based Discovery** | Browse by "Quick Party Game", "Deep Strategy", "Cozy Two-Player", and 5 more moods |
-| **🔍 Search & Filter** | Search 55+ real board games with filters for players, complexity, and playtime |
-| **📋 Game Detail Pages** | Full info, price comparison across retailers, reviews, similar games, play logging |
+| **🔍 Search & Filter** | Search 85+ real board games with filters for players, complexity, and playtime |
+| **📋 Game Detail Pages** | Full info, current prices, seeded deals, reviews, similar games, and play logging |
 | **📚 Collection Management** | Track owned games and wishlist with shelf view and sorting |
-| **📝 Play Logging** | Log plays with date, player count, winner, rating, and notes |
-| **📊 Stats Dashboard** | Charts for plays per month, complexity distribution, top categories, ratings |
-| **💰 Price Tracker** | Compare prices across Amazon, Target, and more with deal alert setup |
+| **📝 Play Logging** | Log plays with date, player count, winner, optional score, rating, and notes |
+| **📊 Stats Dashboard** | Charts for plays per month, complexity distribution, top categories, ratings, and recent scores |
+| **💰 Price Tracker** | Compare retailer snapshots, surface active deals, and set deal alerts |
 
 ## 🚀 Quick Start
 
@@ -34,7 +34,7 @@ npm install
 npm run dev
 ```
 
-Open [http://localhost:3000](http://localhost:3000) — that's it! The SQLite database is created and seeded automatically with 55 real board games on first run.
+Open [http://localhost:3000](http://localhost:3000) — that's it! In non-production environments the SQLite database is created and reseeded automatically on first access with a rich demo dataset (85 board games, 12 personas, play history, reviews, collections, wishlists, price alerts, and active deals).
 
 ## 🛠 Tech Stack
 
@@ -65,9 +65,12 @@ src/
 │       ├── price-alerts/         # Deal alert subscriptions
 │       └── health/               # Service health check
 ├── components/                   # Shared UI components
-├── data/games.ts                 # 55 real board games seed data
+├── data/
+│   ├── games.ts                  # Base board game catalog data
+│   └── seed/                     # Seed catalog, personas, and deal definitions
 ├── lib/
-│   ├── db.ts                     # SQLite schema, init, seed logic
+│   ├── db.ts                     # SQLite schema, init, and migrations
+│   ├── seed.ts                   # Idempotent transactional seed orchestration
 │   ├── recommendations.ts        # Taste profile + scoring engine
 │   ├── moods.ts                  # Mood filter definitions
 │   ├── session.ts                # Opaque session token management
@@ -92,32 +95,43 @@ SQLite with the following tables:
 
 | Table | Purpose |
 | --- | --- |
-| `games` | Game catalog (55 seeded entries) |
-| `price_history` | Retailer prices per game |
-| `users` | User accounts (demo single-user MVP) |
+| `games` | Game catalog (85 seeded entries) |
+| `price_history` | Historical retailer price snapshots per game |
+| `game_deals` | Current seeded deals with discount metadata |
+| `users` | Seeded personas plus runtime-created users |
 | `sessions` | Opaque session tokens |
 | `quiz_answers` | Game ratings and preference answers |
 | `collection` | Owned/wishlist items |
-| `play_logs` | Play history with ratings |
+| `play_logs` | Play history with winners, ratings, and optional scores |
 | `reviews` | User game reviews |
 | `price_alerts` | Deal alert subscriptions |
+| `seed_metadata` | Seed dataset version tracking |
 
 ## 🎮 Seed Data
 
-The database includes 55 real board games spanning all complexity levels:
+The demo dataset is intentionally rich and deterministic:
 
-- **Heavy**: Gloomhaven, Brass: Birmingham, Spirit Island
-- **Medium-Heavy**: Terraforming Mars, Scythe, Twilight Imperium
-- **Medium**: Wingspan, 7 Wonders, Pandemic Legacy
-- **Gateway**: Catan, Ticket to Ride, Azul
-- **Light/Party**: Codenames, Coup, Love Letter
+- **85 real games** with accurate mechanics, themes, player counts, playtimes, and complexity spread from **1.0 (`No Thanks!`)** to **5.0 (`Advanced Squad Leader`)**
+- **12 user personas** with distinct tastes, collection sizes, wishlists, quiz answers, and price alerts
+- **216 seeded play logs** with dates, player counts, winners, ratings, and scores
+- **60 seeded reviews** with short, medium, and long-form text
+- **Historical price snapshots** for every retailer listing plus **active deals** for a large portion of the catalog
+- **Edge cases** including unicode names (`zoë_meeples`, `señor_carton`, `Café`, `Jórvík`) and long descriptions for heavier narrative titles
+
+### Seed Behavior
+
+- **Guarded in production** by default — automatic reseeding only runs outside production unless `GAMESCOUT_ALLOW_PRODUCTION_SEED=1`
+- **Idempotent** — the seeder truncates seed-managed tables and re-inserts a known-good dataset version
+- **Transactional** — catalog, personas, logs, reviews, and pricing data are inserted in a single transaction
+- **Conventionally placed** — catalog and persona definitions live in `src/data/seed/`, while orchestration lives in `src/lib/seed.ts`
 
 ## 📜 Available Scripts
 
 | Command | Description |
 | --- | --- |
 | `npm run dev` | Start development server with hot reload |
 | `npm run build` | Create optimized production build |
+| `GAMESCOUT_ALLOW_PRODUCTION_SEED=1 npm run start` | Allow one-time automatic seeding while running the production server |
 | `npm run start` | Run production server |
 | `npm run lint` | Run ESLint checks |
 | `npm run lint:types` | TypeScript type checking (`tsc --noEmit`) |

src/app/api/games/[id]/route.ts

@@ -5,7 +5,7 @@
  *        collection status, average review score, and play logs.
  */
 
-import { getDb, parseGame, type GameRow, type PriceRow, type ReviewRow, GAME_COLUMNS, GAME_LIST_COLUMNS } from "@/lib/db";
+import { getDb, parseGame, type DealRow, type GameRow, type PriceRow, type ReviewRow, GAME_COLUMNS, GAME_LIST_COLUMNS } from "@/lib/db";
 import { getUserId } from "@/lib/session";
 
 export const dynamic = "force-dynamic";
@@ -33,9 +33,27 @@ export async function GET(
     // Prices
     const prices = db
       .prepare(
-        `SELECT id, game_id, retailer, price, url, updated_at FROM price_history WHERE game_id = ? ORDER BY price ASC`
+        `SELECT ph.id, ph.game_id, ph.retailer, ph.price, ph.url, ph.updated_at
+         FROM price_history ph
+         JOIN (
+           SELECT retailer, MAX(updated_at) AS updated_at
+           FROM price_history
+           WHERE game_id = ?
+           GROUP BY retailer
+         ) latest ON latest.retailer = ph.retailer AND latest.updated_at = ph.updated_at
+         WHERE ph.game_id = ?
+         ORDER BY ph.price ASC`
       )
-      .all(Number(id)) as PriceRow[];
+      .all(Number(id), Number(id)) as PriceRow[];
+
+    const deals = db
+      .prepare(
+        `SELECT id, game_id, retailer, title, sale_price, msrp, discount_pct, url, starts_at, ends_at, coupon_code, featured
+         FROM game_deals
+         WHERE game_id = ?
+         ORDER BY featured DESC, discount_pct DESC, sale_price ASC`
+      )
+      .all(Number(id)) as DealRow[];
 
     // Reviews
     const reviews = db
@@ -75,13 +93,14 @@ export async function GET(
     // Play logs for this game
     const playLogs = db
       .prepare(
-        `SELECT pl.id, pl.played_at, pl.players, pl.winner, pl.rating, pl.notes, g.name as game_name FROM play_logs pl JOIN games g ON pl.game_id = g.id WHERE pl.user_id = ? AND pl.game_id = ? ORDER BY pl.played_at DESC`
+        `SELECT pl.id, pl.played_at, pl.players, pl.winner, pl.rating, pl.score, pl.notes, g.name as game_name FROM play_logs pl JOIN games g ON pl.game_id = g.id WHERE pl.user_id = ? AND pl.game_id = ? ORDER BY pl.played_at DESC`
       )
       .all(userId, Number(id));
 
     return Response.json({
       game,
       prices,
+      deals,
       reviews,
       similar,
       collectionStatus: collectionStatus?.status || null,

src/app/api/play-logs/route.ts

@@ -19,7 +19,7 @@ export async function GET() {
 
     const logs = db
       .prepare(
-        `SELECT pl.id, pl.user_id, pl.game_id, pl.played_at, pl.players, pl.winner, pl.rating, pl.notes, pl.created_at, g.name as game_name, g.thumbnail_url
+        `SELECT pl.id, pl.user_id, pl.game_id, pl.played_at, pl.players, pl.winner, pl.rating, pl.score, pl.notes, pl.created_at, g.name as game_name, g.thumbnail_url
          FROM play_logs pl
          JOIN games g ON pl.game_id = g.id
          WHERE pl.user_id = ?
@@ -81,6 +81,7 @@ export async function POST(request: Request) {
       players?: number;
       winner?: string;
       rating?: number;
+      score?: number;
       notes?: string;
     };
     try {
@@ -89,7 +90,7 @@ export async function POST(request: Request) {
       return Response.json({ error: "Invalid JSON body" }, { status: 400 });
     }
 
-    const { gameId, playedAt, players, winner, rating, notes } = body;
+    const { gameId, playedAt, players, winner, rating, score, notes } = body;
 
     const dateRegex = /^\d{4}-\d{2}-\d{2}$/;
     if (!gameId || !playedAt || !dateRegex.test(playedAt) || isNaN(Date.parse(playedAt))) {
@@ -104,6 +105,10 @@ export async function POST(request: Request) {
       return Response.json({ error: "rating must be an integer between 1 and 10" }, { status: 400 });
     }
 
+    if (score !== undefined && (!Number.isInteger(score) || score < 0 || score > 9999)) {
+      return Response.json({ error: "score must be an integer between 0 and 9999" }, { status: 400 });
+    }
+
     if (winner !== undefined && typeof winner !== "string") {
       return Response.json({ error: "winner must be a string" }, { status: 400 });
     }
@@ -117,8 +122,8 @@ export async function POST(request: Request) {
 
     const result = db
       .prepare(
-        `INSERT INTO play_logs (user_id, game_id, played_at, players, winner, rating, notes)
-         VALUES (@userId, @gameId, @playedAt, @players, @winner, @rating, @notes)`
+        `INSERT INTO play_logs (user_id, game_id, played_at, players, winner, rating, score, notes)
+         VALUES (@userId, @gameId, @playedAt, @players, @winner, @rating, @score, @notes)`
       )
       .run({
         userId,
@@ -127,6 +132,7 @@ export async function POST(request: Request) {
         players: players || null,
         winner: sanitizedWinner,
         rating: rating || null,
+        score: score ?? null,
         notes: sanitizedNotes,
       });
 

src/app/games/[id]/_components/PlayLogSection.tsx

@@ -126,6 +126,11 @@ export function PlayLogSection({
                         ★ {log.rating}/10
                       </span>
                     )}
+                    {log.score !== null && log.score !== undefined && (
+                      <span className="text-xs text-sky-400">
+                        🎯 {log.score} pts
+                      </span>
+                    )}
                   </div>
                   {log.notes && (
                     <p className="text-xs text-zinc-500 mt-1 italic">

src/app/games/[id]/_components/PriceComparison.tsx

@@ -1,9 +1,10 @@
 "use client";
 
-import type { PriceInfo } from "@/types";
+import type { DealInfo, PriceInfo } from "@/types";
 
 interface PriceComparisonProps {
   prices: PriceInfo[];
+  deals: DealInfo[];
   showAlertForm: boolean;
   alertSet: boolean;
   alertPrice: string;
@@ -18,6 +19,7 @@ interface PriceComparisonProps {
 
 export function PriceComparison({
   prices,
+  deals,
   showAlertForm,
   alertSet,
   alertPrice,
@@ -81,6 +83,51 @@ export function PriceComparison({
             ))}
           </div>
 
+          {deals.length > 0 && (
+            <div className="mb-4 rounded-xl border border-amber-500/30 bg-amber-500/5 p-4">
+              <h3 className="mb-3 text-sm font-semibold uppercase tracking-wider text-amber-300">
+                Active Deals
+              </h3>
+              <div className="space-y-3">
+                {deals.map((deal) => (
+                  <div key={deal.id} className="flex flex-col gap-2 rounded-lg border border-zinc-800 bg-zinc-950/40 p-3 sm:flex-row sm:items-center sm:justify-between">
+                    <div>
+                      <div className="flex flex-wrap items-center gap-2">
+                        {deal.featured === 1 && (
+                          <span className="rounded-full bg-amber-400 px-2 py-0.5 text-[10px] font-bold uppercase tracking-wider text-black">
+                            Featured
+                          </span>
+                        )}
+                        <span className="font-medium text-white">{deal.title}</span>
+                        <span className="text-xs text-zinc-500">{deal.retailer}</span>
+                      </div>
+                      <p className="mt-1 text-xs text-zinc-400">
+                        Save {deal.discount_pct}% until {new Date(deal.ends_at).toLocaleDateString()}
+                        {deal.coupon_code ? ` · Code ${deal.coupon_code}` : ""}
+                      </p>
+                    </div>
+                    <div className="flex items-center gap-3">
+                      <div className="text-right">
+                        <p className="text-sm text-zinc-500 line-through">${deal.msrp.toFixed(2)}</p>
+                        <p className="text-lg font-bold text-amber-300">${deal.sale_price.toFixed(2)}</p>
+                      </div>
+                      {deal.url && (
+                        <a
+                          href={deal.url}
+                          target="_blank"
+                          rel="noopener noreferrer"
+                          className="rounded-lg bg-amber-400 px-3 py-1.5 text-xs font-semibold text-black transition-colors hover:bg-amber-300"
+                        >
+                          View deal →
+                        </a>
+                      )}
+                    </div>
+                  </div>
+                ))}
+              </div>
+            </div>
+          )}
+
           {/* Deal Alert */}
           {!alertSet && !showAlertForm && (
             <button

src/app/games/[id]/page.tsx

@@ -278,7 +278,7 @@ export default function GameDetailPage({
     );
   }
 
-  const { game, prices, reviews, similar, playLogs, avgReview } = data;
+  const { game, prices, deals, reviews, similar, playLogs, avgReview } = data;
 
   return (
     <div className="max-w-6xl mx-auto px-4 sm:px-6 lg:px-8 py-8">
@@ -317,6 +317,7 @@ export default function GameDetailPage({
 
       <PriceComparison
         prices={prices}
+        deals={deals}
         showAlertForm={showAlertForm}
         alertSet={alertSet}
         alertPrice={alertPrice}

src/app/stats/_components/RecentPlaysTable.tsx

@@ -29,7 +29,8 @@ export function RecentPlaysTable({ logs }: RecentPlaysTableProps) {
               <th className="pb-3 pr-4">Date</th>
               <th className="pb-3 pr-4">Players</th>
               <th className="pb-3 pr-4">Winner</th>
-              <th className="pb-3">Rating</th>
+              <th className="pb-3 pr-4">Rating</th>
+              <th className="pb-3">Score</th>
             </tr>
           </thead>
           <tbody className="divide-y divide-zinc-800">
@@ -52,7 +53,7 @@ export function RecentPlaysTable({ logs }: RecentPlaysTableProps) {
                 <td className="py-3 pr-4 text-yellow-400">
                   {log.winner || "—"}
                 </td>
-                <td className="py-3">
+                <td className="py-3 pr-4">
                   {log.rating ? (
                     <span className="text-emerald-400 font-medium">
                       {log.rating}/10
@@ -61,6 +62,9 @@ export function RecentPlaysTable({ logs }: RecentPlaysTableProps) {
                     <span className="text-zinc-600">—</span>
                   )}
                 </td>
+                <td className="py-3 text-sky-400">
+                  {log.score ?? "—"}
+                </td>
               </tr>
             ))}
           </tbody>