# 🚀 راهنمای کامل نصب و راه‌اندازی بات ROCKET VPN

## 📋 فهرست مطالب
1. [پیش‌نیازها](#پیش-نیازها)
2. [دریافت هاست رایگان](#دریافت-هاست-رایگان)
3. [نصب بات](#نصب-بات)
4. [تنظیم درگاه پرداخت](#تنظیم-درگاه-پرداخت)
5. [تست بات](#تست-بات)
6. [عیب‌یابی](#عیب-یابی)

---

## پیش‌نیازها

### ✅ چیزهایی که نیاز داری:
1. **توکن بات تلگرام** (از BotFather) - قبلاً گفتی داری ✅
2. **یک هاست لینوکس اشتراکی** (رایگان یا پولی)
3. **دامنه** (بعضی هاست‌های رایگان دامنه هم میدن)
4. **Composer** (ابزار نصب کتابخانه‌های PHP)

---

## دریافت هاست رایگان

### گزینه ۱: InfinityFree (پیشنهاد اول)
1. برو به [infinityfree.com](https://www.infinityfree.com)
2. ثبت‌نام کن (فقط ایمیل لازمه)
3. یک هاست جدید بساز
4. دامنه رایگان بگیر یا دامنه خودت رو وصل کن
5. اطلاعات FTP و دیتابیس رو یادداشت کن

### گزینه ۲: 000webhost
1. برو به [000webhost.com](https://www.000webhost.com)
2. ثبت‌نام کن
3. وب‌سایت جدید بساز

### گزینه ۳: هاست ایرانی پولی (بهترین عملکرد)
- هاستینگ (hosting.ir) - از ۵۰,۰۰۰ تومان/سال
- میهن‌هاست (mihanhost.ir) - از ۳۰,۰۰۰ تومان/سال

---

## نصب بات

### مرحله ۱: آپلود فایل‌ها

```bash
# اگه از Git استفاده می‌کنی:
git clone <repository-url> rocket-vpn-bot
cd rocket-vpn-bot

# اگه فایل‌ها رو دانلود کردی:
# فایل‌ها رو از حالت فشرده خارج کن
```

### مرحله ۲: نصب وابستگی‌ها

```bash
composer install --no-dev --optimize-autoloader
```

اگه Composer نداری:
```bash
# دانلود Composer
curl -sS https://getcomposer.org/installer | php
php composer.phar install --no-dev --optimize-autoloader
```

### مرحله ۳: ساخت دیتابیس

```bash
# از طریق خط فرمان:
mysql -u root -p < database.sql

# یا از طریق phpMyAdmin:
# 1. وارد phpMyAdmin شو
# 2. دیتابیس جدید بساز (rocket_vpn_bot)
# 3. فایل database.sql رو Import کن
```

### مرحله ۴: تنظیم فایل .env

```bash
cp .env.example .env
nano .env
```

این مقادیر رو تنظیم کن:
```
BOT_TOKEN=123456789:ABCdefGHIjklMNOpqrsTUVwxyz
BOT_USERNAME=YourBotUsername
ADMIN_IDS=123456789
DB_HOST=localhost
DB_NAME=rocket_vpn_bot
DB_USER=your_db_user
DB_PASS=your_db_password
WEBHOOK_SECRET=random_secret_string
ADMIN_PANEL_PASSWORD=your_secure_password
```

### مرحله ۵: آپلود روی هاست

با نرم‌افزار FileZilla یا بخش File Manager در cPanel:

1. همه فایل‌ها رو در پوشه `public_html` آپلود کن
2. مطمئن شو فایل `.env` هم آپلود شده

### مرحله ۶: تنظیم وب‌هوک

```bash
php set_webhook.php https://yourdomain.com/webhook.php
```

یا از طریق مرورگر:
```
https://api.telegram.org/bot<TOKEN>/setWebhook?url=https://yourdomain.com/webhook.php
```

### مرحله ۷: تنظیم کرون جاب

در cPanel → Cron Jobs:
```
*/5 * * * * cd /home/username/public_html && php cron.php >> cron.log 2>&1
```

---

## تنظیم درگاه پرداخت

### زرین‌پال (Zarinpal)

1. برو به [zarinpal.com](https://zarinpal.com)
2. ثبت‌نام کن و احراز هویت کن
3. درگاه جدید بساز
4. مرچنت کد رو کپی کن
5. در فایل .env قرار بده:
   ```
   ZARINPAL_MERCHANT_ID=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
   ZARINPAL_CALLBACK_URL=https://yourdomain.com/payment_callback.php
   ```

---

## تست بات

### ۱. تست سلامت:
```
https://yourdomain.com/health.php
```

باید این رو ببینی:
```json
{
    "ok": true,
    "version": "ROCKET_VPN_PHP_BOT_V1.0",
    "bot": "your_bot_username"
}
```

### ۲. تست بات:
1. در تلگرام بات رو باز کن
2. `/start` بزن
3. منوی اصلی باید نمایش داده بشه

### ۳. تست خرید:
1. دکمه "🛒 خرید سرویس جدید" رو بزن
2. یه دسته‌بندی انتخاب کن
3. یه پلن انتخاب کن
4. یه نام انگلیسی وارد کن
5. روش پرداخت رو انتخاب کن

---

## عیب‌یابی

### ❌ بات جواب نمیده:
1. مطمئن شو وب‌هوک تنظیم شده:
   ```
   https://api.telegram.org/bot<TOKEN>/getWebhookInfo
   ```
2. فایل `.env` رو چک کن
3. لاگ‌ها رو ببین:
   ```bash
   tail -f error_log
   ```

### ❌ دیتابیس وصل نمیشه:
1. اطلاعات DB در .env رو چک کن
2. مطمئن شو MySQL در حال اجراست
3. دیتابیس رو import کردی؟

### ❌ پنل ادمین باز نمیشه:
1. برو به `https://yourdomain.com/admin/`
2. رمز پیش‌فرض: `admin123`
3. حتماً رمز رو عوض کن

---

## 📞 پشتیبانی

اگه مشکلی داشتی، این اطلاعات رو بفرست:
1. پیغام خطا دقیق
2. لاگ سرور (error_log)
3. نسخه PHP (`php -v`)

---

## 🔒 نکات امنیتی

1. **رمز پنل ادمین رو عوض کن!**
2. **فایل .env رو در .gitignore قرار بده**
3. **از SSL استفاده کن** (Let's Encrypt رایگانه)
4. **WEBHOOK_SECRET** رو حتماً تنظیم کن
5. **بکاپ منظم** از دیتابیس بگیر

---

## 🎨 سفارشی‌سازی

### تغییر رنگ‌ها:
در فایل `admin/assets/css/admin.css`:
```css
:root {
    --primary: #6366f1;      /* رنگ اصلی */
    --success: #10b981;      /* رنگ موفقیت */
    --danger: #ef4444;       /* رنگ خطا */
}
```

### اضافه کردن ایموجی متحرک:
در تلگرام، استیکرهای Custom Emoji خودکار متحرک نمایش داده میشن. از پنل ادمین بات می‌تونی تنظیم کنی.

---

موفق باشی! 🚀