بتل کد Battle Codeدارد باز می‌شود…

جلسه‌ی 20: پروژه: سرور جدول امتیاز Project: The Leaderboard Server

جلسه‌ی مرور فاز ۵: جدول ساختن و خواندن، API روی SQL، و عوض کردن ردیف‌ها و صفحه‌بندی را در یک نگاه می‌بینی، با یک نگاه دوباره به CRUD فاز ۴. بعد پروژه: سرور جدول امتیاز یک بازی. امتیازها در SQL ذخیره می‌شوند، ورودی بررسی می‌شود، بهترین امتیاز هر بازیکن با MAX و GROUP BY حساب می‌شود و سه نفر اول هر بازی نشان داده می‌شوند.

در این جلسه یاد می‌گیری

درس

🔐 قانون طلایی این دوره: سرور امانت‌دار است. هر سروری که می‌سازی داده‌ی آدم‌ها را نگه می‌دارد: اسم، امتیاز، یادداشت، رمز. پس به هر چه از بیرون می‌آید شک کن، رمز را هیچ‌وقت خام نگه ندار و داده‌ی کسی را به دیگری نشان نده. فقط سرورهای خودت را امتحان کن. سرور این دوره ساختگی است و داخل همین صفحه کار می‌کند: هر بار که برنامه را اجرا می‌کنی از صفر ساخته می‌شود، پس هر چه می‌خواهی امتحان کن.

📌 جلسه‌ی ۱۷ در یک نگاه: حافظه فراموش می‌کند. لیست پایتون با هر بار روشن شدن دوباره‌ی سرور خالی می‌شود؛ پایگاه داده روی دیسک می‌ماند. db.run("CREATE TABLE ...") جدول می‌سازد و db.run("INSERT ... VALUES (?, ?)", (...)) ردیف اضافه می‌کند؛ .id شماره‌ی ردیف تازه است. db.all لیستی از دیکشنری‌ها، db.one یک دیکشنری یا None، و db.value یک مقدار تنها می‌دهد. db.script چند دستور را یک‌جا اجرا می‌کند. مقدارها همیشه با ?.

📌 جلسه‌ی ۱۸ در یک نگاه: API روی SQL. ردیف‌ها دیکشنری‌اند، پس return db.all(...) یا return row مستقیم JSON می‌شود. db.one(...) که None بدهد یعنی 404. ?kind= از request.args با ? به WHERE می‌رود. POST: ورودی را بررسی کن، INSERT کن، ردیف تازه را با .id بخوان و با 201 برگردان.

📌 جلسه‌ی ۱۹ در یک نگاه: عوض کردن و صفحه‌بندی. UPDATE ... SET score = ? WHERE id = ? و DELETE FROM ... WHERE id = ?؛ .changed تعداد ردیف‌های عوض‌شده است و 0 یعنی 404. پاک کردن موفق: return "", 204. صفحه‌ها: ORDER BY id LIMIT ? OFFSET ? با OFFSET (page - 1) * size، و صفحه‌ی غیرعددی یا کمتر از ۱ یعنی 400. اسم ستون مرتب‌سازی فقط از یک دیکشنری ثابت خودت، چون ? فقط جای مقدار است.

⚠️ اشتباه‌های رایج این فاز:
- چسباندن مقدار به SQL با f-string یا +، به‌جای ?.
- '?' داخل کوتیشن، یا تعداد ? که با تعداد مقدارها جور نیست.
- بررسی نکردن None بعد از db.one.
- CREATE TABLE داخل یک مسیر، که درخواست دوم را می‌شکند.
- UPDATE یا DELETE بدون WHERE، که همه‌ی ردیف‌ها را عوض یا پاک می‌کند.
- ORDER BY ? که هیچ چیزی را مرتب نمی‌کند، و صفحه‌بندی بدون ORDER BY.

🔁 از فاز ۴: CRUD و بررسی ورودی. چهار کار با هر چیز: ساختن (POST، جواب 201)، خواندن (GET، 200)، عوض کردن (PUT برای همه‌اش، PATCH برای یک بخش) و پاک کردن (DELETE، 204). هر چه از بیرون می‌آید بررسی می‌شود: فیلدهای لازم، نوع با isinstance، بازه‌ی عددها. بد بود: 400 با پیام روشن؛ تکراری بود: 409. بهتر از همه: همه‌ی مشکل‌ها را در یک لیست جمع کن و با هم برگردان، تا کاربر یک بار همه را درست کند. در فاز ۵ همه‌ی این‌ها همان ماند؛ فقط جای داده عوض شد.

🏆 پروژه: سرور جدول امتیاز. بازی‌های Snake و Pong امتیازهایشان را به سرور ما می‌فرستند. جدول scores ستون‌های id، player، game و points دارد و هر بازیکن ممکن است چند امتیاز داشته باشد. برای «بهترین امتیاز هر بازیکن» دو چیز از SQL لازم داریم که در دوره‌ی پایگاه داده آمده:
- MAX(points) بزرگ‌ترین مقدار را می‌دهد و COUNT(*) تعداد را. AS best به آن ستون یک اسم می‌دهد، که کلید JSON هم می‌شود.
- GROUP BY player ردیف‌های هر بازیکن را یک گروه می‌کند، پس MAX و COUNT برای هر بازیکن جدا حساب می‌شوند.

بعد ORDER BY best DESC, player LIMIT 3 سه نفر اول را می‌دهد. GROUP BY بعد از WHERE و قبل از ORDER BY می‌آید.

from server import db

db.script('''
CREATE TABLE scores (id INTEGER PRIMARY KEY, player TEXT, game TEXT, points INTEGER);
INSERT INTO scores (player, game, points) VALUES ('Sara', 'Snake', 145), ('Ali', 'Snake', 95), ('Mina', 'Snake', 140);
INSERT INTO scores (player, game, points) VALUES ('Sara', 'Pong', 30), ('Reza', 'Pong', 160), ('Kian', 'Snake', 140);
INSERT INTO scores (player, game, points) VALUES ('Sara', 'Snake', 150), ('Omid', 'Pong', 38);
''')

db.show("SELECT player, MAX(points) AS best, COUNT(*) AS plays FROM scores GROUP BY player ORDER BY best DESC, player")
db.show("SELECT player, MAX(points) AS best FROM scores WHERE game = ? GROUP BY player ORDER BY best DESC, player LIMIT 3", ("Snake",))

🛠️ سه قدم پروژه:
1. POST /scores: سه بررسی (player، game، points)، همه‌ی مشکل‌ها با هم در {"errors": [...]} با 400؛ وگرنه INSERT و 201.
2. GET /top/<game>: سه بهترین بازیکن یک بازی با MAX و GROUP BY؛ بازی ناشناخته 404.
3. GET /players/<name> برای آمار یک بازیکن، و DELETE /scores/<int:score_id> برای پاک کردن امتیاز تقلبی.

هر قدم روی کد قدم قبل ساخته می‌شود و درخواست‌های ask قبلی سر جایشان می‌مانند؛ دکمه‌ی «ادامه از کد مرحله‌ی قبلم» کدت را می‌آورد. جدول هر بار با همان ۸ امتیاز شروع می‌شود، پس امتیاز تازه‌ی لیلا شماره‌ی ۹ می‌گیرد.

مثال‌های این جلسه

چالش‌ها

  1. Just the Number (آسان)
  2. Which Status? (آسان)
  3. Delete Twice (متوسط)
  4. Step 1: Saving Scores (متوسط)
  5. Step 2: The Top Three (سخت)
  6. Step 3: Stats and Cheaters (سخت)

بیشتر بخوان

← جلسه‌ی 19: عوض کردن ردیف‌ها و صفحه‌بندی جلسه‌ی 21: ثبت‌نام: رمز را خام نگه ندار →