# 🚀 راهنمای سریع راه‌اندازی

## نصب و اجرا در 3 مرحله:

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

### 2️⃣ اجرای برنامه
```bash
python app.py
```

### 3️⃣ باز کردن در مرورگر
```
http://localhost:7860
```

---

## 🌐 استقرار در Hugging Face Spaces

### روش 1: استفاده از Docker
1. فایل‌های پروژه را آپلود کنید
2. SDK را روی `Docker` تنظیم کنید
3. Space خودکار build می‌شود

### روش 2: استفاده مستقیم
1. `app.py` را در روت قرار دهید
2. پوشه `templates/` را آپلود کنید
3. `requirements.txt` را آپلود کنید
4. در Settings، Port را روی `7860` تنظیم کنید

---

## 🔍 تست APIها

### بررسی سلامت
```bash
curl http://localhost:7860/health
```

### دریافت نمای کلی بازار
```bash
curl http://localhost:7860/api/crypto/market-overview
```

### دریافت ارزهای ترند
```bash
curl http://localhost:7860/api/crypto/prices/trending?limit=10
```

### دریافت شاخص ترس و طمع
```bash
curl http://localhost:7860/api/crypto/sentiment/current
```

---

## ⚙️ تنظیمات پیشرفته

### تغییر Cache Time (در app.py)
```python
cache.get(cache_key, ttl=60)  # ثانیه
```

### تغییر پورت
```python
uvicorn.run(app, host="0.0.0.0", port=7860)
```

### فعال‌سازی HTTPS
```python
uvicorn.run(
    app, 
    host="0.0.0.0", 
    port=7860,
    ssl_keyfile="key.pem",
    ssl_certfile="cert.pem"
)
```

---

## 📊 API Endpoints Summary

| Endpoint | توضیح | پارامترها |
|----------|-------|-----------|
| `/` | صفحه اصلی HTML | - |
| `/health` | بررسی سلامت | - |
| `/api/crypto/market-overview` | نمای کلی بازار | - |
| `/api/crypto/prices/trending` | ارزهای ترند | `limit` (default: 10) |
| `/api/crypto/prices/top` | برترین ارزها | `limit` (default: 20) |
| `/api/crypto/news/latest` | آخرین اخبار | `limit` (default: 20) |
| `/api/crypto/sentiment/current` | احساسات فعلی | - |
| `/api/crypto/sentiment/history` | تاریخچه احساسات | `hours` (default: 168) |
| `/api/crypto/blockchain/gas` | قیمت گس | - |
| `/api/crypto/blockchain/stats` | آمار بلاکچین | - |
| `/api/crypto/whales/transactions` | تراکنش‌های نهنگ | `limit` (default: 20) |

---

## 🐛 مشکلات رایج

### خطای Port Already in Use
```bash
# پیدا کردن process
lsof -i :7860

# متوقف کردن
kill -9 <PID>
```

### خطای Module Not Found
```bash
pip install -r requirements.txt --force-reinstall
```

### مشکل CORS
در `app.py` این تنظیمات را چک کنید:
```python
app.add_middleware(
    CORSMiddleware,
    allow_origins=["*"],
    ...
)
```

---

## 💡 نکات مهم

1. **Rate Limiting**: CoinGecko API محدودیت درخواست دارد، از Cache استفاده کنید
2. **Production**: در محیط production، `allow_origins=["*"]` را تغییر دهید
3. **Monitoring**: لاگ‌ها را بررسی کنید: `tail -f logs/*.log`
4. **Updates**: هر 30 ثانیه داده‌ها به‌روزرسانی می‌شوند

---

## 📞 پشتیبانی

اگر مشکلی دارید:
1. فایل `README.md` را بخوانید
2. در GitHub Issue باز کنید
3. لاگ خطا را ضمیمه کنید

---

**ساخته شده با ❤️ برای کامیونیتی کریپتو**