football-next/QUIZ_QUICKSTART.md

🚀 Quick Start - Daily Quiz & Golden Card

نصب و راه‌اندازی سریع

1️⃣ Database Migration

npm run db:generate
npm run db:push

2️⃣ Seed Sample Data (اختیاری)

npm run seed:quiz

این دستور:

• یک کوییز نمونه برای امروز ایجاد می‌کنه (18:00-21:00)
• 10 بازیکن برتر رو به عنوان Golden Card eligible علامت می‌زنه

3️⃣ Run Development Server

npm run dev

---

🎯 تست سریع

Admin Panel

1. لاگین به عنوان ادمین
2. برو به /admin/quiz
3. کوییز جدید بساز یا از sample استفاده کن
4. بازیکنان Golden Card رو در /admin/players فعال کن

User Flow

1. لاگین به عنوان کاربر عادی
2. برو به /quiz
3. به سوالات پاسخ بده
4. نمره 100% بگیر تا واجد شرایط قرعه‌کشی بشی

Lottery

1. به عنوان ادمین به /admin/quiz برو
2. روی دکمه قرعه‌کشی کلیک کن
3. برندگان رو در /admin/quiz/[id]/results ببین

Golden Cards

1. به عنوان کاربر برنده به /golden-cards برو
2. روی کارت مهر شده کلیک کن
3. بازیکن رو reveal کن

---

📍 Routes

User

• /quiz - کوییز روزانه
• /quiz/history - تاریخچه شرکت
• /golden-cards - کارت‌های طلایی

Admin

• /admin/quiz - مدیریت کوییزها
• /admin/quiz/new - ایجاد کوییز جدید
• /admin/quiz/[id]/results - نتایج و برندگان
• /admin/players - تنظیم Golden Card eligible

---

🐛 Troubleshooting

کوییز نمایش داده نمی‌شه

• بازه زمانی رو چک کن (باید در بازه فعلی باشه)
• تاریخ کوییز باید امروز باشه

قرعه‌کشی کار نمی‌کنه

• حداقل یک بازیکن isGoldenCardEligible = true داشته باش
• حداقل یک شرکت‌کننده با نمره 100% وجود داشته باشه

کارت باز نمی‌شه

• مطمئن شو کاربر لاگین کرده
• کارت باید SEALED باشه

---

✅ Done!

همه چیز آماده است. حالا می‌تونی:

• کوییزهای روزانه بسازی
• کاربران شرکت کنن
• قرعه‌کشی انجام بدی
• Golden Cards توزیع کنی

برای جزئیات بیشتر، QUIZ_FEATURE_GUIDE.md رو بخون.