archive/docs/QUICK_START_ADVANCED_UI.md

# 🚀 Quick Start - Advanced Admin Dashboard

## خلاصه تغییرات (Summary)

رابط کاربری پیشرفته با موفقیت ایجاد شد که تمام مشکلات را برطرف می‌کند:

### ✅ مشکلات برطرف شده:
1. ✅ **تکرار CryptoBERT**: مدل‌های ulako/CryptoBERT و kk08/CryptoBERT دیگر تکراری نمی‌شوند
2. ✅ **نمایش تعداد درخواست‌ها**: آمار کامل درخواست‌های API با نمودار
3. ✅ **اضافه شدن نمودارها**: 3 نوع نمودار تعاملی (Timeline, Status, Performance)
4. ✅ **ابزارهای قدرتمند**: مدیریت، تصحیح، و جایگزینی منابع
5. ✅ **Auto-Discovery**: کشف خودکار منابع جدید

## 🎯 دسترسی سریع

### راه‌اندازی سرور:
```bash
cd /workspace
python3 enhanced_server.py
```

### دسترسی به داشبورد جدید:
```
http://localhost:8000/admin_advanced.html
```

## 📊 امکانات کلیدی

### 1. Dashboard (📊)
- نمایش تعداد کل درخواست‌های API
- نرخ موفقیت (Success Rate)
- میانگین زمان پاسخ
- نمودار Timeline 24 ساعت گذشته
- نمودار Success vs Errors

### 2. Analytics (📈)
- نمودار Performance تمام منابع
- Top 5 منابع سریع
- منابع با مشکل
- Export داده‌ها

### 3. Resource Manager (🔧)
- **حذف Duplicates**: کلیک "Auto-Fix Duplicates"
- **Fix CryptoBERT**: endpoint مخصوص برای حل مشکل تکرار
- جستجو و فیلتر منابع
- اضافه/ویرایش/حذف منابع
- Bulk Operations (Validate All, Refresh All, Remove Invalid)

### 4. Auto-Discovery (🔍)
- کشف خودکار API‌ها و HuggingFace Models
- Progress Bar واقعی
- آمار دقیق
- Integration با APL

### 5. Diagnostics (🛠️)
- Scan & Auto-Fix
- Test Connections
- Clear Cache

### 6. Logs (📝)
- مشاهده و فیلتر لاگ‌ها
- Export لاگ‌ها

## 🔧 حل سریع مشکل CryptoBERT

### روش 1: از UI
1. برو به `http://localhost:8000/admin_advanced.html`
2. تب "Resource Manager"
3. کلیک "🔧 Auto-Fix Duplicates"

### روش 2: API مستقیم
```bash
curl -X POST http://localhost:8000/api/fix/cryptobert-duplicates
```

### روش 3: از کد Python
```python
import requests
response = requests.post('http://localhost:8000/api/fix/cryptobert-duplicates')
print(response.json())
```

## 📦 فایل‌های جدید

```
/workspace/
├── admin_advanced.html          (64 KB - رابط کاربری پیشرفته)
├── backend/routers/
│   └── advanced_api.py          (18 KB - API endpoints جدید)
├── UI_UPGRADE_COMPLETE.md       (راهنمای کامل)
└── QUICK_START_ADVANCED_UI.md   (این فایل)
```

## 🌐 API Endpoints جدید

```
GET  /api/stats/requests              - آمار درخواست‌ها
POST /api/resources/scan              - اسکن منابع
POST /api/resources/fix-duplicates    - حذف تکرار
POST /api/resources                   - اضافه کردن منبع
DELETE /api/resources/{id}            - حذف منبع
POST /api/discovery/full              - Auto-discovery
GET  /api/discovery/status            - وضعیت discovery
POST /api/log/request                 - ثبت درخواست
POST /api/fix/cryptobert-duplicates   - حل مشکل CryptoBERT
GET  /api/export/analytics            - Export آمار
GET  /api/export/resources            - Export منابع
```

## 💡 نکات مهم

### Auto-refresh
داشبورد هر 30 ثانیه خودکار بروزرسانی می‌شود.

### Backup
قبل از هر تغییر، backup خودکار ایجاد می‌شود در:
```
/workspace/providers_config_extended.backup.{timestamp}.json
```

### Logs
تمام عملیات در لاگ ثبت می‌شوند:
```
/workspace/data/logs/provider_health.jsonl
```

### Export
داده‌های Export شده در اینجا ذخیره می‌شوند:
```
/workspace/data/exports/
```

## 🎨 تم

- **Dark Theme**: تم تیره مدرن
- **Responsive**: سازگار با موبایل
- **Animations**: انیمیشن‌های نرم
- **Charts**: نمودارهای تعاملی Chart.js

## 🔍 مثال استفاده

### مثال 1: مشاهده آمار
```javascript
// در Console مرورگر
fetch('/api/stats/requests')
  .then(r => r.json())
  .then(data => console.log(data));
```

### مثال 2: حذف Duplicates
```bash
curl -X POST http://localhost:8000/api/resources/fix-duplicates \
  -H "Content-Type: application/json"
```

### مثال 3: اضافه کردن منبع جدید
```bash
curl -X POST http://localhost:8000/api/resources \
  -H "Content-Type: application/json" \
  -d '{
    "type": "api",
    "name": "My New API",
    "url": "https://api.example.com",
    "category": "market_data",
    "notes": "Test API"
  }'
```

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

### مشکل: نمودارها نمایش داده نمی‌شوند
**راه‌حل**: مطمئن شوید اتصال اینترنت برای دریافت Chart.js فعال است.

### مشکل: آمار صفر است
**راه‌حل**: منتظر بمانید تا چند درخواست API ثبت شود، یا از "Refresh" استفاده کنید.

### مشکل: Discovery کار نمی‌کند
**راه‌حل**: مطمئن شوید `auto_provider_loader.py` در مسیر صحیح است.

## 📞 پشتیبانی

برای مشاهده راهنمای کامل:
```
/workspace/UI_UPGRADE_COMPLETE.md
```

برای لاگ‌های سرور:
```bash
tail -f /workspace/data/logs/app.log
```

## 🎉 نتیجه

✨ همه چیز آماده است! فقط سرور را راه‌اندازی کنید و از داشبورد جدید لذت ببرید!

```bash
python3 enhanced_server.py
```

سپس باز کنید:
```
http://localhost:8000/admin_advanced.html
```

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