🛡️ Advanced VirusTotal Scanner

📋 نظرة عامة

تطبيق Flutter متقدم لفحص الروابط باستخدام VirusTotal API مع ميزات مراقبة الحافظة التلقائية والتكامل الكامل مع Linux KDE.

✨ المميزات الرئيسية

🔍 فحص الروابط المتقدم

• فحص فوري: إدخال الروابط وفحصها على الفور
• تحليل مفصل: نتائج شاملة من جميع محركات الفحص
• تقارير كاملة: ربط مباشر بتقارير VirusTotal
• فحص ذكي: كشف التهديدات وتصنيفها حسب مستوى الخطر

🔄 المراقبة التلقائية

• مراقبة الحافظة: فحص تلقائي لأي رابط يتم نسخه
• إشعارات ذكية: تنبيهات فورية للتهديدات فقط
• عمل في الخلفية: مراقبة مستمرة دون استنزاف البطارية
• تحكم كامل: إعدادات قابلة للتخصيص لسلوك المراقبة

🖥️ التكامل مع KDE Linux

• إشعارات النظام: تكامل مع نظام إشعارات KDE
• اختصارات لوحة المفاتيح:
  • Ctrl+Alt+V: فحص الحافظة
  • Ctrl+Alt+M: تبديل المراقبة
  • Ctrl+Alt+S: عرض الماسح
• قائمة السياق: فحص الملفات من Dolphin
• البدء التلقائي: تشغيل مع النظام

📊 إدارة البيانات المتقدمة

• سجل شامل: حفظ جميع نتائج الفحص مع تفاصيل كاملة
• إحصائيات مفصلة: تقارير عن التهديدات المكتشفة
• بحث متقدم: العثور على النتائج بسرعة
• تصدير واستيراد: نسخ احتياطية للبيانات

🛠️ التثبيت والإعداد

المتطلبات الأساسية

Flutter SDK: 3.10.0+
Dart SDK: 3.0.0+
Android SDK: للتطوير على Android
Linux: KDE Plasma 5.12+ للتكامل الكامل

1. إعداد المشروع

# إنشاء مشروع جديد
flutter create advanced_virus_scanner
cd advanced_virus_scanner

# نسخ الملفات
# انسخ جميع الملفات إلى مجلداتها المناسبة

2. تكوين API Key

// في lib/utils/constants.dart
static const String virusTotalApiKey = 'YOUR_ACTUAL_API_KEY_HERE';

🔑 للحصول على API Key:

1. اذهب إلى VirusTotal
2. أنشئ حساب مجاني
3. اذهب إلى Profile → API Key
4. انسخ المفتاح واستبدله في الملف

3. تثبيت التبعيات

flutter pub get

4. تشغيل التطبيق

# للتطوير
flutter run -d linux    # Linux
flutter run -d android  # Android

# للإنتاج
flutter build apk       # Android
flutter build linux     # Linux

5. إعداد KDE Integration (Linux)

chmod +x setup_kde_integration.sh
./setup_kde_integration.sh

🚀 الاستخدام

الفحص اليدوي

1. أدخل الرابط في الحقل المخصص
2. اضغط "فحص الرابط"
3. راجع النتائج المفصلة
4. استخدم الأزرار للإجراءات الإضافية

المراقبة التلقائية

1. فعل مفتاح "مراقبة الحافظة التلقائية"
2. انسخ أي رابط من المتصفح أو أي مكان
3. سيتم فحص الرابط تلقائياً في الخلفية
4. ستحصل على إشعار فوري للتهديدات

استخدام اختصارات KDE

• Ctrl+Alt+V: فحص محتوى الحافظة الحالي
• Ctrl+Alt+M: تفعيل/إيقاف المراقبة
• Ctrl+Alt+S: عرض نافذة الماسح

⚙️ الإعدادات المتقدمة

إعدادات المراقبة

• تأخير الفحص: الوقت قبل فحص الرابط (افتراضي: 2 ثانية)
• البدء التلقائي: بدء المراقبة مع تشغيل التطبيق
• حد السجل: العدد الأقصى للنتائج المحفوظة

إعدادات الإشعارات

• مستوى الإشعارات: جميع النتائج / التهديدات فقط / بدون إشعارات
• الصوت والاهتزاز: تخصيص تنبيهات التهديدات
• أولوية الإشعارات: عادية أو عالية أو حرجة

🔧 حل المشاكل الشائعة

مشاكل الشبكة

المشكلة: فشل الاتصال بـ VirusTotal الحل:

# تحقق من الاتصال
ping www.virustotal.com

# تحقق من API Key
curl -H "X-Apikey: YOUR_API_KEY" https://www.virustotal.com/api/v3/users/YOUR_API_KEY

مشاكل الإشعارات (Linux)

# تثبيت notify-send إذا لم يكن موجود
sudo apt install libnotify-bin

# اختبار الإشعارات
notify-send "Test" "تجربة الإشعار"

مشاكل مراقبة الحافظة

# التحقق من الأذونات
xhost +SI:localuser:$(whoami)

# إعادة تشغيل خدمة الحافظة
pkill -f clipboard

🛡️ الأمان والخصوصية

حماية البيانات

• لا تخزين للبيانات الحساسة خارج الجهاز
• تشفير البيانات المحلية
• استخدام HTTPS فقط للاتصالات
• حماية API Key من التسريب

إعدادات الأمان

• التحقق من الشهادات: تشفير SSL/TLS
• فلترة الطلبات: منع الطلبات الضارة
• حدود API: تجنب تجاوز حدود الاستخدام

📊 الإحصائيات والتقارير

الإحصائيات المتاحة

• إجمالي الفحوصات: عدد الروابط المفحوصة
• معدل التهديدات: نسبة التهديدات المكتشفة
• أكثر النطاقات: النطاقات الأكثر فحصاً
• اتجاهات زمنية: تطور التهديدات

تصدير التقارير

# تصدير البيانات
flutter run -- --export-data output.json

# إنشاء تقرير
flutter run -- --generate-report

🔄 التحديثات والصيانة

تحديث التبعيات

flutter pub upgrade
flutter pub get

تنظيف المشروع

flutter clean
flutter pub get
flutter build linux --release

🤝 المساهمة في التطوير

إعداد بيئة التطوير

# استنساخ المشروع
git clone https://github.com/username/advanced-virus-scanner
cd advanced-virus-scanner

# تثبيت التبعيات
flutter pub get

# تشغيل الاختبارات
flutter test

إرشادات المساهمة

1. أنشئ branch جديد للميزة
2. اتبع معايير الكود المحددة
3. أضف اختبارات للميزات الجديدة
4. أرسل Pull Request مع وصف مفصل

📞 الدعم والمساعدة

الحصول على المساعدة

• الوثائق: Documentation
• المسائل: GitHub Issues
• المجتمع: Discord Server

الإبلاغ عن المشاكل

**وصف المشكلة:**
[وصف مفصل للمشكلة]

**خطوات إعادة الإنتاج:**
1. [خطوة 1]
2. [خطوة 2]
3. [خطوة 3]

**النتيجة المتوقعة:**
[ما كان يجب أن يحدث]

**النتيجة الفعلية:**
[ما حدث بالفعل]

**البيئة:**
- نظام التشغيل: [Linux/Android]
- إصدار Flutter: [إصدار]
- إصدار التطبيق: [إصدار]

📄 الترخيص

هذا المشروع مرخص تحت MIT License.

🙏 الشكر والتقدير

• VirusTotal: للAPI المجاني الممتاز
• Flutter Team: للإطار الرائع
• KDE Community: لدعم التكامل مع سطح المكتب
• المساهمين: جميع من ساهم في تطوير المشروع

---

🔗 روابط مفيدة

• VirusTotal API Documentation
• Flutter Documentation
• KDE Development

🎉 التطبيق جاهز للاستخدام بجميع الميزات المطلوبة!

---

📊 إحصائيات المشروع:

• اللغة: Dart/Flutter
• المنصات: Android, Linux, Windows
• الحالة: ✅ مكتمل وجاهز للاستخدام