archive/docs/PROVIDERS_CONFIG_UPDATE_FA.md

# 📋 گزارش بروزرسانی providers_config_extended.json

## ✅ خلاصه تغییرات

**تاریخ**: 2025-11-17  
**فایل**: `providers_config_extended.json`  
**پرووایدرهای قبلی**: 93  
**پرووایدرهای جدید**: +2  
**کل پرووایدرها**: **95**

---

## 🆕 پرووایدرهای اضافه شده

### 1. huggingface_space_api
**دسته**: `market_data`  
**URL پایه**: `https://really-amin-datasourceforcryptocurrency.hf.space`

#### Endpoint‌های موجود (20 endpoint):

| # | Endpoint Key | مسیر URL | توضیحات |
|---|-------------|----------|---------|
| 1 | `health` | `/health` | بررسی سلامت سیستم |
| 2 | `info` | `/info` | اطلاعات سیستم |
| 3 | `providers` | `/api/providers` | لیست پرووایدرها |
| 4 | `ohlcv` | `/api/ohlcv` | داده OHLCV/Candlestick |
| 5 | `crypto_prices_top` | `/api/crypto/prices/top` | قیمت‌های برتر |
| 6 | `crypto_price_single` | `/api/crypto/price/{symbol}` | قیمت تکی |
| 7 | `market_overview` | `/api/crypto/market-overview` | بررسی کلی بازار |
| 8 | `market_prices` | `/api/market/prices` | قیمت‌های چندتایی |
| 9 | `market_data_prices` | `/api/market-data/prices` | داده‌های بازار |
| 10 | `analysis_signals` | `/api/analysis/signals` | سیگنال‌های معاملاتی |
| 11 | `analysis_smc` | `/api/analysis/smc` | تحلیل SMC |
| 12 | `scoring_snapshot` | `/api/scoring/snapshot` | امتیازدهی |
| 13 | `all_signals` | `/api/signals` | تمام سیگنال‌ها |
| 14 | `sentiment` | `/api/sentiment` | احساسات بازار |
| 15 | `system_status` | `/api/system/status` | وضعیت سیستم |
| 16 | `system_config` | `/api/system/config` | تنظیمات سیستم |
| 17 | `categories` | `/api/categories` | دسته‌بندی‌ها |
| 18 | `rate_limits` | `/api/rate-limits` | محدودیت‌های درخواست |
| 19 | `logs` | `/api/logs` | لاگ‌ها |
| 20 | `alerts` | `/api/alerts` | هشدارها |

#### مشخصات:
```json
{
  "rate_limit": {
    "requests_per_minute": 1200,
    "requests_per_hour": 60000
  },
  "requires_auth": false,
  "priority": 10,
  "weight": 100,
  "validated": true
}
```

#### ویژگی‌ها:
- ✅ داده OHLCV
- ✅ قیمت‌های real-time
- ✅ سیگنال‌های معاملاتی
- ✅ تحلیل SMC
- ✅ تحلیل احساسات
- ✅ بررسی کلی بازار
- ✅ نظارت سیستم

---

### 2. huggingface_space_hf_integration
**دسته**: `hf-model`  
**URL پایه**: `https://really-amin-datasourceforcryptocurrency.hf.space`

#### Endpoint‌های موجود (5 endpoint):

| # | Endpoint Key | مسیر URL | توضیحات |
|---|-------------|----------|---------|
| 1 | `hf_health` | `/api/hf/health` | سلامت یکپارچه‌سازی HF |
| 2 | `hf_refresh` | `/api/hf/refresh` | بروزرسانی داده HF |
| 3 | `hf_registry` | `/api/hf/registry` | رجیستری مدل‌ها |
| 4 | `hf_run_sentiment` | `/api/hf/run-sentiment` | اجرای تحلیل احساسات |
| 5 | `hf_sentiment` | `/api/hf/sentiment` | تحلیل احساسات (جایگزین) |

#### مشخصات:
```json
{
  "rate_limit": {
    "requests_per_minute": 60,
    "requests_per_hour": 3600
  },
  "requires_auth": false,
  "priority": 10,
  "weight": 100,
  "validated": true
}
```

#### ویژگی‌ها:
- ✅ تحلیل احساسات
- ✅ رجیستری مدل
- ✅ بررسی سلامت مدل
- ✅ بروزرسانی داده

---

## 📊 آمار نهایی

```
📌 کل پرووایدرها: 95
📌 پرووایدرهای جدید: 2
📌 کل endpoint‌های جدید: 25
📌 دسته‌های درگیر: market_data, hf-model
```

### توزیع پرووایدرها بر اساس دسته (به‌روز شده):
```
market_data:           11 (+1) ✨
hf-model:               3 (+1) ✨
blockchain_explorers:   9
exchange:               9
defi:                  11
blockchain_data:        6
news:                   5
hf-dataset:             5
analytics:              4
nft:                    4
social:                 3
sentiment:              2
دیگر موارد:            23
```

---

## 🔗 نحوه استفاده از endpoint‌های جدید

### 1. دریافت داده OHLCV
```python
import requests

response = requests.get(
    "https://really-amin-datasourceforcryptocurrency.hf.space/api/ohlcv",
    params={
        "symbol": "BTCUSDT",
        "interval": "1h",
        "limit": 100
    }
)
data = response.json()
print(f"Got {data['count']} candles")
```

### 2. دریافت قیمت‌های برتر
```python
response = requests.get(
    "https://really-amin-datasourceforcryptocurrency.hf.space/api/crypto/prices/top",
    params={"limit": 10}
)
prices = response.json()
print(f"Top {prices['count']} cryptocurrencies")
```

### 3. دریافت سیگنال‌های معاملاتی
```python
response = requests.get(
    "https://really-amin-datasourceforcryptocurrency.hf.space/api/analysis/signals",
    params={"symbol": "BTCUSDT", "timeframe": "1h"}
)
signals = response.json()
print(f"Signal: {signals['signal']}, Trend: {signals['trend']}")
```

### 4. تحلیل احساسات با HuggingFace
```python
response = requests.post(
    "https://really-amin-datasourceforcryptocurrency.hf.space/api/hf/sentiment",
    json={"texts": ["Bitcoin is going to the moon!"]}
)
sentiment = response.json()
print(sentiment)
```

---

## 🎯 یکپارچه‌سازی با سیستم موجود

این پرووایدرها به طور خودکار در سیستم موجود یکپارچه می‌شوند:

### 1. در Gradio Dashboard (app.py):
```python
# پرووایدرها به طور خودکار load می‌شوند
providers = get_providers_table("All")
# شامل 95 پرووایدر (از جمله 2 پرووایدر جدید)
```

### 2. در API Monitoring:
```python
# سیستم monitoring به طور خودکار پرووایدرهای جدید را شناسایی می‌کند
from provider_manager import ProviderManager
manager = ProviderManager()
stats = manager.get_all_stats()
# شامل آمار 95 پرووایدر
```

### 3. در Collectors:
```python
# Collectors می‌توانند از endpoint‌های جدید استفاده کنند
import collectors
success, count = collectors.collect_from_provider('huggingface_space_api')
```

---

## 🧪 تست endpoint‌های جدید

### تست دستی:
```bash
# تست health
curl https://really-amin-datasourceforcryptocurrency.hf.space/health

# تست OHLCV
curl "https://really-amin-datasourceforcryptocurrency.hf.space/api/ohlcv?symbol=BTCUSDT&interval=1h&limit=10"

# تست top prices
curl "https://really-amin-datasourceforcryptocurrency.hf.space/api/crypto/prices/top?limit=5"

# تست signals
curl "https://really-amin-datasourceforcryptocurrency.hf.space/api/analysis/signals?symbol=BTCUSDT"

# تست HF health
curl "https://really-amin-datasourceforcryptocurrency.hf.space/api/hf/health"
```

### تست خودکار:
```bash
# استفاده از اسکریپت تست
chmod +x TEST_ENDPOINTS.sh
./TEST_ENDPOINTS.sh
```

---

## 📂 فایل‌های مربوطه

### فایل‌های به‌روز شده:
- ✅ `providers_config_extended.json` - اضافه شدن 2 پرووایدر جدید
- ✅ `providers_config_extended.backup.json` - نسخه پشتیبان

### فایل‌های مرتبط:
- `hf_unified_server.py` - سرور API که endpoint‌ها را ارائه می‌دهد
- `app.py` - Gradio dashboard که پرووایدرها را نمایش می‌دهد
- `main.py` - Entry point اصلی

---

## 🔄 نحوه بازگرداندن تغییرات (در صورت نیاز)

اگر نیاز به بازگرداندن تغییرات داشتید:

```bash
# بازگرداندن از backup
cp providers_config_extended.backup.json providers_config_extended.json
```

یا استفاده از git:
```bash
git checkout providers_config_extended.json
```

---

## ✅ چک‌لیست تأیید

- [x] فایل JSON معتبر است
- [x] هیچ syntax error ندارد
- [x] 2 پرووایدر جدید اضافه شد
- [x] 25 endpoint جدید قابل دسترس است
- [x] backup از فایل قبلی گرفته شد
- [x] مستندات کامل ایجاد شد
- [x] نمونه کدها آماده است

---

## 🎉 نتیجه

✅ **موفق!** فایل `providers_config_extended.json` با موفقیت به‌روز شد.

### قبل از بروزرسانی:
- 93 پرووایدر
- هیچ endpoint مستقیم به HuggingFace Space نداشتیم

### بعد از بروزرسانی:
- **95 پرووایدر** (+2)
- **25 endpoint جدید**
- دسترسی مستقیم به HuggingFace Space
- یکپارچه‌سازی کامل با سیستم موجود

---

**نسخه**: 3.2.0  
**تاریخ**: 2025-11-17  
**وضعیت**: ✅ تکمیل شده و آماده استفاده

🚀 حالا سیستم شما می‌تواند از تمام endpoint‌های HuggingFace Space استفاده کند!