# راهنمای نصب سریع (بدون ترمینال)

این راهنما برای هاستینگ اشتراکی است که دسترسی به ترمینال ندارید.

## روش نصب آسان و سریع

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

تمام فایل‌های پروژه را در هاست خود آپلود کنید. ساختار فایل‌ها باید به این صورت باشد:

```
public_html/
├── setup.php              # برای نصب اولیه
├── bootstrap.php          # بارگذاری خودکار
├── .env                   # تنظیمات (بعد از نصب ساخته می‌شود)
├── bot.php                # مدیریت خط فرمان
├── cron_processor.php     # برای cron job
├── composer.json          # (می‌توانید حذف کنید)
├── README.md
├── INSTALL.md
├── UTILS.md
├── config/
│   └── database.php
├── database/
│   └── migrations/
├── public/
│   └── webhook.php        # این آدرس webhook شماست
└── src/
    ├── Domain/
    ├── Engine/
    ├── Controller/
    ├── Repository/
    ├── Service/
    ├── AI/
    └── Utils/
```

### مرحله ۲: نصب از طریق مرورگر

۱. در مرورگر خود آدرس زیر را باز کنید:
```
https://yourdomain.com/setup.php
```

۲. دکمه "شروع نصب" را بزنید

۳. **تنظیمات دیتابیس:**
   - سرور: معمولا `localhost`
   - نام دیتابیس: مثلا `coup_game`
   - نام کاربری: مثلا `coup_user`
   - رمز عبور: رمز دیتابیس شما
   - کاراکتر ست: `utf8mb4` را انتخاب کنید

۴. **تنظیمات ربات:**
   - توکن ربات: توکنی که از BotFather گرفتید
   - آدرس webhook: خودکار پر می‌شود

۵. **نصب:**
   - دکمه "شروع نصب" را بزنید
   - منتظر بمانید تا تمام مراحل کامل شود

### مرحله ۳: شروع استفاده

در تلگرام به ربات خود پیام `/start` دهید!

## تنظیم Cron Job (اختیاری)

برای پردازش خودکار تایم‌اوت‌ها:

۱. به پنل هاستینگ خود بروید
۲. Cron Jobs را پیدا کنید
۳. cron job جدید بسازید با تنظیمات زیر:
```
*/30 * * * * php /path/to/cron_processor.php
```

مثال:
```
*/30 * * * * /usr/bin/php /home/yourusername/public_html/cron_processor.php
```

## تست کردن

### تست دیتابیس:
به phpMyAdmin بروید و ببینید جداول ساخته شده:
- users
- games
- game_players
- player_influences
- و غیره

### تست webhook:
در تلگرام به ربات `/start` دهید. اگر پاسخ داد، همه چیز درست است!

## اگر مشکلی پیش آمد

### ربات پاسخ نمی‌دهد:
۱. بررسی کنید webhook درست تنظیم شده
```
https://api.telegram.org/bot<TOKEN>/getWebhookInfo
```

۲. لاگ‌های خطا را چک کنید:
```
logs/error.log
logs/cron.log
```

### خطای دیتابیس:
۱. اطلاعات دیتابیس در `.env` را چک کنید
۲. مطمئن شوید دیتابیس وجود دارد
۳. دسترسی کاربر دیتابیس را چک کنید

### Cron کار نمی‌کند:
۱. مسیر PHP را درست کنید (از هاستینگ بپرسید)
۲. مسیر فایل cron_processor.php را چک کنید
۳. log فایل را چک کنید

## آدرس‌های مهم

- نصب: `https://yourdomain.com/setup.php`
- Webhook: `https://yourdomain.com/public/webhook.php`
- Bot در تلگرام: ربات خود را در تلگرام پیدا کنید

## حذف نصب

اگر می‌خواهید دوباره نصب کنید:
۱. فایل `.env` را حذف کنید
۲. دیتابیس را خالی کنید یا جدید بسازید
۳. دوباره به `setup.php` بروید

---

**موفق باشید! 🎮**