# দ্রুত শুরু গাইড (Quick Start)

এই গাইডটি আপনাকে ৫ মিনিটের মধ্যে Gaming Tournament Platform চালু করতে সাহায্য করবে।

## সিস্টেম প্রয়োজনীয়তা

- Node.js 18+ 
- PostgreSQL 12+
- pnpm (বা npm/yarn)
- ৫০০MB ফ্রি ডিস্ক স্পেস

## ধাপ 1: পূর্বশর্ত সেটআপ (২ মিনিট)

### PostgreSQL সেটআপ করুন
```bash
# Windows/Mac/Linux - PostgreSQL ইনস্টল করুন
# https://www.postgresql.org/download/

# PostgreSQL চালু হয়েছে কিনা যাচাই করুন
psql --version
```

### Node.js সেটআপ করুন
```bash
# Node.js ইনস্টল করুন (LTS সংস্করণ)
# https://nodejs.org/

# যাচাই করুন
node --version
npm --version
```

## ধাপ 2: প্রকল্প সেটআপ (১ মিনিট)

### ডাটাবেস তৈরি করুন
```bash
# PostgreSQL-এ লগইন করুন
psql -U postgres

# ডাটাবেস তৈরি করুন
CREATE DATABASE gaming_tournament;
CREATE USER gt_user WITH PASSWORD 'secure_password_123';
ALTER ROLE gt_user SET client_encoding TO 'utf8';
ALTER ROLE gt_user SET default_transaction_isolation TO 'read committed';
ALTER ROLE gt_user SET default_transaction_deferrable TO on;
ALTER ROLE gt_user SET default_transaction_read_only TO off;
GRANT ALL PRIVILEGES ON DATABASE gaming_tournament TO gt_user;
\q
```

### স্কিমা আপলোড করুন
```bash
# ডাটাবেস স্কিমা চালান
psql -U gt_user -d gaming_tournament < database/schema.sql

# সফলতা যাচাই করুন - নিম্নলিখিত কমান্ড চালান
psql -U gt_user -d gaming_tournament -c "\dt"
# আপনি সব টেবিল দেখতে পারবেন
```

## ধাপ 3: অ্যাপ্লিকেশন সেটআপ (১ মিনিট)

### এনভায়রনমেন্ট ফাইল কনফিগার করুন
```bash
# প্রজেক্ট ডিরেক্টরিতে যান
cd /path/to/gaming-tournament-platform

# .env.local ফাইল তৈরি করুন
cp .env.example .env.local

# .env.local খুলুন এবং সম্পাদনা করুন (নিচে দেখুন)
```

### .env.local কনফিগারেশন
```bash
# নিম্নলিখিত সেট করুন:

# ডাটাবেস কানেকশন
DATABASE_URL="postgresql://gt_user:secure_password_123@localhost:5432/gaming_tournament"

# প্রমাণীকরণ
NEXTAUTH_SECRET="your-super-secret-key-change-this-in-production"
NEXTAUTH_URL="http://localhost:3000"

# ঐচ্ছিক - SMS (এখনকে এড়িয়ে যান)
# SMS_PROVIDER="nexmo"
# SMS_API_KEY="your-key"
```

### নির্ভরতা ইনস্টল করুন
```bash
# সব প্যাকেজ ইনস্টল করুন
pnpm install

# অপেক্ষা করুন - এটি ২-৩ মিনিট লাগতে পারে
```

## ধাপ 4: অ্যাপ চালু করুন (১ মিনিট)

```bash
# উন্নয়ন সার্ভার চালু করুন
pnpm dev

# আউটপুট দেখবেন:
# > next dev
# - ready started server on 0.0.0.0:3000, url: http://localhost:3000
```

## ধাপ 5: ব্রাউজারে খুলুন

1. আপনার ব্রাউজার খুলুন
2. যান: http://localhost:3000
3. আপনি হোম পৃষ্ঠা দেখতে পারবেন

## প্রথম টেস্ট

### অ্যাকাউন্ট তৈরি করুন
1. "রেজিস্টার" বোতাম ক্লিক করুন
2. ফর্ম পূরণ করুন:
   - নাম: আপনার নাম
   - ইউজারনেম: testuser123
   - ফোন: 01712345678
   - পাসওয়ার্ড: Test@12345
   - নিয়ম গ্রহণ করুন
3. "নিবন্ধন করুন" ক্লিক করুন

### লগইন করুন
1. লগইন পৃষ্ঠায় যান
2. ফোন: 01712345678
3. পাসওয়ার্ড: Test@12345
4. "লগইন করুন" ক্লিক করুন

### ড্যাশবোর্ড দেখুন
1. আপনি ড্যাশবোর্ডে থাকবেন
2. আপনার ব্যালেন্স দেখতে পারবেন
3. ডিপোজিট বোতাম ক্লিক করুন

## সাধারণ সমস্যা সমাধান

### পোর্ট ৩০০০ ইতিমধ্যে ব্যবহৃত
```bash
# অন্য পোর্টে চালু করুন
pnpm dev -p 3001

# তারপর খুলুন: http://localhost:3001
```

### "ডাটাবেস সংযোগ ব্যর্থ"
```bash
# পরীক্ষা করুন:
# 1. PostgreSQL চলছে কিনা?
# 2. DATABASE_URL সঠিক কিনা?
# 3. স্কিমা চালানো হয়েছে কিনা?

# যাচাই করুন:
psql -U gt_user -d gaming_tournament -c "SELECT COUNT(*) FROM users;"
```

### "মডিউল পাওয়া যায়নি"
```bash
# নির্ভরতা পুনরায় ইনস্টল করুন
rm -rf node_modules pnpm-lock.yaml
pnpm install
```

## স্থাপনা করুন (উৎপাদনে)

### Vercel এ স্থাপন করুন
```bash
# Vercel CLI ইনস্টল করুন
npm i -g vercel

# লগইন করুন
vercel login

# স্থাপন করুন
vercel

# পরিবেশ ভেরিয়েবল যোগ করুন:
# - DATABASE_URL
# - NEXTAUTH_SECRET
# - NEXTAUTH_URL (আপনার ডোমেইন)
```

### নিজের সার্ভারে স্থাপন করুন
```bash
# বিল্ড করুন
pnpm build

# চালু করুন
pnpm start

# production এ সুরক্ষিত রাখুন
# - SSL সার্টিফিকেট যোগ করুন
# - শক্তিশালী পাসওয়ার্ড ব্যবহার করুন
# - নিয়মিত ব্যাকআপ নিন
```

## পরবর্তী পদক্ষেপ

1. **প্রোফাইল সম্পাদনা করুন**
   - ড্যাশবোর্ডে যান
   - আপনার গেম প্রোফাইল সেটআপ করুন

2. **টুর্নামেন্ট ব্রাউজ করুন**
   - "টুর্নামেন্ট" পৃষ্ঠায় যান
   - উপলব্ধ ম্যাচ দেখুন

3. **ডিপোজিট করুন**
   - ড্যাশবোর্ড > ডিপোজিট
   - পরিমাণ এবং পেমেন্ট পদ্ধতি নির্বাচন করুন

4. **ম্যাচে যোগ দিন**
   - টুর্নামেন্ট নির্বাচন করুন
   - "যোগ দিন" ক্লিক করুন

## কমান্ড রেফারেন্স

### উন্নয়ন
```bash
pnpm dev              # উন্নয়ন সার্ভার চালু করুন
pnpm build            # উৎপাদন বিল্ড তৈরি করুন
pnpm start            # উৎপাদন সার্ভার চালু করুন
pnpm lint             # কোড চেক করুন
```

### ডাটাবেস
```bash
# স্কিমা আপলোড করুন
psql -U gt_user -d gaming_tournament < database/schema.sql

# ডাটাবেসে সংযোগ করুন
psql -U gt_user -d gaming_tournament

# সব টেবিল দেখুন
\dt

# এক্সিট করুন
\q
```

## সহায়ক লিংক

- **Next.js ডকুমেন্টেশন:** https://nextjs.org/docs
- **PostgreSQL ডকুমেন্টেশন:** https://www.postgresql.org/docs/
- **Tailwind CSS:** https://tailwindcss.com/docs
- **TypeScript:** https://www.typescriptlang.org/docs/

## জরুরি সাহায্য

**যদি সমস্যা হয়:**

1. লগ দেখুন (ব্রাউজার কনসোল এবং টার্মিনাল)
2. README.md পড়ুন
3. IMPLEMENTATION_GUIDE.md যাচাই করুন
4. ডাটাবেস সংযোগ পরীক্ষা করুন

**যোগাযোগ:**
- Email: support@gamingtournament.bd
- WhatsApp: +8801XXXXXXXXX

---

**শুভেচ্ছা! আপনার Gaming Tournament Platform প্রস্তুত।**

সফলভাবে চালানোর পরে, আপনি সম্পূর্ণ প্ল্যাটফর্ম কাস্টমাইজ এবং সম্প্রসারণ করতে পারেন।