# 🚀 Quick Start - Daily Quiz & Golden Card

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

### 1️⃣ Database Migration
```bash
npm run db:generate
npm run db:push
```

### 2️⃣ Seed Sample Data (اختیاری)
```bash
npm run seed:quiz
```
این دستور:
- یک کوییز نمونه برای امروز ایجاد می‌کنه (18:00-21:00)
- 10 بازیکن برتر رو به عنوان Golden Card eligible علامت می‌زنه

### 3️⃣ Run Development Server
```bash
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` رو بخون.
