92 lines
2.5 KiB
Markdown
92 lines
2.5 KiB
Markdown
# 🚀 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` رو بخون.
|