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

```

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