PANO - منصة التحليل وعمليات الشبكة

🚀 بدء الاستخدام

1. استنساخ المستودع:

   git clone https://github.com/ALW1EZ/PANO.git
   cd PANO
   

2. تشغيل التطبيق:

   • لينكس: ./start_pano.sh
   • ويندوز: start_pano.bat

سينفذ البرنامج النصي للتشغيل تلقائياً ما يلي:

• التحقق من وجود تحديثات
• إعداد بيئة بايثون
• تثبيت التبعيات
• إطلاق PANO

لاستخدام تحويل البحث عن البريد الإلكتروني (Email Lookup transform) تحتاج إلى تسجيل الدخول باستخدام GHunt أولاً. بعد بدء PANO عبر البرامج النصية للتشغيل:

1. حدد البيئة الافتراضية يدوياً
   • لينكس: source venv/bin/activate
   • ويندوز: call venv\Scripts\activate
2. راجع كيفية تسجيل الدخول هنا

💡 دليل البدء السريع

1. إنشاء تحقيق: ابدأ تحقيقاً جديداً أو قم بتحميل تحقيق موجود
2. إضافة كيانات: اسحب الكيانات من الشريط الجانبي على الرسم البياني
3. اكتشاف الروابط: استخدم التحويلات (transforms) لإيجاد العلاقات تلقائياً
4. تحليل: استخدم طرق عرض الجدول الزمني والخريطة لفهم الأنماط
5. حفظ: قم بتصدير تحقيقك لاستخدامه لاحقاً

🔍 المميزات

🕸️ الوظائف الأساسية

• التصور البياني التفاعلي (Interactive Graph Visualization)

  • إنشاء الكيانات بالسحب والإفلات
  • خوارزميات تخطيط متعددة (دائري، هرمي، شعاعي، موجه بالقوة)
  • رسم خرائط ديناميكي للعلاقات
  • تنسيق مرئي للعُقد والحواف

• تحليل الجدول الزمني (Timeline Analysis)

  • تصور الأحداث زمنياً
  • تنقل تفاعلي عبر الجدول الزمني
  • تصفية وتجميع الأحداث
  • تحليل العلاقات الزمنية

• التكامل مع الخريطة (Map Integration)

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

🎯 إدارة الكيانات

• أنواع الكيانات المدعومة
  • 📧 عناوين البريد الإلكتروني
  • 👤 أسماء المستخدمين
  • 🌐 مواقع الويب
  • 🖼️ الصور
  • 📍 المواقع
  • ⏰ الأحداث
  • 📝 المحتوى النصي
  • 🔧 أنواع كيانات مخصصة

🔄 نظام التحويلات (Transform System)

• تحليل البريد الإلكتروني

  • التحقق من حسابات جوجل
  • استخراج أحداث التقويم
  • تحليل سجل المواقع
  • اكتشاف الخدمات المتصلة

• تحليل اسم المستخدم

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

• تحليل الصور

  • البحث العكسي عن الصور
  • تحليل المحتوى البصري
  • استخراج البيانات الوصفية
  • اكتشاف الصور ذات الصلة

🤖 التكامل مع الذكاء الاصطناعي

• PANAI
  • مساعد تحقيق باللغة الطبيعية
  • استخراج وربط الكيانات تلقائياً
  • التعرف على الأنماط واكتشاف الحالات الشاذة
  • دعم متعدد اللغات
  • اقتراحات مراعية للسياق
  • تحليل الجدول الزمني والرسوم البيانية

🧩 المكونات الأساسية

📦 الكيانات (Entities)

الكيانات هي اللبنات الأساسية لـ PANO. تمثل قطعاً متميزة من المعلومات يمكن ربطها وتحليلها:

• الأنواع المضمنة

  • 📧 البريد الإلكتروني: عناوين البريد الإلكتروني مع اكتشاف الخدمة
  • 👤 اسم المستخدم: أسماء المستخدمين في وسائل التواصل الاجتماعي والمنصات
  • 🌐 موقع الويب: صفحات ويب مع بيانات وصفية
  • 🖼️ الصورة: صور مع EXIF وتحليل
  • 📍 الموقع: إحداثيات جغرافية وعناوين
  • ⏰ الحدث: أحداث زمنية
  • 📝 النص: محتوى نصي عام

• نظام الخصائص (Properties System)

  • التحقق من صحة الخصائص مع مراعاة النوع
  • دوال جلب خصائص تلقائية
  • تحديث الخصائص ديناميكياً
  • أنواع خصائص مخصصة
  • دعم البيانات الوصفية

⚡ التحويلات (Transforms)

التحويلات هي عمليات مؤتمتة تعالج الكيانات لاكتشاف معلومات وعلاقات جديدة:

• أنواع العمليات

  • 🔍 الاكتشاف: إيجاد كيانات جديدة من الكيانات الموجودة
  • 🔗 الربط: ربط الكيانات ذات الصلة
  • 📊 التحليل: استخراج الرؤى من بيانات الكيان
  • 🌐 OSINT: جمع الاستخبارات مفتوحة المصدر
  • 🔄 الإثراء: إضافة بيانات إلى الكيانات الموجودة

• الميزات

  • دعم العمليات غير المتزامنة
  • تتبع التقدم
  • معالجة الأخطاء
  • تحديد المعدل
  • التحقق من النتائج

🛠️ المساعدون (Helpers)

المساعدون هي أدوات متخصصة بواجهات مستخدم مخصصة لمهام تحقيق محددة:

• المساعدون المتوفرون

  • 🔍 الفحص المتقاطع: تحليل الأقوال والشهادات
  • 👤 منشئ الصورة الشخصية: توليد تركيبات وجهية
  • 📸 محلل الوسائط: معالجة وتحليل متقدم للصور
  • 🔍 باحث القاعدة: البحث بالقرب من أماكن الاهتمام
  • 🔄 المترجم: ترجمة النصوص بين اللغات

• ميزات المساعدين

  • واجهات Qt مخصصة
  • تحديثات في الوقت الفعلي
  • تكامل مع الرسم البياني
  • تصور البيانات
  • إمكانيات التصدير

👥 المساهمة

نرحب بالمساهمات! للمساهمة في PANO:

1. انسخ المستودع (Fork) على https://github.com/ALW1EZ/PANO/
2. أجرِ تغييراتك في نسختك
3. اختبر تغييراتك بدقة
4. أنشئ طلب سحب (Pull Request) إلى فرعنا الرئيسي
5. في وصف طلب السحب، قم بتضمين:
   • ما تفعله التغييرات
   • لماذا أجريت هذه التغييرات
   • أي اختبارات أجريتها
   • لقطات شاشة إن أمكن

ملاحظة: نستخدم فرع main واحد للتطوير. يجب تقديم جميع طلبات السحب مباشرة إلى main.

📖 دليل التطوير

from dataclasses import dataclass
from typing import ClassVar, Dict, Any
from .base import Entity

@dataclass
class PhoneNumber(Entity):
    name: ClassVar[str] = "Phone Number"
    description: ClassVar[str] = "A phone number entity with country code and validation"
    
    def init_properties(self):
        """Initialize phone number properties"""
        self.setup_properties({
            "number": str,
            "country_code": str,
            "carrier": str,
            "type": str,  # mobile, landline, etc.
            "verified": bool
        })
    
    def update_label(self):
        """Update the display label"""
        self.label = self.format_label(["country_code", "number"])

from dataclasses import dataclass
from typing import ClassVar, List
from .base import Transform
from entities.base import Entity
from entities.phone_number import PhoneNumber
from entities.location import Location
from ui.managers.status_manager import StatusManager