# 🚀 راهنمای سریع شروع

## نصب و اجرا

### 1. نصب وابستگی‌ها:
```bash
pip install -r requirements.txt
```

### 2. تنظیمات:
ویرایش `config/settings.py`:
```python
BOT_TOKEN = "8773106625:AAGfE8gY8cHjjRd-80o7tefBWHo7kBfzTlM"
ADMIN_ID = 7135477742
```

### 3. اجرا:
```bash
python main.py
```

## 📱 استفاده

### برای کاربران:
1. `/start` - شروع ربات
2. کلیک روی دکمه‌های منو
3. انتخاب پلن و خریداری

### برای ادمین:
1. `/admin` - ورود به پنل
2. مدیریت پلن‌ها، کاربران، و تراکنش‌ها

## 🎯 مثال‌های سریع

### اضافه کردن کاربر دستی:
```python
from database.db_manager import UserManager
users = UserManager('data/users.json')
users.create_user(123456789, 'username', 'نام')
users.add_coin(123456789, 1000)
```

### ویرایش پلن:
```python
from database.db_manager import PlansManager
plans = PlansManager('data/plans.json')
plans.update_plan('1', {'price_toman': 60000})
```

### مشاهده آمار:
```python
from database.db_manager import UserManager, TransactionManager
users = UserManager('data/users.json')
transactions = TransactionManager('data/transactions.json')
print(f"کل کاربران: {len(users.get_all_users())}")
print(f"کل فروش: {transactions.get_total_sales():,}")
```

## 🔗 لینک‌های مهم

- [aiogram Documentation](https://docs.aiogram.dev/)
- [Telegram Bot API](https://core.telegram.org/bots/api)

## ❓ سوالات متکرر

**Q: از کجا می‌تونم توکن ربات بگیرم؟**  
A: از [@BotFather](https://t.me/botfather) توی تلگرام درخواست کنید

**Q: چطور ادمین شم؟**  
A: ادمین آی‌دی خود را در `config/settings.py` تنظیم کنید

**Q: داده‌ها کجا ذخیره می‌شن؟**  
A: در فایل‌های JSON داخل پوشه `data/`

## 🐛 حل مشکلات

### خطای اتصال:
```
HTTP Client says - ClientConnectorError
```
- VPN/داده انترنت را چک کنید
- آتش‌خانه را راستی‌آزمایی کنید

### خطای توکن:
```
Not found: 404 Not Found
```
- توکن را درست کپی کنید
- حروف اضافی را پاک کنید

---

**برای کمک بیشتر [Issues](https://github.com) را چک کنید**