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: کشف خودکار منابع جدید

🎯 دسترسی سریع

راه‌اندازی سرور:

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 مستقیم

curl -X POST http://localhost:8000/api/fix/cryptobert-duplicates

روش 3: از کد 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: مشاهده آمار

// در Console مرورگر
fetch('/api/stats/requests')
  .then(r => r.json())
  .then(data => console.log(data));

مثال 2: حذف Duplicates

curl -X POST http://localhost:8000/api/resources/fix-duplicates \
  -H "Content-Type: application/json"

مثال 3: اضافه کردن منبع جدید

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

برای لاگ‌های سرور:

tail -f /workspace/data/logs/app.log

🎉 نتیجه

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

python3 enhanced_server.py

سپس باز کنید:

http://localhost:8000/admin_advanced.html

موفق باشید! 🚀