🚀 دليل الإعداد الشامل

ابدأ مع Auto-Guardian

نظام الفحص الأمني التلقائي للكود. اتبع الخطوات أدناه لتفعيل النظام بالكامل والحصول على لوحة تحكم تفاعلية تعرض حالة أمان مستودعك.

خطوات الإعداد

اتبع هذه الخطوات بالترتيب لتفعيل النظام على مستودعك

1

إنشاء المستودع أو نسخ القالب

أولاً، تحتاج إلى إنشاء مستودع جديد. يمكنك استخدام هذا المشروع كقالب لإنشاء مستودع جديد، أو نسخ الملفات يدوياً إلى مستودع موجود.

  • اذهب إلى GitHub
  • زر Use this template لإنشاء مستودع جديد
  • أو انسخ الملفات يدوياً إذا كان لديك مستودع موجود
  • 2

    رفع الملفات

    بعد إنشاء المستودع، تحتاج إلى رفع جميع الملفات. الهيكل التالي يجب أن يكون موجوداً في مستودعك:

    📁 .github/workflows/scan-and-deploy.yml 📁 scripts/aggregate_results.py 📁 scripts/generate_report.py 📁 dashboard/public/data/latest.json 📁 dashboard/index.html 📄 README.md
    3

    تفعيل GitHub Pages

    الآن تحتاج إلى تفعيل GitHub Pages للسماح بنشر لوحة التحكم. اتبع الخطوات التالية:

  • اذهب إلى Settings في مستودعك
  • انقر على Pages في القائمة الجانبية
  • في قسم Build and deployment:
  • Source: اختر GitHub Actions
  • ┌─────────────────────────────────────────────┐ │ Build and deployment │ │ │ │ Source › GitHub Actions │ └─────────────────────────────────────────────┘
    4

    تفعيل GitHub Actions

    الآن دعنا نتحقق من أن GitHub Actions يعمل. سير العمل سيبدأ تلقائياً عند دفع أي تغيير.

  • اذهب إلى تبويب Actions في المستودع
  • ابحث عن Auto-Guardian Scan & Deploy
  • انقر على Enable workflow إذا كان معطلاً
  • 5

    اختبار النظام

    للاختبار، قم بدفع أي تغيير بسيط إلى المستودع. سير العمل سيبدأ تلقائياً وسيتم نشر لوحة التحكم بعد اكتمال الفحص.

  • أنشئ ملفاً جديداً أو عدل ملفاً موجوداً
  • ادفع التغييرات: git add . && git commit -m "test" && git push
  • تحقق من تبويب Actions لرؤية تقدم الفحص
  • بعد اكتمال الفحص، اذهب إلى Settings > Pages للحصول على الرابط
  • هيكل الملفات

    تأكد من أن جميع الملفات موجودة في الأماكن الصحيحة

    📁 auto-guardian/
        📁 .github/
            📁 workflows/
      NEW      📄 scan-and-deploy.yml
        📁 dashboard/
          📄 index.html
          📁 public/
            📁 data/
              📄 latest.json
        📁 scripts/
      NEW  📄 aggregate_results.py
            📄 generate_report.py
        📄 README.md

    مميزات النظام

    كل ما يقدمه لك نظام Auto-Guardian

    🛡️

    فحص أمني شامل

    يكتشف الثغرات الأمنية والأخطاء البرمجية باستخدام أدوات متخصصة لكل لغة برمجية.

    فحص تلقائي

    يبدأ الفحص تلقائياً عند كل دفع للكود، ولا تحتاج لأي تدخل يدوي.

    📊

    لوحة تحكم تفاعلية

    واجهة جميلة وسهلة الاستخدام تعرض حالة الأمان بشكل واضح ومباشر.

    🌐

    دعم لغات متعددة

    يدعم Python وJavaScript وTypeScript وGo وRust وغيرها من اللغات.

    الأسئلة الشائعة

    إجابات على الأسئلة المتكررة

    كم يستغرق الفحص؟
    يعتمد وقت الفحص على حجم المشروع. للمشاريع الصغيرة (أقل من 100 ملف) يستغرق عادة من 2 إلى 5 دقائق. للمشاريع الكبيرة قد يستغرق حتى 15 دقيقة.
    هل يمكنني استخدام النظام في مستودع خاص؟
    نعم، يمكنك استخدام النظام في المستودعات الخاصة. لكن إذا كنت تريد GitHub Pages عام، ستحتاج إلى خطة GitHub مدفوعة.
    ماذا يعني درجة الأمان؟
    درجة الأمان هي رقم من 0 إلى 100. الدرجة A (90-100) تعني مستوى ممتاز، بينما F (أقل من 60) تعني وجود مشاكل حرجة تحتاج اهتماماً فورياً.
    هل يمكنني تخصيص أدوات الفحص؟
    نعم، يمكنك تعديل ملف سير العمل لإضافة أو إزالة أدوات الفحص، أو تخصيص إعدادات كل أداة من خلال ملفات الإعدادات الخاصة بها.