---
language:
- ar
- en
tags:
- guardian
- auto-guardian-core
- core
- auto
license: mit
---

# 🛡️ Auto-Guardian Security System | نظام الحارس التلقائي للأمن

<div align="center">

![Auto-Guardian Logo](assets/logo.svg)

![Python](https://img.shields.io/badge/Python-3.9%2B-blue?style=for-the-badge&logo=python)
![License](https://img.shields.io/badge/License-MIT-green?style=for-the-badge)
![GitHub Actions](https://img.shields.io/badge/GitHub_Actions-Enabled-purple?style=for-the-badge)
![Dashboard](https://img.shields.io/badge/Dashboard-Web_Interface-orange?style=for-the-badge)

**نظام متكامل لفحص الكود البرمائي وكشف الثغرات الأمنية بشكل تلقائي**

*Automated Code Security Scanning and Vulnerability Detection System*

</div>

---

## 📋 نظرة عامة | Overview

**نظام Auto-Guardian** هو أداة متكاملة مصممة لتعزيز الأمان في مشاريع البرمجة من خلال فحص الكود آلياً واكتشاف الثغرات الأمنية قبل دمجها في الكود الرئيسي. يجمع النظام بين قوة أدوات التحليل الثابت (Static Analysis) وسهولة الاستخدام من خلال لوحة تحكم ويب متجاوبة تدعم اللغتين العربية والإنجليزية.

يهدف هذا المشروع إلى تمكين فرق التطوير من تبني ممارسات **DevSecOps** بسهولة، حيث يتم دمج الفحص الأمني تلقائياً ضمن دورة حياة التطوير. يوفر النظام تقارير تفصيلية عن الثغرات المكتشفة مع تصنيفها حسب مستوى الخطورة، مما يساعد المطورين على تحديد أولويات الإصلاح بكفاءة عالية.

---

## ✨ الميزات الرئيسية | Key Features

### 🔍 الفحص الأمني الآلي | Automated Security Scanning
يستخدم النظام مجموعة متكاملة من أدوات التحليل الأمني للكشف عن الثغرات الشائعة في الكود البرمجي. يدعم النظام فحص مشاريع **Python** و **JavaScript** و **Java** وغيرها من اللغات الشائعة.

### 📊 لوحة تحكم تفاعلية | Interactive Dashboard
توفر لوحة التحكم واجهة ويب متجاوبة بالكامل تعرض إحصائيات الأمان بشكل لحظي ومباشر. تدعم اللوحة اللغتين العربية والإنجليزية مع دعم كامل للاتجاه من اليمين لليسار (RTL).

### 🛠️ ملحقات النظام | System Extras
يتضمن المشروع مجموعة واسعة من الملحقات والأدوات الإضافية:
- **Docker Support**: حاويات جاهزة للتشغيل باستخدام `docker-compose`.
- **API Documentation**: توثيق كامل للواجهة البرمجية بصيغة `OpenAPI`.
- **Management Scripts**: سكربتات للنسخ الاحتياطي والصيانة والترقية.
- **Security Templates**: قوالب جاهزة لبلاغات الثغرات وطلبات السحب.

---

## 🏗️ هيكل المشروع | Project Structure

```
Auto-Guardian-Core/
├── 📄 index.html                # لوحة التحكم الرئيسية (GitHub Pages)
├── 📄 docker-compose.yml        # إعدادات Docker
├── 📄 requirements.txt          # متطلبات Python
├── 📂 scripts/                  # سكربتات الإدارة والفحص
│   ├── 📄 security_scanner.py   # فحص أمني متقدم (جديد)
│   ├── 📄 backup.sh             # النسخ الاحتياطي
│   ├── 📄 maintenance.sh        # الصيانة
│   └── 📄 upgrade.sh            # الترقية
├── 📄 robots.txt                # ملفات SEO لمحركات البحث
├── 📄 sitemap.xml               # خريطة الموقع لمحركات البحث
├── 📄 structured-data.json      # البيانات المنظمة (JSON-LD)
├── 📂 docs/                     # التوثيق التقني
│   ├── 📂 api/                  # توثيق OpenAPI
│   └── 📄 configuration.md      # إعدادات النظام
├── 📂 assets/                   # الأصول المرئية والشعارات
└── 📂 .github/                  # قوالب GitHub
```

---

## 🚀 البدء السريع | Quick Start

### التشغيل عبر Docker (موصى به)
```bash
docker-compose up -d
```

### التشغيل المحلي
```bash
pip install -r requirements.txt
python -m http.server 8000
```

---

## 📝 الترخيص | License
هذا المشروع مرخص تحت **رخصة MIT**. راجع ملف [LICENSE](LICENSE) لمزيد من التفاصيل.

---

<div align="center">

**صُنع بـ ❤️ بواسطة Auto-Guardian Team**

[المستودع الرئيسي](https://github.com/AbdulElahOthmanGwaith/Auto-Guardian-Core) | [لوحة التحكم المباشرة](https://abdulelahothmangwaith.github.io/Auto-Guardian-Core/)

</div>